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

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

Связь класса

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

Парус · Oracle и PostgreSQL

В командной строке: --object LNK:Request|UDO_C_REQUEST_CLIENT_FK · как задать состав в CLI. Для файла пакета в наборе должен быть и сам объект «Класс»; в Git часть запишется, если его файл там уже есть

Связи классов КОР Парус 8: стороны и соответствия атрибутов, все поля, команды и рёбра, ограничения и хранение в Git, S3 и файле пакета.

← К составу: Класс
На этой странице

Парус 8 · Конструктор отраслевых расширений

Связь описывает, как один класс обращается к другому: например, какое поле заявки хранит ссылку на клиента и какое сообщение показать при нарушении связи.

АдресLNK + UnitCode|ConstraintName
Вложенная частьСоответствия атрибутов
Удаление целой связиНе формируется

Связь в КОР

Связь принадлежит классу, в котором она описана. В терминах Паруса этот класс называется приёмником связи, а класс, к которому обращаются, — источником. В учебном примере Request («Заявки») — приёмник, Clients («Клиенты») — источник: поле Request.CLIENT_RN ссылается на Clients.RN. Эти слова обозначают стороны отношения внутри Паруса, независимо от того, между какими базами выполняется перенос Holkas.

Физическая связь описывает существующий внешний ключ между таблицами. Логическая связь описывает отношение классов без такого ключа, например участие документов в механизме связей DocLinks. Стереотип придаёт отношению дополнительный смысл: штатный Master-Detail позволяет из записи основного раздела просматривать подчинённые записи.

LNK не создаёт SQL-внешний ключ и не переносит связанные записи. Для физической связи отдельно нужен внешний ключ в описании таблицы. Обязательность заполнения задаётся ограничениями атрибутов; ForeignKey=1 сам по себе не делает поле обязательным. Текст ConstraintInit сохраняется для инструментов КОР и не выполняется как скрипт переноса.

Что входит в перенос

Собственные реквизиты принадлежат самой LNK. Единственная вложенная коллекция — AttributesLink; LNK.Attr — код команды над её элементом. Стереотип, сообщения, ограничение источника и мастер-связь остаются отдельными объектами.

Выбор класса раскрывает его семейство, включая связи. Связь адресуется отдельно как LNK · Request|UDO_C_REQUEST_CLIENT_FK; её пары загружаются вместе с ней. Ссылка на Clients, CNS, STY или MSG не означает их безусловного включения: они должны существовать в приёмнике либо быть добавлены в состав переноса. Ссылочный атрибут вида «получен по связи» находится в описании CLS, а не в AttributesLink.

Справочник полей

19 полей · 2 группы

14 реквизитов LNK, список AttributesLink и четыре поля каждой пары. Слева — имя Git YAML, рядом — имя JSON для S3 и «Файла пакета».

Как читать обозначения и правила

Ключ определяет сопоставляемую связь или пару. Сравниваемые поля могут дать Update. Поэлементный список порождает собственные команды создания, изменения и удаления.

Разница в плане не гарантирует допустимость записи: ограничения проверяет Парус. Вызовы его процедур относятся к приёмнику БД; Git сохраняет описание, а оба ZIP-транспорта создают новый архив.

