Парус 8 · Конструктор отраслевых расширений
Класс связывает данные раздела с тем, как человек их видит и обрабатывает: от атрибута «Мнемокод» до действия «Исправить» и формы на экране.
CLS + UnitCodeКласс в КОР
В Парусе класс описывает устройство раздела: какие данные есть у записи, как записи связаны между собой, какие действия над ними доступны и какими формами пользоваться. Например, у раздела «Заявки» есть номер и дата, связь с организацией, действия добавления и согласования, список и форма редактирования.
Класс и его экземпляры — разные вещи. Описание «Заявки» относится к метаданным, а конкретная заявка № 42 — к данным. Перенос CLS переносит описание. Документы и строки реализующей таблицы от этого в приёмнике не появляются.
Класс с хранимыми экземплярами связан с таблицей БД; одна таблица может обслуживать несколько классов. Абстрактный класс собственных экземпляров не имеет и служит для определения других классов. В КОР встречаются как штатные классы, так и классы, созданные средствами Конструктора. Возможность изменить конкретную настройку зависит в том числе от технологии класса и правил Паруса.
Что входит в перенос
Класс объединяет атрибуты, действия, методы, формы и другие части раздела. Дерево показывает их состав. У действия есть привязки к методам класса: один метод может использоваться в разных действиях.
CLSКлассCLS.AttrАтрибутыПоля записи, типы, домены и ссылкиACTДействияКоманды, доступные пользователюMETМетодыОперации класса и их реализацияCLS.VFВизуальные формыОписание экранов и обработчики событийMECМетоды вызоваОткрытие раздела и передача контекстаVIWПредставленияНаборы полей и настройки доступаLNKСвязиКлассы-источники и соответствие атрибутовCNSОграниченияПроверки и сообщения об ошибкахCLOОбъекты классаРеестр исходных текстов
Линии показывают состав. Ссылка «Используют методы класса» — связь между частями.
DOM, пиктограммы PIC, другие классы, приложения, физические таблицы и представления, процедуры и функции. Запись CLO хранит исходный текст в реестре; её перенос сам по себе не выполняет этот текст в БД.Справочник полей
61 поле · 7 группЗдесь перечислены все поля класса, его атрибутов и визуальных форм, представленные в модели переноса Holkas. Для самостоятельных частей семейства приведены ссылки на их страницы. В каждой карточке: техническое имя поля, его имя в JSON или Git YAML, назначение и поведение при переносе. Приёмник — база или файл, куда вы переносите настройки.
Как читать обозначения и правила
Наведите указатель на значок рядом с полем, нажмите его или перейдите к нему клавишей Tab — появится пояснение.
Ключ — поле, по которому Holkas находит соответствующий объект в приёмнике. Класс ищется по коду UnitCode, атрибут внутри класса — по имени ColumnName. Для формы нужны четыре поля вместе: FormClass, FormKind, ShowMethod и Form; каждое помечено как часть ключа.
Сравнивается — Holkas проверяет, отличается ли значение от приёмника. По элементам — отдельно проверяет состав списка и свойства каждой записи. Перестановка записей в JSON сама по себе не считается изменением: порядок задают специальные поля, например Position.
При переносе — что попадёт в план и что сделает команда. Create означает создание, Update — изменение, Delete — удаление, SetOrder — установку порядка. Для нового объекта значения задаются при создании; пояснение про Update относится к уже существующему объекту. Ограничения записи в базу Паруса отмечены отдельно: найденное различие не всегда можно применить.
При смене кода класса прежний класс сохраняется. При замене атрибута, формы или назначения в списке план может удалить прежний элемент и создать новый. В таких примерах предполагается, что прежний элемент убран из источника, а нового ещё нет в приёмнике.
Реквизиты класса CLS · 12
UnitCodeJSON: unitCodeстрокаКлючКод- Назначение
- Код класса, например Request. По нему Holkas находит соответствующий класс в другой базе. Внутренние номера записей RN в базах могут различаться.
- При переносе:
- Holkas находит класс по его коду. Если изменить код, план предложит создать класс с новым кодом, если его ещё нет в приёмнике. Существующий класс с прежним кодом сохранится.
UnitNameJSON: unitNameстрока / nullСравниваетсяНаименование- Назначение
- Название раздела для человека, например «Заявки».
- При переносе:
- Меняет наименование существующего класса (Update CLS). Код класса остаётся прежним, новый класс не создаётся.
UnitCodeParentJSON: unitCodeParentстрока / nullСравниваетсяКод родительского класса- Назначение
- Код родительского класса в структуре КОР. Пустое значение означает, что родителя нет. Это родитель класса, а не отдельной записи раздела.
- При переносе:
- Родитель задаётся при создании класса (Create CLS). Ограничение: Если изменить родителя существующего класса, Update CLS будет отклонён целиком — остальные настройки класса этой командой тоже не запишутся. Holkas сам класс не пересоздаёт.
TableNameJSON: tableNameстрока / nullСравниваетсяТаблица раздела- Назначение
- Имя таблицы, в которой хранятся записи раздела, например UDO_T_REQUEST. У класса без таблицы значение может быть null.
- При переносе:
- Записывает имя таблицы в настройки класса и обеспечивает её регистрацию в Парусе через команду CLS. Создание таблицы, её колонок и перенос строк данных выполняются отдельно.
AbstractJSON: abstractцелое / nullСравниваетсяАбстрактный- Назначение
- 1 — абстрактный класс: собственных записей у него нет, он служит основой для определения других классов. 0 — обычный класс.
- При переносе:
- Значение записывается при создании класса (Create CLS). Ограничение: Парус не позволяет изменить абстрактность у существующего класса, поэтому в базу Паруса Holkas его не переносит. План предупреждает о расхождении. Если других изменений у класса нет, команды для него не будет, и повторное сравнение покажет то же предупреждение. В Git и файлы значение записывается как в источнике.
SignBufferJSON: signBufferцелое / nullСравниваетсяБуферный- Назначение
- Отметка «Буферный» у класса в Парусе. Она относится к устройству раздела; на скорость или буферизацию переноса Holkas не влияет.
- При переносе:
- Передаёт значение признака при создании или обновлении класса (CLS).
SignDrivenJSON: signDrivenцелое / nullСравниваетсяВедомый- Назначение
- Отметка ведомого раздела. Ведущий раздел для него указывается отдельно в HostCode.
- При переносе:
- Меняет признак ведомого раздела (Update CLS). Код ведущего класса берётся из HostCode.
HostCodeJSON: hostCodeстрока / nullСравниваетсяВедущий раздел- Назначение
- Код ведущего класса для ведомого раздела. Связь с ведущим разделом и положение в дереве классов — отдельные настройки.
- При переносе:
- Меняет указание на ведущий класс (Update CLS). Если ведущий класс тоже создаётся или изменяется в плане, его команда выполняется раньше.
SysImageJSON: sysImageстрока / nullСравниваетсяПиктограмма- Назначение
- Код пиктограммы Паруса, используемой для класса. Сам рисунок хранится как отдельный объект PIC.
- При переносе:
- Меняет выбранную пиктограмму класса (Update CLS). Пиктограмма должна уже быть в приёмнике или переноситься вместе с классом.
GetProcedureJSON: getProcedureстрока / nullСравниваетсяПроцедура считывания значений атрибутов- Назначение
- Имя хранимой процедуры, которая считывает значения атрибутов класса.
- При переносе:
- Меняет только имя процедуры в настройках класса (Update CLS). Её исполняемый текст переносится отдельно; автоматической зависимости от процедуры для этого поля нет.
CustomTechnologyJSON: customTechnologyцелое / nullСравниваетсяКонструктор WIN- Назначение
- Отметка готовности раздела к работе в режиме «Конструктор» Windows-клиента Паруса.
- При переносе:
- Меняет эту отметку (Update CLS). Саму форму нужно перенести и проверить отдельно: включённый признак ещё не означает, что экран работает.
CustomTechnologyWebJSON: customTechnologyWebцелое / nullСравниваетсяКонструктор WEB- Назначение
- Отдельная отметка готовности раздела к работе в режиме «Конструктор» web-клиента Паруса.
- При переносе:
- Меняет отметку для web-клиента (Update CLS). Настройка Windows-клиента и работоспособность web-формы проверяются отдельно.
Деление и возможности раздела CLS · 7
SharingJSON: sharingцелое / nullСравниваетсяДеление по версиям / организациям- Назначение
- Вместе с AccReg задаёт деление данных раздела: Sharing = 0 и AccReg = 0 — без деления; 1 и 0 — по версиям; 1 и 1 — по организациям. Нужны также связи с классом «Версии» или «Организации».
- При переносе:
- Выбранный способ деления записывается при создании класса (Create CLS). Ограничение: Парус не позволяет изменить способ деления у существующего класса, поэтому в базу Паруса Holkas его не переносит. План предупреждает о расхождении. Если других изменений у класса нет, команды для него не будет, и повторное сравнение покажет то же предупреждение. В Git и файлы значение записывается как в источнике.
AccRegJSON: accRegцелое / nullСравниваетсяДеление по организациям- Назначение
- Дополняет Sharing: при Sharing = 1 значение AccReg = 1 задаёт деление по организациям, а AccReg = 0 — по версиям. В КОР это один выбор способа деления.
- При переносе:
- Записывается вместе с Sharing при создании класса (Create CLS). Ограничение: Парус не позволяет изменить способ деления у существующего класса, поэтому в базу Паруса Holkas его не переносит. План предупреждает о расхождении. Если других изменений у класса нет, команды для него не будет, и повторное сравнение покажет то же предупреждение. В Git и файлы значение записывается как в источнике.
SignHierJSON: signHierцелое / nullСравниваетсяКаталоги- Назначение
- Разрешает размещать записи раздела по каталогам и учитывать права доступа к этим каталогам. Для этого нужна также связь класса с классом «Каталоги».
- При переносе:
- Меняет настройку использования каталогов (Update CLS). Сами каталоги и права доступа к ним вместе с описанием класса не переносятся.
SignJurpersJSON: signJurpersцелое / nullСравниваетсяЮридические лица- Назначение
- Включает учёт принадлежности записей юридическим лицам. По правилам КОР этот признак используется у классов с делением по организациям.
- При переносе:
- Меняет признак «Юридические лица» (Update CLS). Сами юридические лица, записи раздела и права пользователей этой командой не создаются.
HierarchicalJSON: hierarchicalцелое / nullСравниваетсяИерархия- Назначение
- Указывает, что записи раздела образуют иерархию: одна запись может быть подчинена другой. Положение самого класса в дереве задаёт UnitCodeParent.
- При переносе:
- Меняет признак иерархического раздела (Update CLS). Сами записи и отношения между ними не переносятся.
UseDocPropsJSON: useDocPropsцелое / nullСравниваетсяСвойства документов- Назначение
- Разрешает задавать записям раздела дополнительные характеристики через механизм «Свойства документов» Паруса.
- При переносе:
- Меняет признак использования свойств (Update CLS). Описания дополнительных свойств и их значения у записей в эту команду не входят.
UseFileLinkJSON: useFileLinkцелое / nullСравниваетсяПрисоединённые документы- Назначение
- Разрешает работать с внешними файлами, присоединёнными к записям раздела через механизм «Присоединённые документы».
- При переносе:
- Меняет признак использования присоединённых документов (Update CLS). Сами документы, файлы и их связи с записями не переносятся.
Регистрация таблицы в Парусе CLS · TABLELIST · 9
Эти поля описывают запись о таблице в реестре Паруса (TABLELIST). Они не создают саму таблицу и её триггеры. Настройки записываются командой класса CLS. Если TableName не задано, регистрации нет; если TableNote = null, уже существующая регистрация сохраняется.
TableNoteJSON: tableNoteстрока / nullСравниваетсяНаименование таблицы- Назначение
- Наименование таблицы в реестре таблиц Паруса. Значение null означает, что сведения о регистрации таблицы в пакете не заданы.
- При переносе:
- Если наименование задано, команда CLS записывает его вместе с настройками регистрации. При null существующая регистрация сохраняется. Если регистрации ещё нет, она создаётся с именем таблицы вместо наименования и настройками из пакета.
TableTempFlagJSON: tableTempFlagцелоеСравниваетсяТип информации таблицы- Назначение
- Числовой код типа информации в реестре таблиц Паруса (TABLELIST). Значение переносится как код, без преобразования в команду создания временной таблицы.
- При переносе:
- Записывается вместе с регистрацией таблицы через CLS. Если TableNote = null, существующая регистрация сохраняется.
TableRegInsertJSON: tableRegInsertцелоеСравниваетсяРегистрация добавления- Назначение
- Определяет, нужно ли регистрировать событие при добавлении записи в таблице раздела: 1 — да, 0 — нет.
- При переносе:
- Записывает признак в регистрацию таблицы через CLS. Для включённой регистрации нужны соответствующие триггеры Паруса — обработчики событий таблицы. Сам признак их не создаёт.
TableRegUpdateJSON: tableRegUpdateцелоеСравниваетсяРегистрация исправления- Назначение
- Определяет, нужно ли регистрировать событие при изменении записи в таблице раздела: 1 — да, 0 — нет.
- При переносе:
- Записывает признак в регистрацию таблицы через CLS. Для включённой регистрации нужны соответствующие триггеры Паруса — обработчики событий таблицы. Сам признак их не создаёт.
TableRegDeleteJSON: tableRegDeleteцелоеСравниваетсяРегистрация удаления- Назначение
- Определяет, нужно ли регистрировать событие при удалении записи в таблице раздела: 1 — да, 0 — нет.
- При переносе:
- Записывает признак в регистрацию таблицы через CLS. Для включённой регистрации нужны соответствующие триггеры Паруса — обработчики событий таблицы. Сам признак их не создаёт.
TableRegRefNoteJSON: tableRegRefNoteцелоеСравниваетсяПримечание по ссылкам- Назначение
- Признак «Примечание по ссылкам» в реестре таблиц Паруса. Управляет регистрацией примечаний по ссылкам.
- При переносе:
- Записывается вместе с регистрацией таблицы через CLS. Если TableNote = null, существующая регистрация сохраняется.
TableCheckInsertJSON: tableCheckInsertцелоеСравниваетсяПроверка процессных действий при добавлении- Назначение
- Определяет, нужно ли проверять процессные действия Паруса при добавлении записи: 1 — да, 0 — нет.
- При переносе:
- Записывает признак в регистрацию таблицы через CLS. Для работы проверки нужны соответствующие триггеры Паруса — обработчики событий таблицы. Сам признак их не создаёт.
TableCheckUpdateJSON: tableCheckUpdateцелоеСравниваетсяПроверка процессных действий при исправлении- Назначение
- Определяет, нужно ли проверять процессные действия Паруса при изменении записи: 1 — да, 0 — нет.
- При переносе:
- Записывает признак в регистрацию таблицы через CLS. Для работы проверки нужны соответствующие триггеры Паруса — обработчики событий таблицы. Сам признак их не создаёт.
TableCheckDeleteJSON: tableCheckDeleteцелоеСравниваетсяПроверка процессных действий при удалении- Назначение
- Определяет, нужно ли проверять процессные действия Паруса при удалении записи: 1 — да, 0 — нет.
- При переносе:
- Записывает признак в регистрацию таблицы через CLS. Для работы проверки нужны соответствующие триггеры Паруса — обработчики событий таблицы. Сам признак их не создаёт.
Атрибуты Attributes[] · CLS.Attr · 7
ColumnNameJSON: columnNameстрокаКлючИмя атрибута- Назначение
- Имя поля внутри класса. Для физического атрибута — колонка таблицы; у логического атрибута физической колонки может не быть.
- При переносе:
- Holkas находит атрибут по имени внутри класса. При замене имени план удаляет описание прежнего атрибута и создаёт описание нового (Delete и Create CLS.Attr).
CaptionJSON: captionстрока / nullСравниваетсяНаименование- Назначение
- Читаемая подпись, например «Мнемокод». В пределах класса подписи атрибутов должны быть уникальны.
- При переносе:
- Меняет подпись атрибута (Update CLS.Attr), сохраняя его имя. Если подпись переходит от одного атрибута к другому, Holkas сначала освобождает её, а обмен подписями по кругу не переносит и называет в плане — см. «Атрибуты меняются наименованиями». После обновления Holkas закрепляет позиции атрибутов отдельной командой SetOrder CLS.AttrPos.
KindJSON: kindцелое / nullСравниваетсяТип атрибута- Назначение
- 0 — физический атрибут, связанный с колонкой таблицы; 1 — логический, значение которого не хранится в поле таблицы; 2 — ссылочный, получающий значение через связь с атрибутом другого класса.
- При переносе:
- Тип записывается при создании атрибута (Create CLS.Attr). Ограничение: Если изменить Kind у существующего атрибута, Update CLS.Attr будет отклонён целиком. Holkas не заменяет такое изменение автоматическим удалением и созданием атрибута.
PositionJSON: positionцелое / nullСравниваетсяПозиция- Назначение
- Номер места атрибута в списке; в пределах класса позиции должны быть уникальны. По ним КОР размещает элементы на автоматически создаваемой форме. Перестановка элементов JSON без изменения Position новый порядок не задаёт.
- При переносе:
- Изменение даёт Update CLS.Attr. После изменений списка команда SetOrder CLS.AttrPos расставляет атрибуты по конечным значениям Position.
DomainJSON: domainстрока / nullСравниваетсяДомен- Назначение
- Код домена, который определяет тип данных и их настройки, например TCODE. Внутренний номер домена в базе вместо кода указывать не нужно.
- При переносе:
- Меняет домен в описании атрибута (CLS.Attr). Домен должен уже существовать в приёмнике или создаваться раньше атрибута в этом же плане.
RefLinkJSON: refLinkстрока / nullСравниваетсяСвязь- Назначение
- Имя связи текущего класса, по которой ссылочный атрибут получает значение из другого класса.
- При переносе:
- Меняет ссылку в описании атрибута (CLS.Attr). Связь LNK и её сопоставления атрибутов переносятся отдельно; их создание учитывается при построении порядка команд.
RefAttributeJSON: refAttributeстрока / nullСравниваетсяАтрибут связи- Назначение
- Имя атрибута другого класса, откуда нужно получить значение. В каком классе его искать, определяет связь RefLink.
- При переносе:
- Меняет имя исходного атрибута (CLS.Attr). Если описание связи LNK включено в набор, Holkas учитывает создание исходного атрибута при построении порядка команд.
Визуальные формы VisualForms[] · CLS.VF · 15
FormClassJSON: formClassстрокаЧасть ключаИмя формы- Назначение
- Имя формы в КОР. Одного имени недостаточно: одинаковые имена допустимы при разных привязках.
- При переносе:
- Holkas находит форму по сочетанию имени, вида, метода вызова и действия. При замене имени план удаляет прежнюю форму и создаёт новую (Delete и Create CLS.VF).
FormNameJSON: formNameстрокаСравниваетсяНаименование формы- Назначение
- Читаемое наименование формы. Его можно изменить, сохранив ту же форму и её привязки.
- При переносе:
- Меняет наименование существующей формы (Update CLS.VF). Само по себе это изменение не требует удаления и создания формы.
FormKindJSON: formKindцелоеЧасть ключаВид формы- Назначение
- Например: 3 — форма действия или метода действия; 5 — форма представления. Определяет контекст использования.
- При переносе:
- Вид участвует в поиске соответствующей формы. При его замене план удаляет прежнюю форму и создаёт форму с новым видом (Delete и Create CLS.VF).
ShowMethodJSON: showMethodстрока / nullЧасть ключаМетод вызова- Назначение
- Код метода вызова класса, например main. У форм других назначений может отсутствовать.
- При переносе:
- При замене метода вызова план удаляет прежнюю форму и создаёт форму с новой привязкой (Delete и Create CLS.VF). Сам метод вызова переносится отдельно как MEC.
FormJSON: formстрока / nullЧасть ключаДействие / метод действия- Назначение
- Для формы действия: код действия; для формы метода действия: «КодДействия|КодМетода». Может быть null для иной привязки.
- При переносе:
- При замене действия или метода действия план удаляет прежнюю форму и создаёт форму с новой привязкой (Delete и Create CLS.VF). Нужное действие ACT или привязка ACT.Method должны существовать в приёмнике.
LinkApplicationJSON: linkApplicationцелоеСравниваетсяИспользовать привязку к приложениям- Назначение
- Определяет, используется ли список приложений Applications при выборе формы. Выключение признака не очищает сохранённый список.
- При переносе:
- Меняет признак в настройках формы (Update CLS.VF). Чтобы добавить или снять связь с конкретным приложением, нужно изменить список Applications.
LinkPrivilegesJSON: linkPrivilegesцелоеСравниваетсяИспользовать назначения- Назначение
- Определяет, используются ли назначения ролям и пользователям из списка Privileges при выборе формы. Выключение признака не очищает этот список.
- При переносе:
- Меняет признак в настройках формы (Update CLS.VF). Чтобы назначить форму конкретной роли или пользователю либо снять назначение, нужно изменить список Privileges.
FormActiveJSON: formActiveцелоеСравниваетсяДоступна для использования- Назначение
- Разрешает использовать форму: 1 — форма доступна, 0 — выключена. При выборе формы учитываются также её привязки и назначения.
- При переносе:
- Меняет доступность существующей формы (Update CLS.VF). Выключение формы сохраняет её описание и содержимое.
EventsLanguageJSON: eventsLanguageцелое / nullСравниваетсяЯзык обработчиков- Назначение
- Числовой код языка обработчиков событий формы. null означает, что язык ещё не задан. Значение 0 тоже считается заданным кодом.
- При переносе:
- Если язык ещё не задан, его можно установить через Update CLS.VF. Ограничение: Уже заданный язык нельзя сменить или сбросить в Парусе. Update CLS.VF отклоняется целиком, включая остальные изменения этой формы. Автоматически пересоздавать форму Holkas не будет.
FormDataJSON: formDataстрока / nullСравниваетсяОписание формы- Назначение
- Текст XML, описывающий структуру и настройки формы. При null существующий текст в базе Паруса сохраняется.
- При переносе:
- Записывает описание формы через CLS.VF. Holkas проверяет, читается ли XML, и распознаёт известные ссылки на другие объекты. Это не проверка работоспособности экрана; при ошибке XML появляется предупреждение, команда остаётся в плане.
FormEventsJSON: formEventsстрока / nullСравниваетсяОбработчики событий- Назначение
- Программный текст обработчиков событий формы. При null существующий текст в базе Паруса сохраняется.
- При переносе:
- Записывает обработчики вместе с формой (CLS.VF). Ограничение: Holkas переносит текст без перевода на другой язык программирования или другую платформу клиента Паруса.
FormDataExtJSON: formDataExtстрока / nullСравниваетсяРасширение описания формы- Назначение
- Дополнительный текст XML с описанием формы, хранящийся отдельно от FormData. При null существующий текст в базе Паруса сохраняется.
- При переносе:
- Записывает дополнительное описание через CLS.VF. При проверке XML и поиске известных ссылок Holkas рассматривает его вместе с FormData.
FormEventsExtJSON: formEventsExtстрока / nullСравниваетсяРасширение обработчиков- Назначение
- Дополнительный программный текст обработчиков, хранящийся отдельно от FormEvents. При null существующий текст в базе Паруса сохраняется.
- При переносе:
- Записывает дополнительные обработчики вместе с формой (CLS.VF). Ограничение: Holkas переносит текст без перевода на другой язык программирования или другую платформу клиента Паруса.
PrivilegesJSON: privilegesмассив / nullПо элементамНазначения ролям / пользователям- Назначение
- Список назначений формы: в каждой записи указывается одна роль Role или один пользователь User. null или отсутствие списка сохраняет текущие назначения; пустой список [] снимает все назначения этой формы.
- При переносе:
- Holkas сравнивает назначения по именам ролей и логинам пользователей. Новое назначение добавляется, отсутствующее в списке снимается (Create и Delete CLS.VF.Priv). Порядок записей в списке не влияет на результат.
ApplicationsJSON: applicationsмассив / nullПо элементамСвязи с приложениями- Назначение
- Список кодов приложений, с которыми связана форма, например ["Admin"]. null сохраняет текущие связи; пустой список [] снимает все связи этой формы с приложениями.
- При переносе:
- Holkas сравнивает связи по кодам приложений. Новая связь добавляется, отсутствующая в списке снимается (Create и Delete CLS.VF.App). Сами приложения сохраняются; порядок записей в списке не влияет на результат.
Элемент назначения формы Privileges[] · CLS.VF.Priv · 2
RoleJSON: roleстрока / nullЧасть ключаРоль Паруса- Назначение
- Имя роли Паруса. В одной записи назначения указывается либо роль, либо пользователь. Если роли в базах называются по-разному, их соответствие задают настройкой parusRoleMap.
- При переносе:
- При замене роли план снимает назначение формы прежней роли и назначает форму новой (Delete и Create CLS.VF.Priv). Сами роли сохраняются.
UserJSON: userстрока / nullЧасть ключаПользователь Паруса- Назначение
- Имя учётной записи пользователя в Парусе (AUTHID). Нужно указать логин, под которым он входит, а не отображаемое имя. Этот пользователь должен существовать в приёмнике.
- При переносе:
- При замене логина план снимает назначение формы прежнему пользователю и назначает её новому (Delete и Create CLS.VF.Priv). Сами пользователи сохраняются.
Коллекции и файловое представление CLS · семейство · 9
AttributesJSON: attributesмассивПо элементамАтрибуты- Назначение
- Список описаний атрибутов класса. Поля каждого атрибута разобраны в группе «Атрибуты».
- При переносе:
- Holkas находит каждый атрибут по имени ColumnName и отдельно сравнивает его свойства. Добавление, изменение и удаление атрибутов дают команды CLS.Attr. Если настройки самого класса совпадают, Update CLS не нужен.
VisualFormsJSON: visualFormsмассивПо элементамВизуальные формы- Назначение
- Список описаний форм класса. Каждая форма содержит свои настройки, тексты, назначения пользователям и ролям и связи с приложениями.
- При переносе:
- Каждая форма сопоставляется по имени, виду, методу вызова и действию и получает свои команды CLS.VF. Назначения пользователям и ролям меняются через CLS.VF.Priv, связи с приложениями — через CLS.VF.App.
ConstraintsGit YAML: ConstraintsмассивПо элементамОграничения- Назначение
- Список ограничений (CNS) в файле класса формата Git YAML. В ZIP-пакете эти объекты хранятся отдельно, в каталоге Constraint/.
- При переносе:
- Holkas находит ограничение по коду класса и имени ограничения. Новое имя означает отдельное ограничение CNS; существующее с прежним именем сохраняется. См. страницу «Ограничение».
LinksGit YAML: LinksмассивПо элементамСвязи- Назначение
- Список связей (LNK) в файле класса формата Git YAML. В ZIP-пакете эти объекты хранятся отдельно, в каталоге Link/.
- При переносе:
- Holkas находит связь по коду класса и имени связи. Новое имя означает отдельную связь LNK; существующая с прежним именем сохраняется. См. страницу «Связь».
ActionsGit YAML: ActionsмассивПо элементамДействия- Назначение
- Список действий (ACT) в файле класса формата Git YAML. В ZIP-пакете эти объекты хранятся отдельно, в каталоге Action/.
- При переносе:
- Holkas находит действие по его коду внутри класса и отдельно сравнивает настройки и части. Порядок действий закрепляет команда CLS.ActPos, если класс участвует в плане и появились действия или изменились их позиции.
MethodsGit YAML: MethodsмассивПо элементамМетоды- Назначение
- Список методов (MET) в файле класса формата Git YAML. В ZIP-пакете эти объекты хранятся отдельно, в каталоге Method/.
- При переносе:
- Holkas находит метод по его коду внутри класса. Настройки метода дают команды MET, параметры сравниваются отдельно. Новое имя метода не удаляет существующий метод с прежним именем.
MethodCallsGit YAML: MethodCallsмассивПо элементамМетоды вызова- Назначение
- Список методов вызова (MEC) в файле класса формата Git YAML. В ZIP-пакете эти объекты хранятся отдельно, в каталоге MethodCall/.
- При переносе:
- Holkas находит метод вызова по его коду внутри класса. Настройки, параметры и локальные переменные сравниваются отдельно и дают свои команды MEC, MEC.Param и MEC.Var.
ViewsGit YAML: ViewsмассивПо элементамПредставления класса- Назначение
- Список представлений класса (VIW) в файле класса формата Git YAML. В ZIP-пакете эти объекты хранятся отдельно, в каталоге View/. Это описания представлений Паруса; физические представления БД переносятся отдельно.
- При переносе:
- Holkas находит представление по имени внутри класса. Его настройки, параметры и отображаемые колонки сравниваются отдельно и дают свои команды VIW, VIW.Param и VIW.Attr.
ObjectsGit YAML: Objectsмассив / nullПо элементамРеестр объектов- Назначение
- Список записей реестра объектов класса (CLO) в файле класса формата Git YAML. В ZIP-пакете эти объекты хранятся отдельно, в каталоге ClassObject/. При пустом реестре список может отсутствовать.
- При переносе:
- Holkas находит запись по классу, типу и имени объекта. Настройки и текст меняет команда CLO, связи с другими записями — CLO.Dep. Перенос записи сам по себе не выполняет её текст в базе данных.
Команды плана
У класса и его семейства 28 кодов команд: семь относятся к самому CLS, ещё 21 — к действиям, методам, вызовам, связям, ограничениям, представлениям и объектам класса. В конкретном плане появляются только команды выбранных объектов, для которых найдены изменения.
Код — что меняем, действие — как меняем, ключ — где именно. Create — создать, Update — изменить, Delete — удалить, SetOrder — задать итоговый порядок. Ниже показаны поддерживаемые действия и шаблоны ключей: вместо «Класс», «Метод» и других частей подставляются их коды или имена.
Класс, атрибуты и формы · CLSКодов: 7
CLSРеквизиты класса
Создаёт класс либо меняет основные настройки. Обеспечивает регистрацию таблицы в Парусе; физическую таблицу не создаёт. Отдельной команды Delete для класса нет.
Ключ: Класс · Применение: P_DMSCLASSES_INSERT / UPDATE; регистрация — P_TABLELIST_INSERT / UPDATE.
CLS.AttrОдин атрибут
Добавляет, изменяет или удаляет описание атрибута. Сопоставление идёт по имени, а не по подписи. Тип Kind у существующего атрибута изменить этой командой нельзя.
Ключ: Класс|ColumnName · Обычно P_DMSCLATTRS_INSERT / UPDATE / DELETE; для ссылочных атрибутов с несовпадающим доменом предусмотрен специальный путь записи метаданных.
CLS.AttrPosИтоговый порядок атрибутов
Появляется при любом Create или Update атрибутов и ждёт всех команд атрибутов этого класса, включая Delete. Устанавливает конечные значения Position после перенумерации процедурами Паруса.
Ключ: Класс · Прямая установка позиций в DMSCLATTRS. При одних удалениях не создаётся.
CLS.ActPosИтоговый порядок действий
Для выбранного класса с семейством появляется при добавлении действия или изменении его позиции. Изменение только текста действия её не вызывает. Состав берётся из выбранных ACT этого класса.
Ключ: Класс · Устанавливает итоговые номера UNITFUNC.NUMB после соответствующих Create / Update ACT.
CLS.VFОдна визуальная форма
Переносит реквизиты и содержимое формы. Изменение обычных свойств даёт Update. Если вместо прежней формы указать форму с другим именем, видом, методом вызова или действием, план содержит удаление прежней формы и создание новой, если её ещё нет в приёмнике. Назначения и приложения сравниваются отдельно.
Ключ: Класс|FormClass|FormKind|ShowMethod|Form · P_USERFORMS_INSERT / UPDATE / DELETE и запись содержимого в USERFORMS.
CLS.VF.PrivНазначение формы роли или пользователю
Holkas находит назначение по имени роли или логину пользователя. Переносит связь с формой; создание роли, пользователя и членство в ролях в эту команду не входят.
Ключ: ключ формы + |role:Роль или |user:Логин. Для ключа формы, заканчивающегося на «|», разделители соседних частей дают «||».
CLS.VF.AppСвязь формы с приложением
Добавляет или снимает связь по коду приложения. Признак использования связей LinkApplication меняется через CLS.VF. У Create есть зависимости от создания формы и приложения.
Ключ: ключ формы + |AppCode. Изменение приложения выражается через снятие старой и создание новой связи.
Действия · ACTКодов: 5
ACTНастройки действия
Создаёт действие или меняет его настройки. Параметры, привязки методов и шаги получают отдельные команды.
Ключ: Класс|Действие
ACT.ParamПараметр действия
Меняет один параметр: его домен, привязки, значения и прочие свойства. Переименование даёт удаление прежнего параметра и создание нового.
Ключ: Класс|Действие|Имя параметра
ACT.ParamPosПорядок параметров действия
Закрепляет итоговые позиции после команд параметров. Появляется при их создании или изменении; при одних удалениях не создаётся. Порядок самих действий задаёт CLS.ActPos.
Ключ: Класс|Действие
ACT.MethodПривязка метода к действию
Подключает существующий метод к действию или снимает подключение. Сам MET при снятии остаётся. У привязки нет изменяемых свойств, поэтому Update не возникает.
Ключ: Класс|Действие|Метод
ACT.StepШаг действия
Меняет один шаг и его ссылки на параметр, привязку метода или открываемый раздел. Ключом служит позиция. Удаления шагов выполняются раньше их создания и обновления; отдельного ACT.StepPos нет.
Ключ: Класс|Действие|Позиция
Методы · METКодов: 3
METНастройки метода
Регистрирует метод или меняет его настройки. Исполняемая функция, процедура или пакет переносится своей командой БД. Смену MethodType, Package или Name у существующего метода применение отклоняет.
Ключ: Класс|Метод
MET.ParamПараметр метода
Меняет описание одного параметра, включая домен и привязки к атрибуту или связанному методу. Удаление параметра не удаляет сам метод.
Ключ: Класс|Метод|Имя параметра
MET.ParamPosПорядок параметров метода
Ставит конечные позиции после всех изменений параметров. Создаётся при наличии Create или Update параметров; одних Delete недостаточно.
Ключ: Класс|Метод
Методы вызова · MECКодов: 3
MECНастройки метода вызова
Создаёт или обновляет способ вызова раздела, включая настройки и условия отбора. Параметры и локальные переменные изменяются отдельно.
Ключ: Класс|Метод вызова
MEC.ParamПараметр вызова
Меняет параметр, его атрибут и зависимость от другого параметра. При смене привязки учитывает освобождение старого атрибута. Отдельной команды порядка параметров MEC нет.
Ключ: Класс|Метод вызова|Имя параметра
MEC.VarЛокальная переменная
Меняет переменную вызова, её домен и метод инициализации. Новое имя означает удаление прежней переменной и создание новой.
Ключ: Класс|Метод вызова|Имя переменной
Связи · LNKКодов: 3
LNKНастройки связи
Регистрирует связь классов или меняет её настройки. Сопоставления атрибутов переносятся отдельно через LNK.Attr.
Ключ: Класс|Имя связи
LNK.AttrСопоставление атрибутов
Меняет соответствие между атрибутом текущего класса и атрибутом класса-источника. Ключ — SourceUnitCode и Destination: смена Source при прежних SourceUnitCode и Destination даёт Update. Delete снимает соответствие, сохраняя сами атрибуты.
Ключ: Класс|Имя связи|SourceUnitCode|Destination
LNK.AttrPosПорядок сопоставлений атрибутов
Появляется при любом Create или Update сопоставлений и ждёт всех их команд, включая Delete. Ставит позиции из списка источника после сдвигов процедурами Паруса.
Ключ: Класс|Имя связи
Ограничения · CNSКодов: 3
CNSНастройки ограничения
Меняет описание ограничения класса и его сообщение. Состав участвующих атрибутов задаётся отдельными командами.
Ключ: Класс|Имя ограничения
CNS.AttrАтрибут ограничения
Включает атрибут в ограничение, меняет свойства участия или исключает из него. Удаление этой записи сохраняет сам атрибут класса.
Ключ: Класс|Имя ограничения|Атрибут
CNS.AttrPosПорядок атрибутов ограничения
Закрепляет позиции после команд списка атрибутов. Возникает при их создании или изменении; при одних удалениях не создаётся.
Ключ: Класс|Имя ограничения
Представления · VIWКодов: 3
VIWНастройки представления
Меняет описание представления Паруса, включая собственный SQL-запрос. Физическое представление БД переносится отдельно. Смена CustomQuery у существующего представления отклоняется.
Ключ: Класс|Представление
VIW.ParamПараметр представления
Меняет параметр и его домен. Ключом служит ParameterName; смена имени создаёт новую часть и удаляет прежнюю.
Ключ: Класс|Представление|ParameterName
VIW.AttrКолонка представления
Меняет описание отображаемой колонки и привязку к атрибуту класса. Ключ — ColumnName, а не Attribute. Delete снимает описание колонки, сохраняя атрибут класса и физическую колонку БД.
Ключ: Класс|Представление|ColumnName
Объекты класса · CLOКодов: 2
CLOЗапись реестра объектов класса
Меняет запись в разделе «Объекты» класса: её реквизиты и текст. Это запись реестра Паруса; перенос физического объекта БД имеет свой код команды.
Ключ: Класс|ТИП:ИМЯ
CLO.DepЗависимость объекта класса
Добавляет или снимает зависимость между двумя записями реестра. Все поля входят в ключ: изменять отдельно нечего, поэтому Update не возникает. Снятие зависимости сохраняет обе записи.
Ключ: Класс|ТИП:ИМЯ|Класс цели|ТИП:ИМЯ цели
Удаление целого CLS, ACT, MET, MEC, LNK, CNS, VIW или CLO по отсутствию в наборе не строится. Delete в каталоге относится к вложенным частям выбранного объекта. Команды порядка перечислены явно: отдельный SetOrder есть не у каждой коллекции.
Ограничения и что с ними делать
Нужно сменить родительский класс
Что произойдёт. План предупреждает о смене UnitCodeParent. Update CLS отказывает целиком до записи остальных реквизитов.
Как действовать. Для обычного обновления сохраните родителя приёмника. Если нужна другая структура, проектируйте новый класс и перенос данных/ссылок отдельно. Holkas не пересоздаёт существующий класс автоматически.
Нужно изменить тип атрибута, деление или абстрактность
Тип атрибута. Смена Kind обнаруживается сравнением, но Update CLS.Attr её отклоняет. Создайте атрибут нужного типа под новым именем и перенастройте его использование; удаление и повторное создание под тем же именем требует отдельной проверки зависимых частей и последовательности операций.
Деление и абстрактность. Sharing, AccReg и Abstract Парус задаёт только при создании класса. Если у существующего класса они отличаются, план называет поля и значения в предупреждении и не переносит их; остальные изменения класса применяются. Чтобы изменить эти свойства, класс нужно пересоздать с сохранением его настроек и связей. Holkas не делает этого автоматически, поэтому сначала согласуйте нужное устройство класса в КОР.
Атрибуты меняются наименованиями
Наименование (Caption) атрибута уникально в классе: Парус не даёт занять подпись, пока её держит другой атрибут.
Цепочка — например, SUMMA: «Сумма» → «Сумма с НДС», SUMMA_NET: «Сумма без НДС» → «Сумма». Holkas упорядочивает команды сам: сначала SUMMA освобождает «Сумма», потом её получает SUMMA_NET. Всё проходит за один перенос.
Обмен по кругу — например, A: «Первое» → «Второе», B: «Второе» → «Первое». Без временного наименования его не выполнить, а промежуточные значения Holkas не записывает. План называет такие атрибуты в предупреждении и не отправляет по ним команд; остальные правки класса переносятся. Поменяйте эти наименования в приёмнике вручную или в три переноса: дайте в источнике одному атрибуту свободное временное наименование, перенесите, затем верните нужные наименования и перенесите снова.
Если подпись держит атрибут, который в этом переносе её не меняет и не удаляется, команда получает отказ «Значение уже занято» с именем ограничения C_DMSCLATTRS_CAPTION_UK.
Проверено на PostgreSQL и Oracle.
Нужно сменить язык обработчиков формы
Если EventsLanguage уже задан, смена или сброс запрещены: план предупреждает, применение отказывает. Установка языка из незаданного состояния допускается. Для другого языка подготовьте новую форму, перенесите необходимые привязки и назначения и проверьте её до снятия прежней. Holkas сам такого пересоздания не делает.
XML повреждён или ссылается на отсутствующий объект
Некорректный XML даёт предупреждение с полем, местом и фрагментом; команда остаётся в плане. Исправьте форму в источнике и постройте план заново. При отсутствующей известной зависимости включите объект в состав либо обеспечьте его наличие в приёмнике. Проверьте также предупреждения при пустом списке команд.
Форму перенесли, но нужный пользователь её не получает
Проверьте FormActive, LinkPrivileges, LinkApplication, оба списка назначений и контекст открытия формы. Наличие роли в Privileges ещё не включает использование назначений. Отсутствующие роли и пользователи называются до применения; роли с разными именами сопоставляются через parusRoleMap. Пользователя и его членство нужно подготовить отдельно.
Пакет старый или заполнен частично
Регистрация таблицы: TableNote = null не задаёт новую регистрацию; существующая сохраняется. Если регистрацию требуется создать, используется совместимый путь с умолчаниями.
Назначения форм: отсутствующее поле или null сохраняет текущие назначения; [] явно задаёт пустой список и может породить удаления.
Содержимое формы: null в FormData, FormEvents, FormDataExt, FormEventsExt пропускает запись соответствующей колонки. Не используйте null как команду очистки и не заменяйте им отсутствующие знания о том, какой должна быть форма.
Метаданные перенесены, но раздел не работает
Проверьте физическую таблицу, представления, реализующие методы процедуры/функции и пункт меню приложения. Регистрация таблицы в TABLELIST не создаёт таблицу SQL. Включение регистрации или проверки событий требует соответствующих триггеров Паруса.
Код CLS общий для Oracle и PostgreSQL, но серверный код автоматически не переводится. Работа формы в Windows также не доказывает её работу в web-клиенте: проверяйте оба используемых клиента. Особые правила штатной технологии могут отклонить допустимую на уровне модели команду.
Рёбра команд класса
Что такое ребро и где оно видно в Holkas →
Рёбра помогают Holkas правильно отсортировать команды перед применением. Ребро связывает две команды и указывает, какая из них должна выполниться раньше.
Например, в одном переносе создаются новый домен и атрибут класса, который ссылается на этот домен. Для них нужен такой порядок:
Create DOMCreate CLS.AttrНиже собраны правила, по которым Holkas строит рёбра для класса, его частей и связанных объектов. Конкретные рёбра зависят от того, какие команды появились в вашем плане.
Читайте слева направо: какая команда выполняется раньше → какая после неё. Под ними — условие появления ребра и его назначение.
Реквизиты класса · CLS5 правил
Create / Update CLS родителя→Create / Update CLSКогда: UnitCodeParent задан.
Родительский класс должен быть подготовлен раньше дочернего.
Create / Update CLS ведущего раздела→Create / Update CLSКогда: HostCode задан.
Ведомый раздел ссылается на ведущий.
Create PIC→Create / Update CLSКогда: SysImage содержит код пиктограммы.
Сначала создать пиктограмму класса.
Create / Update TBP или JTB→Create / Update CLSКогда: Хотя бы один TableRegInsert/Update/Delete или TableCheckInsert/Update/Delete равен 1; таблица TableName схемы PARUS есть в переносимом наборе.
Подготовить таблицу перед включением регистрации или проверки событий. Без этих флагов общего ребра от таблицы нет.
Create / Update TBP.Trg или JTB.Trg→Create / Update CLSКогда: Те же флаги событий; для всех триггеров соответствующей таблицы из переносимого набора.
Поддержка событий должна быть готова до регистрации класса.
Атрибуты и порядок · CLS.Attr / AttrPos / ActPos9 правил
Create CLS→Create CLS.AttrКогда: Создаётся атрибут данного класса.
Сначала создать класс. На Update атрибута это ребро не объявляется.
Create DOM→Create / Update CLS.AttrКогда: Domain задан.
Домен нужен и при создании, и при обновлении атрибута.
Create LNK→Create / Update CLS.AttrКогда: RefLink задан: связь того же класса.
Подготовить связь ссылочного атрибута.
Create LNK.Attr→Create / Update CLS.AttrКогда: RefLink задан и описание LNK есть в наборе. Берутся сопоставления, у которых Destination не равен ColumnName текущего атрибута.
Сначала подготовить нужные сопоставления; исключение собственного атрибута предотвращает самозависимость.
Create CLS.Attr исходного класса→Create / Update CLS.AttrКогда: RefLink и RefAttribute заданы, LNK есть в наборе; исходный класс берётся из LNK.SourceCode.
Ссылочный атрибут использует атрибут класса-источника связи.
Delete CLS.Attr со старым именем→Create / Update CLS.AttrКогда: В этом классе есть удаляемый атрибут с тем же непустым Caption.
Освободить подпись: Парус не допускает двух одинаковых Caption.
Update CLS.Attr, отдающий Caption→Update CLS.Attr, занимающий CaptionКогда: Атрибут получает непустой Caption, который в приёмнике держит другой атрибут этого класса, и тот в этом же переносе свой Caption меняет. Для обмена наименованиями по кругу ребро не ставится.
Сначала освободить подпись, потом занять: цепочка переименований проходит за один перенос.
Create / Update / Delete CLS.Attr→SetOrder CLS.AttrPosКогда: Есть хотя бы один Create или Update атрибута. Ребро — от каждой команды атрибутов данного класса.
Закрепить позиции после всех изменений, включая удаления. При одних удалениях SetOrder не создаётся.
Create / Update ACT→SetOrder CLS.ActPosКогда: При построении команд CLS найдено новое действие или смена Position, и в переносимом наборе есть хотя бы одно действие класса из источника. Берутся Added→Create и Modified→Update действий класса.
Закрепить порядок действий после команд их корней; изменение только частей ACT может не дать корневую команду.
Формы и назначения · CLS.VF7 правил
Create CLS→Create CLS.VFКогда: Создаётся форма класса.
Сначала создать класс.
Create MEC→Create / Update CLS.VFКогда: ShowMethod задан; ключ — класс формы и ShowMethod.
Подготовить метод вызова, к которому привязана форма.
Create ACT→Create / Update CLS.VFКогда: Form задан без разделителя |.
Form называет действие этого класса.
Create ACT.Method→Create / Update CLS.VFКогда: Form содержит Действие|Метод.
Подготовить привязку метода к действию, на которую указывает форма.
Create CLS.VF→Create CLS.VF.Priv / CLS.VF.AppКогда: Добавляется назначение роли/пользователя или привязка приложения для этой формы.
Сначала создать саму форму. Её Update эти команды не ждут.
Create APP→Create CLS.VF.AppКогда: В Applications[] добавляется код приложения.
Приложение должно существовать до привязки формы.
Delete CLS.VF.Priv / CLS.VF.App→Delete CLS.VFКогда: Удаляется форма с назначениями или связями с приложениями.
Сначала снять её назначения и связи.
Ссылки внутри XML формы10 правил
Читаются FormData и FormDataExt. Если новое тело равно null, используются ссылки из текущего тела. Поддерживаются только перечисленные XML-конструкции; произвольный текст обработчиков не анализируется. Для файлового приёмника без СУБД тип реализации определяется по источнику и набору.
Create / Update JPR (Oracle) или JFP / JPP (PostgreSQL)→Create / Update CLS.VFКогда: В control-rules/recalc указан storedproc, в том числе внутри Conditions объекта TPContentUserConditions.
Подготовить процедуру пересчёта. Имя без схемы дополняется PARUS; тип выбирается по СУБД приёмника.
Create / Update JFN (Oracle) или JFP (PostgreSQL)→Create / Update CLS.VFКогда: ContentDictInterface.FuncName или ContentDictInterface_.FuncName.
Подготовить функцию словаря.
Create / Update PCE→Create / Update CLS.VFКогда: UserProcedureCode.
Подготовить пользовательскую процедуру из XML формы.
Create / Update REP→Create / Update CLS.VFКогда: UserReportCode.
Подготовить вызываемый пользовательский отчёт.
Create / Update UAP.Link→Create / Update CLS.VFКогда: UserApplicationCode называет действие; в наборе найдено UAP с Links на это действие и класс формы.
Подготовить подключение действия пользовательского приложения к разделу. Если UAP не найдено в наборе, ребра нет: появляется поясняющая заметка.
Create / Update MEC→Create / Update CLS.VFКогда: Словарь задаёт класс и метод: ContentDictInterface или ContentDictInterface_ (DocCode/ShowMethod), DictLink.Dictionary/Method или DictionaryInterface UnitCode/Method.
Подготовить указанный метод вызова словаря.
Create / Update CLS словаря→Create / Update CLS.VFКогда: В тех же ссылках словаря указан класс, но не метод.
Без метода зависимость ведёт непосредственно на класс.
Create / Update VIW→Create / Update CLS.VFКогда: Корневой XML-элемент form содержит class и view.
Подготовить представление формы заполнения.
Create / Update CLS источника→Create / Update CLS.VFКогда: Корневой элемент form содержит class, но не view.
Подготовить сам класс-источник формы заполнения.
Create / Update ACT→Create / Update CLS.VFКогда: ContentDocumentAction.ActionCode; класс берётся из соседнего UnitCode, а при его отсутствии — из класса формы.
Подготовить действие, вызываемое из формы.
Действия · ACT16 правил
Create CLS→Create ACTКогда: Новое действие класса.
Класс должен существовать раньше действия.
Create MET→Create / Update ACTКогда: Method задан.
Подготовить основной метод действия.
Create ACT→Create ACT.Param / ACT.Method / ACT.StepКогда: Создаётся соответствующая часть данного действия.
Сначала создать действие.
Create DOM→Create / Update ACT.ParamКогда: Domain параметра задан.
Подготовить домен параметра.
Create CLS.Attr→Create / Update ACT.ParamКогда: LinkAttribute задан.
Параметр использует атрибут этого класса.
Create MET→Create / Update ACT.ParamКогда: LinkedFunction задан.
Подготовить связанный метод класса.
Delete / Update ACT.Param→Delete CLS.AttrКогда: Параметр удаляется или его LinkAttribute сменился либо очищен.
Снять параметр до удаления используемого атрибута.
Create / Update / Delete ACT.Param→SetOrder ACT.ParamPosКогда: Есть хотя бы одно создание или обновление параметра; берутся все команды параметров действия.
Закрепить итоговый порядок параметров.
Create MET→Create ACT.MethodКогда: Создаётся привязка к методу этого класса.
Подготовить метод до его подключения к действию.
Update / Delete ACT.Step→Delete ACT.ParamКогда: Шаг раньше ссылался через ExecParameter на удаляемый параметр, а теперь снимает или меняет эту ссылку.
Сначала освободить старый параметр от использования шагом.
Delete ACT.Step→Create / Update ACT.StepКогда: В том же действии удаляются шаги; каждый Create/Update ждёт все эти Delete.
Удаление уплотняет позиции и не должно сдвинуть уже записанный новый шаг.
Delete ACT.Step→Delete ACT.MethodКогда: У удаляемого шага задан ExecMethod.
Сначала удалить шаг, использующий привязку метода.
Create ACT.Param→Create / Update ACT.StepКогда: ExecParameter задан.
Подготовить параметр, используемый шагом.
Create ACT.Method→Create / Update ACT.StepКогда: ExecMethod задан.
Подготовить привязку метода, которую выполняет шаг.
Create CLS другого раздела→Create / Update ACT.StepКогда: ShowUnitCode задан.
Подготовить открываемый шагом раздел.
Create MEC другого раздела→Create / Update ACT.StepКогда: ShowUnitCode и ShowMethodName заданы.
Подготовить метод вызова открываемого раздела.
Методы · MET9 правил
Create CLS→Create METКогда: Новый метод класса.
Сначала создать класс.
Create / Update объекта БД реализации→Create / Update METКогда: Name задан. Для процедуры: Oracle JPR, PostgreSQL JFP/JPP; для функции: Oracle JFN, PostgreSQL JFP. Метод пакета: Oracle JPG; PostgreSQL пакет$имя.
Подготовить реализацию метода. Метод без Name такого ребра не объявляет.
Create MET→Create MET.ParamКогда: Создаётся параметр метода.
Сначала создать метод.
Create / Update объекта БД реализации→Create / Update MET.ParamКогда: Корень MET не создаётся; реализация определяется теми же правилами Name/Package/MethodType.
При изменении только параметра ожидание реализации объявляется на самом параметре.
Create DOM→Create / Update MET.ParamКогда: Domain задан.
Подготовить домен параметра метода.
Create CLS.Attr→Create / Update MET.ParamКогда: LinkAttribute задан.
Подготовить атрибут, связанный с параметром.
Create MET связанного метода→Create / Update MET.ParamКогда: LinkedFunction задан.
Подготовить метод, используемый параметром.
Delete / Update MET.Param→Delete CLS.AttrКогда: Параметр удаляется или его LinkAttribute сменился либо очищен.
Снять параметр до удаления используемого атрибута.
Create / Update / Delete MET.Param→SetOrder MET.ParamPosКогда: Есть хотя бы один Create/Update параметра; берутся все команды параметров данного метода.
Закрепить порядок после изменений.
Методы вызова · MEC9 правил
Create CLS→Create MECКогда: Новый метод вызова.
Сначала создать класс.
Create / Update JPR (Oracle) или JFP / JPP (PostgreSQL)→Create / Update MECКогда: CondType = 1; в Settings найдена ConditionParams/@ConditionProcedure.
Подготовить процедуру серверных условий отбора.
Create MEC→Create MEC.Param / MEC.VarКогда: Создаётся параметр или локальная переменная вызова.
Сначала создать метод вызова.
Create / Update MEC.Param родителя→Create / Update MEC.ParamКогда: DepParameter параметра из источника задан.
Сначала подготовить параметр, от которого зависит текущий.
Update / Delete MEC.Param→Delete MEC.Param прежнего родителяКогда: У текущего параметра задан DepParameter.
Обновление или удаление зависимого параметра должно предшествовать удалению прежнего родителя.
Create CLS.Attr→Create / Update MEC.ParamКогда: Attribute параметра из источника задан.
Подготовить атрибут, на который переходит параметр.
Update / Delete MEC.Param→Delete CLS.Attr прежней привязкиКогда: Attribute текущего параметра задан.
Сначала обновить или удалить параметр, использовавший прежний атрибут.
Create DOM→Create / Update MEC.VarКогда: Domain локальной переменной задан.
Подготовить её домен.
Create MET→Create / Update MEC.VarКогда: InitFunction задан.
Подготовить метод инициализации переменной.
Связи · LNK13 правил
Create CLS своего и исходного классов→Create / Update LNKКогда: Создаётся связь: UnitCode и SourceCode; для Update — только сменившийся SourceCode.
Оба конца связи должны существовать. Собственный класс у существующей связи уже есть, поэтому Update его не ждёт.
Create CNS исходного класса→Create / Update LNKКогда: SrcConstraint задан; для Update — если значение меняется.
Подготовить ограничение, на которое ссылается связь.
Create STY→Create / Update LNKКогда: StereotypeCode задан; для Update — если значение меняется.
Подготовить стереотип связи.
Create MSG→Create / Update LNKКогда: MessageCode1 и/или MessageCode2 заданы; для Update — если значение меняется.
Подготовить каждое указанное сообщение.
Create LNK ведущей связи→Create / Update LNKКогда: MasterLink задан; ведущая связь того же класса; для Update — если значение меняется.
Подготовить ведущую связь.
Create CLS.Attr класса-источника→Create / Update LNKКогда: LevelAttribute и/или PathAttribute заданы; атрибут ищется в SourceCode связи; для Update — если значение меняется.
Подготовить атрибут уровня и/или пути.
Create LNK→Create LNK.AttrКогда: Создаётся сопоставление атрибутов.
Сначала создать связь.
Create CLS.Attr обоих концов→Create LNK.AttrКогда: SourceUnitCode|Source и UnitCode|Destination сопоставления.
Подготовить исходный и принимающий атрибуты.
Delete LNK.Attr→Delete CLS.Attr обоих концовКогда: Удаляемое сопоставление использует Source и Destination.
Сначала снять сопоставление, затем удалять атрибуты.
Create CLS.Attr исходного класса→Update LNK.AttrКогда: У сопоставления сменился Source или SourceUnitCode; цель — новый SourceUnitCode|Source.
Процедура Паруса ищет исходный атрибут по коду: он должен существовать.
Update LNK.Attr→Delete CLS.Attr прежнего источникаКогда: У сопоставления сменился Source или SourceUnitCode; цель — прежний SourceUnitCode|Source.
Перепривязать сопоставление до удаления атрибута, на который оно смотрело.
Delete LNK.Attr текущей связи→Delete LNK.Attr одноимённой связи исходного классаКогда: Цель: SourceUnitCode|ConstraintName|Source.
Порядок удаления цепочки master-detail; работает, если обе команды есть в плане.
Create / Update / Delete LNK.Attr→SetOrder LNK.AttrPosКогда: Есть хотя бы один Create или Update сопоставления; ребро от каждой команды списка связи.
Закрепить позиции после всех правок: процедуры Паруса сдвигают соседние пары. При одних удалениях SetOrder не создаётся.
Ограничения · CNS6 правил
Create CLS→Create CNSКогда: Новое ограничение класса.
Сначала создать класс.
Create MSG→Create / Update CNSКогда: MessageCode задан.
Подготовить сообщение ограничения.
Create CNS→Create CNS.AttrКогда: Добавляется атрибут ограничения.
Сначала создать ограничение.
Create CLS.Attr→Create / Update CNS.AttrКогда: Attribute называет атрибут данного класса.
Подготовить атрибут класса.
Delete CNS.Attr→Delete CLS.AttrКогда: Удаляется включение атрибута в ограничение.
Освободить атрибут от ограничения.
Create / Update / Delete CNS.Attr→SetOrder CNS.AttrPosКогда: Есть хотя бы один Create/Update; берутся все команды атрибутов ограничения.
Закрепить позиции после всех изменений.
Представления · VIW7 правил
Create CLS→Create VIWКогда: Новое представление класса.
Сначала создать класс.
Create / Update JVP (PostgreSQL) или JVW (Oracle)→Create / Update VIWКогда: CustomQuery != 1; физическое представление PARUS.ViewName.
Подготовить физическое представление. При собственном запросе CustomQuery = 1 такого ребра нет.
Create VIW→Create VIW.Param / VIW.AttrКогда: Новый параметр или атрибут представления.
Сначала создать представление класса.
Create / Update JVP или JVW→Create / Update VIW.Param / VIW.AttrКогда: Корень VIW не создаётся, CustomQuery != 1.
Если меняются только части, они сами ждут физическое представление.
Create DOM→Create / Update VIW.ParamКогда: Domain параметра задан.
Подготовить домен параметра представления.
Create CLS.Attr→Create / Update VIW.AttrКогда: Attribute указан в элементе представления.
Подготовить отображаемый атрибут класса.
Delete / Update VIW.Attr→Delete CLS.AttrКогда: Удаляется включение атрибута в представление или оно переходит на другой атрибут.
Снять включение раньше удаления прежнего атрибута.
Объекты класса · CLO4 правила
Create CLS→Create CLOКогда: Новая запись реестра объектов класса.
Сначала создать класс.
Create CLO спецификации пакета→Create CLO тела пакетаКогда: ObjectType — тело пакета; Name совпадает со спецификацией в этом классе, либо класс спецификации неизвестен ни набору, ни источнику.
Парус регистрирует тело после спецификации. Это записи реестра, а не выполнение DDL.
Create CLO спецификации пакета другого класса→Create CLO тела пакетаКогда: Спецификация с тем же Name числится в другом классе — по набору переноса, а без него по перечню источника.
Парус ищет спецификацию по имени во всём реестре, без класса.
Create CLO владельца и цели зависимости→Create / Update CLO.DepКогда: Добавляется или меняется запись Dependencies; цель задаётся UnitCode|ObjectKey.
Обе записи реестра должны существовать до записи зависимости.
Кто ссылается на класс извне10 правил
Create CLS→Create / Update APP.SecКогда: UnitCode раздела приложения.
Сначала подготовить подключаемый класс.
Create CLS→Create / Update REP.Param / REP.LinkКогда: UnitCode параметра или связи отчёта.
Подготовить класс, с которым работает отчёт.
Create CLS→Create / Update PCE.Param / PCE.LinkКогда: UnitCode параметра или связи пользовательской процедуры.
Подготовить используемый класс.
Create CLS→Create / Update UAP.Param / UAP.LinkКогда: UnitCode параметра или подключения пользовательского приложения.
Подготовить используемый раздел.
Create / Update CLS→Create / Update PRMКогда: UnitCode и/или LinkUnitCode параметра приложения.
Подготовить оба указанных класса.
Create MEC и MEC.Param→Create / Update REP.Param / PCE.Param / UAP.ParamКогда: Указаны класс и метод вызова; ребро на его параметр добавляется только при указанном имени параметра.
Сначала подготовить словарь и нужный параметр вызова.
Create MEC класса UserReports→Create / Update REP.VFКогда: ShowMethod формы отчёта задан.
Форма отчёта ссылается на вызов в специальном классе UserReports.
Create / Update MEC и MEC.Param→Create / Update PRMКогда: LinkMethod задан; для MEC.Param дополнительно задан LinkParameterName. Класс берётся из LinkUnitCode.
Подготовить адресуемый вызов и его параметр.
Update PRM→Delete MEC.Param прежней привязкиКогда: В текущем PRM задан LinkParameterName.
Обновить привязку параметра приложения до удаления прежнего параметра вызова.
Create / Update CLS→Create / Update DAT.RowКогда: Внешняя адресная ссылка строки DAT на UNITLIST по UNITCODE; ссылка не внутренняя для этого набора.
Подготовить класс перед записью адресной ссылки строки набора.
Скрипты и сохранённые зависимости Oracle4 правила
Команды SCR «до»→Команды класса и его семействаКогда: Приёмник выполняет скрипты; скрипт относится ко всему переносу или к данному объекту/вложенным корням.
Скрипт должен выполниться до команд своих объектов. Без команд этих объектов он удаляется из плана.
Команды класса и его семейства→Команды SCR «после»Когда: Та же область скрипта; When = After.
Скрипт выполняется после команд своих объектов.
Create / Update сохранённых зависимостей Oracle→Команда класса или части, которая ждёт объект OracleКогда: Команда ждёт объект Oracle по ребру без отметки «Только порядок». Этот объект (для части — её целый объект) в плане не меняется, но входит в сравниваемые объекты, и для него известны сохранённые зависимости. Цепочка прослеживается дальше через зависимости, которые в плане тоже не меняются.
Например, совпавшая процедура формы всё ещё может ждать пакет. Список конкретных целей определяется сохранёнными зависимостями БД.
Create / Update JTB.Col→Та же команда, использующая зависимость OracleКогда: Найдена зависимость на JTB; берутся реально построенные команды создания/изменения колонок этой таблицы.
Учесть подготовку колонок уже существующей таблицы.
Правила, связанные с удалением целого объекта13 правил
Эти правила порядка тоже предусмотрены, но обычный перенос не создаёт команды удаления указанных целых объектов. Поэтому сейчас они не образуют рёбер между командами плана. Они не означают, что Holkas удалит класс или другой целый объект по отсутствию в пакете.
Delete CLS.Attr→Delete CLS / LNKКогда: Класс-владелец атрибута и связь текущего RefLink.
Delete / Update ACT.Param→Delete ACT / METКогда: Своё действие и текущий LinkedFunction; у Update — прежний LinkedFunction, если он сменился или очищен.
Delete ACT.Method→Delete ACT / METКогда: Своё действие и привязанный метод.
Delete ACT.Step→Delete ACT / CLS / MECКогда: Своё действие, ShowUnitCode и ShowMethodName удаляемого шага.
Delete MET.Param→Delete METКогда: Метод-владелец и LinkedFunction текущего параметра.
Delete MEC.Param→Delete MECКогда: Свой метод вызова.
Delete MEC.Var→Delete MEC / METКогда: Свой метод вызова и InitFunction переменной.
Delete CNS.Attr→Delete CNSКогда: Своё ограничение.
Delete VIW.Param→Delete VIW / DOMКогда: Своё представление и Domain параметра.
Delete VIW.Attr→Delete VIWКогда: Своё представление.
Delete CLO.Dep→Delete CLO целиКогда: UnitCode|ObjectKey текущей зависимости.
Delete APP.Sec / REP.Param / REP.Link / PCE.Link / UAP.Link→Delete CLSКогда: UnitCode текущей ссылки. У PCE.Param и UAP.Param такого ребра на удаление класса нет.
Delete REP.Param→Delete MECКогда: Текущие UnitCode и MethodCode параметра отчёта.
Обозначения и особые случаи
- Действия команд. Create — создать, Update — изменить, Delete — удалить, SetOrder — задать порядок элементов. Запись Create / Update означает соответствующую команду из плана. Для ребра нужны обе команды; если домен уже есть и создавать его не нужно, ребра на Create DOM в плане не будет.
- Выбор и ошибки. Обычное ребро также связывает выполнение команд: если снять создание домена с выполнения, зависимое создание атрибута тоже снимается. Ошибка создания домена блокирует зависимые команды, в том числе по цепочке.
- «Только порядок». Такие рёбра тоже участвуют в сортировке, но не распространяют снятие команды или её ошибку на другую команду. Отсутствие цели такого ребра само по себе не даёт предупреждения.
- Состав переноса. Само ребро объект в набор не добавляет. Известная зависимость вне плана проверяется по приёмнику; при отсутствии её корневого объекта появляется предупреждение. Проверка известных ссылок работает и для совпавших объектов — предупреждение возможно даже при нуле команд. Как дополнить состав →
- Роли и пользователи. Они проверяются отдельно; команд их создания и соответствующих рёбер нет.
- Физическая таблица и GetProcedure. Имя TableName само по себе не задаёт универсального ребра к таблице. Для CLS действует специальное правило флагов событий выше. GetProcedure не объявляет ребро к реализации процедуры.
- Удаление и пересоздание. Нет универсального ребра «Delete старой формы → Create новой». Само удаление формы не объявляет рёбер к её привязке; снятие назначений и приложений перед удалением формы объявляют их команды.
- Цикл. Если команды требуют друг друга раньше самих себя, порядок построить нельзя: Holkas сообщает о цикле. Отсутствие ребра не доказывает, что объекты независимы по всем правилам Паруса.
Как класс хранится в файлах
Начните с каталога Class/. Имя файла — код класса: например, для класса «Заявки» с кодом Request это Request.yaml или Request.json. Дальше устройство зависит от того, куда выполнена выгрузка.
Git
YAMLClass/Request.yamlКласс и сохраняемые объекты его семейства собраны в одном файле.
В корне репозитория —.holkas со сведениями о репозитории.S3
JSON в ZIPClass/Request.jsonВ файле класса — его реквизиты, атрибуты и формы. Действия, методы и другие объекты семейства лежат в отдельных файлах.
В корне архива —manifest.json, перечисляющий сохранённые объекты. Архив устроен так же, как у «Файла пакета».Файл пакета
JSON в ZIPClass/Request.jsonВ файле класса — его реквизиты, атрибуты и формы. Действия, методы и другие объекты семейства лежат в отдельных файлах.
В корне архива —manifest.json, перечисляющий сохранённые объекты.«Файл пакета» здесь — способ выгрузки со скачиванием ZIP из Holkas. ZIP из S3 и ZIP «Файла пакета» устроены одинаково: архив, выгруженный одним способом, загружается другим.
ZIP, записанные в S3 версией Holkas 0.1.30 или более ранней, хранили всё семейство внутри Class/Request.json. Такие архивы по-прежнему читаются обоими способами. Обратное ограничение: Holkas 0.1.30 и ранее не читает новый ZIP через источник S3 и сообщает об ошибке; через «Файл пакета» читает. Обновите Holkas на принимающей стороне.
Атрибуты и визуальные формы во всех трёх вариантах находятся внутри файла класса. Описание формы, её обработчики, назначения ролям и пользователям, связи с приложениями входят в запись формы. Содержимое XML хранится в строковых полях этой записи.
Где искать действия, методы и остальные части класса
В Git имена полей начинаются с заглавной буквы: Attributes, Methods. В JSON — со строчной: attributes, methods. Слева — список в файле класса Git, справа — место в ZIP, одинаковое для S3 и «Файла пакета».
| Что ищем | В файле класса Git | В ZIP: S3 и «Файл пакета» |
|---|---|---|
| Атрибуты | Attributes | attributes в файле класса |
| Визуальные формы | VisualForms | visualForms в файле класса |
| Действия · ACT | Actions | Action/…json |
| Методы · MET | Methods | Method/…json |
| Методы вызова · MEC | MethodCalls | MethodCall/…json |
| Связи · LNK | Links | Link/…json |
| Ограничения · CNS | Constraints | Constraint/…json |
| Представления класса · VIW | Views | View/…json |
| Реестр объектов класса · CLO | Objects | ClassObject/…json |
Например, метод Request|Save находится в списке Methods файла Class/Request.yaml в Git, а в ZIP из S3 или «Файла пакета» — в отдельном файле Method/Request%7CSave.json. Здесь %7C заменяет разделитель | в имени файла. В manifest.json у метода своя строка: {"typeCode":"MET","name":"Request|Save"}.
Параметры, шаги и другие вложенные части хранятся внутри своего действия, метода или другого объекта. При чтении файла Holkas выделяет самостоятельные объекты семейства и сравнивает их отдельно: один файл в Git не означает одну команду в плане.
Домены и физические объекты БД хранятся отдельно от класса, если включены в выгрузку. Например, домен статуса — в Domain/RequestStatus.yaml в Git или Domain/RequestStatus.json в ZIP. Запись метода внутри класса описывает метод Паруса; реализующая его функция БД имеет собственный файл. Так же различаются представление класса и физическое представление БД, запись реестра объектов класса и сам объект БД.
Сравнить запись одних и тех же полей в YAML и JSON
Ниже сокращённые учебные фрагменты: код и название класса, один атрибут. Остальные поля и списки опущены. Это примеры для чтения, не готовые файлы для загрузки.
Git — Class/Request.yaml
UnitCode: Request
UnitName: Заявки
Attributes:
- ColumnName: STATUS
Caption: Статус
Kind: 0
Position: 3
Domain: RequestStatus
S3 или «Файл пакета» — Class/Request.json
{
"unitCode": "Request",
"unitName": "Заявки",
"attributes": [
{
"columnName": "STATUS",
"caption": "Статус",
"kind": 0,
"position": 3,
"domain": "RequestStatus"
}
]
}
Файл класса в S3 и «Файле пакета» одинаков. Действия, методы и другие объекты семейства в нём не лежат — у каждого свой файл, как показано выше.
Практические шаги: сохранить доработку в Git, выгрузить и загрузить файл пакета. Устройство скачиваемого ZIP и его оглавления — в справке о пакете.
Основа справки: руководство «ПАРУС-Бюджет 8. Конструктор отраслевых расширений», издание 2026, гл. 2 (классы, атрибуты, деление, методы вызова и формы); сохранённые результаты изучения КОР на Парусе от 27.08.2026; модель, сравнение, построение команд и применение Holkas 0.1.30. Страница сверена 5 ноября 2026; раздел о хранении файлов уточнён по коду 9 ноября 2026 и проверен переносом класса с VIW, ACT и MET через S3 и «Файл пакета» на PostgreSQL и Oracle. Схемы и Request — учебные примеры. Остальные разделы страницы новым прогоном переноса в БД не проверялись.