Парус 8 · Конструктор отраслевых расширений
Домен задаёт общее описание значения для атрибутов и параметров: например, строковый статус со списком «Новый», «В работе», «Готово».
DOM + CodeДомен в КОР
Домен — именованное описание типа значения. Он помогает одинаково описывать атрибуты классов и параметры: задаёт тип и подтип, длину строки или формат числа, значение по умолчанию. Перечисляемый домен дополнительно задаёт допустимые значения и их порядок в списке выбора.
В учебном домене RequestStatus наименование элемента «Новый» может соответствовать хранимой строке NEW, а позиция 1 ставит его первым в списке. Эти три свойства не взаимозаменяемы: Holkas узнаёт элемент по наименованию, переносит строку NEW как значение, а позицию устанавливает отдельно.
DOM описывает домен Паруса на Oracle или PostgreSQL. Он не создаёт самостоятельный SQL-объект CREATE DOMAIN, не переносит записи прикладного раздела и не переписывает сохранённые в них статусы. Использование домена атрибутом относится к описанию класса, а использование параметром — к соответствующему методу, действию или другому объекту.
Что входит в перенос
Перенос домена не переносит использующие его атрибуты и параметры. Например, если атрибут «Статус» использует этот домен, выбор домена не добавит в перенос сам атрибут или его класс. Чтобы перенести и атрибут, включите в состав переноса его класс.
Справочник полей
20 полей · 2 группыВсе поля модели переноса: 14 реквизитов домена, список значений и 5 полей каждого элемента. Техническое имя совпадает с именем в Git YAML; рядом указано имя в JSON для S3 и «Файла пакета».
Как читать обозначения и правила
Наведите указатель на значок, перейдите к нему клавишей Tab или нажмите его — появится пояснение.
Ключ определяет, какой объект или элемент Holkas сопоставляет в источнике и приёмнике. Сравнивается означает, что разница учитывается в плане. По элементам — список проверяется по составу и свойствам записей.
При создании задаются настройки нового объекта. При изменении существующего домена Update DOM передаёт весь набор его реквизитов, а Update DOM.Val — поля соответствующего элемента. Допустимость значений проверяет Парус: наличие поля в модели не гарантирует, что приёмник разрешит его изменить.
Реквизиты домена · DOM15 полей
CodeJSON: codeстрокаКлючКод домена- Назначение
- Мнемокод, по которому Holkas находит домен, например RequestStatus. Префикс схемы не нужен; регистр кода сохраняется.
- При переносе:
- Если заменить код, Holkas сопоставит описание с другим доменом. Если нового кода в приёмнике нет, создаст новый домен; прежний автоматически не удалится.
NameJSON: nameстрока / nullСравниваетсяНаименование- Назначение
- Название домена для человека. Оно отличается от кода, которым домен адресуется.
- При переносе:
- Изменение названия даёт Update DOM. При записи в Парус передаётся новое название; домен с тем же Code остаётся тем же объектом.
CrnNameJSON: crnNameстрокаСравниваетсяПапка каталога- Назначение
- Имя папки словаря «Домены», в которой лежит домен, например «3. Прикладные». Это имя самой папки; путь к ней хранится в CrnPath.
- При переносе:
- Holkas находит папку по имени: в одном разделе Паруса (для организации и версии) двух одноимённых папок не бывает. Если папки с таким именем в приёмнике нет, создаёт недостающие папки по пути CrnPath. При изменении папки перемещает домен в неё. Подготовка папок входит в команду домена и отдельной строкой в плане не показывается. Строка «Решение/Статусы» в CrnName — одно имя, а не путь.
CrnPathJSON: crnPathсписок строк / nullСравниваетсяПуть каталога- Назначение
- Имена папок от первого уровня под корнем словаря «Домены» до папки домена включительно, например «Решение», «Статусы»; последний элемент равен CrnName. Сам корень в путь не входит: у каждой организации и версии он свой, и в приёмнике берётся его корень.
[]— домен лежит прямо в корне; отсутствие поля — путь неизвестен (файл записан прежней версией Holkas). - При переносе:
- В базе Паруса сравнивается только имя папки: если папка с именем CrnName в приёмнике уже есть, домен ляжет в неё, где бы она ни находилась, а сама папка не переместится. Если такой папки нет, Holkas проходит путь: имеющиеся уровни использует, недостающие создаёт под предыдущим. В Git, S3 и «Файле пакета» сравнивается весь путь, и его изменение даёт Update DOM. В плане путь показан как «Решение / Статусы», пустой — «(корень)». Если последний элемент пути не совпадает с CrnName, план отклоняется до применения.
DataTypeJSON: dataTypeцелое / nullСравниваетсяТип данных- Назначение
- Код основного типа: 0 — строка, 1 — число, 2 — дата, 3 — время, 4 — двоичные данные, 5 — длинный текст.
- При переносе:
- Разница даёт Update DOM. Holkas передаёт тип процедуре Паруса; допустимость изменения и сочетания с остальными настройками проверяет Парус. Отдельный SQL-тип CREATE DOMAIN не создаётся.
DataSubTypeJSON: dataSubTypeцелое / nullСравниваетсяПодтип данных- Назначение
- Уточняет тип: например, для числа 0 — стандартный, 1 — логический, 2 — год, 3 — с плавающей точкой. Все пары приведены ниже.
- При переносе:
- Передаётся вместе с типом в Create / Update DOM. Holkas не подбирает замену для старого релиза Паруса, в котором такого подтипа ещё нет.
DataLengthJSON: dataLengthцелое / nullСравниваетсяДлина строки- Назначение
- Размер строкового домена. У обычной строки — до 4000 знаков; для URL в исследованном Парусе используется 4000.
- При переносе:
- Изменение даёт Update DOM и передаёт новый размер в Парус. Это настройка домена, а не отдельная команда изменения физической колонки таблицы.
DataPrecisionJSON: dataPrecisionцелое / nullСравниваетсяОбщее число знаков- Назначение
- Общее число цифр числового значения, без десятичного разделителя. Для логического подтипа — 1, для года — 4.
- При переносе:
- Передаётся в Create / Update DOM вместе с DataScale. Допустимый диапазон зависит от релиза Паруса; в исследованном релизе 27.08.2026 база допускает 1–29, окно Windows — до 17.
DataScaleJSON: dataScaleцелое / nullСравниваетсяЧисло знаков после запятой- Назначение
- Дробная часть формата числа. Для логического значения и года — 0; в исследованном релизе для обычного числа и числа с плавающей точкой — 0–17.
- При переносе:
- Изменение даёт Update DOM. Парус проверяет сочетание точности, дробности и значения по умолчанию; Holkas не округляет значение под новый формат.
DefaultStrJSON: defaultStrстрока / nullСравниваетсяСтроковое значение по умолчанию- Назначение
- Начальное значение для строки или URL, если пользователь не задал другое значение при работе с формой.
- При переносе:
- Записывается через Create / Update DOM. null передаётся как отсутствие значения, а не как просьба сохранить прежнее. При сравнении null и пустая строка считаются равными.
DefaultNumJSON: defaultNumдесятичное / nullСравниваетсяЧисловое значение по умолчанию- Назначение
- Число, логическое значение, год или время. Для логического: 1 — да, 0 — нет, null — не задано. Время хранится долей суток: 12:00 — 0.5.
- При переносе:
- Передаётся как десятичное число, без преобразования времени в секунды. Ноль — заданное значение, он отличается от null. Изменение даёт Update DOM; null сбрасывает значение по умолчанию.
DefaultDateJSON: defaultDateдата и время / nullСравниваетсяДата по умолчанию- Назначение
- Дата с возможной часовой частью для DataType = 2. В JSON — строка ISO, например 2026-11-08T09:30:00, без часового пояса.
- При переносе:
- Create / Update DOM передаёт дату в Парус; null — отсутствие значения. Часовая часть участвует в сравнении. Подтип определяет, как дату показывает клиент.
EnumeratedJSON: enumeratedцелое / nullСравниваетсяИмеет перечисляемые значения- Назначение
- 1 включает список допустимых значений, 0 выключает. При чтении из базы Holkas загружает элементы только при значении 1.
- При переносе:
- Изменение даёт Update DOM. Для перехода 1 → 0 сначала выполняются удаления значений. Сам список передаётся отдельно в EnumeratedValues; при отключении он должен быть пустым.
PaddingJSON: paddingцелое / nullСравниваетсяВыравнивать по длине- Назначение
- Признак выравнивания строкового поля по длине домена: 1 — включён, 0 — выключен. Настройка участвует в автоматическом построении колонок и контролов формы.
- При переносе:
- Передаётся в Create / Update DOM. В исследованном клиенте доступен для простой строки. Перенос признака не перестраивает существующие формы отдельной командой.
EnumeratedValuesJSON: enumeratedValuesсписокПо элементамПеречисляемые значения- Назначение
- Принадлежащий домену список наименований, хранимых значений и позиций. В Git, S3 и «Файле пакета» вложен в описание домена.
- При переносе:
- Элементы сопоставляются по Name: новые добавляются, изменённые обновляются, отсутствующие в источнике удаляются из выбранного домена. [] означает пустой список, а не пропуск переноса. После любой правки списка строится DOM.ValPos.
Значения перечисления · DOM.Val5 полей
NameJSON: nameстрокаКлючНаименование значения- Назначение
- Название элемента в списке выбора, например «Новый». Это ключ элемента внутри домена; хранимое значение задаётся отдельно.
- При переносе:
- Смена имени означает удаление прежнего элемента и создание нового, если прежнее имя убрано из источника, а нового ещё нет в приёмнике. Простого переименования через Update DOM.Val нет.
PositionJSON: positionстрока с числомСравниваетсяПозиция в списке- Назначение
- Место элемента в списке выбора. В JSON записывается строкой, например "2". При чтении из БД Holkas убирает ведущие пробелы служебного выравнивания.
- При переносе:
- Разница даёт Update DOM.Val и SetOrder DOM.ValPos. Create DOM.Val добавляет элемент в конец, Update оставляет текущую позицию; итоговые места задаёт только DOM.ValPos. Если у элемента позиция пустая, равна null, отсутствует или не является числом, план в БД отклоняется до применения с названием домена и элемента.
ValueStrJSON: valueStrстрока / nullСравниваетсяСтроковое значение элемента- Назначение
- Значение, соответствующее названию элемента строкового домена: например, у «Новый» — NEW.
- При переносе:
- Изменение при прежнем Name даёт Update DOM.Val. В Парус передаётся строка; null и пустая строка равны при сравнении. Одинаковые хранимые значения разных элементов могут нарушить уникальность.
ValueNumJSON: valueNumдесятичное / nullСравниваетсяЧисловое значение элемента- Назначение
- Значение числового домена или времени; время, как и DefaultNum, задаётся долей суток. Допускается дробное число, это не только целый код.
- При переносе:
- Передаётся в Create / Update DOM.Val. 0 отличается от null. Обмен значениями двух существующих элементов может быть отклонён из-за уникальности; перестановка позиций решается отдельно.
ValueDateJSON: valueDateдата и время / nullСравниваетсяДата элемента- Назначение
- Значение элемента домена даты. Используется с DataType = 2; запись в JSON такая же, как у DefaultDate.
- При переносе:
- Передаётся в Create / Update DOM.Val вместе с остальными полями элемента. Сравнение учитывает и время. Holkas не превращает его в числовое время для DataType = 3.
Команды плана
У домена три кода команд. Create — создание, Update — изменение, Delete — удаление, SetOrder — установка позиций. Наведите указатель на пиктограмму действия, перейдите к ней клавишей Tab или нажмите её, чтобы прочитать подпись.
DOMРеквизиты домена
Создаёт домен, которого нет в приёмнике, либо обновляет изменившиеся настройки существующего: название, папку, тип, формат, умолчания и признаки. При записи в БД используются процедуры Паруса; недостающие папки пути создаются, а при изменении папки домен перемещается. Разница только в списке значений не требует Update DOM.
Ключ: Код домена
DOM.ValЗначение перечисления
Добавляет элемент с новым Name, меняет поля элемента с прежним Name или удаляет отсутствующий в списке источника. При создании в БД элемент временно добавляется в конец; Update сохраняет текущую позицию. Удаление может сдвинуть оставшиеся элементы. Итоговые места задаёт DOM.ValPos.
Ключ: Код домена|Наименование значения
DOM.ValPosПозиции значений
Появляется после любой команды DOM.Val, даже если изменилось только хранимое значение или единственная правка — удаление. Ждёт все команды значений этого домена. В БД закрепляет позиции из списка источника; для пустого списка запись позиций не нужна. Неполную раскладку не выполняет: такой план отклоняется ещё при построении.
Ключ: Код домена
Удаление целого домена по отсутствию в наборе не формируется. Самостоятельных объектов DOM.Val в каталоге и файлов DOM.ValPos в экспорте нет. В Git команды изменяют сохраняемое описание; вызовы процедур Паруса относятся к приёмнику БД. Выгрузка в S3 или «Файл пакета» создаёт новый ZIP.
Пример: удалить значение из середины
В приёмнике: Новый (1) → В работе (2) → Готово (3). В источнике: Новый (1) → Готово (2). Настройки домена и хранимые строки оставшихся элементов совпадают.
Delete DOM.Val · RequestStatus|В работеснимает отсутствующий элемент.Update DOM.Val · RequestStatus|Готововозникает из-за изменения Position с «3» на «2».SetOrder DOM.ValPos · RequestStatusзакрепляет позиции: «Новый» — 1, «Готово» — 2.
«Готово» остаётся тем же элементом, потому что Name не изменилось. Перестановка записей в JSON без изменения Position такого плана не даст.
Ограничения и что с ними делать
Переименование и границы удаления
Новый Code описывает другой домен: старый не удаляется и ссылки на него автоматически не меняются. Перенастройте использующие его атрибуты и параметры отдельно. Внутри выбранного домена смена Name у элемента, напротив, означает удаление прежнего и создание нового.
Не заменяйте полный список значений сокращённым примером: отсутствующие элементы могут попасть в Delete DOM.Val. Удаление значения перечисления не преобразует уже сохранённые прикладные данные.
Отключение перечисления
При переходе Enumerated: 1 → 0 и пустом списке источника Holkas сначала удаляет значения, затем обновляет домен. Для этого достаточно одной операции.
Не оставляйте непустой EnumeratedValues при выключенном признаке. При чтении домена из базы значения не загружаются, если Enumerated не равен 1; отключение признака и состав списка должны описывать одно состояние.
Перестановка позиций, цепочки и кольца значений
Переставить элементы в списке позволяет DOM.ValPos. Смена хранимых значений при прежних именах упирается в уникальность значения в Парусе: занять число можно только после того, как его освободит соседний элемент.
Цепочку — например, A: 1 → 2, B: 2 → 3, C: 3 → 4 — Holkas упорядочивает сам: сначала C, потом B, потом A, и всё проходит за один перенос. Кольцо — например, A: 1 → 2 и B: 2 → 1 — без временного значения не выполнить, а выдуманные промежуточные значения Holkas не записывает. План называет такие элементы в предупреждении и не отправляет по ним команд; остальные правки домена переносятся. Поменяйте значения кольца в приёмнике вручную.
Если число держит элемент, который в этом переносе его не освобождает (например, его удаление не входит в план), команда получает отказ «не лечится» с объяснением, что значение уже занято.
Пустая или неверная позиция в файле
Если у хотя бы одного элемента Position пустая, состоит из пробелов, равна null, отсутствует или не является числом, Holkas отклоняет план в БД до применения. В сообщении названы домен и элементы без позиции; в приёмнике ничего не меняется. Такая запись не означает «сохранить старое место».
Возьмите полный экспорт и задайте всем элементам допустимые, различные позиции числовыми строками, затем постройте план заново. Сверьте порядок именно по Position. Запись в Git такую раскладку не проверяет: репозиторий хранит файл как есть.
Нужно сохранить дерево папок
Holkas сохраняет и имя папки домена, и путь к ней. Для домена из «Домены → Решение → Статусы» в файл попадут CrnName «Статусы» и CrnPath «Решение», «Статусы». Корень «Домены» в путь не входит: в приёмнике используется корень его организации и версии.
Если в приёмнике нет папки «Статусы», Holkas создаёт недостающие уровни: найденную по имени «Решение» использует как есть, а «Статусы» создаёт под ней; если нет и «Решение», создаёт обе. Отдельных строк плана для папок нет — это часть команды DOM.
Имя папки в разделе Паруса уникально, поэтому уже существующая в приёмнике папка «Статусы» используется там, где лежит, даже под другим родителем. Holkas её не перемещает: вместе с ней уехали бы чужие объекты приёмника. Если домен в приёмнике уже есть, план показывает у него замечание «Папка с тем же именем в приёмнике лежит в другом месте дерева; объект ляжет в неё, папка не перемещается: …». Нужное расположение такой папки задайте в Парусе вручную.
Файл, записанный прежней версией Holkas, пути не содержит. Если имя папки совпадает с приёмником, путь берётся у приёмника и команд не возникает. Иначе папка ищется по имени, а отсутствующая создаётся под корнем, о чём план предупреждает: «В источнике не указан путь папки каталога (описание старой версии)…». Чтобы перенести вложенность, выгрузите домен из источника заново. В Git, S3 и «Файле пакета» старое описание без пути получит Update DOM, который допишет путь.
Парус не разрешает настройки или изменение записи
Тип, подтип, формат и значения проверяются процедурами и ограничениями Паруса. Holkas передаёт их без автоматической замены на «ближайший» вариант. Например, в обследованной линейке PostgreSQL подтип числа 1/3 и точность до 29 появились в релизе 29.04.2025; более старый приёмник может их отвергнуть.
Штатная технология также может запрещать изменение или удаление записи. Наличие Update в плане не снимает запрет Паруса. Сохраните допустимые настройки приёмника либо подготовьте отдельный пользовательский домен и его использование. Сверяйтесь с совместимостью релизов.
Изменение домена не является обещанием преобразовать физические колонки или перестроить существующие формы. Если меняется смысл типа, отдельно проверьте использующие его атрибуты, параметры и данные.
Рёбра команд домена
Что такое ребро и где оно видно в Holkas →
Рёбра помогают Holkas правильно отсортировать команды перед применением. Ребро связывает две команды и указывает, какая должна выполниться раньше. Например, для нового перечисляемого домена сначала нужно создать его описание, затем — значения.
Create DOMCreate DOM.ValКаталог охватывает команды домена, непосредственно использующие его части других объектов и общие правила скриптов. Здесь 13 правил, из них два относятся к удалению целого домена и сейчас не дают исполняемых рёбер: Delete DOM не строится. Число рёбер конкретного плана зависит от числа команд.
Внутри домена3 правил
Create DOM→Create DOM.ValКогда: Добавляется значение того же домена; обе команды есть в плане.
Значение создаётся после домена.
Delete DOM.Val→Update DOMКогда: Enumerated меняется с 1 на 0; ребро от каждого удаляемого значения этого домена.
Парус разрешает отключить перечисление только после удаления его значений.
Create / Update / Delete DOM.Val→SetOrder DOM.ValPosКогда: Есть хотя бы одна команда значения; ребро от каждой такой команды данного домена.
Установить итоговые позиции после всех правок, в том числе после одних удалений.
Объекты, использующие домен7 правил
Create DOM→Create / Update CLS.AttrКогда: Domain у атрибута класса задан и называет этот домен.
Подготовить тип значения атрибута.
Create DOM→Create / Update MET.ParamКогда: Domain у параметра метода задан и называет этот домен.
Подготовить тип параметра метода.
Create DOM→Create / Update METКогда: Domain функции — домен её результата RESULT — называет этот домен.
Метод передаёт домен результата Парусу, и тот принимает только существующий.
Create DOM→Create / Update ACT.ParamКогда: Domain у параметра действия задан и называет этот домен.
Подготовить тип параметра действия.
Create DOM→Create / Update MEC.VarКогда: Domain у локальной переменной метода вызова задан.
Подготовить тип локальной переменной.
Create DOM→Create / Update VIW.ParamКогда: Domain у параметра представления класса задан.
Подготовить тип параметра представления.
Create DOM→Create / Update UAP.ParamКогда: DomainCode у параметра действия пользовательского приложения задан.
Подготовить тип параметра приложения.
Общие правила скриптов2 правил
SCR «до»→DOM / DOM.Val / DOM.ValPosКогда: Приёмник выполняет скрипты; скрипт относится к данному домену или всему переносу.
Выполнить скрипт до команд его объектов. Если этих команд нет, скрипт в план не попадает.
DOM / DOM.Val / DOM.ValPos→SCR «после»Когда: Та же область действия скрипта, время выполнения — After.
Выполнить скрипт после команд его объектов.
Рёбра для удаления домена2 правил
Delete DOM.Val→Delete DOMКогда: Значение удаляется; Delete DOM сейчас не формируется.
Ребро задаёт порядок: удаление части раньше удаления родителя; само удаление целого домена оно в план не добавляет.
Delete VIW.Param→Delete DOMКогда: Удаляется параметр представления с заданным Domain; Delete DOM сейчас не формируется.
Ребро задаёт порядок: сначала снять использование домена, затем удалять сам домен; команды удаления домена в плане нет.
Что означает отсутствие ребра или команды
Если домен уже есть в приёмнике, отдельная команда его создания не нужна. Ссылки атрибутов и параметров требуют существования домена, но не добавляют ожидания Update DOM или всех DOM.Val. Выбор DOM не включает обратным ходом все использующие его объекты.
Обычные зависимости влияют и на выбор команд, и на выполнение при отказе предшественника. Для нового домена снятие его создания затрагивает зависимые команды. Недостающий домен нужно включить в перенос или подготовить в приёмнике; подробнее — разбор недостающих зависимостей.
Внутри списка Holkas строит удаления перед изменениями и созданием; удаления перебираются с конца текущего списка. Это исходная очередность команд, а не дополнительные рёбра между каждой парой. При сортировке она разрешает выбор между уже готовыми к выполнению командами. У домена нет отдельного ребра на папку каталога и нет собственных зависимостей на физические объекты Oracle.
Как домен хранится в файлах
Начните с каталога Domain/. Для учебного кода RequestStatus ниже показаны пути и устройство каждого способа выгрузки. Во всех трёх случаях значения находятся внутри файла домена; отдельного файла на каждый элемент нет.
Git
YAMLDomain/RequestStatus.yamlРеквизиты и список EnumeratedValues в одном файле. Имена полей: Code, Name, Position.
.holkas со сведениями о нём.S3
JSON в ZIPDomain/RequestStatus.jsonВнутри ZIP — реквизиты и список enumeratedValues в одном JSON. Имена начинаются с маленькой буквы.
manifest.json и загружает указанный файл домена. ZIP хранится в S3.Файл пакета
JSON в ZIPDomain/RequestStatus.jsonСкачиваемый ZIP содержит такой же файл домена с вложенным enumeratedValues. В оглавлении домен указан один раз.
manifest.json и читает описание домена вместе с элементами.Для DOM S3 и «Файл пакета» хранят данные одинаково: в JSON внутри ZIP. Это утверждение о домене, а не об одинаковой раскладке всех типов объектов в ZIP. Использующие домен классы, методы и другие объекты сохраняются по собственным правилам, если включены в выгрузку.
В manifest.json домен обозначен как {"typeCode":"DOM","name":"RequestStatus"}. Манифест также содержит версию формата, СУБД и сведения об экспорте; его устройство описано в справке о пакете. В именах файлов небезопасные символы кодируются: например, / превращается в %2F; содержимое Code от этого не меняется. Не переименовывайте файл отдельно от адреса объекта.
Одни и те же поля в YAML и JSON
Сокращённые учебные фрагменты: код домена и один элемент списка. Остальные поля опущены. Это иллюстрация устройства, не готовые файлы для загрузки.
Git — Domain/RequestStatus.yaml
Code: RequestStatus
EnumeratedValues:
- Position: '1'
Name: Новый
ValueStr: NEW
S3 и «Файл пакета» — Domain/RequestStatus.json
{
"code": "RequestStatus",
"enumeratedValues": [
{
"position": "1",
"name": "Новый",
"valueStr": "NEW"
}
]
}
Сохраните полный список при ручной правке. [] — настоящее пустое перечисление, а не обозначение пропущенных в примере элементов. При выгрузке поля с null опускаются; нули и пустые списки сохраняются.
Практические шаги: сохранить доработку в Git, выгрузить и загрузить файл пакета.
Основа справки: руководство «ПАРУС-Бюджет 8. Конструктор отраслевых расширений», издание 2026, гл. 1, с. 7–9; сохранённое исследование регистрации и переноса доменов на Oracle / Парус 27.08.2026; модель, читатели, писатели и команды Holkas 0.1.30. Сверено 9 ноября 2026. RequestStatus и схемы — учебные примеры. Новый перенос в БД при подготовке страницы не выполнялся.