Соответствие атрибутов · LNK.Attr4 поля
DestinationJSON: destinationстрокаКлючАтрибут класса-приёмника связи
Назначение
ColumnName атрибута класса UnitCode, например CLIENT_RN. Это ключ пары внутри связи.
При переносе:
Смена CLIENT_RN на OTHER_RN даёт Delete прежнего и Create нового соответствия. Атрибуты не переименовываются и не удаляются этими командами. Create ждёт создания атрибута UnitCode|Destination.
SourceJSON: sourceстрокаСравниваетсяАтрибут класса-источника связи
Назначение
ColumnName атрибута класса SourceUnitCode, например RN. Для физической связи соответствует полю ссылочного ключа.
При переносе:
При прежнем Destination изменение RN → ALT_RN даёт Update LNK.Attr, а не новое соответствие. Create и Update ждут создания нового исходного атрибута, а Update освобождает прежний до его удаления; совпавший Source рёбер не даёт. Если значение переходит от одного элемента к другому, Holkas сначала освобождает его, а обмен по кругу не переносит и называет в плане — см. «Соответствия меняются исходными атрибутами».
SourceUnitCodeJSON: sourceUnitCodeстрокаСравниваетсяКласс исходного атрибута
Назначение
Код класса, которому принадлежит Source. Для допустимого соответствия должен совпадать с SourceCode самой связи: Парус проверяет принадлежность обеих сторон.
При переносе:
Входит в ключ пары вместе с Destination: другой класс даёт Delete прежней пары и Create новой, а не Update. Пары меняют класс вместе со SourceCode связи — тогда прежние удаляются до изменения связи, новые создаются после. Перед записью Holkas заново находит класс и атрибут.
PositionJSON: positionцелоеСравниваетсяПозиция пары в связи
Назначение
Порядковое место соответствия. Для составного внешнего ключа отражает порядок колонок в foreign key и references, а не порядок команд плана.
При переносе:
Передаётся в Create / Update LNK.Attr. Процедуры Паруса при вставке и изменении сдвигают соседние пары, поэтому после команд пар SetOrder LNK.AttrPos ставит итоговые позиции из списка источника. Перестановка строк в файле без смены Position команд не даёт. Ноль не означает «оставить прежнее место»: это служебная позиция процедур Паруса; для ручной правки сохраняйте допустимые положительные позиции полного экспорта.
Null, ноль и пустой текст — разные случаи

В строковых реквизитах сравнение считает null и пустую строку равными, а CRLF и LF — одинаковыми окончаниями строк. Пробелы внутри текста и регистр значимы. Это правило сравнения, а не общая команда очистки. Исключение — ConstraintInit: его пропуск, null и пустая строка Holkas читает как пустой текст и записывает в базу именно его. У числовых ForeignKey и Rule null отличается от 0 и передаётся процедуре как отсутствие значения.

Необязательные коды STY, MSG, мастер-связи и атрибутов со значением null передаются процедуре для снятия соответствующей ссылки, если настройки Паруса это допускают. Обязательные SourceCode, Name, ForeignKey и Rule нельзя удалять из полного файла ради значения «не менять». Поля null при записи пропускаются, нули и пустые списки сохраняют.

AttributesLink — полный список, а не необязательная поправка

AttributesLink: [] задаёт отсутствие всех пар выбранной связи. Лишние пары приёмника могут получить Delete LNK.Attr. Оба ZIP в JSON отклоняют пропуск списка и null; YAML допускает получение null, что не означает работоспособный план. Сохраняйте явный полный список из экспорта.

Какие сведения Паруса не переносятся

RN, внутренние номера классов, атрибутов, сообщений и стереотипа заменяются именами и заново находятся в приёмнике. Отдельного поля STEREOTYPE_KIND в LNK нет — Парус вычисляет вид по своему стереотипу и правилам стандартных связей. Производителя задаёт приёмник.

Каталога папок у LNK нет: чтение и запись используют класс-владелец и код связи. Папки для связи не ищутся и не создаются. PathAttribute означает атрибут полного имени в иерархии, а Class/ и Link/ в примерах — каталоги файлов, не папки Паруса.

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

Три кода охватывают связь, её соответствия и их порядок. Подписи значков доступны по наведению, фокусу клавиатуры и нажатию.
Связь и соответствия атрибутов3 кода
LNK
CreateUpdate

Настройки связи класса

Создаёт отсутствующую связь или передаёт весь набор настроек изменившейся связи процедуре Паруса. UnitCode и ConstraintName существующей записи остаются адресом. Изменение только AttributesLink не требует Update корня. Смена SourceCode в Парусе удаляет прежние пары триггером, поэтому Update такой связи ждёт удаления прежних пар, а пары нового источника — его.

Ключ: Класс-приёмник связи|Код связи

LNK.Attr
CreateUpdateDelete

Соответствие атрибутов

