Парус 8 · Конструктор отраслевых расширений
Ограничение класса описывает правило для одного или нескольких атрибутов и указывает, какое сообщение Парус покажет при его нарушении.
CNS + Класс|ИмяОграничение в КОР
Ограничение класса — описание правила в метаданных Паруса. Например, у класса «Заявки» номер должен быть уникальным внутри группы. В таблице это может обеспечивать UNIQUE(NUM, GRP). Ограничение класса с соответствующим именем связывает эту ошибку с сообщением «Номер уже занят в группе» и перечисляет участвующие атрибуты: NUM — позиция 1, GRP — позиция 2.
Само физическое ограничение переносится с таблицей: TBP.Cns на PostgreSQL или JTB.Cns на Oracle. Добавление CNS не создаёт UNIQUE, CHECK или триггер. Чтобы правило действовало в приёмнике, нужны и его описание, и реализация в базе. Метаданные одного класса можно переносить между СУБД; SQL-реализацию Holkas автоматически не переводит.
Тип «Обязательность» описывает обязательное поле, а «Неизменяемость» — запрет изменения уже заданного значения. Последнему нужен триггер БД: одна запись типа 6 поле не блокирует. Внешний ключ описывается связью класса.
Что входит в перенос
Ограничение принадлежит классу и появляется при раскрытии его состава. Оно также имеет собственный адрес, например CNS Request|UDO_C_REQUEST_NUMGRP_UK. Выбор одного CNS не заменяет перенос класса и его атрибутов. Сообщение MSG — отдельный объект: CNS хранит только его код. Текст сообщения не является дочерней частью ограничения.
У CNS нет папки каталога Паруса: UnitCode называет класс, а Class/ и Constraint/ ниже — каталоги файлов. Поиск и создание папки ACATALOG этому типу не требуются.
Справочник полей
11 полей · 2 группыВсе поля модели переноса: 8 реквизитов ограничения, список атрибутов и 2 поля включения. Технические имена совпадают с Git YAML; рядом — имена JSON для S3 и «Файла пакета».
Как читать обозначения и правила
Наведите указатель на значок, перейдите к нему клавишей Tab или нажмите его — появится пояснение.
Часть ключа определяет адрес вместе с другим полем; Ключ узнаёт элемент внутри родителя; Сравнивается означает учёт разницы в плане; По элементам — отдельные команды над списком.
Create задаёт новое описание; Update передаёт все реквизиты своей записи. Допустимость значений проверяет Парус. Ограничения самого Holkas указаны у полей отдельно.
Реквизиты ограничения · CNS9 полей
UnitCodeJSON: unitCodeстрокаЧасть ключаКласс-владелец- Назначение
- Код класса Паруса, например Request. Вместе с ConstraintName задаёт адрес ограничения.
- При переносе:
- При создании класс должен уже существовать или создаваться в том же плане. Другой UnitCode адресует ограничение другого класса; прежнее в БД автоматически не удаляется.
ConstraintNameJSON: constraintNameстрокаЧасть ключаИмя ограничения- Назначение
- Имя, например UDO_C_REQUEST_NUMGRP_UK. Для сообщения об ошибке БД оно должно соответствовать имени физического ограничения таблицы.
- При переносе:
- Новое имя означает другой CNS: если его нет, создаётся новый; старый в БД остаётся. Это не переименование через Update. В обследованном Парусе имя непустое, в верхнем регистре, до 32 знаков и уникально среди ограничений всех классов.
ConstraintNoteJSON: constraintNoteстрока / nullСравниваетсяНаименование- Назначение
- Понятное человеку описание, например «Номер уникален в группе». Это отдельный реквизит, а не имя ограничения.
- При переносе:
- Разница даёт Update CNS и меняет наименование существующей записи. В обследованном Парусе оно непустое, до 240 знаков и уникально внутри класса. Если наименование переходит к другому ограничению этого класса, Holkas сначала освобождает его, а обмен по кругу не переносит и называет в плане — см. «Ограничения меняются наименованиями». null не означает «оставить прежнее»: значение передаётся процедуре.
ConstraintTypeJSON: constraintTypeцелое / nullСравниваетсяТип ограничения- Назначение
- 0 — уникальность; 1 — первичный ключ; 2 — проверка; 5 — обязательность; 6 — неизменяемость. Смысл типов разобран ниже.
- При переносе:
- Передаётся при Create / Update CNS; физическое ограничение от этого не создаётся и не меняется. Тип обязателен в Парусе. При переходе с проверки на другой тип очистите ConstraintText; LinksSign=1 допустим только у уникальности.
MessageCodeJSON: messageCodeстрока / nullСравниваетсяСообщение при нарушении- Назначение
- Код отдельного сообщения MSG, например REQUEST_NUMGRP_UK. Сам текст сообщения в CNS не хранится.
- При переносе:
- Create / Update CNS находит сообщение по коду; его Create выполняется раньше. В обследованном Парусе сообщение обязательно: null не сохраняет прежнюю ссылку. Изменение текста самого MSG при прежнем коде не требует Update CNS.
ConstraintTextJSON: constraintTextстрока / nullСравниваетсяТекст ограничения- Назначение
- Условие типа «Проверка», например NUM is null or NUM between 1 and 100. В обследованном Парусе текст — до 2000 знаков, для других типов должен быть null.
- При переносе:
- Изменение даёт Update CNS. Holkas сохраняет описание, не исполняет условие и не создаёт CHECK в таблице. Null передаётся процедуре; пустая строка не является рекомендуемой заменой null.
ConstraintInitJSON: constraintInitстрокаСравниваетсяИнициализация ограничения- Назначение
- Текст для действия КОР «Синхронизация метаданных»: подготовка значений полей перед созданием физического ограничения. Это не скрипт, автоматически запускаемый переносом Holkas.
- При переносе:
- Передаётся при создании. При Update текст менять нельзя: настоящее отличие отклоняет всю корневую команду. Отличие только в записи — пропущенное поле, null или пустая строка, CRLF или LF — изменением не считается: остальные реквизиты записываются, а текст приёмника остаётся прежним. Пропуск и null Holkas читает как пустой текст: так Парус хранит его отсутствие.
LinksSignJSON: linksSignцелое / nullСравниваетсяИспользовать для разрешения ссылок- Назначение
- Признак КОР: 1 — выбрать это ограничение уникальности для разрешения ссылок; 0 — не выбирать. Например, признак может быть у ограничения пары «Номер, Группа».
- При переносе:
- Передаётся при Create / Update CNS. Только один CNS класса может иметь 1; у других типов требуется 0. Holkas не просит Парус снять 1 с соседа автоматически: команда, ставящая 1, выполняется после Update прежнего владельца, который признак снимает. Если прежний владелец не входит в перенос, Парус откажет.
AttributeConstrainsJSON: attributeConstrainsсписокПо элементамАтрибуты ограничения- Назначение
- Полный список включений атрибутов класса в правило: имя Attribute и числовая Position. Именно AttributeConstrains — имя текущего поля, с таким написанием.
- При переносе:
- Элементы сопоставляются по Attribute: новые добавляются, позиции меняются, отсутствующие в списке из источника удаляются. [] снимает все включения. Атрибуты класса при этом сохраняются. Порядок строк файла сам по себе не меняет позиции.
Атрибут ограничения · CNS.Attr2 поля
AttributeJSON: attributeстрокаКлючИмя атрибута класса- Назначение
- ColumnName существующего атрибута того же UnitCode, например NUM. Это включение атрибута в ограничение, а не новое определение атрибута.
- При переносе:
- Если заменить NUM на NUMBER в полном списке, план удалит включение NUM и добавит NUMBER. Сам NUM останется в классе. Перед добавлением/обновлением включения ожидается Create CLS.Attr, если такой атрибут создаётся в плане.
PositionJSON: positionцелое / nullСравниваетсяПозиция в ограничении- Назначение
- Место поля внутри физического ограничения: для UNIQUE(NUM, GRP) у NUM позиция 1, у GRP — 2. Это число, а не строка и не порядок атрибутов всего класса.
- При переносе:
- Разница даёт Update CNS.Attr и SetOrder CNS.AttrPos. Процедуры частей могут сдвигать соседей; завершающая команда закрепляет указанные позиции. Задавайте каждому элементу различную позицию с 1. null не означает «сохранить старое место»; 0 процедуры обычного добавления/изменения отвергают.
Команды плана
Три кода относятся к самому ограничению, включению атрибута и установке позиций. Значки действий имеют подписи по наведению, клавиатурному фокусу и нажатию.
Ограничение и его атрибуты3 кода
CNSРеквизиты ограничения
Создаёт отсутствующее ограничение либо изменяет наименование, тип, сообщение, текст и LinksSign существующего. Передаёт весь набор реквизитов процедуре Паруса. Отличие ConstraintInit при Update отклоняет всю эту команду; части списка — отдельные команды. При изменении только состава атрибутов Update CNS не требуется.
Ключ: Класс|Имя ограничения
CNS.AttrВключение атрибута в ограничение
Добавляет включение нового Attribute, меняет позицию существующего либо снимает отсутствующее в списке из источника. Использует процедуры Паруса, которые могут сдвигать позиции соседей. Delete CNS.Attr не удаляет CLS.Attr и не снимает физический UNIQUE или CHECK таблицы.
Ключ: Класс|Имя ограничения|Атрибут
CNS.AttrPosПозиции атрибутов ограничения
Появляется, если построен хотя бы один Create / Update CNS.Attr, и ждёт все команды списка. В БД задаёт позиции из полного списка источника прямой правкой после процедур. При заполненных позициях всех элементов сначала освобождает их места во временном диапазоне; если есть null, пишет только заданные позиции без этого общего сдвига. Это не гарантия успешной раскладки неполного списка.
Ключ: Класс|Имя ограничения
При переносе в БД удаление целого CNS по отсутствию в источнике не формируется. В Git команды меняют сохраняемое описание; вызовы процедур относятся к приёмнику БД. S3 и «Файл пакета» создают новый ZIP. CNS.Attr и CNS.AttrPos не являются отдельными объектами каталога и не получают собственных файлов.
Пример: убрать атрибут из правила
В приёмнике ограничение содержит NUM (1), GRP (2), а в источнике оставлен только NUM (1). Реквизиты CNS совпадают.
Появится Delete CNS.Attr · Request|UDO_C_REQUEST_NUMGRP_UK|GRP. Корневого Update и SetOrder нет. Атрибут GRP самого класса останется. Физическое UNIQUE(NUM, GRP) таблицы тоже сохранится: если правило должно стать уникальностью одного NUM, отдельно измените ограничение таблицы и согласуйте его описание в КОР.
Ограничения и что с ними делать
Описание перенеслось, а правило не срабатывает
Запись типа «Проверка» с текстом NUM between 1 and 100 сама не создаёт CHECK. В прежнем исследовании на Oracle и PostgreSQL / Парус 27.08.2026 запись с условием только в CNS не мешала сохранить нарушающие его данные. Именованная физическая проверка таблицы, напротив, вызывала сообщение CNS.
Для UNIQUE и CHECK сверяйте имя физического ограничения с ConstraintName. Для неизменяемости нужна реализация триггером; показанный текст определяется триггером, а не автоматически MessageCode типа 6. Перенесите нужные части таблицы и её реализацию по правилам своей СУБД.
Смена имени не заменяет прежнее ограничение
Замена UDO_C_REQUEST_NUMGRP_UK на UDO_C_REQUEST_CODE_UK описывает другой CNS. Старое описание в БД останется, и ссылки на него сами не переключатся. Имя ограничения уникально во всём обследованном Парусе: перенос в другой класс с прежним именем тоже может получить отказ.
Согласуйте имя и использующие его связи отдельно. Внутри AttributeConstrains другие правила: смена Attribute в полном списке удаляет старое включение и создаёт новое.
Инициализация блокирует Update
Holkas разрешает задать ConstraintInit при создании, но запрещает менять его в существующем CNS. Если вместе с ним меняется наименование, откажет вся корневая Update: новое наименование тоже не запишется. Части списка могут применяться отдельно, поэтому отказ корня не означает неизменность всех включений.
Разница только в записи текста — null и пустая строка, CRLF и LF — отказа не вызывает: Update записывает остальные реквизиты и оставляет текст приёмника побайтно прежним. Очистка непустого текста — тоже смена: файл без поля, с null или пустой строкой против непустого текста приёмника получит тот же отказ. Настоящую смену инициализации подготовьте отдельно средствами КОР.
Существующая связь переключается на новый CNS
И создание, и изменение LNK ждут создания CNS из SrcConstraint, если ограничение переносится тем же планом. Порядок выбора объектов на это не влияет. Если создание ограничения снято или отказало, связь не переключается.
Допустима ли новая ссылка, по-прежнему проверяет Парус: ограничение должно принадлежать классу-источнику связи.
Признак разрешения ссылок передаётся другому ограничению
Если у ограничения пары «Номер, Группа» стоит LinksSign=1, другое ограничение этого класса не может одновременно получить 1. Holkas передаёт Парусу режим без автоматического снятия признака с соседа.
При передаче старое: 1 → 0, новое: 0 → 1 Holkas сначала выполняет Update прежнего владельца, затем Create или Update нового — за один перенос, в каком бы порядке ограничения ни шли в наборе. Прежний владелец теряет признак и тогда, когда перестаёт быть уникальностью: Парус считает владельцем только ограничение типа 0.
Оба ограничения должны входить в перенос. Если прежний владелец остался вне набора, Парус откажет: перенесите его вместе с новым.
Ограничения меняются наименованиями
ConstraintNote уникально среди ограничений класса (C_DMSCLCONSTRS_NOTE_UK): Парус не даёт занять наименование, пока его держит другое ограничение.
Цепочка — например, A: «Z1» → «Z2», B: «Z2» → «Z3». Holkas упорядочивает команды сам: сначала B освобождает «Z2», потом его получает A. Новый объект, которому нужно освобождаемое наименование, тоже ждёт. Всё проходит за один перенос, в каком бы порядке объекты ни шли в наборе.
Обмен по кругу — например, A: «Первое» → «Второе», B: «Второе» → «Первое». Без временного наименования его не выполнить, а промежуточные значения Holkas не записывает. План в базу Паруса называет такие ограничения в предупреждении и оставляет им наименования приёмника; остальные их правки переносятся. В Git и файл обмен записывается как есть. Поменяйте наименования в приёмнике вручную или в три переноса: дайте в источнике одному объекту свободное временное наименование, перенесите, затем верните нужные наименования и перенесите снова.
Оба объекта должны входить в перенос. Если наименование держит объект вне набора или тот, что его не меняет, команда получает отказ «Значение уже занято другой записью приёмника…» с именем ограничения.
Проверено на PostgreSQL и Oracle.
Рёбра команд ограничения
Что такое ребро и где оно видно в Holkas →
Рёбра помогают Holkas правильно отсортировать команды перед применением. Ребро связывает две команды и указывает, какая должна выполниться раньше. Например, новое сообщение нужно создать до записи ссылающегося на него ограничения.
Create MSGCreate / Update CNSКаталог охватывает собственные команды CNS, прямого потребителя LNK и общие правила скриптов. Это 11 правил, а не число рёбер каждого плана. Зависимости существующих записей не требуют выдуманных команд Create. Сохранённых Oracle-зависимостей и отдельного общего ребра к физическому ограничению таблицы у CNS нет.
Собственные команды8 правил
Create CLS→Create CNSКогда: Создаётся новое ограничение класса UnitCode.
Сначала должен существовать класс. Update CNS этим правилом не ждёт Update CLS.
Create MSG→Create / Update CNSКогда: В MessageCode задан код сообщения.
Подготовить сообщение перед записью ссылки. Ребро не требует выполнения Update существующего MSG.
Create CNS→Create CNS.AttrКогда: В ограничение добавляется Attribute.
Сначала зарегистрировать само ограничение. Его Update включения не ждут.
Create CLS.Attr→Create / Update CNS.AttrКогда: Attribute называет атрибут того же UnitCode.
Подготовить атрибут класса перед его включением в ограничение.
Delete CNS.Attr→Delete CLS.AttrКогда: Убирается включение Attribute, сам атрибут удаляется из выбранного класса.
Сначала снять участие в ограничении. Если включение оставлено в списке из источника, это ребро его не удалит.
Update CNS→Create / Update CNSКогда: Команда ставит LinksSign=1, а другое ограничение того же UnitCode держит признак в приёмнике (уникальность с LinksSign=1) и в переносе его теряет.
Сначала снять признак у прежнего владельца: Парус допускает его только у одного ограничения уникальности класса. Если владелец не меняется, ребра нет.
Update CNS, отдающий ConstraintNote→Create / Update CNS, занимающий ConstraintNoteКогда: CNS получает непустое ConstraintNote, которое в приёмнике держит другое ограничение того же класса, и в этом же переносе своё ConstraintNote меняет. Оба объекта входят в набор. Для обмена по кругу ребро не ставится.
Сначала освободить наименование, потом занять: C_DMSCLCONSTRS_NOTE_UK не допускает двух одинаковых, и цепочка переименований проходит за один перенос в любом порядке набора. Если наименование держит объект вне набора или тот, что его не меняет, Парус откажет «Значение уже занято».
Create / Update / Delete CNS.Attr→SetOrder CNS.AttrPosКогда: Есть хотя бы один Create или Update включения; ребро от каждой команды его списка.
Закрепить позиции после всех правок. При одних удалениях SetOrder не создаётся.
Связь, использующая ограничение1 правило
Create CNS→Create / Update LNKКогда: У новой связи заполнен SrcConstraint, а у существующей меняется SrcConstraint или класс-источник; адрес CNS — SourceCode|SrcConstraint.
Подготовить ограничение исходного класса связи до записи связи.
Скрипты автора2 правила
SCR Before→CNS / CNS.Attr / CNS.AttrPosКогда: Приёмник исполняет скрипты; область — это ограничение, его класс или весь перенос.
Выполнить скрипт до охватываемых команд. Скрипт без команд в своей области в плане не остаётся.
CNS / CNS.Attr / CNS.AttrPos→SCR AfterКогда: Та же область, время After.
Выполнить скрипт после команд ограничения; это не ConstraintInit.
Правило без удаления самого объекта1 правило
Delete CNS.Attr→Delete CNSКогда: Удаляется включение атрибута.
Ребро описывает порядок на случай удаления целого CNS, но обычный перенос не формирует Delete целого CNS. Такое ребро не означает, что ограничение будет удалено.
Пример: существующая связь переходит на новое ограничение источника
Create CNS · Clients|CLIENTS_CODE_UKUpdate LNK · Request|OwnerLinkВ источнике связь Request|OwnerLink ссылается на новое ограничение CLIENTS_CODE_UK класса Clients. Изменение связи ждёт создания корня CNS по адресу SourceCode|SrcConstraint. Если меняется класс-источник, адрес меняется вместе с ним, и связь ждёт ограничение нового источника.
Порядок не зависит от того, в какой последовательности объекты выбраны в наборе. Если создание снято с плана или завершилось ошибкой, изменение связи тоже не выполняется, и связь остаётся с прежней ссылкой. Ожидание касается корня CNS, а не каждого его атрибута.
Как ограничение хранится в файлах
Для примера Request|UDO_C_REQUEST_NUMGRP_UK Git вкладывает CNS в файл класса, а S3 и «Файл пакета» пишут одинаковый отдельный JSON. В каждом случае список атрибутов остаётся внутри самого ограничения.
Git
YAMLClass/Request.yamlВ списке Constraints — реквизиты CNS и AttributeConstrains. Имена с заглавной буквы: ConstraintName, Attribute, Position.
S3
JSON в ZIPConstraint/Request%7CUDO_C_REQUEST_NUMGRP_UK.jsonОтдельный файл CNS, устроенный так же, как у «Файла пакета»: реквизиты и attributeConstrains. В manifest.json ограничение указано собственным типом и полным именем.
Файл пакета
JSON в ZIPConstraint/Request%7CUDO_C_REQUEST_NUMGRP_UK.jsonОтдельный файл CNS: реквизиты и attributeConstrains. В manifest.json ограничение указано собственным типом и полным именем.
ZIP из S3 и «Файла пакета» устроены одинаково, архив одного способа загружается другим. ZIP, записанные в S3 версией Holkas 0.1.30 или более ранней, хранили ограничение в списке constraints внутри Class/Request.json; такие архивы по-прежнему читаются обоими способами.
При выгрузке выбранного класса целиком файл Git собирается из его выгружаемого семейства заново: отсутствующее CNS может исчезнуть из файла. Это не команда Delete CNS для базы при последующей загрузке. Новый ZIP также содержит только выгружаемый состав.
В оглавлении ZIP запись имеет вид {"typeCode":"CNS","name":"Request|UDO_C_REQUEST_NUMGRP_UK"}. MSG с текстом сохраняется отдельно, если включён в выгрузку. При записи Holkas опускает null-поля, а нули, пустой текст и пустые списки сохраняет.
Пример одного ограничения в YAML и JSON
Сокращённые учебные фрагменты с двумя включениями. Это иллюстрация расположения данных, не готовые файлы для загрузки. Класс, атрибуты, сообщение и остальные сведения экспорта не показаны.
Git — внутри Class/Request.yaml:
UnitCode: Request
Constraints:
- UnitCode: Request
ConstraintName: UDO_C_REQUEST_NUMGRP_UK
ConstraintNote: Номер уникален в группе
ConstraintType: 0
MessageCode: REQUEST_NUMGRP_UK
ConstraintInit: ''
LinksSign: 1
AttributeConstrains:
- Attribute: NUM
Position: 1
- Attribute: GRP
Position: 2
S3 или «Файл пакета» — Constraint/Request%7CUDO_C_REQUEST_NUMGRP_UK.json:
{
"unitCode": "Request",
"constraintName": "UDO_C_REQUEST_NUMGRP_UK",
"constraintNote": "Номер уникален в группе",
"constraintType": 0,
"messageCode": "REQUEST_NUMGRP_UK",
"constraintInit": "",
"linksSign": 1,
"attributeConstrains": [
{ "attribute": "NUM", "position": 1 },
{ "attribute": "GRP", "position": 2 }
]
}
Не заменяйте AttributeConstrains сокращённым списком: отсутствующие включения получат Delete CNS.Attr. Пустой список [] — реальное снятие всех включений.
Практические шаги: сохранить в Git, выгрузить и загрузить файл пакета. Оглавление ZIP — в справке о формате пакета.
Основа: руководство КОР Парус 8, издание 2026, с. 82–84 и 112; прежнее исследование ограничений на Oracle и PostgreSQL / Парус 27.08.2026 с Holkas 0.1.26; текущие DTO, читатели, построители, исполнители и файловые адаптеры Holkas 0.1.30. Сверено 8 ноября 2026; хранение в ZIP уточнено по коду 9 ноября 2026. Процедуры и ограничения PostgreSQL 14 / Парус 27.08.2026 прочитаны без записи. Локальные пробы плана, проверки исполнителя и файлов не являются переносом БД. Новый перенос и проверка клиентов Паруса не выполнялись. Имена и схемы учебные.