Парус 8 · Конструктор отраслевых расширений
Стереотип придаёт связи между классами дополнительный смысл. Holkas переносит запись словаря с кодом и наименованием; сама связь и соответствия её атрибутов переносятся отдельно.
STY + CodeСтереотип в КОР
Стереотип — запись словаря «Стереотипы связей». Пользовательский стереотип, например с кодом Owner и наименованием «Связь с ответственным», позволяет обозначить смысл связи. Его выбирают в настройках связи класса. Одна запись словаря может использоваться несколькими связями.
В Парусе есть и стандартные стереотипы: master–detail, связи с организациями, версиями, юридическими лицами, каталогами и родителем в иерархии. У них есть специальный вид, который использует Парус. Например, master–detail описывает связь для просмотра списка detail-класса при работе со списком master-класса.
Наименование и стандартный вид — разные свойства. Если назвать пользовательскую запись «Master-Detail», она от этого не получит стандартного поведения. В модели STY нет поля вида KIND; особенности переноса штатных записей разобраны в ограничениях.
Что входит в перенос
Выбор STY Owner не добавляет использующие его связи или классы. Раскрытие семейства класса включает его связи LNK, но не все записи словаря STY: нужные стереотипы включают отдельно либо добавляют при разборе известных недостающих зависимостей. STY хранится самостоятельно, а не внутри описания связи класса.
Справочник полей
2 поля · 1 группаВсе поля стереотипа в модели переноса. Техническое имя совпадает с Git YAML; рядом указано имя JSON для S3 и «Файла пакета».
Как читать обозначения
Наведите указатель на значок, перейдите клавишей Tab или нажмите, чтобы прочитать пояснение.
Ключ определяет, какую запись Holkas сопоставляет. Сравнивается — разница учитывается при построении команды. Допустимость записи в БД проверяет Парус.
Стереотип · STY 2 поля
CodeJSON: codeстрокаКлючМнемокод стереотипа- Назначение
- Код записи словаря, например Owner. Указывается без схемы PARUS; допустимы кириллица и пробелы. В обследованном Oracle / Парус 27.08.2026 длина кода — до 30 знаков.
- При переносе:
- Нет такого кода в приёмнике — создаётся новый стереотип. При замене Owner на OwnerNew прежний Owner сохраняется; ссылки связей автоматически не переключаются. При совпадении со штатным кодом Holkas находит существующую стандартную запись, а не создаёт отдельную пользовательскую.
NameJSON: nameстрокаСравниваетсяНаименование- Назначение
- Поясняет смысл стереотипа, например «Связь с ответственным». Это не программа и не настройка стандартного вида. В обследованном Oracle / Парус 27.08.2026 длина — до 240 знаков.
- При переносе:
- При прежнем Code изменение передаётся в Update STY: «Связь с ответственным» можно заменить на «Ответственный за запись» без создания новой записи. Ни настройки использующих его связей, ни их атрибуты эта команда не меняет. При создании Name передаётся вместе с кодом.
Команды плана
Один код команды — STY, ключ — код стереотипа. Отдельной команды наименования нет; Delete и SetOrder не формируются.
STYСоздать стереотип или изменить наименование
Кода нет в приёмнике — Create; наименование отличается — Update; реквизиты совпали — команды нет. В БД Create вызывает P_DMSLSTYPES_INSERT с кодом и наименованием. Update ищет внутренний RN по коду в DMSLSTYPES и вызывает P_DMSLSTYPES_UPDATE с найденным номером, тем же кодом и желаемым наименованием. Если запись исчезла после построения плана, обновление откажет, а не создаст её заново.
Git записывает описание в файл. S3 и «Файл пакета» формируют новый ZIP без сравнения с прежним архивом. Вызовы процедур Паруса относятся к приёмнику БД.
Ключ: Код стереотипа · пример: Owner
Пример: изменить наименование
В источнике у Owner — «Ответственный за запись», в приёмнике — «Связь с ответственным». План содержит одну Update STY · Owner. После её применения изменится наименование той же записи; переключать использующие её связи на новый код не требуется.
Если вместо Owner в описании указан OwnerNew, которого ещё нет в приёмнике, это Create STY · OwnerNew. Старый Owner останется. Для использования OwnerNew нужно отдельно изменить StereotypeCode у нужных связей.
Ограничения и решения
Стандартный вид не переносится
В обследованном Oracle / Парус 27.08.2026 штатные стереотипы имеют KIND 1–6, а процедура создания пользовательского стереотипа всегда задаёт KIND = 0. Holkas читает и записывает только Code и Name; экспорт не сохраняет KIND и PRODUCER. Например, создание записи под другим кодом с наименованием «Master-Detail» даст пользовательский стереотип, а не новую стандартную связь master–detail.
Используйте штатный стереотип, уже установленный в приёмнике, для соответствующего стандартного поведения. Если в приёмнике его нет, восстановите нужные стандартные метаданные средствами поставки Паруса: создание STY не заменяет их установку.
Код совпадает со штатной записью
Holkas сопоставляет записи по коду, без проверки происхождения. Если пользовательское описание совпало кодом с уже существующим штатным стереотипом, отдельная запись не появится: при другом Name план предложит обновить наименование найденной записи. KIND от этого не изменяется.
Например, учебное описание с Code = Master-Detail нельзя использовать как безопасный способ создать собственный стереотип. Для него выберите отдельный код решения и явно настройте использующие его связи.
Удаление в источнике не удаляет стереотип в приёмнике
Отсутствие STY в выбранном наборе не означает команду удаления. Если выбранный код удалён из базы-источника, чтение этого объекта откажет «не найден в источнике»; копия в приёмнике сохранится. Уберите отсутствующий код из набора, чтобы продолжить перенос других объектов.
Если пользовательская запись больше не нужна в приёмнике, сначала разберите использующие её связи и удалите запись средствами Паруса. В сохранённом опыте Oracle / Парус 27.08.2026 удаление стандартных стереотипов запрещено самим Парусом. Holkas не обходит этот запрет.
Существующая связь переключается на новый стереотип
Update LNK передаёт новый StereotypeCode в Парус и ждёт создания этого стереотипа, если он переносится тем же планом. Порядок выбора объектов на это не влияет. Если создание OwnerNew снято или отказало, связь не переключается и остаётся на прежнем стереотипе.
Включите новый стереотип в тот же набор либо перенесите его заранее. Без него в приёмнике Парус откажет в изменении связи: «Запись стереотипа связей классов … не определена».
Рёбра команд стереотипа
Что такое ребро и где оно видно в Holkas →
Рёбра помогают Holkas правильно отсортировать команды перед применением. Ребро связывает две команды и указывает, какая должна выполниться раньше. Например, сначала нужно создать стереотип, затем — новую связь, которая использует его код.
Create STY · OwnerCreate LNK · Request|OwnerLinkНепосредственно связанные правила · 4
Создание и изменение STY не ждёт других объектов. Здесь перечислены правила, в которых другие объекты ждут STY, и общие правила скриптов. Число правил не равно числу рёбер каждого плана.
Связи и наборы данных2 правила
Create STY→Create / Update LNKКогда: у новой связи задан StereotypeCode, а у существующей он меняется. Сначала создать запись словаря, затем записать связь с ней. Ребро ждёт именно Create STY, а не изменение наименования; связь с прежним кодом стереотипа создания STY не ждёт.
Create / Update STY→Create / Update DAT.RowКогда: ссылка-адрес в строке набора данных указывает на запись таблицы DMSLSTYPES по CODE. Ссылка должна вести за пределы таблиц самого набора. Подготовить стереотип до записи использующей его строки; строка не становится частью STY.
Скрипты автора при работе с БД2 правила
Create SCR · Before→Create / Update STYКогда: скрипт запускается до всего переноса либо до этого стереотипа. Он должен завершиться до записи STY. Без подходящих команд скрипт из плана убирается.
Create / Update STY→Create SCR · AfterКогда: та же область действия, но скрипт запускается после объектов. Сначала записать стереотип, затем выполнить скрипт.
Снятие создания STY снимает зависимую команду, а ошибка создания блокирует её — и для создания связи, и для её переключения на этот стереотип. Известная ссылка на стереотип проверяется отдельно по приёмнику, в том числе у совпавшей связи; сама эта зависимость не добавляет объект в перенос. Как дополнить состав — в разборе недостающих зависимостей. Правила скриптов разобраны отдельно.
Пример: существующая связь переходит на новый стереотип
Create STY · OwnerNewUpdate LNK · Request|OwnerLinkВ приёмнике связь Request|OwnerLink использует Owner, в источнике — OwnerNew, которого в приёмнике ещё нет. План содержит Create STY · OwnerNew и Update LNK · Request|OwnerLink; изменение связи ждёт создания стереотипа.
Порядок не зависит от того, в какой последовательности объекты выбраны в наборе. Если создание снято с плана или завершилось ошибкой, изменение связи тоже не выполняется, и связь остаётся с прежней ссылкой. Если связь меняет только наименование, а код стереотипа прежний, ребра к STY нет.
Как стереотип хранится в файлах
Начните с каталога Stereotype/. В каждом транспорте стереотип хранится отдельным файлом; связанные LNK не вложены в него.
Git
YAMLStereotype/Owner.yamlОба реквизита в одном файле: Code и Name, с заглавной буквы.
S3
JSON в ZIPStereotype/Owner.jsonОтдельный JSON с полями code и name. STY не объединяется с файлом класса.
Файл пакета
JSON в ZIPStereotype/Owner.jsonСкачиваемый ZIP содержит такой же JSON стереотипа с двумя полями. В оглавлении одна запись STY.
При загрузке Holkas сверяется с manifest.json и восстанавливает описание стереотипа.Для STY экспорт в S3 и в «Файл пакета» сохраняет одни и те же данные, и обе загрузки их восстанавливают. Это проверено для стереотипа, а не для всех типов объектов. В manifest.json он обозначен как {"typeCode":"STY","name":"Owner"}. Версия формата, СУБД и сведения об экспорте описаны в справке о пакете.
Кириллица и пробелы в коде сохраняются в имени файла. Небезопасные символы кодируются: например, / становится %2F; внутри Code значение остаётся прежним. Не переименовывайте файл отдельно от адреса объекта и записи манифеста.
Один стереотип в YAML и JSON
Полные учебные описания STY без вложенных частей. Holkas прочитал оба примера; допустимость учебного кода в конкретной базе проверяется отдельно.
Git — Stereotype/Owner.yaml
Code: Owner
Name: Связь с ответственным
S3 и «Файл пакета» — Stereotype/Owner.json
{
"code": "Owner",
"name": "Связь с ответственным"
}
В модели только два строковых реквизита: нет ни поля kind, ни списка связей. Для загрузки сохраняйте оба заполненных поля. ZIP дополнительно требует корректный manifest.json; один JSON не является готовым ZIP-пакетом.
Практические шаги: сохранить доработку в Git, выгрузить и загрузить файл пакета.
Основа справки: руководство «ПАРУС-Бюджет 8. Конструктор отраслевых расширений», издание 2026, гл. 1, с. 9 и гл. 2, с. 90; сохранённое исследование стереотипов на Oracle / Парус 27.08.2026; модель, команды, применение и файловые читатели и писатели Holkas 0.1.30. Сверено 8 ноября 2026. Owner, Request и схемы — учебные примеры. Новый перенос в БД не выполнялся.