Добавляет пару с новым ключом; при прежних SourceUnitCode и Destination меняет Source и Position; снимает пару, отсутствующую в списке источника. Create и Update заново ищут оба класса и атрибута. Delete удаляет только соответствие и может сдвинуть позиции соседних пар; сами атрибуты, связь и данные таблиц сохраняются.

Ключ: Класс-приёмник связи|Код связи|SourceUnitCode|Destination

LNK.AttrPos
SetOrder

Позиции соответствий атрибутов

Появляется, если построен хотя бы один Create / Update LNK.Attr, и ждёт все команды списка. Сначала уводит позиции связи во временный диапазон, затем прямой правкой ставит каждой паре Position из списка источника. Так пары сходятся с источником при любом порядке имён атрибутов, вставке в середину и перестановке.

Ключ: Класс-приёмник связи|Код связи

Delete целой LNK по отсутствию в источнике не строится. Итоговые позиции соответствий ставит SetOrder LNK.AttrPos после всех их команд.

Пример: изменить соответствие, сохранив атрибут назначения

В приёмнике: Destination=CLIENT_RN, Source=RN, SourceUnitCode=Clients. В полном описании из источника Source изменён на ALT_RN; остальные реквизиты и пары совпадают.

Появится Update LNK.Attr · Request|UDO_C_REQUEST_CLIENT_FK|Clients|CLIENT_RN. Сам CLIENT_RN остаётся тем же атрибутом и ключом пары. Если вместо него задан OTHER_RN, а CLIENT_RN исключён из списка, возникнут Delete прежнего соответствия и Create нового. Сами атрибуты обеих сторон этими командами не удаляются.

Это пример сопоставления, а не утверждение, что любое ALT_RN допустимо для данного внешнего ключа. Проверьте принадлежность атрибута, ограничение источника и физическую реализацию. Новый ALT_RN можно создать тем же переносом: изменение пары дождётся его.

Ограничения и что с ними делать

Описание связи есть, а физического ключа нет

ForeignKey=1 описывает связь Паруса, но LNK не выполняет ALTER TABLE. Например, перенос Request → Clients не добавит внешний ключ таблицы заявок и не поменяет его ON DELETE при смене Rule.

Включите физические таблицы и нужное ограничение в их составе либо подготовьте их отдельно. Сверьте имена ключей, пары колонок и их порядок. Для физической связи исходные атрибуты выбираются из ограничения класса-источника; обязательность обеспечивается отдельными ограничениями атрибутов. Не смешивайте отсутствие SQL-ключа с отсутствием LNK или LNK.Attr.

Нужно переключить связь на другой класс-источник

При смене SourceCode с Clients на Other триггер Паруса удаляет все прежние соответствия, а новые Парус примет только с атрибутами Other. Класс источника входит в ключ пары, поэтому в плане такая смена — замена пар, даже если Destination те же: Delete LNK.Attr · Request|UDO_C_REQUEST_CLIENT_FK|Clients|CLIENT_RN выполняется до Update LNK, Create LNK.Attr · Request|UDO_C_REQUEST_CLIENT_FK|Other|CLIENT_RN — после.

Переключение переносится одним планом, отдельными транзакциями или одной (на PostgreSQL); проверено на PostgreSQL и Oracle. Если смену связи снимете или она откажет, новые пары тоже не создаются. Использующие связь атрибуты (RefLink с RefAttribute прежнего источника) и правила КОР проверьте отдельно: такое переключение не проверялось.

Update связи использует объект, который создаётся тем же планом

Например, существующая LNK переключается на новые стереотип, сообщения и ограничение источника, и все они переносятся вместе с ней. Изменение связи ждёт создания каждой новой цели, в каком бы порядке объекты ни были выбраны. Если создание цели снято или отказало, изменение связи тоже не выполняется.

Включите новые цели в тот же набор либо перенесите их заранее. Отсутствие предупреждения не подтверждает допустимость новой привязки: её по-прежнему проверяет Парус.

Соответствие переключается на новый атрибут

