Парус 8 · Конструктор отраслевых расширений
Метод вызова определяет, как открыть раздел: обычным списком, со спецификациями или как словарь с отбором и возвратом выбранного значения.
MEC:Класс|Код вызоваМетод вызова в КОР
Метод вызова описывает способ открытия раздела и передачи контекста. Например, «Заявки» из меню показывают полный раздел со спецификациями, а то же окно как словарь позволяет выбрать заявку, позиционируясь по переданному номеру. Параметры задают значения для позиционирования, отбора и возврата результата; локальные переменные хранят значения, нужные этому вызову.
В интерфейсе Паруса это «Методы вызова класса». Заголовок справочника «Вызов метода» соответствует типу MEC Holkas. Метод MET описывает операцию и её реализацию; MEC описывает открытие раздела. У MEC нет обязательной ссылки на одноимённый MET. Функция-метод может использоваться для инициализации отдельной переменной.
MEC принадлежит классу, но имеет отдельный адрес, например MEC:Request|main. Выбор класса раскрывает доступное семейство источника. Параметры и переменные загружаются вместе с MEC; его выбор сам по себе не включает все формы, домены, пиктограммы и представления. Перенос сохраняет описание, а не открывает раздел в клиенте.
Что входит в перенос
Справочник полей
27 полей · 3 группыВсе 9 реквизитов и 2 коллекции вызова, 8 полей параметра и 8 полей переменной. Git YAML использует имена с заглавной буквы; рядом точное имя JSON обоих ZIP.
Как читать обозначения и правила
Наведите указатель, перейдите к значку клавишей Tab или нажмите его для пояснения.
Часть ключа задаёт адрес MEC, Ключ узнаёт запись внутри коллекции, Сравнивается учитывает разницу в плане, По элементам проверяет список по записям.
Create создаёт, Update меняет, Delete удаляет. Команда передаёт настройки соответствующей записи; наличие разницы не гарантирует допустимость записи в Парусе. При смене InCode или OutCode Update параметра отклоняется целиком.
Реквизиты вызова · MEC11 полей
UnitCodeJSON: unitCodeстрокаЧасть ключаКласс-владелец- Назначение
- Код класса Паруса, например Request. Вместе с Code определяет адрес вызова.
- При переносе:
- Находит класс по коду. При создании ждёт Create CLS. Другой UnitCode адресует вызов другого класса; прежний автоматически не удаляется.
CodeJSON: codeстрокаЧасть ключаКод метода вызова- Назначение
- Мнемокод способа открытия раздела, например main. Это не код метода MET.
- При переносе:
- Смена main на dictionary описывает другой MEC. Если его нет, создаётся новый; прежний остаётся. Формы, шаги и другие потребители сами на новый код не переключаются.
NameJSON: nameстрокаСравниваетсяНаименование вызова- Назначение
- Подпись для человека, например «Заявки списком».
- При переносе:
- Разница даёт Update MEC, а не переименование адреса. В обследованном Парусе наименование непустое и уникально среди вызовов класса. Если наименование переходит к другому вызову этого класса, Holkas сначала освобождает его, а обмен по кругу не переносит и называет в плане — см. «Вызовы меняются наименованиями».
UseForLinksJSON: useForLinksцелое / nullСравниваетсяПоказ через связи документов- Назначение
- 1 — использовать этот вызов для отображения через связи документов; 0 — не назначать его для этой роли.
- При переносе:
- Create / Update MEC передаёт признак в Парус. В одном классе только один вызов может иметь 1 для этой роли. Когда роль переходит к другому вызову, Holkas сначала снимает её с прежнего, затем назначает новому (ребро).
UseForViewJSON: useForViewцелое / nullСравниваетсяПоказ по умолчанию- Назначение
- 1 — использовать для отображения по умолчанию; 0 — не назначать для этой роли.
- При переносе:
- Сравнивается отдельно от двух других признаков. Парус отклоняет назначение второго вызова с 1, поэтому при передаче назначения план снимает признак у прежнего вызова раньше, чем ставит новому (ребро).
UseForDictionaryJSON: useForDictionaryцелое / nullСравниваетсяПоказ в качестве словаря- Назначение
- 1 — использовать по умолчанию при открытии как словаря; 0 — не назначать для этой роли.
- При переносе:
- Передаётся при Create / Update MEC. Парус разрешает только один такой вызов у класса; при передаче признака план снимает его у прежнего вызова раньше (ребро). Это не запрет явно использовать другой вызов в настройках конкретного словарного поля.
SysImageJSON: sysImageстрока / nullСравниваетсяПиктограмма- Назначение
- Код PIC, используемый для оформления вызова. Не сами байты картинки.
- При переносе:
- Передаётся процедуре Паруса, которая ищет пиктограмму по коду. Непустой код ждёт Create PIC; если пиктограммы нет ни в наборе, ни в приёмнике, план называет её недостающей зависимостью. null передаётся как пустая ссылка, а не «сохранить прежнюю».
CondTypeJSON: condTypeцелоеСравниваетсяТип условий отбора- Назначение
- 0 — «Клиент», 1 — «Сервер». Режим определяет обработку условий при работе раздела.
- При переносе:
- Разница даёт Update MEC. При 1 Holkas читает ConditionParams/@ConditionProcedure из Settings и считает процедуру БД зависимостью. При 0 этой зависимости нет. Смена числа не создаёт процедуру и не дописывает настройки за пользователя.
SettingsJSON: settingsстрока / nullСравниваетсяНастройки источников данных- Назначение
- XML, описывающий источники, параметры, отображение и условия отбора вызова. Формы класса хранятся отдельно в CLS.
- При переносе:
- Записывается целиком внутри команды MEC. При Update изменившийся null очищает настройки; при Create null не записывается отдельно, в том числе если Парус уже создал вызов. Синтаксическая ошибка XML даёт предупреждение, но не исключает команду. Источники данных XML (DataSource, TreeSource, CrossSource) дают ребро на представление класса UnitCode|ViewName; остальные ссылки внутри XML не проверяются.
ParametersJSON: parametersсписокПо элементамПараметры вызова- Назначение
- Передаваемые значения для позиционирования, отбора и возврата результата выбора. Каждый элемент узнаётся по Name внутри MEC.
- При переносе:
- Новые, изменённые и отсутствующие элементы дают Create / Update / Delete MEC.Param. [] означает удалить прежние параметры. Перестановка строк массива сама по себе ничего не меняет; SetOrder нет.
LocalVariablesJSON: localVariablesсписокПо элементамЛокальные переменные- Назначение
- Именованные значения для работы этого вызова. У каждой свой домен и способ инициализации.
- При переносе:
- Сопоставляются по Name. [] означает удалить прежние переменные; изменение одной переменной даёт MEC.Var и не требует Update MEC. Позиции и SetOrder отсутствуют.
Параметр вызова · MEC.Param8 полей
NameJSON: nameстрокаКлючНаименование параметра- Назначение
- Имя записи, например «Идентификатор» или «Мнемокод». Может быть подписью на русском; не путать с техническими InCode и OutCode.
- При переносе:
- Holkas находит запись по Name внутри вызова. Смена имени с исключением старой записи из списка даёт Delete и Create. Ссылки DepParameter используют именно это имя; их нужно обновить вместе с переименованием.
InCodeJSON: inCodeстрокаСравниваетсяВходной код- Назначение
- Техническое имя входного значения, например IN_RN. Вызывающая сторона передаёт значение по этому коду.
- При переносе:
- Задаётся при создании. Разница даёт Update MEC.Param, но при применении в БД Holkas отклоняет всю команду до записи, включая прочие изменения параметра. Отличие только в записи (CRLF или LF) изменением не считается. Автоматического пересоздания нет.
OutCodeJSON: outCodeстрокаСравниваетсяВыходной код- Назначение
- Техническое имя возвращаемого значения, например OUT_RN. Для конструкторской записи отличается от входного кода.
- При переносе:
- Задаётся при создании; изменение существующего OutCode отклоняет Update MEC.Param целиком. Правка имени Name и правка выходного кода имеют разные последствия.
AttributeJSON: attributeстрока / nullСравниваетсяСвязанный атрибут класса- Назначение
- ColumnName атрибута того же UnitCode, например RN. Это имя поля класса, не его подпись.
- При переносе:
- Create / Update ждут Create CLS.Attr. Delete и Update параметра освобождают прежний атрибут перед его удалением. В частности, RN → ID даёт Update параметра между созданием ID и удалением RN. Пустая ссылка передаётся в Парус.
DataTypeJSON: dataTypeцелоеСравниваетсяТип передаваемого значения- Назначение
- 0 — строка, 1 — дата, 2 — число. Это словарь TPARAM_DATA_TYPE; коды не совпадают с DataType домена.
- При переносе:
- Передаётся при создании и изменении параметра. Парус проверяет допустимость записи. Например, для числового идентификатора RN нужен 2, а не код 1, используемый для числа в DOM.
DirectSqlJSON: directSqlстрока / nullСравниваетсяПрямой запрос- Назначение
- SQL-текст прямого преобразования значения параметра при работе вызова.
- При переносе:
- Сравнивается как текст и передаётся процедуре Паруса. Парус формирует служебный преобразованный запрос; Holkas не хранит его отдельным полем и не переводит исходный SQL в другую СУБД. null не означает сохранение прежнего текста.
BackSqlJSON: backSqlстрока / nullСравниваетсяОбратный запрос- Назначение
- SQL-текст обратного преобразования значения параметра. Задаётся отдельно от DirectSql.
- При переносе:
- Разница даёт Update MEC.Param. Парус заново обрабатывает запрос при записи; ссылки на объекты внутри произвольного SQL не становятся автоматически рёбрами Holkas.
DepParameterJSON: depParameterстрока / nullСравниваетсяВедущий параметр- Назначение
- Name другого параметра этого же вызова. Например, параметр подразделения зависит от выбранной организации.
- При переносе:
- Create / Update ждёт Create или Update ведущего; изменение или удаление зависимого выполняется перед Delete прежнего ведущего. При создании связь задаётся дополнительным вызовом UPDATE внутри той же команды. null или пустая строка снимает связь. Снимки до появления этого поля не содержат сохранённой зависимости.
Локальная переменная · MEC.Var8 полей
NameJSON: nameстрокаКлючИмя переменной- Назначение
- Имя внутри вызова, например NLIMIT. В обследованном Парусе сохраняется в верхнем регистре.
- При переносе:
- Сопоставляется по Name. Переименование NLIMIT в NMAX с удалением прежней записи даёт Delete и Create. Упоминания имени в настройках и привязках других частей сами не переписываются.
DomainJSON: domainстрокаСравниваетсяДомен переменной- Назначение
- Код DOM, определяющий тип значения, например TNUMBER или TSTR0020.
- При переносе:
- Обязателен; Create / Update MEC.Var ждут Create DOM. При записи Парус находит домен по коду и нормализует поля констант по его типу. Это не объявление SQL-переменной при переносе.
InitTypeJSON: initTypeцелоеСравниваетсяСпособ инициализации- Назначение
- 0 — без источника; 1 — значение; 2 — функция; 3 — параметр метода вызова. Нужные поля приведены ниже.
- При переносе:
- Передаётся вместе со всеми остальными реквизитами переменной. При смене способа очистите поля прежнего источника: Парус проверяет их взаимную исключаемость. Например, при переходе 1 → 2 уберите DefaultNumber и заполните InitFunction.
DefaultStringJSON: defaultStringстрока / nullСравниваетсяНачальное значение: строка- Назначение
- Строковая константа при InitType=1 и строковом домене.
- При переносе:
- Передаётся вместе с DefaultNumber и DefaultDate. Парус очищает неподходящие типу поля; для значения должно остаться ровно одно непустое поле. Пустая строка не означает «сохранить прежнее».
DefaultNumberJSON: defaultNumberдесятичное / nullСравниваетсяНачальное значение: число или время- Назначение
- Числовая константа при InitType=1; для домена времени используется то же поле. Может быть дробным.
- При переносе:
- 0 — настоящее значение. Сравнивается и записывается без округления: разница 1.75 и 1.25 даёт Update MEC.Var.
DefaultDateJSON: defaultDateдата и время / nullСравниваетсяНачальное значение: дата- Назначение
- Дата при InitType=1 и домене даты.
- При переносе:
- Передаётся в Парус без переноса клиентского часового пояса. При другом типе домена процедура очищает поле. Разница даёт Update MEC.Var.
InitFunctionJSON: initFunctionстрока / nullСравниваетсяФункция инициализации- Назначение
- Code функции-метода MET того же класса при InitType=2. Не имя физической функции БД.
- При переносе:
- Create / Update MEC.Var ждут Create MET; Парус ищет метод-функцию класса по коду. Например, Value указывает на MET Request|Value. Реализация БД переносится по правилам MET; сам перенос MEC функцию не запускает.
SmParameterJSON: smParameterстрока / nullСравниваетсяПараметр для инициализации- Назначение
- Строковая привязка к параметру метода вызова при InitType=3. Отличается от DepParameter: это источник значения переменной, а не ведущий параметр другой записи.
- При переносе:
- Записывается как строка sm_parameter; Holkas не ищет RN параметра и не создаёт ребро к MEC.Param. Сохраняйте значение полного экспорта и согласуйте его с настройками вызова. Наличие непустой строки не подтверждает правильность привязки при работе клиента.
Команды плана
У вызова три кода команд. Подписи действий доступны по наведению, клавиатурой и касанием; без JavaScript остаются текстовые обозначения. Отдельного поиска для трёх карточек нет.
Вызов, параметры и переменные3 кода
MECМетод вызова
Создаёт вызов или обновляет его наименование, признаки, пиктограмму и тип условий; Settings при необходимости записывается отдельно внутри той же команды. Если создание класса уже завело этот вызов, Create MEC переходит к исправлению найденной записи. Изменение только списков не требует Update MEC.
Ключ: Класс|Код вызова
MEC.ParamПараметр вызова
Добавляет запись, меняет свойства при прежнем Name или удаляет лишнюю. При попытке изменить InCode либо OutCode Holkas при применении в БД отклоняет Update целиком, ничего не записав. У Create с DepParameter установка связи входит в ту же команду, но не становится отдельной строкой плана.
Ключ: Класс|Код вызова|Name параметра
MEC.VarЛокальная переменная
Добавляет, меняет или удаляет одну переменную. Домен и функция находятся по кодам в приёмнике; строка SmParameter передаётся без поиска RN. Изменение InitType само не очищает поля прежнего источника в переносимом описании.
Ключ: Класс|Код вызова|Name переменной
Сам MEC по отсутствию в источнике не удаляется. Параметры и переменные — части вызова, не самостоятельные объекты каталога. В Git команды меняют описание; приёмник БД вызывает процедуры Паруса; S3 и «Файл пакета» создают новый ZIP.
Пример: параметр переходит на другой атрибут
У Request|main параметр с Name «Идентификатор», InCode=IN_RN, OutCode=OUT_RN и DataType=2 переходит с Attribute=RN на ID. Полный CLS из источника содержит новый ID вместо RN; остальные свойства вызова совпадают.
Create CLS.Attr · Request|IDподготавливает новый атрибут.Update MEC.Param · Request|main|Идентификаторменяет ссылку, сохраняя коды параметра.Delete CLS.Attr · Request|RNудаляет освобождённый атрибут.
Рёбра MEC задают этот порядок. Команды класса могут дополнительно включать закрепление позиций его атрибутов; у самого вызова и его списков SetOrder нет. Если RN используют и другие части, их ссылки тоже нужно согласовать.
Ограничения и решения
Нужно изменить входной или выходной код
При прежнем Name смена IN_RN на IN_ID даёт Update MEC.Param, который Holkas при применении в БД отклоняет целиком. Одновременное изменение Attribute тоже не запишется этой командой. Успех правки Git-файла не подтверждает допустимость применения в Парусе.
Подготовьте замену параметра средствами КОР с учётом всех потребителей. Новый Name в файле означает Delete старого и Create нового, но ссылки форм, шагов, ведущих и системных параметров автоматически не переключаются. Если входная/выходная пара занята старой записью или старая запись используется, простое добавление замены может быть недопустимо.
Ведущий параметр и старые снимки
DepParameter — имя ведущего внутри того же вызова. При снятии связи Holkas сначала обновляет зависимого, затем удаляет прежнего ведущего. Например, для «Подразделение» → «Организация» сначала очистите DepParameter подразделения; не оставляйте ссылку на исключённую из списка организацию.
В старых пакетах и Git-снимках до добавления этого поля связи нет. Повторно выгрузите вызов из базы, чтобы сохранить её: применение старого снимка может показать снятие зависимости. Не используйте пропуск поля как просьбу сохранить значение приёмника. В обследованном Парусе удаление ведущей строки может каскадно удалить зависимые; полный список и рёбра освобождения существенны.
Передать признак использования другому вызову
В пределах класса каждый из признаков UseForLinks, UseForView и UseForDictionary может быть включён только у одного вызова. Роли независимы: один MEC может иметь все три, либо роли могут принадлежать разным вызовам.
Перенесите оба вызова в одном наборе — проще всего вместе с классом. План сначала снимает признак у прежнего вызова, затем ставит новому или создаёт новый вызов с ним, в каком бы порядке вызовы ни пришли. Проверено переносом на PostgreSQL и Oracle. Если в наборе только новый владелец, а прежний в приёмнике держит признак, Парус откажет: добавьте прежний вызов в набор.
Обмен разными признаками за один перенос (у A был UseForView и он получает UseForLinks, у B — наоборот) план построить не может: каждый вызов ждёт другого, и Holkas сообщает о цикле. Перенесите в два шага: сначала снимите признаки в источнике и перенесите, затем назначьте новые.
XML источника сохранён, а нужного представления нет
Settings переносится целиком. Holkas читает в нём источники данных и ждёт названные представления класса. Парус настройки не проверяет, поэтому перенос пройдёт и без представления, а ошибка появится при открытии раздела. Если VIW нет ни в наборе, ни в приёмнике, план предупреждает; если она есть в источнике, перестроение добавит её — как дополнить перенос.
Правильный XML не доказывает наличие всех названных объектов. Неверный XML вызывает предупреждение и остаётся в плане; если ссылки невозможно прочитать, отсутствие рёбер не означает отсутствия зависимостей. Текст SQL внутри параметров Holkas не переводит между Oracle и PostgreSQL.
Новая пиктограмма ещё не создана
MEC.SysImage ждёт Create PIC. Если пиктограммы нет в приёмнике и она не выбрана, план называет её недостающей зависимостью; после добавления в набор она запишется раньше вызова. Без неё Парус отказывает в записи: «Пиктограмма … не определена».
Дробное начальное значение переменной
DefaultNumber переносится с дробной частью на обеих СУБД, без округления.
Штатный вызов, UserDefinedMethod и релиз Паруса
Стандартные вызовы создаются разработчиками Паруса; допустимость изменения их реквизитов определяет технология записи. Служебный UserDefinedMethod Парус создаёт при создании класса. Текущий Holkas его не пропускает: Create при обнаружении готовой строки выполняет Update. Не назначайте ему произвольные признаки и CondType: обследованный Парус требует нули для трёх UseFor… и клиентские условия.
При создании нового MEC с 24.12.2025 Holkas вызывает P_DMSCLCALLMETHODS_INSERT с пустым dup_rn; раньше — вариант INSERT_ADV. Дублирование чужого состава не запрашивается. Параметры и переменные переносятся собственными командами. Сверяйтесь с проверенными релизами; новый прогон БД и клиента при подготовке страницы не выполнялся.
Вызовы меняются наименованиями
Name уникально среди вызовов класса (C_UNIT_SHOWMETHODS_NAME_UK): Парус не даёт занять наименование, пока его держит другой вызов.
Цепочка — например, A: «Z1» → «Z2», B: «Z2» → «Z3». Holkas упорядочивает команды сам: сначала B освобождает «Z2», потом его получает A. Новый объект, которому нужно освобождаемое наименование, тоже ждёт. Всё проходит за один перенос, в каком бы порядке объекты ни шли в наборе.
Обмен по кругу — например, A: «Первое» → «Второе», B: «Второе» → «Первое». Без временного наименования его не выполнить, а промежуточные значения Holkas не записывает. План в базу Паруса называет такие вызовы в предупреждении и оставляет им наименования приёмника; остальные их правки переносятся. В Git и файл обмен записывается как есть. Поменяйте наименования в приёмнике вручную или в три переноса: дайте в источнике одному объекту свободное временное наименование, перенесите, затем верните нужные наименования и перенесите снова.
Оба объекта должны входить в перенос. Если наименование держит объект вне набора или тот, что его не меняет, команда получает отказ «Значение уже занято другой записью приёмника…» с именем ограничения.
Проверено на PostgreSQL и Oracle.
Рёбра команд
Что такое ребро и где оно видно в Holkas →
Рёбра помогают Holkas правильно отсортировать команды перед применением. Ребро связывает две команды и указывает, какая должна выполниться раньше.
Create CLS.Attr · Request|IDUpdate MEC.ParamКаталог охватывает MEC и его части, прямых потребителей, процедуру условий и общие правила плана. 35 строк — правила, а не количество рёбер каждого плана. Из XML настроек разбираются процедура условий и представления источников; вложенные ссылки произвольного SQL и остальной XML этим каталогом не объявляются проверенными.
Класс, пиктограмма, процедура условий и источники данных7 правил
Create CLS→Create MECКогда: Создаётся вызов класса UnitCode.
Сначала подготовить класс. Update MEC не ждёт Update CLS этим правилом.
Create PIC→Create / Update MECКогда: SysImage непустой.
Парус принимает пиктограмму кодом и записывает вызов только с существующей. Update PIC здесь не ожидается.
Create / Update JPR→Create / Update MECКогда: Oracle; CondType=1, в Settings прочитан ConditionParams/@ConditionProcedure.
Сначала подготовить процедуру серверных условий. Без схемы используется PARUS; адрес приводится к верхнему регистру.
Create / Update JFP или JPP→Create / Update MECКогда: PostgreSQL; то же условие серверного отбора.
Функция и настоящая процедура — альтернативные типы цели. Без схемы используется parus; адрес приводится к нижнему регистру.
Create / Update VIW→Create / Update MECКогда: В Settings источник DataSource, TreeSource или CrossSource, в том числе внутри Details, называет UnitCode и ViewName. Без ViewName вызов ждёт класс UnitCode.
Подготовить представление источника, часто чужого класса. Тип условий не важен. Физический JVW/JVP называет сама VIW, поэтому для представления на своём запросе лишней ссылки нет. Парус настройки не проверяет: без ребра перенос прошёл бы, а раздел не открылся.
Update прежнего MEC→Create / Update MECКогда: Вызов получает UseForLinks, UseForView или UseForDictionary = 1, а другой вызов того же класса в наборе этот же признак снимает (1 → 0).
Парус держит каждый признак только у одного вызова класса и отказывает «Дублирование значения признака …», если поставить его, пока он стоит у соседа. Порядок во входном наборе значения не имеет. Если прежний владелец в набор не входит, снять признак некому — Парус откажет.
Update MEC, отдающий Name→Create / Update MEC, занимающий NameКогда: MEC получает непустое Name, которое в приёмнике держит другой вызов того же класса, и в этом же переносе своё Name меняет. Оба объекта входят в набор. Для обмена по кругу ребро не ставится.
Сначала освободить наименование, потом занять: C_UNIT_SHOWMETHODS_NAME_UK не допускает двух одинаковых, и цепочка переименований проходит за один перенос в любом порядке набора. Если наименование держит объект вне набора или тот, что его не меняет, Парус откажет «Значение уже занято».
Параметры и освобождение ссылок5 правил
Create MEC→Create MEC.ParamКогда: Добавляется параметр вызова.
Родитель должен существовать; его Update этим ребром не ожидается.
Create CLS.Attr→Create / Update MEC.ParamКогда: Attribute задан; атрибут находится в том же UnitCode.
Подготовить новый атрибут перед назначением параметру.
Update / Delete MEC.Param→Delete CLS.AttrКогда: У текущего параметра Attribute непустой.
Сначала изменить или снять параметр, использующий прежний атрибут. Наличие ребра не исправит параметр в источнике, который продолжает ссылаться на удаляемый атрибут.
Create / Update ведущего MEC.Param→Create / Update зависимого MEC.ParamКогда: В DepParameter источника указано Name ведущего того же вызова.
Подготовить ведущую запись до установки зависимости; одноимённые параметры другого вызова не подходят.
Update / Delete зависимого MEC.Param→Delete прежнего ведущего MEC.ParamКогда: В текущем DepParameter есть прежнее имя.
Освободить связь или удалить зависимого до удаления ведущего. В Парусе DEP_RN имеет каскадное удаление; нельзя рассчитывать на сохранение продолжающего зависеть элемента.
Локальные переменные3 правил
Create MEC→Create MEC.VarКогда: Добавляется локальная переменная.
Сначала подготовить вызов.
Create DOM→Create / Update MEC.VarКогда: Domain задаёт домен переменной.
Подготовить тип значения; Update домена и его перечисление этим правилом не ожидаются.
Create MET→Create / Update MEC.VarКогда: InitFunction непустой.
Подготовить функцию-метод того же класса. У существующего MET исполнение его Update этим ребром не ожидается.
Кто использует вызов и его параметры13 правил
Create MEC→Create / Update CLS.VFКогда: ShowMethod формы называет этот вызов своего класса.
Вызов должен существовать до регистрации формы для него.
Create / Update MEC→Create / Update CLS.VFКогда: Словарь внутри XML FormData / FormDataExt называет класс и метод вызова.
Подготовить вызов, на который ссылается словарный элемент формы. Если метод не указан, форма ссылается только на CLS.
Create MEC→Create / Update ACT.StepКогда: ShowUnitCode и ShowMethodName указывают открываемый вызов.
Подготовить способ открытия раздела перед записью шага действия.
Create MEC→Create / Update REP.ParamКогда: Указаны UnitCode и вызов в MethodCode.
Подготовить вызов словаря параметра.
Create MEC.Param→Create / Update REP.ParamКогда: Дополнительно задано имя параметра в ParameterName.
Подготовить конкретный параметр указанного вызова.
Create MEC→Create / Update PCE.ParamКогда: Указаны UnitCode и вызов в CodeMethodCall.
Подготовить вызов словаря параметра.
Create MEC.Param→Create / Update PCE.ParamКогда: Дополнительно задано имя параметра в NameParameterMethodCall.
Подготовить конкретный параметр указанного вызова.
Create MEC→Create / Update UAP.ParamКогда: Указаны UnitCode и вызов в MethodCode.
Подготовить вызов словаря параметра.
Create MEC.Param→Create / Update UAP.ParamКогда: Дополнительно задано имя параметра в MethodParameterName.
Подготовить конкретный параметр указанного вызова.
Create MEC класса UserReports→Create / Update REP.VFКогда: ShowMethod формы отчёта непустой.
Подготовить вызов специального класса UserReports, используемый формой отчёта.
Create / Update MEC→Create / Update PRMКогда: LinkMethod системного параметра задан; класс — LinkUnitCode.
Подготовить связанный метод вызова.
Create / Update MEC.Param→Create / Update PRMКогда: Дополнительно задан LinkParameterName.
Подготовить параметр вызова. Его имя задаёт порядок, фактическую привязку Парус ищет по входному/выходному коду PRM.
Update PRM→Delete прежнего MEC.ParamКогда: В текущем PRM есть LinkParameterName.
Обновить системную привязку до удаления прежнего параметра вызова.
Скрипты и сохранённые зависимости Oracle4 правил
SCR Before→MEC / MEC.Param / MEC.VarКогда: Приёмник исполняет скрипты; область — этот вызов, его класс или весь перенос.
Исполнить скрипт до охватываемых команд. Без обычных команд области скрипт в плане не остаётся.
MEC / MEC.Param / MEC.Var→SCR AfterКогда: Та же область; время After.
Исполнить скрипт после команд вызова.
Create / Update зависимости Oracle→MEC с прямой ссылкой на объект OracleКогда: Цель прямой ссылки не меняется, но её описание с сохранёнными зависимостями присутствует в сравнении.
Продолжить зависимости через неизменившуюся процедуру условий; сам MEC такого списка не хранит.
Create / Update JTB.Col→Та же команда MECКогда: Среди зависимостей, найденных по предыдущему правилу, есть JTB, и в плане есть реальные команды её колонок.
Дождаться новых или изменяемых колонок таблицы, нужной процедуре.
Рёбра без удаления целого объекта4 правил
Delete MEC.Param→Delete MECКогда: Удаляется параметр своего вызова.
Ребро описывает освобождение родителя; исполняемого Delete целого MEC обычный план не создаёт.
Delete MEC.Var→Delete MEC / METКогда: Удаляется переменная; MET — текущий InitFunction.
Целые MEC и MET обычный перенос не удаляет. Это рёбра, а не обещание удаления этих объектов.
Delete ACT.Step→Delete MECКогда: У удаляемого шага есть ShowUnitCode и ShowMethodName.
Ребро описывает освобождение вызова при Delete шага; Delete MEC не возникает.
Delete REP.Param→Delete MECКогда: Удаляется параметр отчёта с текущими UnitCode и MethodCode.
Зарезервированное освобождение вызова. Аналогичного ребра у PCE.Param / UAP.Param нет.
Границы рёбер и выбора объектов
Для ребра нужны обе команды. Если домен или атрибут уже есть и не создаётся, отдельного Create не будет. Обычные зависимости также связывают выбор и ошибки: снятие создания родителя затрагивает зависимые команды. Ребро к объекту по ссылке само не добавляет этот объект; отсутствующую зависимость нужно подготовить или включить в состав — как дополнить перенос.
У MEC нет ребра MEC.Var → MEC.Param по SmParameter. Нет отдельного ребра к папке Паруса и SetOrder. Наличие текста ссылки не означает проверку её работоспособности.
Удаления частей строятся перед изменениями и созданием, внутри текущего списка — с конца. Это исходная очередность, а не ребро каждой пары: реальные зависимости могут поставить Update зависимого перед Delete ведущего. Команды частей не ждут Update MEC; ошибка корня в обычном режиме не гарантирует, что остальные части не изменились. См. режим одной транзакции.
Как вызов хранится в файлах
Для учебного MEC:Request|main Git использует файл класса, а S3 и «Файл пакета» — одинаковый отдельный файл вызова в ZIP. Parameters и LocalVariables во всех вариантах вложены в описание MEC; отдельных файлов на их элементы нет.
Git
YAMLClass/Request.yamlВызов — элемент MethodCalls файла класса; внутри него Parameters и LocalVariables. Holkas объединяет семейство в файл класса, а при чтении YAML восстанавливает его и выделяет MEC.
В корне репозитория есть .holkas. Для одиночного MEC Holkas подмешивает существующий файл класса и сохраняет остальные объекты. Если класса нет и CLS не едет, отказывает.
S3
JSON в ZIPMethodCall/Request%7Cmain.jsonОтдельный JSON, устроенный так же, как у «Файла пакета»: unitCode, code, параметры и переменные. В manifest.json записан MEC / Request|main; реквизиты класса лежат отдельно в Class/Request.json.
Одиночный MEC без CLS сохраняется и читается обратно.
Файл пакета
JSON в ZIPMethodCall/Request%7Cmain.jsonОтдельный JSON содержит unitCode, code, параметры и переменные. В manifest.json записан MEC / Request|main; при выборе класса его реквизиты находятся отдельно в Class/Request.json.
При чтении Holkas идёт по оглавлению к этому JSON. Собственная пара сохраняет одиночный MEC без CLS; при переносе в БД класс должен уже существовать или создаваться тем же планом.
ZIP из S3 и «Файла пакета» устроены одинаково, архив одного способа загружается другим. ZIP, записанные в S3 версией Holkas 0.1.30 или более ранней, хранили вызов в списке methodCalls внутри Class/Request.json; такие архивы по-прежнему читаются обоими способами.
Нули и пустые списки сохраняются, null при записи опускается. В адресе файла | кодируется как %7C, в поле и оглавлении остаётся Request|main. Не переименовывайте файл отдельно от адреса. Поля папки Паруса у MEC нет: UnitCode указывает класс; Class/ и MethodCall/ — файловые каталоги, а не восстанавливаемая иерархия Паруса.
Один вызов в YAML класса и JSON в ZIP
Сокращённые учебные фрагменты: один параметр и одна переменная. Остальные поля и элементы опущены; это не готовые файлы для загрузки. Сохраните полные списки: [] означает их очистку.
Git — внутри Class/Request.yaml:
UnitCode: Request
MethodCalls:
- UnitCode: Request
Code: main
Name: Заявки списком
CondType: 0
Parameters:
- Name: Идентификатор
InCode: IN_RN
OutCode: OUT_RN
Attribute: RN
DataType: 2
LocalVariables:
- Name: NLIMIT
Domain: TNUMBER
InitType: 1
DefaultNumber: 7
S3 или «Файл пакета» — MethodCall/Request%7Cmain.json:
{
"unitCode": "Request",
"code": "main",
"name": "Заявки списком",
"condType": 0,
"parameters": [
{
"name": "Идентификатор",
"inCode": "IN_RN",
"outCode": "OUT_RN",
"attribute": "RN",
"dataType": 2
}
],
"localVariables": [
{
"name": "NLIMIT",
"domain": "TNUMBER",
"initType": 1,
"defaultNumber": 7
}
]
}
Пример показывает устройство, а не полный перенос всех используемых объектов.
Практические шаги: сохранить в Git, выгрузить и загрузить файл пакета. Оглавление ZIP — в справке о формате пакета.
Основа: руководство КОР Парус 8, издание 2026, с. 79–81; прежнее исследование серверных условий и выбора записей на Парусе 27.08.2026; текущие DTO, читатели Oracle/PostgreSQL, построители, исполнители и файловые адаптеры Holkas 0.1.30. Сверено 8 ноября 2026; хранение в ZIP уточнено по коду 9 ноября 2026. Определения процедур, ограничений и словарь типов прочитаны на PostgreSQL 14 / Парус 27.08.2026 без записи. Примеры учебные. Новый перенос в БД и проверка клиента Паруса не выполнялись.