Парус 8 · Конструктор отраслевых расширений
Метод описывает, какую операцию выполняет класс и как её аргументы получают значения: например, сохранить заявку с её идентификатором и комментарием.
MET:Класс|Код методаМетод в КОР
Метод класса — описание операции над данными класса. Обычно за ним стоит процедура или функция базы с дополнительными настройками КОР: наименованием, видом, параметрами и способом их инициализации. Одна реализация может использоваться несколькими методами и действиями. Внешний метод с типом 2 — отдельный вариант без имени процедуры БД.
В учебном классе «Заявки» метод Save может ссылаться на P_REQUEST_SAVE. Параметр NRN получает идентификатор текущей записи из контекста, а SCOMMENT — заданную строку. Эти значения определяются при работе раздела. Сам перенос MET метод не запускает и данные заявки не изменяет.
Метод принадлежит классу, но в Holkas имеет отдельный адрес MET:Request|Save. Выбор класса раскрывает доступное семейство источника, включая методы. Выбор одного MET не означает, что все его домены, атрибуты и реализация уже включены: используйте зависимости и проверьте состав плана.
Действие ACT определяет запуск обработки и может использовать MET. Метод вызова MEC описывает открытие раздела, его параметры и переменные. Совпадение кодов не делает эти объекты одним и тем же.
Что входит в перенос
Справочник полей
26 полей · 2 группыВсе 9 реквизитов и список Parameters метода, все 16 полей параметра. Имена Git YAML — с заглавной буквы; рядом точное имя JSON в обоих ZIP.
Как читать обозначения и правила
Наведите указатель, перейдите к значку клавишей Tab или нажмите его для пояснения.
Часть ключа задаёт адрес метода, Ключ узнаёт параметр внутри него, Сравнивается учитывает различие в плане, По элементам проверяет список по записям. Create создаёт, Update меняет, Delete удаляет, SetOrder задаёт позиции.
Update MET записывает допустимые реквизиты существующего метода; MethodType, Package и Name предварительно проверяются на неизменность. Update MET.Param передаёт все настройки параметра. Обнаруженная разница сама по себе не означает, что Парус разрешит её применить.
Реквизиты метода · MET10 полей
UnitCodeJSON: unitCodeстрокаЧасть ключаКласс-владелец- Назначение
- Код класса Паруса, например Request. Вместе с Code задаёт адрес метода.
- При переносе:
- Ищет класс по UnitCode. Новый код адресует метод другого класса; прежний метод автоматически не удаляется. При Create MET есть зависимость от Create CLS.
CodeJSON: codeстрокаЧасть ключаКод метода- Назначение
- Мнемокод внутри класса, например Save. Отличается от имени реализующей процедуры Name.
- При переносе:
- Смена Save на SaveNew адресует другой MET. Если его нет в приёмнике, создаётся новый; прежний сохраняется. Ссылки действий и параметров сами не переключаются.
MethodTypeJSON: methodTypeцелоеСравниваетсяТип метода- Назначение
- 0 — процедура, 1 — функция, 2 — внешний метод. Для типа 2 имя и пакет пусты, Accessibility=1.
- При переносе:
- Задаётся при создании. Изменение существующего типа даёт Update MET, но при применении Holkas отклоняет всю команду, включая новую подпись или примечание. Автоматического пересоздания нет.
PackageJSON: packageстрока / nullСравниваетсяПакет реализации- Назначение
- Имя пакета без схемы; например PKG_REQUEST. Для отдельной процедуры или функции — null.
- При переносе:
- Задаётся при создании. Изменение пакета у существующего метода отклоняет Update MET целиком. Отличие только в записи — null или пустая строка — изменением не считается: остальные реквизиты записываются. На Oracle зависимость — пакет PARUS.PKG_REQUEST, на PostgreSQL — функция или процедура parus.pkg_request$имя.
NameJSON: nameстрока / nullСравниваетсяИмя реализации- Назначение
- Имя процедуры или функции БД; например P_REQUEST_SAVE. В пакете — имя его метода. У внешнего метода пусто.
- При переносе:
- Создание ждёт реализацию; Update с заменой Name отклоняется целиком в БД; null и пустая строка при этом считаются одним значением. Поле содержит имя, а не исполняемый текст. Парус ожидает имена реализации и пакета в верхнем регистре; адрес зависимости Holkas приводит к регистру СУБД.
CaptionJSON: captionстрокаСравниваетсяНаименование метода- Назначение
- Подпись для человека, например «Сохранить». Не код и не имя процедуры.
- При переносе:
- Изменение даёт Update MET. При допустимых остальных реквизитах записывает новую подпись. В обследованном Парусе подпись непустая и уникальна среди методов класса. Если наименование переходит к другому методу этого класса, Holkas сначала освобождает его, а обмен по кругу не переносит и называет в плане — см. «Методы меняются наименованиями».
AccessibilityJSON: accessibilityцелоеСравниваетсяБазовый / клиентский- Назначение
- 0 — базовый, 1 — клиентский метод. Клиентский используется при вызове из клиента Паруса; внешний метод требует 1.
- При переносе:
- Передаётся при создании и изменении MET. Это настройка метода, а не разрешение Holkas на перенос и не назначение прав пользователю.
NoteJSON: noteстрока / nullСравниваетсяПримечание- Назначение
- Дополнительное пояснение к методу. В таблице Паруса соответствует COMMENT_, а Caption — NOTE.
- При переносе:
- Разница даёт Update MET. null передаётся как пустое примечание; это не просьба сохранить старый текст. Ограничения изменения штатной записи остаются в силе.
DomainJSON: domainстрока / nullСравниваетсяДомен результата на уровне метода- Назначение
- Тип результата функции. Не путать с Domain параметра. Читалки Oracle и PostgreSQL берут его из записи RESULT в Parameters; у процедуры здесь всегда null. Файлы прежних версий, где поле пустое, читаются так же и разницы не дают.
- При переносе:
- Новый домен передаётся как result_domain в Create / Update MET, и Парус сам создаёт или перестраивает RESULT; прежний при Update не передаётся. Команда метода ждёт Create DOM. Заданное значение главнее: RESULT в Parameters получает тот же домен. См. результат функции.
ParametersJSON: parametersсписокПо элементамПараметры метода- Назначение
- Описание аргументов и результата функции. Элементы сопоставляются по Name внутри метода.
- При переносе:
- Новые, изменённые и исчезнувшие параметры дают MET.Param. [] означает удалить прежние параметры, а не пропустить их описание; RESULT функции так не удалить — план предупредит. Перестановка массива без смены Position ничего не меняет.
Параметр метода · MET.Param16 полей
NameJSON: nameстрокаКлючИмя параметра- Назначение
- Имя аргумента, например NRN или SCOMMENT; у функции RESULT описывает результат.
- При переносе:
- Замена NRN на NID при удалении NRN из списка даёт Delete прежнего и Create нового. Для обычных параметров Парус ожидает имена в верхнем регистре. RESULT функции ведёт сам метод — см. результат функции.
DomainJSON: domainстрокаСравниваетсяДомен параметра- Назначение
- Код DOM, определяющий тип значения. Например TRN — идентификатор. Это не имя SQL-типа.
- При переносе:
- Create / Update MET.Param ждут Create DOM. Домен обязателен; при LinkType=1 он должен совпадать с доменом связанного атрибута. У RESULT функции домен переносит команда метода, а не параметра.
CaptionJSON: captionстрокаСравниваетсяНаименование параметра- Назначение
- Подпись аргумента для человека.
- При переносе:
- Изменение даёт Update MET.Param с остальными настройками записи. В обследованном Парусе подписи непустые и уникальны среди параметров одного метода. Если значение переходит от одного элемента к другому, Holkas сначала освобождает его, а обмен по кругу не переносит и называет в плане — см. «Параметры меняются подписями».
PositionJSON: positionцелоеСравниваетсяПозиция параметра- Назначение
- Место в списке аргументов. Параметр сопоставляется по Name, а не по позиции.
- При переносе:
- Смена позиции даёт Update MET.Param и затем SetOrder MET.ParamPos. Парус сдвигает соседей при вставке, изменении и удалении; завершающая команда закрепляет весь список из источника. Позиции должны быть различны и допустимы для Паруса.
InOutJSON: inOutцелоеСравниваетсяНаправление параметра- Назначение
- 0 — входной/выходной, 1 — входной, 2 — выходной. Это код Паруса, не номер позиции.
- При переносе:
- Передаётся в MET.Param. Для выходного аргумента Парус допускает ограниченный набор привязок; полная матрица ниже. На PostgreSQL колонка чтения выбирается по релизу 29.05.2025.
DefaultStringJSON: defaultStringстрока / nullСравниваетсяЗначение: строка- Назначение
- Строковая константа при LinkType=3 и строковом домене.
- При переносе:
- Сравнивается и передаётся вместе с двумя другими полями значения. Парус очищает поля, не соответствующие типу домена; для константы должно остаться ровно одно непустое значение. Пустая строка не обозначает «оставить старую».
DefaultNumberJSON: defaultNumberдесятичное / nullСравниваетсяЗначение: число или время- Назначение
- Числовая константа при LinkType=3; Парус также использует числовое поле для домена времени. Может быть дробным.
- При переносе:
- Сравнивается и записывается без округления: разница 1.75 и 1.25 даёт Update MET.Param.
DefaultDateJSON: defaultDateдата и время / nullСравниваетсяЗначение: дата- Назначение
- Константа даты при LinkType=3 и соответствующем домене.
- При переносе:
- Разница даёт Update MET.Param. Передаётся дата и время без переноса клиентского часового пояса; для других типов домена процедура Паруса очищает это поле.
LinkAttributeJSON: linkAttributeстрока / nullСравниваетсяСвязанный атрибут- Назначение
- Имя атрибута того же класса при LinkType=1. Значение берётся из текущей записи при работе раздела.
- При переносе:
- Create / Update MET.Param ждут Create CLS.Attr. Параметр, который удаляется или перестаёт ссылаться на прежний атрибут, выполняется до удаления этого атрибута, поэтому смена привязки и удаление атрибута проходят одним переносом.
LinkTypeJSON: linkTypeцелоеСравниваетсяСпособ получения / передачи значения- Назначение
- 0 — нет, 1 — атрибут, 2 — контекст, 3 — значение, 4 — результат функции, 5 — параметр действия, 6 — параметр метода вызова, 7 — локальная переменная.
- При переносе:
- Передаётся в MET.Param вместе с полями выбранного способа. Например, при переходе 2 → 1 нужно очистить Context и задать LinkAttribute. Не копируйте числовые коды из ACT: там 5 и 6 означают другие привязки.
ContextJSON: contextцелое / nullСравниваетсяИсточник контекста- Назначение
- При LinkType=2: 0 — первичный ключ, 3 — организация, 7 — пользователь и другие коды из таблицы ниже.
- При переносе:
- Передаётся как код; 0 — настоящее значение. При другом LinkType поле должно быть пустым. Контекст определяется при запуске метода, а не при переносе описания.
LinkedFunctionJSON: linkedFunctionстрока / nullСравниваетсяМетод вычисления значения- Назначение
- Код другого MET того же класса при LinkType=4. Это не имя физической SQL-функции.
- При переносе:
- Create / Update MET.Param ждут Create MET указанного метода. Его параметры и текст реализации остаются собственными объектами. Ребро не ожидает Update этого метода или всех его параметров. Команда параметра, который удаляется или сменил функцию, ставится раньше удаления прежней функции; сам метод Holkas не удаляет.
MandatoryJSON: mandatoryцелое / nullСравниваетсяОбязательность- Назначение
- Признак обязательного значения: 0 — нет, 1 — да. Сохраняется в описании параметра.
- При переносе:
- Разница даёт Update MET.Param. Поле допускает null, но это не команда сохранить старое значение и не доказательство, что Парус примет его. Сохраняйте корректное значение полного экспорта; проверка исполнения метода клиентом — отдельная задача.
ActionParameterJSON: actionParameterстрока / nullСравниваетсяПараметр действия- Назначение
- Имя параметра текущего действия при LinkType=5. Например COMMENT у действия, запускающего Save.
- При переносе:
- Передаётся как имя. Автоматического ребра к ACT.Param нет: один метод может использоваться разными действиями. Определение метода не создаёт параметры этих действий и не переименовывает их.
SmParameterJSON: smParameterстрока / nullСравниваетсяПараметр метода вызова- Назначение
- Имя параметра текущего MEC при LinkType=6. Не собственный параметр MET.
- При переносе:
- Передаётся в MET.Param без явного ребра к MEC.Param. После переименования параметра вызова соответствующее имя в методе нужно согласовать отдельно.
SmVariableJSON: smVariableстрока / nullСравниваетсяЛокальная переменная вызова- Назначение
- Имя локальной переменной MEC при LinkType=7.
- При переносе:
- Передаётся в MET.Param; определения переменной внутри метода нет и ребра к MEC.Var нет. Проверьте наличие этого имени в том контексте вызова, где используется метод.
Команды плана
Три кода относятся к описанию метода, его параметрам и позициям. Подсказки у пиктограмм доступны мышью, клавиатурой и касанием; без JavaScript остаются текстовые обозначения.
Метод и параметры3 кода
METМетод класса
Создаёт описание метода либо меняет его наименование, доступность и примечание. При смене MethodType, Package или Name при применении Holkas отклоняет Update целиком. Только изменение Parameters не требует Update MET. У функции новый домен результата едет этой командой: Парус сам создаёт или перестраивает RESULT. Снять домен результата Update не может, поэтому ради одного этого команды метода нет.
Ключ: Класс|Код метода
MET.ParamПараметр метода
Добавляет аргумент с новым Name, меняет запись с прежним Name или удаляет лишнюю. Позиция передаётся процедуре Паруса вместе с настройками; при этом соседние позиции могут сдвигаться. Для RESULT функции процедура параметра не вызывается: домен переносит MET, позицию — MET.ParamPos, а команда проверяет итог. Удаление RESULT и правка остальных его полей отклоняются до записи в БД.
Ключ: Класс|Код метода|Имя параметра
MET.ParamPosПозиции параметров
Появляется при хотя бы одном Create или Update MET.Param, даже если менялась только подпись. Ждёт все команды параметров, включая Delete; затем закрепляет Position у всего списка из источника. Если есть только удаления, отдельной команды нет.
Ключ: Класс|Код метода
Удаление целого MET по отсутствию в источнике не формируется. Команды MET.Param не являются самостоятельными объектами каталога. В Git команды меняют сохраняемое описание; приёмник БД вызывает Парус; S3 и «Файл пакета» создают новый ZIP.
Пример: добавить входной параметр
У существующего Request|Save появился SCOMMENT: домен TSTR240, Caption «Комментарий», Position=2, InOut=1, LinkType=3, DefaultString «Без примечания». Остальные поля констант и привязок пусты. Метод, его реализация, первый аргумент и домен уже совпадают с приёмником.
Create MET.Param · Request|Save|SCOMMENTдобавляет аргумент.SetOrder MET.ParamPos · Request|Saveзакрепляет позиции всего списка, включая прежний аргумент.
Update MET не нужен: его собственные реквизиты не менялись. Сигнатура реализации должна соответствовать описанию, но изменение MET не переписывает текст P_REQUEST_SAVE и не исправляет автоматически вызывающие действия.
Ограничения и решения
Нужно заменить реализацию существующего метода
Смена MethodType, Package или Name обнаруживается, но Update MET в БД отклоняется целиком до записи реквизитов. Например, Name=P_REQUEST_SAVE → P_REQUEST_SAVE_V2 вместе с новой Caption не запишет ни имя, ни подпись. Используйте новый код метода и отдельно перенастройте его потребителей либо подготовьте изменение средствами КОР. Старый MET сам не удалится.
Отказ корня не гарантирует неизменность его параметров: они не ждут Update MET и в обычном режиме выполняются отдельными командами. Режим одной транзакции меняет последствия отказа для всего переноса. В Git сохраняется описание, поэтому успешная правка файла ещё не доказывает допустимость Update в БД.
Результат функции RESULT
У MethodType=1 тип результата хранится параметром RESULT, но ведёт его сам метод. Обычные процедуры исправления и удаления параметра Парус для RESULT запрещает на обеих СУБД. Поэтому домен результата — поле метода Domain: читалки берут его из RESULT, а команда MET передаёт новый домен как result_domain, и Парус сам создаёт или перестраивает запись.
Смена типа результата даёт Update MET и Update MET.Param RESULT. Вторая команда процедуру параметра не вызывает: она ждёт MET и проверяет домен, а позицию RESULT ставит MET.ParamPos. Остальные поля RESULT Парус ставит сам — примечание «Результат функции», выходной, без связи и значения по умолчанию. Если источник требует иного или в приёмнике у функции есть RESULT, которого нет в источнике, план предупреждает, а применение отказывает по этой команде, не трогая базу; остальные команды метода выполняются. Такое расхождение исправьте средствами КОР. Git записывает RESULT как есть.
Параметр больше не использует удаляемый атрибут
Если SCOMMENT переключается с атрибута COMMENT_ на другой атрибут или способ связи, а COMMENT_ удаляется тем же планом, Holkas сначала изменяет параметр и только потом удаляет атрибут. Внешний ключ DMSCLMETPARMS.LINK_ATTR иначе отклонил бы удаление. Порядок не зависит от того, в каком порядке выбраны класс и метод. Удаление самого параметра освобождает атрибут так же.
Дробная числовая константа
DefaultNumber переносится с дробной частью на обеих СУБД, без округления.
Аргументы, привязки и запуск в Парусе
Имена аргументов и их направления должны соответствовать реализации. Парус проверяет допустимость домена, связь с атрибутом, заполненность константы и сочетание InOut / LinkType. Передача произвольного кода в описании метода не делает его допустимым для старого приёмника.
Регистрация метода и отсутствие предупреждений не подтверждают его запуск. Руководство КОР не предусматривает перегруженные методы пакетов. Holkas не выбирает перегрузку по Parameters и не переводит PL/SQL в PL/pgSQL: реализацию для нужной СУБД готовят отдельно. Параметры текущего действия или вызова проверяйте в соответствующем ACT / MEC; их имена не создают автоматических рёбер.
Релиз Паруса
На PostgreSQL с 29.05.2025 InOut читается из колонки «INOUT» в верхнем регистре; раньше — из inout. Holkas выбирает колонку по релизу. У Create MET с 24.12.2025 передаётся дополнительный пустой аргумент dup_rn; копирование чужих параметров через него не запрашивается. Это различия чтения и вызова API, а не новые поля файла.
Проверенные границы — в совместимости релизов. Новый прогон Oracle или PostgreSQL при подготовке страницы не выполнялся; определения процедур и ограничений прочитаны на PostgreSQL / Парус 27.08.2026.
Параметры меняются подписями
Caption (столбец NOTE) уникально среди параметров метода (C_DMSCLMETPARMS_NOTE_UK): Парус не даёт занять значение, пока его держит соседний элемент.
Цепочка — например, NRN: «Документ» → «Документ-основание», NBASE: «Основание» → «Документ». Holkas упорядочивает команды сам: сначала освобождает значение, потом занимает его. Всё проходит за один перенос.
Обмен по кругу — например, A: «Первое» → «Второе», B: «Второе» → «Первое». Без временного значения его не выполнить, а промежуточные значения Holkas не записывает. План в базу Паруса называет такие элементы в предупреждении и оставляет им значения приёмника; остальные правки объекта переносятся. В Git и файл обмен записывается как есть. Поменяйте значения в приёмнике вручную или в три переноса: дайте в источнике одному элементу свободное временное значение, перенесите, затем верните нужные значения и перенесите снова.
Если значение держит элемент, который в этом переносе его не меняет и не удаляется, команда получает отказ «Значение уже занято другой записью приёмника…» с именем ограничения.
Проверено на PostgreSQL и Oracle.
Методы меняются наименованиями
Caption уникально среди методов класса (C_DMSCLMETHODS_NOTE_UK): Парус не даёт занять наименование, пока его держит другой метод.
Цепочка — например, A: «Z1» → «Z2», B: «Z2» → «Z3». Holkas упорядочивает команды сам: сначала B освобождает «Z2», потом его получает A. Новый объект, которому нужно освобождаемое наименование, тоже ждёт. Всё проходит за один перенос, в каком бы порядке объекты ни шли в наборе.
Обмен по кругу — например, A: «Первое» → «Второе», B: «Второе» → «Первое». Без временного наименования его не выполнить, а промежуточные значения Holkas не записывает. План в базу Паруса называет такие методы в предупреждении и оставляет им наименования приёмника; остальные их правки переносятся. В Git и файл обмен записывается как есть. Поменяйте наименования в приёмнике вручную или в три переноса: дайте в источнике одному объекту свободное временное наименование, перенесите, затем верните нужные наименования и перенесите снова.
Оба объекта должны входить в перенос. Если наименование держит объект вне набора или тот, что его не меняет, команда получает отказ «Значение уже занято другой записью приёмника…» с именем ограничения.
Проверено на PostgreSQL и Oracle.
Рёбра команд
Что такое ребро и где оно видно в Holkas →
Рёбра помогают Holkas правильно отсортировать команды перед применением. Ребро связывает две команды и указывает, какая должна выполниться раньше.
Create DOM · RequestCommentCreate MET.ParamКаталог охватывает собственные команды MET, его параметры и позиции, непосредственно связанные действия и переменные вызова, реализации БД и общие правила плана. 27 строк — правила, а не число рёбер в каждом плане.
Класс-владелец2 правила
Create CLS→Create METКогда: Создаётся новый метод UnitCode|Code.
Класс должен существовать до регистрации метода.
Update MET, отдающий Caption→Create / Update MET, занимающий CaptionКогда: MET получает непустое Caption, которое в приёмнике держит другой метод того же класса, и в этом же переносе своё Caption меняет. Оба объекта входят в набор. Для обмена по кругу ребро не ставится.
Сначала освободить наименование, потом занять: C_DMSCLMETHODS_NOTE_UK не допускает двух одинаковых, и цепочка переименований проходит за один перенос в любом порядке набора. Если наименование держит объект вне набора или тот, что его не меняет, Парус откажет «Значение уже занято».
Реализация Oracle / PostgreSQL7 правил
Create / Update JPR→Create / Update MET или MET.ParamКогда: Oracle; MethodType=0, Package пуст, Name задан.
Отдельная процедура PARUS.ИМЯ. Параметры ждут её напрямую, если нет Create MET; иначе — через создание метода.
Create / Update JFN→Create / Update MET или MET.ParamКогда: Oracle; MethodType=1, Package пуст, Name задан.
Отдельная функция PARUS.ИМЯ; правило не ждёт произвольную процедуру вместо функции.
Create / Update JPG→Create / Update MET или MET.ParamКогда: Oracle; Package и Name непустые.
Сначала подготовить целый пакет PARUS.ПАКЕТ; метод внутри пакета отдельной командой JPR/JFN не представлен.
Create / Update JFP или JPP→Create / Update MET или MET.ParamКогда: PostgreSQL; MethodType=0, Package пуст, Name задан.
Имя без схемы получает parus.; имя со схемой сохраняет её. Ссылку закрывает функция или настоящая процедура, рёбра ведут к обоим альтернативным типам.
Create / Update JFP→Create / Update MET или MET.ParamКогда: PostgreSQL; MethodType=1, Package пуст, Name задан.
Для функции требуется JFP; JPP не является её альтернативой.
Create / Update JFP или JPP→Create / Update MET или MET.ParamКогда: PostgreSQL; MethodType=0, Package и Name заданы.
Пакетной процедуре соответствует parus.пакет$имя; отдельного пакета PostgreSQL не создаётся.
Create / Update JFP→Create / Update MET или MET.ParamКогда: PostgreSQL; MethodType=1, Package и Name заданы.
Пакетной функции соответствует parus.пакет$имя. Адрес приводится к нижнему регистру.
Параметры и их позиции9 правил
Create MET→Create MET.ParamКогда: Добавляется параметр метода.
Метод должен существовать. Update MET этим ребром не ожидается.
Create DOM→Create / Update MET.ParamКогда: Domain параметра задаёт домен.
Подготовить тип аргумента.
Create DOM→Create / Update METКогда: У функции задан домен результата.
Парус принимает result_domain только существующим доменом.
Create / Update MET→Create / Update MET.Param RESULTКогда: У функции меняется RESULT, и метод тоже имеет команду.
Запись RESULT перестраивает команда метода; команда параметра только проверяет итог.
Create CLS.Attr→Create / Update MET.ParamКогда: LinkAttribute непустой.
Сначала подготовить атрибут того же UnitCode.
Create MET→Create / Update MET.ParamКогда: LinkedFunction непустой.
Сначала подготовить метод вычисления того же класса.
Delete / Update MET.Param→Delete CLS.AttrКогда: Параметр удаляется или его LinkAttribute сменился либо очищен, а прежний атрибут удаляется.
Внешний ключ DMSCLMETPARMS.LINK_ATTR не даёт удалить атрибут, пока параметр на него ссылается.
Create / Update / Delete MET.Param→SetOrder MET.ParamPosКогда: Есть хотя бы один Create или Update параметра; ребро от всех команд параметров этого метода.
Закрепить итоговые позиции после правок, включая Delete в том же плане. Только удаления не создают SetOrder.
Update MET.Param, отдающий Caption→Update MET.Param, занимающий CaptionКогда: Параметр получает непустой Caption, который в приёмнике держит другой параметр этого метода, и тот в этом же переносе свой Caption меняет. Для обмена по кругу ребро не ставится.
Сначала освободить значение, потом занять: цепочка проходит за один перенос.
Непосредственные потребители4 правила
Create MET→Create / Update ACTКогда: Поле Method действия непустое и называет этот метод того же класса.
Зарегистрировать основной метод до назначения действию.
Create MET→Create / Update ACT.ParamКогда: LinkedFunction параметра действия называет этот метод.
Подготовить метод, вычисляющий значение параметра действия.
Create MET→Create ACT.MethodКогда: Method в привязке действия называет этот метод.
Включить существующий метод в действие. У ACT.Method нет Update.
Create MET→Create / Update MEC.VarКогда: InitFunction локальной переменной называет этот метод того же класса.
Подготовить метод инициализации переменной вызова.
Общие правила4 правила
SCR Before→MET / MET.Param / MET.ParamPosКогда: Приёмник исполняет скрипты; область включает метод, его класс или весь перенос.
Скрипт выполняется до команд метода. Без обычных команд охраняемых объектов в план не входит.
MET / MET.Param / MET.ParamPos→SCR AfterКогда: Та же область; время After.
Выполнить скрипт после команд метода.
Create / Update зависимости Oracle→MET или MET.Param с прямой ссылкойКогда: Цель прямой ссылки неизменна, но это объект Oracle с сохранённым списком зависимостей (пакет, представление, функция или процедура), и он присутствует в сравнении.
Продолжить зависимости через неизменившуюся реализацию Oracle. Сам MET такого списка не имеет; произвольный SQL метод не разбирает.
Create / Update JTB.Col→Та же MET или MET.ParamКогда: Предыдущий обход нашёл JTB; в плане есть команды её колонок.
Дождаться добавляемых или изменяемых колонок таблицы.
Правила без удаления целого метода4 правила
Delete / Update MET.Param→Delete METКогда: Delete — для своего метода и метода из текущего LinkedFunction; Update — для прежнего LinkedFunction, если он сменился или очищен.
Delete целого MET не формируется в обычном плане; это правило не разрешает удалить метод.
Delete ACT.Param→Delete METКогда: У удаляемого параметра действия задан LinkedFunction.
Зарезервированное освобождение метода; Delete MET отсутствует.
Delete ACT.Method→Delete METКогда: Удаляется привязка этого метода к действию.
Снятие привязки сохраняет определение метода; исполняемого Delete MET нет.
Delete MEC.Var→Delete METКогда: У удаляемой переменной задан InitFunction.
Зарезервированное освобождение метода, который инициализировал переменную.
Границы зависимостей
Если создаётся MET, его новые параметры ждут Create MET и через него реализацию. Если корень неизменен или имеет Update, Create / Update MET.Param ждут реализацию напрямую. SetOrder ждёт команды параметров. Внешний метод с пустым Name не даёт ребра к объекту БД.
Зависимость параметра от MET или DOM ожидает только Create, а не все изменения этого объекта. Поле ActionParameter не добавляет ACT.Param, SmParameter — MEC.Param, SmVariable — MEC.Var. Для MET нет универсального правила DAT.Row через ObjectTables: DMSCLMETHODS в этом словаре отсутствует.
Обычные рёбра влияют на выбор и пропуск зависимых команд. Недостающую реализацию нужно подготовить в приёмнике либо включить в перенос, если она доступна источнику. Подробнее — разбор недостающих объектов. У файлового приёмника без СУБД тип реализации определяется перечнем источника и составом набора; он не переводит SQL между СУБД.
Как метод хранится в файлах
Для учебного MET:Request|Save есть два места хранения: внутри файла класса в Git и отдельный файл в ZIP — одинаково у S3 и «Файла пакета». Во всех случаях Parameters / parameters вложены в описание метода; отдельного файла на каждый аргумент нет.
Git
YAMLClass/Request.yamlРеквизиты класса и семейство в одном файле. Метод — элемент Methods, параметры — его Parameters. Имена UnitCode, Code, InOut начинаются с заглавной буквы.
При записи семейство объединяется в один файл, при чтении YAML восстанавливается и из него выделяется MET. В корне репозитория .holkas. При записи одного метода берётся существующий файл класса, остальные объекты сохраняются; если класса нет и CLS не едет, запись отклоняется.
S3
JSON в ZIPMethod/Request%7CSave.jsonОтдельный JSON, устроенный так же, как у «Файла пакета»: unitCode, code и parameters. В manifest.json метод указан как MET / Request|Save; реквизиты класса лежат отдельно в Class/Request.json.
Одиночный MET без CLS сохраняется и читается обратно.
Файл пакета
JSON в ZIPMethod/Request%7CSave.jsonОтдельный JSON непосредственно содержит unitCode, code и parameters. В manifest.json метод указан как MET / Request|Save. При выборе класса его реквизиты лежат отдельно в Class/Request.json.
Метод находится по оглавлению и читается из отдельного Method JSON. Такой ZIP сохраняет метод и без CLS; при переносе в БД класс всё равно должен существовать или создаваться в том же плане.
ZIP из S3 и «Файла пакета» устроены одинаково, архив одного способа загружается другим. ZIP, записанные в S3 версией Holkas 0.1.30 или более ранней, хранили метод в списке methods внутри Class/Request.json; такие архивы по-прежнему читаются обоими способами.
В адресе файла | закодирован как %7C, а в поле и оглавлении сохраняется Request|Save. Не переименовывайте файл отдельно от адреса. Нули и пустые списки сохраняются, при записи null опускается. Текущий метод не содержит поля папки Паруса, не ищет и не создаёт каталоги: UnitCode указывает класс, а Class/ и Method/ — каталоги файлов.
Один метод в YAML класса и JSON в ZIP
Сокращённые учебные фрагменты с одним аргументом; остальные реквизиты и элементы опущены. Это не готовые файлы для загрузки. Сохраните полный список Parameters: [] означает его очистку.
Git — внутри Class/Request.yaml:
UnitCode: Request
Methods:
- UnitCode: Request
Code: Save
MethodType: 0
Name: P_REQUEST_SAVE
Caption: Сохранить
Accessibility: 1
Parameters:
- Name: NRN
Domain: TRN
Caption: Идентификатор
Position: 1
InOut: 0
LinkType: 2
Context: 0
Mandatory: 0
S3 или «Файл пакета» — Method/Request%7CSave.json:
{
"unitCode": "Request",
"code": "Save",
"methodType": 0,
"name": "P_REQUEST_SAVE",
"caption": "Сохранить",
"accessibility": 1,
"parameters": [
{
"name": "NRN",
"domain": "TRN",
"caption": "Идентификатор",
"position": 1,
"inOut": 0,
"linkType": 2,
"context": 0,
"mandatory": 0
}
]
}
Практические шаги: сохранить доработку в Git, выгрузить и загрузить файл пакета. Устройство ZIP — в справке о пакете.
Основа справки: руководство КОР Парус 8, издание 2026, с. 76–79; текущие DTO, читалки Oracle/PostgreSQL, сравнение, построители, исполнители и файловые транспорты Holkas 0.1.30. Ограничения уточнены чтением определений PostgreSQL 14 / Парус 27.08.2026. Сверено 8 ноября 2026; хранение в ZIP уточнено 9 ноября 2026. Request и Save — учебные примеры. Новые проверки — локальные планы и форматы; перенос класса с MET из S3 через «Файл пакета» на PostgreSQL и Oracle. Клиенты Паруса не проверялись.