При смене Source с RN на ALT_RN и прежнем Destination возникает Update LNK.Attr. Если ALT_RN создаётся тем же планом, изменение пары ждёт его создания; если RN тем же планом удаляется, удаление ждёт, пока пара его освободит. Отказ создания ALT_RN снимает изменение пары и удаление RN.

Класс нового атрибута должен совпадать с SourceCode связи; наличие колонки с тем же именем у другого класса не подходит.

Соответствия меняются исходными атрибутами

Source уникально среди соответствий связи (C_DMSCLLINKATTRS_SOUERCE_UK): Парус не даёт занять значение, пока его держит соседний элемент.

Цепочка — например, PRN ← RN, CRN ← ALT_RN сменяются на PRN ← ALT_RN, CRN ← NEW_RN. Holkas упорядочивает команды сам: сначала освобождает значение, потом занимает его. Всё проходит за один перенос.

Обмен по кругу — например, PRN: RN → ALT_RN, CRN: ALT_RN → RN. Без временного значения его не выполнить, а промежуточные значения Holkas не записывает. План в базу Паруса называет такие элементы в предупреждении и оставляет им значения приёмника; остальные правки объекта переносятся. В Git и файл обмен записывается как есть. Поменяйте значения в приёмнике вручную или в три переноса: дайте в источнике одному элементу свободное временное значение, перенесите, затем верните нужные значения и перенесите снова.

Если значение держит элемент, который в этом переносе его не меняет и не удаляется, команда получает отказ «Значение уже занято другой записью приёмника…» с именем ограничения.

Проверено на PostgreSQL и Oracle.

Прежний исходный атрибут удаляется после перепривязки

В источнике пара уже использует ALT_RN, а прежний RN исключён из атрибутов класса-источника. Update LNK.Attr освобождает RN до Delete CLS.Attr, поэтому оба изменения можно перенести одним планом.

Если перепривязка пары откажет или будет снята, удаление RN тоже не выполнится: атрибут, на который ещё смотрит пара, остаётся на месте.

Атрибуты иерархии находятся в классе-источнике

Парус ищет LevelAttribute и PathAttribute в классе SourceCode, и Holkas ждёт создания атрибутов там же. У иерархической самоссылки SourceCode и UnitCode совпадают. Атрибут полного имени бывает и у связи между разными классами: тогда он должен существовать в классе-источнике, а не в классе связи.

Нужно убрать текст инициализации

Очистите поле в файле: удалите его, запишите null или пустую строку — для Holkas это один и тот же пустой текст. План покажет один Update LNK; после применения текст в базе пуст, и повторный план пуст. Это проверено на PostgreSQL и Oracle.

Обратное тоже верно: если текст менять не нужно, сохраните его в файле из полного экспорта. Файл без поля при изменении другого реквизита связи очистит и текст. Сам текст Holkas не исполняет и между SQL-диалектами не переводит.

Нужно переименовать связь или сменить её владельца

ConstraintName и UnitCode входят в адрес Holkas. Другой код даёт другую связь, а прежняя в БД остаётся. Код связи уникален глобально в обследованном Парусе: перемена только UnitCode не обходит регистрацию с тем же кодом у другого класса.

Согласуйте новую структуру и использующие RefLink, MasterLink и соответствия отдельно. Для удаления старой целой связи нужны действия в КОР с проверкой её использования; отсутствие в снимке не команда очистки всей базы. Пустой AttributesLink, напротив, может снять все пары выбранной связи.

Связи меняются наименованиями

Name уникально среди связей класса (C_DMSCLLINKS_NOTE_UK): Парус не даёт занять наименование, пока его держит другая связь.

Цепочка — например, A: «Z1» → «Z2», B: «Z2» → «Z3». Holkas упорядочивает команды сам: сначала B освобождает «Z2», потом его получает A. Новый объект, которому нужно освобождаемое наименование, тоже ждёт. Всё проходит за один перенос, в каком бы порядке объекты ни шли в наборе.

