Holkas
Написать в поддержку Поддержка

Справочник / объект

Стереотип

Тип объекта в Holkas: STY

Парус · Oracle и PostgreSQL

В командной строке: --object STY:Owner · как задать состав в CLI

Стереотип связи КОР Парус 8: поля, команды, зависимости, стандартные стереотипы и хранение в Git и ZIP.

← Все объекты
На этой странице

Парус 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 и «Файла пакета».

Как читать обозначения

Ключ определяет, какую запись 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 передаётся вместе с кодом.
Пустые значения и сравнение строк

Code и Name задуманы как заполненные строки. Пустой код не является допустимым адресом объекта. При сравнении Name Holkas приравнивает null к пустой строке и не считает различием окончания строк CRLF/LF; пробелы и регистр содержимого учитываются. Успешное чтение неполного файла не означает допустимость его записи в Парус.

Если непустое Name заменить пустым или null, возникает Update STY; при применении это значение передаётся процедуре Паруса, а прежнее имя не сохраняется. Не используйте пропуск поля как просьбу «не менять»: сохраняйте оба заполненных реквизита. Числовых признаков и списков у STY нет.

Что не входит в модель

Внутренний RN, стандартный вид KIND и производитель PRODUCER не переносятся. В модели нет ни имени папки Паруса, ни полного пути, ни поиска или создания каталога в приёмнике. Stereotype/ в экспорте — каталог файлов по типу объекта.

Команды плана

Один код команды — STY, ключ — код стереотипа. Отдельной команды наименования нет; Delete и SetOrder не формируются.

STY
CreateUpdate

Создать стереотип или изменить наименование

Кода нет в приёмнике — 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 не обходит этот запрет.

Рёбра команд стереотипа

Что такое ребро и где оно видно в Holkas →

Рёбра помогают Holkas правильно отсортировать команды перед применением. Ребро связывает две команды и указывает, какая должна выполниться раньше. Например, сначала нужно создать стереотип, затем — новую связь, которая использует его код.

1 · СначалаСоздать стереотипCreate STY · Owner
→
2 · ЗатемСоздать связьCreate LNK · Request|OwnerLink
Учебный пример: StereotypeCode новой связи равен Owner. Если создавать стереотип не нужно, команды Create STY и этого ребра в плане не будет.

Непосредственно связанные правила · 4

Создание и изменение STY не ждёт других объектов. Здесь перечислены правила, в которых другие объекты ждут STY, и общие правила скриптов. Число правил не равно числу рёбер каждого плана.

Связи и наборы данных2 правила
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 снимает зависимую команду, а ошибка создания блокирует её — и для создания связи, и для её переключения на этот стереотип. Известная ссылка на стереотип проверяется отдельно по приёмнику, в том числе у совпавшей связи; сама эта зависимость не добавляет объект в перенос. Как дополнить состав — в разборе недостающих зависимостей. Правила скриптов разобраны отдельно.

Пример: существующая связь переходит на новый стереотип
1 · СначалаСоздать стереотипCreate STY · OwnerNew
→
2 · ЗатемИзменить связьUpdate LNK · Request|OwnerLink

В приёмнике связь Request|OwnerLink использует Owner, в источнике — OwnerNew, которого в приёмнике ещё нет. План содержит Create STY · OwnerNew и Update LNK · Request|OwnerLink; изменение связи ждёт создания стереотипа.

Порядок не зависит от того, в какой последовательности объекты выбраны в наборе. Если создание снято с плана или завершилось ошибкой, изменение связи тоже не выполняется, и связь остаётся с прежней ссылкой. Если связь меняет только наименование, а код стереотипа прежний, ребра к STY нет.

Как стереотип хранится в файлах

Начните с каталога Stereotype/. В каждом транспорте стереотип хранится отдельным файлом; связанные LNK не вложены в него.

Git

YAML
Stereotype/Owner.yaml

Оба реквизита в одном файле: Code и Name, с заглавной буквы.

Holkas записывает и читает стереотип в формате YAML. В корне репозитория — .holkas со сведениями о нём.

S3

JSON в ZIP
Stereotype/Owner.json

Отдельный JSON с полями code и name. STY не объединяется с файлом класса.

ZIP хранится в S3. При чтении состав берётся из manifest.json, затем читается указанный в нём файл.

Файл пакета

JSON в ZIP
Stereotype/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 и схемы — учебные примеры. Новый перенос в БД не выполнялся.