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

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

Вызов метода

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

Парус · Oracle и PostgreSQL

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

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

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

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

Метод вызова определяет, как открыть раздел: обычным списком, со спецификациями или как словарь с отбором и возвратом выбранного значения.

Адрес объектаMEC:Класс|Код вызова
Вложенные частиПараметры и переменные
Удаление вызоваНе формируется

Метод вызова в КОР

Метод вызова описывает способ открытия раздела и передачи контекста. Например, «Заявки» из меню показывают полный раздел со спецификациями, а то же окно как словарь позволяет выбрать заявку, позиционируясь по переданному номеру. Параметры задают значения для позиционирования, отбора и возврата результата; локальные переменные хранят значения, нужные этому вызову.

В интерфейсе Паруса это «Методы вызова класса». Заголовок справочника «Вызов метода» соответствует типу MEC Holkas. Метод MET описывает операцию и её реализацию; MEC описывает открытие раздела. У MEC нет обязательной ссылки на одноимённый MET. Функция-метод может использоваться для инициализации отдельной переменной.

MEC принадлежит классу, но имеет отдельный адрес, например MEC:Request|main. Выбор класса раскрывает доступное семейство источника. Параметры и переменные загружаются вместе с MEC; его выбор сам по себе не включает все формы, домены, пиктограммы и представления. Перенос сохраняет описание, а не открывает раздел в клиенте.

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

Используются по ссылке: атрибуты класса, домены, функции-методы и пиктограмма. Представления и процедура условий, названные в XML, остаются отдельными объектами. Формы класса и шаги действий могут ссылаться на MEC, но не входят в него.
Реквизиты находятся в самом вызове. Обе дочерние ветви — реальные коллекции; папки Паруса и отдельной части «порядок» у MEC нет.

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

27 полей · 3 группы

Все 9 реквизитов и 2 коллекции вызова, 8 полей параметра и 8 полей переменной. Git YAML использует имена с заглавной буквы; рядом точное имя JSON обоих ZIP.

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

Часть ключа задаёт адрес 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 сначала освобождает его, а обмен по кругу не переносит и называет в плане — см. «Вызовы меняются наименованиями».
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. Сохраняйте значение полного экспорта и согласуйте его с настройками вызова. Наличие непустой строки не подтверждает правильность привязки при работе клиента.
Какие поля нужны выбранному InitType
КодИсточникЗаполнение
0Без источникаКонстанты, InitFunction и SmParameter пусты
1ЗначениеОдно из DefaultString, DefaultNumber, DefaultDate; InitFunction и SmParameter пусты
2ФункцияInitFunction; константы и SmParameter пусты
3Параметр вызоваSmParameter; константы и InitFunction пусты

Парус нормализует константы по Domain: строке соответствует DefaultString, числу и времени — DefaultNumber, дате — DefaultDate. Для двоичного домена и длинного текста процедура очищает все три константы, поэтому InitType=1 с таким доменом не удовлетворяет требованию одного значения. Домен нужен при любом способе.

Например, NLIMIT с Domain=TNUMBER, InitType=1 и DefaultNumber=7 получает начальное значение при работе вызова. Передача этого описания не выполняет запрос раздела и не вычисляет InitFunction во время переноса.

Пустой текст, ноль и пустые списки

В текстовых полях null и пустая строка при построении команд равны; CRLF и LF не создают различия. Регистр и обычные пробелы значимы. XML сравнивается как текст: изменение оформления может дать Update MEC даже при одинаковом смысле.

Число 0 отличается от null. В модели UseFor… допускают null, но обследованный Парус требует значение каждого из трёх признаков: null не выключает признак и не сохраняет старый, а нарушает обязательность колонки. Используйте 0 или 1 из полного экспорта. CondType=0 означает клиентские условия; DefaultNumber=0 — заданная числовая константа. Parameters: [] и LocalVariables: [] — действительно пустые списки, а не способ опустить пример. В JSON ZIP оба списка обязательны: их отсутствие или null приводит к отказу при чтении. Это правило JSON не следует переносить на YAML по одному расширению.

Если команда появилась из-за другой правки, она передаёт и остальные реквизиты записи. Исключение Settings описано у поля: Update отдельно пишет его только при буквальном отличии от текущего; Create отдельно пишет любое значение, отличное от null, включая пустую строку.

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

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

Вызов, параметры и переменные3 кода
MEC
CreateUpdate

Метод вызова

Создаёт вызов или обновляет его наименование, признаки, пиктограмму и тип условий; Settings при необходимости записывается отдельно внутри той же команды. Если создание класса уже завело этот вызов, Create MEC переходит к исправлению найденной записи. Изменение только списков не требует Update MEC.

Ключ: Класс|Код вызова

MEC.Param
CreateUpdateDelete

Параметр вызова

Добавляет запись, меняет свойства при прежнем Name или удаляет лишнюю. При попытке изменить InCode либо OutCode Holkas при применении в БД отклоняет Update целиком, ничего не записав. У Create с DepParameter установка связи входит в ту же команду, но не становится отдельной строкой плана.

Ключ: Класс|Код вызова|Name параметра

MEC.Var
CreateUpdateDelete

Локальная переменная

Добавляет, меняет или удаляет одну переменную. Домен и функция находятся по кодам в приёмнике; строка 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; остальные свойства вызова совпадают.

  1. Create CLS.Attr · Request|ID подготавливает новый атрибут.
  2. Update MEC.Param · Request|main|Идентификатор меняет ссылку, сохраняя коды параметра.
  3. 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 правильно отсортировать команды перед применением. Ребро связывает две команды и указывает, какая должна выполниться раньше.

1 · СначалаСоздать атрибут классаCreate CLS.Attr · Request|ID
→
2 · ЗатемПереключить параметр вызоваUpdate MEC.Param
Параметр «Идентификатор» сохранил Name, но Attribute меняется с RN на ID. Holkas сначала готовит новое поле, затем меняет ссылку. Delete CLS.Attr прежнего RN выполняется после обновления параметра.

Каталог охватывает 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

YAML
Class/Request.yaml

Вызов — элемент MethodCalls файла класса; внутри него Parameters и LocalVariables. Holkas объединяет семейство в файл класса, а при чтении YAML восстанавливает его и выделяет MEC.

В корне репозитория есть .holkas. Для одиночного MEC Holkas подмешивает существующий файл класса и сохраняет остальные объекты. Если класса нет и CLS не едет, отказывает.

S3

JSON в ZIP
MethodCall/Request%7Cmain.json

Отдельный JSON, устроенный так же, как у «Файла пакета»: unitCode, code, параметры и переменные. В manifest.json записан MEC / Request|main; реквизиты класса лежат отдельно в Class/Request.json.

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

Файл пакета

JSON в ZIP
MethodCall/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 без записи. Примеры учебные. Новый перенос в БД и проверка клиента Паруса не выполнялись.