Обмен по кругу — например, A: «Первое» → «Второе», B: «Второе» → «Первое». Без временного наименования его не выполнить, а промежуточные значения Holkas не записывает. План в базу Паруса называет такие связи в предупреждении и оставляет им наименования приёмника; остальные их правки переносятся. В Git и файл обмен записывается как есть. Поменяйте наименования в приёмнике вручную или в три переноса: дайте в источнике одному объекту свободное временное наименование, перенесите, затем верните нужные наименования и перенесите снова.

Оба объекта должны входить в перенос. Если наименование держит объект вне набора или тот, что его не меняет, команда получает отказ «Значение уже занято другой записью приёмника…» с именем ограничения.

Проверено на PostgreSQL и Oracle.

Вид связи не согласован с её настройками

Для логической связи обследованный Парус требует ForeignKey=0, отсутствие SrcConstraint и MasterLink, Rule=0. У физической связи ForeignKey=1 требует SrcConstraint. Например, сменить только ForeignKey с 1 на 0, оставив ограничение источника, нельзя.

Подготовьте согласованное описание в КОР и заново выгрузите его. Не подменяйте неизвестный код похожим значением. Совместимость релизов →

Атрибут не принадлежит стороне связи или используется дважды

Парус проверяет, что Source принадлежит SourceCode, а Destination — UnitCode. Внутри связи исходный и принимающий атрибуты уникальны каждый со своей стороны. Например, две пары с разными Destination, но одним Source=RN могут быть отклонены, хотя ключи Holkas у них различны.

Сверьте пары с ограничением источника и определением физического ключа. Не создавайте вторую пару ради изменения первой: при прежнем Destination меняются её реквизиты. Проверку принадлежности нельзя обойти заменой одного SourceUnitCode в файле.

После правки нужен определённый порядок соответствий

Position задаёт порядок колонок составного ключа. Позиции уникальны внутри связи; процедуры Паруса при вставке, изменении и удалении сдвигают соседние пары. Поэтому после команд пар Holkas выполняет SetOrder LNK.AttrPos: она ставит позиции из списка источника. При одних удалениях её нет — Парус сам уплотняет оставшиеся позиции.

Сохраняйте согласованный полный список с разными положительными позициями. Перестановка строк файла без изменения Position не меняет связь.

Штатный стереотип не подходит классам сторон

Парус проверяет классы стандартных связей и сам вычисляет STEREOTYPE_KIND. Например, одно название «Master-Detail» у пользовательского STY не придаёт ему штатного вида.

Используйте предусмотренный Парусом стереотип и допустимые для него стороны. Перенос LNK не создаёт штатную технологию и не отключает её проверки. Значения StereotypeCode и признаки иерархии должны описывать одно допустимое отношение.

Рёбра команд

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

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

СначалаCreate CLS.AttrАтрибуты Clients.RN и Request.CLIENT_RN

Оба класса и сама LNK также должны существовать.

→
ЗатемCreate LNK.AttrСоответствие RN → CLIENT_RN

Записывается пара по адресу связи и Destination.

Сначала создаются используемые атрибуты, потом соответствие между ними. Это не загрузка строк клиентов или заявок и не создание SQL-ключа таблицы.
Создание и изменение связи10 правил
Create CLS · UnitCode→Create LNK

Когда: Создаётся связь класса UnitCode.

Сначала создать класс, которому принадлежит связь.

Create CLS · SourceCode→Create / Update LNK

Когда: Задан класс-источник связи; для Update — если он меняется.

Сначала создать второй класс; при самоссылке обе ссылки ведут на один CLS.

Create CNS→Create / Update LNK

Когда: Непустой SrcConstraint: адрес SourceCode|SrcConstraint; для Update — если адрес меняется.

Зарегистрировать ограничение источника. Это ожидание корня CNS, не всех CNS.Attr и не физического SQL-ключа.

Create STY→Create / Update LNK

Когда: Непустой StereotypeCode; для Update — если код меняется.

Подготовить стереотип связи.

Create MSG · MessageCode1→Create / Update LNK

Когда: Задан код сообщения со стороны источника; для Update — если код меняется.

Сначала создать соответствующее сообщение.

Create MSG · MessageCode2→Create / Update LNK

Когда: Задан код сообщения со стороны приёмника; для Update — если код меняется.

Это независимая ссылка на второе сообщение.

Create LNK · MasterLink→Create / Update LNK

Когда: Непустой MasterLink: адрес UnitCode|MasterLink; для Update — если он меняется.

Подготовить мастер-связь того же класса.

Create CLS.Attr · SourceCode|LevelAttribute→Create / Update LNK

Когда: Непустой LevelAttribute; для Update — если он меняется.

Процедура Паруса ищет атрибут уровня в классе-источнике связи.

Create CLS.Attr · SourceCode|PathAttribute→Create / Update LNK

Когда: Непустой PathAttribute; для Update — если он меняется.

Атрибут полного имени тоже ищется в классе-источнике, в том числе когда классы сторон разные.

Update LNK, отдающая Name→Create / Update LNK, занимающая Name

Когда: LNK получает непустое Name, которое в приёмнике держит другая связь того же класса, и в этом же переносе своё Name меняет. Оба объекта входят в набор. Для обмена по кругу ребро не ставится.

Сначала освободить наименование, потом занять: C_DMSCLLINKS_NOTE_UK не допускает двух одинаковых, и цепочка переименований проходит за один перенос в любом порядке набора. Если наименование держит объект вне набора или тот, что его не меняет, Парус откажет «Значение уже занято».

Создание и снятие соответствий10 правил
Create LNK→Create LNK.Attr

Когда: Добавляется соответствие в AttributesLink.

Сначала создать саму связь. Update LNK этим правилом не ожидается — его ждёт пара при смене источника (правило ниже).

Delete LNK.Attr · прежний SourceUnitCode→Update LNK

Когда: Update LNK меняет SourceCode.

Снять прежние пары до смены источника: иначе их удалит триггер Паруса, и Delete не найдёт строку.

Update LNK→Create LNK.Attr · новый SourceUnitCode

Когда: Update LNK меняет SourceCode.

Парус принимает в пару только атрибут текущего источника связи, поэтому новые пары создаются после смены.

Create CLS.Attr · SourceUnitCode|Source→Create / Update LNK.Attr

Когда: Создаётся пара атрибутов; для Update — если меняется Source.

Подготовить исходный атрибут в его классе: процедура Паруса ищет его по коду.

Create CLS.Attr · UnitCode|Destination→Create LNK.Attr

Когда: Создаётся пара атрибутов.

Подготовить атрибут класса, в котором описана связь.

Delete / Update LNK.Attr→Delete CLS.Attr · прежний SourceUnitCode|Source

Когда: Удаляется соответствие со ссылкой на исходный атрибут; для Update — если меняется Source.

Снять ссылку перед удалением исходного атрибута: удалить атрибут, на который смотрит пара, не даёт внешний ключ.

Delete LNK.Attr→Delete CLS.Attr · UnitCode|Destination

Когда: Удаляется соответствие со ссылкой на атрибут владельца.

Сначала освободить атрибут класса-приёмника связи.

Delete LNK.Attr · текущая пара→Delete LNK.Attr · пара связи SourceUnitCode|ConstraintName с Destination = Source

Когда: На исходном классе есть удаляемая пара в одноимённой связи, и эта связь есть в наборе: класс источника её пары, часть ключа, знает только она.

Снятие пары текущей связи выполняется раньше соответствующей пары следующего звена цепочки. Само наличие ребра не добавляет вторую команду Delete.

Create / Update / Delete LNK.Attr→SetOrder LNK.AttrPos

Когда: Есть хотя бы один Create или Update соответствия; ребро от каждой команды списка этой связи.

Закрепить позиции после всех правок. При одних удалениях SetOrder не создаётся.

Update LNK.Attr, отдающий Source→Update LNK.Attr, занимающий Source

Когда: Соответствие переключается на исходный атрибут, который в приёмнике занят другим соответствием этой связи, и то в этом же переносе свой Source меняет. Для обмена по кругу ребро не ставится.

Сначала освободить значение, потом занять: цепочка проходит за один перенос.

Использующие связь атрибуты4 правила
Create LNK.Attr→Create / Update CLS.Attr

Когда: RefLink задан, LNK есть в переносимом наборе; берутся пары, у которых Destination не равен ColumnName этого атрибута.

Подготовить соответствия, исключив ожидание собственного атрибута, которое дало бы цикл.

Create CLS.Attr · SourceCode|RefAttribute→Create / Update CLS.Attr

Когда: RefLink и RefAttribute заданы, описание LNK есть в наборе.

Подготовить читаемый по связи атрибут. Класс берётся из LNK.SourceCode, не из базы-источника переноса.

Delete CLS.Attr→Delete LNK

Когда: Удаляется атрибут с прежним RefLink.

Ребро описывает освобождение связи, но обычный перенос не создаёт Delete целой LNK. Это правило не добавляет удаление связи в план.

Скрипты автора2 правила
SCR Before→LNK / LNK.Attr / LNK.AttrPos

Когда: Приёмник исполняет скрипты; область охватывает эту связь, её класс либо весь перенос.

Скрипт выполняется до охватываемых команд. ConstraintInit сам по себе таким скриптом не является.

LNK / LNK.Attr / LNK.AttrPos→SCR After

Когда: Та же область, время After.

Скрипт выполняется после команд связи. Без охватываемых команд скрипт в плане не остаётся.

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

Update LNK передаёт в Парус все ссылки связи, но ждёт только сменившиеся: новые StereotypeCode, MessageCode1, MessageCode2, SrcConstraint, MasterLink, LevelAttribute, PathAttribute и SourceCode. Прежние цели уже есть в приёмнике, ребра к ним нет. Класс UnitCode — часть адреса связи, у Update он не меняется.

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

Что эти рёбра обеспечивают и где есть пробелы

Каталог охватывает LNK, LNK.Attr, непосредственно использующие связь атрибуты и общие скрипты: 24 правила, а не 24 ребра в любом плане. У LNK нет подключения к универсальному словарю ObjectTables для строк DAT и нет анализа SQL из ConstraintInit. Команда создания существующей цели не нужна; ожидание Create не означает ожидания её Update или всех частей.

Update LNK ждёт только те ссылки, которые меняет: совпавшая цель уже есть в приёмнике. Снятие или отказ создания новой цели снимает и это изменение. Update LNK.Attr со сменившимся источником ждёт создания нового атрибута и освобождает прежний до его удаления; снятие или отказ создания снимает изменение пары, а с ним и удаление прежнего атрибута.

Удаления соответствий выпускаются перед изменениями и созданиями, с конца текущего списка. Это исходная очередность, а не ребро между каждой парой. При смене источника порядок задают рёбра: прежние пары удаляются до Update LNK, новые создаются после него. При обычных зависимостях снятие или отказ предшественника влияет на зависимые команды; существование нужной ссылки в базе и полнота графа — разные вопросы.

Как разобрать недостающие зависимости →

Как связь хранится в файлах

Для учебной связи Request|UDO_C_REQUEST_CLIENT_FK Git использует файл класса. S3 и «Файл пакета» пишут одинаковый отдельный JSON. Соответствия всегда находятся внутри своей LNK; отдельного файла для LNK.Attr нет.

Git

YAML
Class/Request.yaml

В списке Links находятся реквизиты связи и вложенный AttributesLink. Имена полей начинаются с заглавной буквы.

При чтении LNK выделяется из файла класса. При выгрузке одной LNK без CLS Git подмешивает существующий класс репозитория; если его и команды создания нет, отказывает. В корне репозитория — .holkas.

S3

JSON в ZIP
Link/Request%7CUDO_C_REQUEST_CLIENT_FK.json

Отдельная LNK с реквизитами и attributesLink, как у «Файла пакета». Оглавление перечисляет LNK и имя Request|UDO_C_REQUEST_CLIENT_FK.

Одиночная LNK без CLS сохраняется и читается обратно.

Файл пакета

JSON в ZIP
Link/Request%7CUDO_C_REQUEST_CLIENT_FK.json

Отдельная LNK с реквизитами и attributesLink. Оглавление перечисляет LNK и имя Request|UDO_C_REQUEST_CLIENT_FK.

При чтении файл находится по типу и имени. CLS может лежать отдельно; LNK читается и без него. В имени файла | заменён на %7C, внутри данных разделитель обычный.

ZIP из S3 и «Файла пакета» устроены одинаково, архив одного способа загружается другим. ZIP, записанные в S3 версией Holkas 0.1.30 или более ранней, хранили связь в списке links внутри Class/Request.json; такие архивы по-прежнему читаются обоими способами.

Полный файл выбранного CLS собирается из выгружаемого семейства заново: если связи в нём нет, её не будет в Links файлового снимка. Последующая загрузка такого снимка в БД не удалит прежнюю целую LNK. При выгрузке одиночной LNK Git сохраняет остальные объекты существующего файла класса. Новый ZIP содержит только выгружаемый состав.

Классы другой стороны, стереотипы, сообщения, ограничения и физические таблицы имеют собственные записи или файлы по правилам своих типов. Они не вкладываются в LNK вместе с кодами ссылок. В старых файлах встречаются вложенные StereotypeObject и MessageObject; сейчас здесь сохраняются только коды.

Одна связь в YAML и JSON

Сокращённые учебные фрагменты, не готовые файлы для загрузки. Остальные сведения класса и другие связи опущены; показанные две пары образуют условный составной ключ. Пустые списки не служат обозначением опущенных частей.

Git — внутри Class/Request.yaml:

UnitCode: Request
Links:
  - UnitCode: Request
    ConstraintName: UDO_C_REQUEST_CLIENT_FK
    SourceCode: Clients
    ForeignKey: 1
    SrcConstraint: UDO_C_CLIENTS_PK
    Name: Связь с клиентом
    Rule: 0
    ConstraintInit: ''
    AttributesLink:
      - Destination: CLIENT_RN
        Source: RN
        SourceUnitCode: Clients
        Position: 1
      - Destination: CLIENT_COMPANY
        Source: COMPANY
        SourceUnitCode: Clients
        Position: 2

S3 или «Файл пакета» — Link/Request%7CUDO_C_REQUEST_CLIENT_FK.json:

{
  "unitCode": "Request",
  "constraintName": "UDO_C_REQUEST_CLIENT_FK",
  "sourceCode": "Clients",
  "foreignKey": 1,
  "srcConstraint": "UDO_C_CLIENTS_PK",
  "name": "Связь с клиентом",
  "rule": 0,
  "constraintInit": "",
  "attributesLink": [
    { "destination": "CLIENT_RN", "source": "RN", "sourceUnitCode": "Clients", "position": 1 },
    { "destination": "CLIENT_COMPANY", "source": "COMPANY", "sourceUnitCode": "Clients", "position": 2 }
  ]
}

При записи null опускается, но сохраняются нули, пустой текст и attributesLink: []. Для ручной правки берите полный экспорт: удаление пары из списка может дать Delete LNK.Attr.

Практические шаги: сохранить доработку в Git, выгрузить и загрузить файл пакета. Оглавление ZIP — в справке о пакете.

Основа справки: руководство «ПАРУС-Бюджет 8. Конструктор отраслевых расширений», издание 2026, с. 85–90, 112–113; прежнее исследование связи, словарного выбора и сообщений на Oracle / Парус 27.08.2026 / Holkas 0.1.26; текущие DTO, команды, исполнители и файловые адаптеры Holkas 0.1.30; чтение процедур и ограничений PostgreSQL / Парус 27.08.2026. Сверено 8 ноября 2026; хранение в ZIP уточнено по коду 9 ноября 2026. Request, Clients и схемы — учебные примеры. Новый перенос в БД и новая проверка клиентов Паруса не выполнялись; Oracle заново не проверялся.