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

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

Пользовательская процедура

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

Парус · Oracle и PostgreSQL

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

Операция Паруса: все поля, параметры, формы, подключения к разделам, команды, зависимости и файлы переноса.

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

Парус 8 · Пользовательские процедуры

Пользовательская процедура описывает прикладную операцию: её реализацию, ввод параметров и подключение к разделам. Например, «Обработать заявку» получает примечание и вызывает подготовленную процедуру базы.

ИдентификаторPCE + Code
Вложенные частиПараметры, формы, связи
Удаление процедурыНе формируется

Пользовательская процедура в Парусе

PCE — описание операции в системном разделе «Пользовательские процедуры» Паруса. В доработке КОР (Конструктора отраслевых расширений) её можно вызвать кнопкой формы класса. Подключение к классу и кнопка, которая ссылается на код процедуры, — разные настройки.

В учебном примере ProcessRequest операция «Обработать заявку» вызывает P_PROCESS_REQUEST и получает строковый параметр SNOTE с подписью «Примечание». Параметр, подпись подключения к разделу и текст подтверждения входят в PCE. Исходный код P_PROCESS_REQUEST — отдельный объект процедуры БД или функции.

Holkas переносит метаданные PCE на Oracle и PostgreSQL. Тексты блоков не переводятся между диалектами SQL. Перенос описания не является запуском прикладной операции или выполнением скрипта автора SCR; реализацию для целевой СУБД нужно подготовить отдельно.

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

Внешние ссылки: реализация БД, классы, методы их вызова и параметры, пиктограмма, приложения, дополнительный словарь. Сам выбор PCE не добавляет их все в перенос. Поддерживаемые зависимости можно включить через план; словарь и получателей назначений готовят в приёмнике.
Три ветви принадлежат одной PCE. Программные блоки — поля самой процедуры, а не отдельные дочерние объекты. Коды PCE.Param, PCE.VF и PCE.Link обозначают команды частей.

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

52 поля · 5 групп

Все задаваемые поля модели: 14 у процедуры, 15 у параметра, 6 у подключения, 15 у формы и 2 у назначения. Техническое имя совпадает с Git YAML; рядом — имя в JSON для S3 и «Файла пакета».

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

Ключ определяет объект или элемент внутри родителя. У назначения заполняют ровно одно поле: Role или User. Сравнивается означает, что различие учитывается в плане; возможность записи проверяется отдельно. По элементам — список получает команды отдельных частей.

Create — создать, Update — изменить, Delete — удалить. При создании передаются настройки новой записи; при обновлении — настройки существующей. Допустимость значений проверяет Парус.

Пользовательская процедура · PCE14 полей
CodeJSON: codeстрокаКлючМнемокод
Назначение
Код процедуры Паруса, например ProcessRequest, без схемы БД.
При переносе:
Другой Code означает другую процедуру. Если нового кода в приёмнике нет, Holkas создаёт её; прежнюю автоматически не удаляет и ссылки кнопок не переписывает.
NameJSON: nameстрокаСравниваетсяНаименование
Назначение
Название операции для человека, например «Обработать заявку».
При переносе:
Изменение даёт Update PCE. Процедура с тем же Code остаётся тем же объектом.
CrnNameJSON: crnNameстрокаСравниваетсяПапка каталога
Назначение
Название папки раздела «Пользовательские процедуры», в которой лежит процедура. Это имя самой папки; путь к ней хранится в CrnPath.
При переносе:
При Create / Update PCE папка ищется по имени: в разделе одной организации и версии двух одноимённых папок не бывает. Если её нет, недостающие папки создаются по пути CrnPath. Update перемещает процедуру в найденную папку. «Решение/Обработка» в CrnName — одно имя, а не путь.
CrnPathJSON: crnPathсписок строк / nullСравниваетсяПуть каталога
Назначение
Имена папок от первого уровня под корнем раздела «Пользовательские процедуры» до папки процедуры включительно, например «Решение», «Обработка»; последний элемент равен CrnName. Корень раздела в путь не входит: в приёмнике берётся корень его организации и версии. [] — процедура лежит прямо в корне; отсутствие поля — путь неизвестен (файл прежней версии Holkas).
При переносе:
В базе Паруса сравнивается только имя папки: одноимённая папка приёмника используется там, где лежит, и не перемещается. Отсутствующую папку Holkas создаёт по пути: имеющиеся уровни использует, недостающие создаёт под предыдущим. В Git, S3 и «Файле пакета» сравнивается весь путь; его изменение даёт Update PCE. В плане путь показан как «Решение / Обработка», пустой — «(корень)». Путь, который кончается не папкой CrnName, отклоняет план до применения.
ProcedureTypeJSON: procedureTypeцелоеСравниваетсяТип процедуры
Назначение
Вид реализации операции Паруса. В сохранённом примере 0 — хранимая процедура БД.
При переносе:
Передаётся в Create / Update PCE. Holkas не переводит вид и программный текст при смене СУБД; допустимость сочетания настроек проверяет Парус.
ProcedureAutoJSON: procedureAutoцелоеСравниваетсяСпособ исполнения
Назначение
Сохранённый в Парусе способ исполнения; 0 — неавтоматическая процедура в проверенном примере.
При переносе:
Сравнивается и передаётся через PCE. Это настройка самой операции Паруса, не разрешение Holkas автоматически выполнить её при переносе.
ProcedureNameJSON: procedureNameстрока / nullСравниваетсяХранимая процедура
Назначение
Имя реализации в базе, например P_PROCESS_REQUEST. Её исходный код сюда не входит.
При переносе:
При непустом имени PCE ждёт Create / Update реализации целевой СУБД: JPR на Oracle, JFP или JPP на PostgreSQL. Зависимости можно добавить в состав; одно имя не переносит реализацию.
BlockTextJSON: blockTextстрока / nullСравниваетсяОсновной блок
Назначение
Программный текст основного блока, сохранённый в настройках пользовательской процедуры.
При переносе:
Изменение только текста уже даёт Update PCE. Он передаётся Парусу как текст: Holkas не переводит диалект и не выполняет блок как скрипт автора SCR.
AlterTextJSON: alterTextстрока / nullСравниваетсяБлок изменения
Назначение
Второй программный блок из описания операции Паруса.
При переносе:
Сравнивается отдельно от BlockText; разница даёт Update PCE. Передаётся вместе с остальными реквизитами, без автоматической адаптации SQL.
LockForExecJSON: lockForExecцелое / nullСравниваетсяБлокировка при выполнении
Назначение
Настройка блокировки при выполнении пользовательской процедуры в Парусе.
При переносе:
Передаётся в Create / Update PCE. null и 0 различаются при сравнении; это не блокировка очереди команд Holkas.
SystemImageJSON: systemImageстрока / nullСравниваетсяПиктограмма
Назначение
Код пиктограммы Паруса; RN из исходной базы не переносится.
При переносе:
Сравнивается и передаётся Парусу кодом. Непустой код ждёт Create PIC; если пиктограммы нет ни в наборе, ни в приёмнике, план называет её недостающей зависимостью. Без неё Парус отказывает в записи: «Пиктограмма … не определена».
ParametersJSON: parametersсписокПо элементамПараметры процедуры
Назначение
Полный список параметров: тип, позиция, привязка, умолчание и прочие настройки.
При переносе:
Сопоставляются по ParameterName. Новые создаются, изменившиеся обновляются, отсутствующие удаляются через PCE.Param. При создании PCE Holkas сначала удаляет параметры, автоматически заведённые Парусом, затем переносит этот список.
VisualFormsJSON: visualFormsсписокПо элементамВизуальные формы
Назначение
Формы ввода параметров процедуры с настройками, текстами, назначениями и приложениями.
При переносе:
Сопоставляются только по FormClass. PCE.VF добавляет, меняет и удаляет формы; назначения и приложения получают свои команды.
LinksClassJSON: linksClassсписокПо элементамСвязи с разделами
Назначение
Подключения процедуры к классам Паруса и настройки её запуска из этих разделов.
При переносе:
Сопоставляются по UnitCode. PCE.Link создаёт, меняет или снимает подключение. Снятие связи не удаляет ни класс, ни пользовательскую процедуру.
Параметр процедуры · PCE.Param15 полей
PositionJSON: positionцелоеСравниваетсяПозиция
Назначение
Порядковое место параметра в Парусе.
При переносе:
Разница даёт Update PCE.Param; позиция записывается вместе с полями параметра. Отдельного PCE.ParamPos или SetOrder нет. Перестановка записей в файле без изменения Position команды не даёт.
ParameterNameJSON: parameterNameстрокаКлючИмя параметра
Назначение
Техническое имя, например SNOTE; ключ внутри процедуры.
При переносе:
Смена имени в полном списке означает Delete старого и Create нового параметра. Это не простая правка подписи Name. Проверьте ссылки детей InitParameter и вызываемую реализацию.
DataTypeJSON: dataTypeцелоеСравниваетсяТип данных
Назначение
Тип параметра Паруса. В сохранённом примере 0 — строка (varchar2).
При переносе:
Передаётся через PCE.Param; Holkas не подбирает другой тип под сигнатуру реализации. Изменение настроек не является преобразованием прикладных данных.
IsBooleanJSON: isBooleanцелоеСравниваетсяЛогическое значение
Назначение
Признак логического типа параметра.
При переносе:
Сравнивается и передаётся вместе с DataType. Допустимые сочетания проверяет Парус; признак не заменяет тип и значение по умолчанию.
ParameterTypeJSON: parameterTypeцелое / nullСравниваетсяНаправление параметра
Назначение
Направление передачи значения; в сохранённом примере 0 — входной (in).
При переносе:
Передаётся при Create / Update PCE.Param. null и 0 — разные значения, пропуск не означает сохранить прежнее направление.
NameJSON: nameстрокаСравниваетсяНаименование
Назначение
Подпись параметра для человека, например «Примечание».
При переносе:
Изменение даёт Update PCE.Param при прежнем ParameterName. Ключ и ссылки на параметр от изменения подписи не меняются. Если значение переходит от одного элемента к другому, Holkas сначала освобождает его, а обмен по кругу не переносит и называет в плане — см. «Параметры меняются подписями».
LinkIngJSON: linkIngцелоеСравниваетсяТип привязки
Назначение
Способ получения значения параметра. В текущем коде 2 допускает родительский параметр, 5 требует дополнительный словарь.
При переносе:
Имя поля в YAML именно LinkIng, в JSON — linkIng. Передаётся вместе с полями привязки. Holkas не заполняет недостающие ссылки по одному числовому коду.
UnitCodeJSON: unitCodeстрока / nullСравниваетсяКод раздела
Назначение
Класс Паруса, к которому относится привязка параметра.
При переносе:
При непустом коде команда ждёт Create CLS. Для метода вызова раздел обязателен; метод без UnitCode отклоняется до записи параметра.
CodeMethodCallJSON: codeMethodCallстрока / nullСравниваетсяМетод вызова раздела
Назначение
Код метода вызова MEC указанного класса.
При переносе:
При заданных UnitCode и CodeMethodCall ждёт Create MEC. В приёмнике код разрешается во внутренний RN. Это не имя исполняемой процедуры PCE.
NameParameterMethodCallJSON: nameParameterMethodCallстрока / nullСравниваетсяПараметр метода вызова
Назначение
Имя параметра выбранного MEC.
При переносе:
При полной ссылке ждёт Create MEC.Param; при записи ищет параметр в приёмнике. Заданное имя без CodeMethodCall отклоняется. Сам параметр метода этим полем не создаётся.
CodeAdditionalDictionaryJSON: codeAdditionalDictionaryстрока / nullСравниваетсяДополнительный словарь
Назначение
Код EXTRA_DICTS. При LinkIng = 5 обязателен.
При переносе:
Словарь ищется по коду в версии организации приёмника. Holkas не переносит сам словарь; план предупреждает об отсутствии, при применении Holkas отказывает. Старый файл без кода при LinkIng = 5 нужно выгрузить заново.
VisualizeJSON: visualizeцелоеСравниваетсяВизуализация
Назначение
Признак отображения параметра в интерфейсе ввода Паруса.
При переносе:
Сравнивается и записывается через PCE.Param. Он не создаёт отдельную визуальную форму и не отменяет обязательность параметра.
MandatoryJSON: mandatoryцелоеСравниваетсяОбязательность
Назначение
Признак обязательного заполнения параметра.
При переносе:
Передаётся через PCE.Param. Например, обязательный видимый SNOTE потребует значение при запуске; перенос признака сам процедуру не запускает.
DefaultValueJSON: defaultValueстрока / nullСравниваетсяЗначение по умолчанию
Назначение
Текстовое представление начального значения; в примере SNOTE — «Учебное значение».
При переносе:
Передаётся через PCE.Param. null не является командой сохранить прежнее умолчание. Строка «0» остаётся строкой и не равна отсутствию значения.
InitParameterJSON: initParameterстрока / nullСравниваетсяРодительский параметр
Назначение
ParameterName другого параметра этой же PCE; Парус допускает родителя при LinkIng = 2.
При переносе:
Создание или изменение ребёнка ждёт создания родителя. Перед удалением родителя ребёнок должен быть удалён либо отпустить ссылку. Отсутствие поля в старом файле равно null и может очистить связь.
Визуальная форма · PCE.VF / PCE.VF.Priv / PCE.VF.App15 полей
FormClassJSON: formClassстрокаКлючИмя формы
Назначение
Ключ формы внутри процедуры. У PCE, в отличие от CLS, для сопоставления используется только это имя.
При переносе:
Смена имени в полном списке даёт Delete прежней и Create новой PCE.VF. Две формы одной процедуры с одинаковым FormClass нельзя однозначно сопоставить.
FormNameJSON: formNameстрокаСравниваетсяНаименование формы
Назначение
Подпись формы для человека.
При переносе:
Изменяется через Update PCE.VF при сохранении ключа и допустимых настроек. Отдельного переименования ключа этим полем нет.
FormKindJSON: formKindцелоеСравниваетсяВид формы
Назначение
Вид формы Паруса; для формы пользовательской процедуры в обследованной реализации используется 1.
При переносе:
Записывается при создании. Смена при прежнем FormClass даёт Update PCE.VF, но применение в БД отказывает целиком. Автоматического удаления и пересоздания нет.
ShowMethodJSON: showMethodстрока / nullСравниваетсяМетод вызова формы
Назначение
Метод вызова формы раздела UserProcedures; для формы вида 1 должен оставаться null: Парус запрещает здесь метод показа.
При переносе:
При создании передаётся Парусу. У PCE нет ребра на MEC по этому полю. Смена ShowMethod при прежнем FormClass даёт Update PCE.VF, который в БД отклоняется целиком. Сохраняйте значение полного экспорта.
LinkApplicationJSON: linkApplicationцелоеСравниваетсяУчитывать приложения
Назначение
Признак использования списка приложений формы: 1 — включён, 0 — выключен.
При переносе:
Записывается через PCE.VF. Сам список Applications переносится даже при выключенном признаке; его наличие не включает признак автоматически.
LinkPrivilegesJSON: linkPrivilegesцелоеСравниваетсяУчитывать назначения
Назначение
Признак использования назначений ролям и пользователям: 1 — включён, 0 — выключен.
При переносе:
Записывается через PCE.VF отдельно от списка Privileges. Одна запись роли в списке не гарантирует выбор этой формы для пользователя.
FormActiveJSON: formActiveцелоеСравниваетсяДоступность формы
Назначение
Признак доступности формы в Парусе: 1 — включена, 0 — выключена.
При переносе:
Изменяется через PCE.VF. Наличие описания и назначений не отменяет выключенную доступность.
EventsLanguageJSON: eventsLanguageцелое / nullСравниваетсяЯзык обработчиков
Назначение
Код языка обработчиков формы. null — язык не задан; 0 — уже заданное значение.
При переносе:
Из незаданного состояния язык можно установить. Смена или сброс уже заданного языка вызывает предупреждение плана и отказ Update PCE.VF до записи этой формы. Для иного языка нужна новая форма.
FormDataJSON: formDataстрока / nullСравниваетсяОписание формы
Назначение
Текст основного описания формы. XML сохраняется как строка внутри записи формы.
При переносе:
Непустой изменяемый XML проверяется на синтаксис, предупреждение не запрещает перенос. null пропускает запись этого тела в БД и сохраняет прежнее; пустая строка передаётся на запись. Полной проверки ссылок внутри формы процедуры нет.
FormEventsJSON: formEventsстрока / nullСравниваетсяОбработчики событий
Назначение
Основной текст обработчиков формы на выбранном языке.
При переносе:
Записывается вместе с PCE.VF, если не null. null сохраняет прежний текст в БД. Holkas не переводит обработчики между языками и не доказывает их работоспособность.
FormDataExtJSON: formDataExtстрока / nullСравниваетсяДополнительное описание формы
Назначение
Дополнительное текстовое описание в отдельной колонке Паруса.
При переносе:
Как FormData: синтаксическая проверка изменяемого непустого XML; null пропускает запись в БД. Не считайте перенос основного тела переносом этого поля.
FormEventsExtJSON: formEventsExtстрока / nullСравниваетсяДополнительные обработчики
Назначение
Дополнительный текст обработчиков в отдельной колонке Паруса.
При переносе:
Записывается вместе с PCE.VF только при значении, отличном от null. Переносится как текст без автоматической адаптации к другому клиенту.
FormJSON: formстрока / nullСравниваетсяОбщее поле модели формы
Назначение
Общее поле принадлежности формы действию, используемое у CLS. В настоящей выгрузке PCE оно не задаётся: владелец — сама процедура.
При переносе:
Для PCE сохраняйте null. Поле участвует в сравнении общей модели, но при применении Holkas не использует его для записи владельца. Произвольное значение не создаёт привязку к действию.
PrivilegesJSON: privilegesсписок / nullПо элементамНазначения ролям и пользователям
Назначение
Полный список назначений формы, в том числе при LinkPrivileges = 0.
При переносе:
PCE.VF.Priv добавляет и снимает назначения. null или отсутствие списка сохраняет текущие назначения этой формы; [] явно снимает все. Порядок записей не важен. Требуются существующие роли и пользователи Паруса.
ApplicationsJSON: applicationsсписок строк / nullПо элементамПриложения формы
Назначение
Коды приложений APP, в которых используется форма. Это коды, а не наименования приложений.
При переносе:
PCE.VF.App добавляет и снимает связи, создание ждёт APP Create. null сохраняет текущие связи этой формы; [] явно снимает все. Порядок и повторения кодов не задают разные связи.
Назначение формы · PCE.VF.Priv2 поля
RoleJSON: roleстрока / nullКлючРоль Паруса
Назначение
Имя роли; заполняется ровно одно из Role или User.
При переносе:
Ключ назначения — role:Имя. Роль должна существовать в приёмнике; при отличающихся именах используется parusRoleMap. Создание и удаление назначения не создаёт и не удаляет роль.
UserJSON: userстрока / nullКлючПользователь Паруса
Назначение
Логин AUTHID; заполняется вместо Role.
При переносе:
Ключ назначения — user:Логин. Пользователь должен существовать. Членство в ролях и права разделов этим назначением не переносятся.
Полные списки, null и пустые значения

Parameters, VisualForms и LinksClass — полные списки выбранной PCE. [] означает удалить все соответствующие части. Загрузка из ZIP (S3 и файл пакета) отвергает отсутствие или null этих списков. Чтение из Git устроено иначе: не рассчитывайте на такую же защиту неполного YAML.

У Privileges и Applications отсутствие или null означает неизвестный состав старого файла: назначения сохранившейся формы не сравниваются и сохраняются, о чём план сообщает. [] явно снимает связи. У InitParameter другое правило: отсутствие равно null и может очистить родителя.

Строковое сравнение приравнивает null к пустой строке, CRLF к LF. Пробелы и регистр содержимого сохраняются. Числовой 0 не равен null. Для четырёх текстовых тел формы null отдельно означает пропустить запись этого тела в БД; это не общее правило для всех строк PCE.

Служебные сведения и границы модели

RN, PRN и внутренние номера ссылок разрешаются в приёмнике. Путь папки хранится в CrnPath именами папок, без корня раздела. Form у PCE остаётся null, поскольку владелец формы определяется по самой процедуре.

В JSON формы есть вычисляемое identity со значением FormClass|FormKind|ShowMethod|Form; в Git YAML оно не записывается. При чтении оно не задаётся отдельно и не заменяет ключ PCE.VF: здесь используется только FormClass. Не правьте identity как настройку формы.

Числовые коды не являются общим перечислением для всех объектов: например, ParameterType = 0 в сохранённой PCE означает входной параметр. Сохраняйте значения полного экспорта, а допустимые изменения задавайте средствами Паруса. Настройки клиентского поведения не доказывают работоспособность во всех версиях Windows и web.

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

Шесть кодов охватывают саму процедуру и все её части. Create — создание, Update — изменение, Delete — удаление. Пиктограммы имеют подписи по наведению, клавиатурному фокусу и нажатию.

Процедура и вложенные части6 кодов
PCE
CreateUpdate

Пользовательская процедура

Создаёт описание новой операции либо меняет её реквизиты и программные блоки. Подготавливает папку, при необходимости создавая недостающие уровни пути; при обновлении перемещает процедуру. При создании удаляет параметры, которые Парус завёл автоматически: затем выполняются команды списка из источника. Изменение одних частей не требует Update PCE.

Ключ: Код процедуры

PCE.Param
CreateUpdateDelete

Параметр процедуры

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

Ключ: Процедура|Имя параметра

PCE.VF
CreateUpdateDelete

Визуальная форма

Создаёт форму, меняет её настройки и заданные текстовые поля либо удаляет форму. Ключ — FormClass. Изменение FormKind, ShowMethod или уже заданного EventsLanguage отклоняет Update в БД целиком. null в одном из четырёх тел пропускает запись именно этого тела.

Ключ: Процедура|Имя формы

PCE.VF.Priv
CreateDelete

Назначение формы

Назначает форму роли или пользователю Паруса либо снимает назначение. Другой получатель означает другую запись, Update нет. Роли, пользователи, членство и права разделов не создаются.

Ключ: Процедура|Форма|role:Роль или user:Логин

PCE.VF.App
CreateDelete

Приложение формы

Подключает форму к приложению либо снимает связь. Код приложения — ключ записи, Update нет. При снятии связи сохраняются и форма, и приложение.

Ключ: Процедура|Форма|Код приложения

Удаление целой PCE по отсутствию в наборе не формируется. SetOrder нет. В Git команды сохраняют новое описание; вызовы процедур Паруса относятся к БД. S3 и «Файл пакета» создают новый ZIP.

Пример: удалить родителя, сохранить ребёнка

У ProcessRequest есть PARENT и CHILD с InitParameter = PARENT. В источнике остаётся CHILD без этой ссылки; PARENT удалён. Прочие настройки допустимы для нового состояния.

  1. Update PCE.Param · ProcessRequest|CHILD очищает InitParameter.
  2. Delete PCE.Param · ProcessRequest|PARENT удаляет освобождённого родителя.

Если ребёнок тоже удалён из полного списка, сначала выполнится его Delete. В отличие от параметров отчёта, Парус при удалении параметра процедуры сам не сбрасывает ссылки детей. Сокращённый список нельзя использовать как обозначение «остальное не меняется».

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

Переименование процедуры или параметра

Смена Code создаёт другую PCE, прежняя остаётся. Исправьте отдельно ссылки кнопок и подключения, которым нужна новая операция. Смена ParameterName внутри выбранной PCE, напротив, удаляет старый параметр и создаёт новый.

Параметры меняются подписями

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

Цепочка — например, SDATE: «Дата» → «Дата с», SDATE_TO: «Дата с» → «Дата по». Holkas упорядочивает команды сам: сначала освобождает значение, потом занимает его. Всё проходит за один перенос.

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

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

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

Неполный список и автоматические параметры

При Create PCE Holkas очищает параметры, автоматически созданные Парусом, чтобы воспроизвести экспортированный список. Если Parameters в источнике = [], новая процедура останется без параметров, а не с автоматически найденными аргументами. Используйте полный экспорт; сверяйте список с реализацией БД.

Нужно сохранить дерево папок

Для процедуры из «Пользовательские процедуры → Решение → Обработка» в файл попадут CrnName = «Обработка» и CrnPath «Решение», «Обработка». Корень раздела не записывается: в приёмнике используется корень его организации и, если применимо, версии.

Приёмник ищет папку «Обработка» по имени в UserProcedures. Если её нет, Holkas проходит путь: найденную «Решение» использует как есть, «Обработка» создаёт под ней; отсутствующую «Решение» тоже создаёт. Папки готовятся внутри команды PCE, отдельных строк плана для них нет. При Update PCE процедура перемещается в нужную папку.

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

В файле прежней версии Holkas пути нет. При совпадающем имени папки путь берётся у приёмника и команд нет; иначе папка ищется по имени и при отсутствии создаётся под корнем, о чём план предупреждает. Выгрузите процедуру заново, чтобы описание получило путь; в Git, S3 и «Файле пакета» старый файл без пути получит Update PCE.

Не найден дополнительный словарь

При LinkIng = 5 параметр требует CodeAdditionalDictionary. Если кода нет в старом файле, план просит повторно выгрузить PCE. Если код есть, но такого словаря нет в версии организации приёмника, план называет отсутствие. Предупреждение не снимает команду: запись параметра завершится отказом.

Подготовьте дополнительный словарь средствами Паруса или возьмите полный свежий экспорт, если словарь уже есть. Сам EXTRA_DICTS Holkas не переносит. Приёмник без выбранной организации ищет код по всем версиям.

В старом файле нет родительского параметра

Файл до поддержки InitParameter не содержит родителя: null может сформировать Update с очисткой существующей связи. Чтобы перенести родителя, выгрузите процедуру заново. Не подставляйте имя родителя по позиции параметра.

Цикл родителей и ссылка на себя

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

PostgreSQL: имя реализации перегружено

С релиза Паруса 29.05.2025 Create / Update PCE с заполненным именем реализации может отказать, если у этого имени в схеме parus несколько функций или процедур. До этой границы проверка касается Create для ProcedureType = 0 и ProcedureAuto = 0. План заранее называет перегруженное имя, но перенос не запрещает.

Подготовьте одну подходящую реализацию имени с учётом её других пользователей и сравните заново. Имена вида ПАКЕТ.ПРОЦЕДУРА эта проверка не разбирает. Она не является проверкой типов всех параметров PCE. Совместимость релизов.

Нужно изменить способ открытия формы

Ключ формы PCE — FormClass. Смена FormKind или ShowMethod при прежнем имени даёт Update PCE.VF, который отклоняется целиком. Для другого способа открытия подготовьте новую форму и её назначения; автоматического пересоздания нет.

Нужно изменить язык обработчиков формы

Уже заданный EventsLanguage, включая 0, нельзя сменить или сбросить. План предупреждает, при применении Holkas отказывает до записи этой формы; первоначальная установка из null допустима. Этот отказ не означает отката прочих частей PCE: общего ожидания Update формы или корня у них нет.

XML верен, но объектов для формы не хватает

Изменяемые непустые FormData и FormDataExt проверяются на синтаксис XML. Ошибка даёт предупреждение и оставляет команду в плане. Исправьте текст в источнике и повторите сравнение.

Полный поиск ссылок, как у CLS.VF, к PCE.VF не применяется. Отсутствие предупреждения не доказывает готовность объектов кнопок и словарей; их готовят отдельно. null в теле формы сохраняет прежний текст БД, пустая строка передаётся на запись.

Используется новая пиктограмма

SystemImage хранит код, и PCE ждёт Create PIC. Если пиктограммы с этим кодом нет в приёмнике, а в набор она не выбрана, план называет её недостающей зависимостью — добавьте её в набор, и она запишется раньше процедуры. Без неё Парус отказывает в записи: «Пиктограмма … не определена». Не подставляйте RN пиктограммы исходной базы вместо кода.

Пользователь не получает форму

Сверьте FormActive, LinkPrivileges, LinkApplication, назначения и приложения. Наличие формы не создаёт роли, пользователей и права. Настройка соответствия ролей и перенос назначений форм.

Процедура перенесена, но кнопка в клиенте не работает

Подключение PCE к классу и кнопка UserProcedureCode в его форме — отдельные настройки. В сохранённом опыте Паруса 27.08.2026 подключение делало процедуру доступной в выборе кнопки. Windows-кнопка открывала ввод SNOTE и запускала процедуру; web 8.561.9735.5514 отвергал обработчик кнопки. Это граница прежнего опыта, а не утверждение обо всех нынешних клиентах. Проверяйте работу в используемом клиенте.

Рёбра команд

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

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

Отвязать дочерний параметрUpdate PCE.Param · CHILD
Удалить родителяDelete PCE.Param · PARENT

Например, CHILD больше не использует PARENT. Сначала нужно записать это изменение; иначе удалению PARENT помешает ссылка ребёнка.

Ниже — непосредственные правила PCE и её частей, входящая ссылка из формы класса, общие правила скриптов и сохранённых зависимостей Oracle. Количество правил не равно числу рёбер в каждом плане. Уже существующий объект не требует команды создания.

Собственные части и внешние ссылки18 правил
Create / Update JPR; на PostgreSQL JFP или JPPCreate / Update PCE

Когда: ProcedureName непустой. Зачем: Реализация должна быть подготовлена для целевой СУБД.

Create PICCreate / Update PCE

Когда: SystemImage непустой. Зачем: Парус принимает пиктограмму кодом и записывает процедуру только с существующей. Update PIC это правило не ожидает.

Create PCECreate PCE.Param

Когда: Новые процедура и параметр. Зачем: Параметру нужна запись владельца.

Create CLSCreate / Update PCE.Param

Когда: UnitCode задан. Зачем: Сначала нужен класс привязки.

Create PCE.Param родителяCreate / Update PCE.Param ребёнка

Когда: InitParameter непустой и не равен ParameterName. Зачем: Приёмник ищет родителя в этой же процедуре.

Update PCE.Param ребёнкаDelete PCE.Param прежнего родителя

Когда: Изменение отпускает прежний непустой InitParameter, не равный самому параметру. Зачем: Ссылка ребёнка больше не мешает удалению.

Delete PCE.Param ребёнкаDelete PCE.Param родителя

Когда: У удаляемого ребёнка задан другой параметр как InitParameter. Зачем: Сначала снимается запись, удерживающая родителя.

Create MECCreate / Update PCE.Param

Когда: Заданы UnitCode и CodeMethodCall. Зачем: Сначала нужен метод вызова раздела.

Create MEC.ParamCreate / Update PCE.Param

Когда: Также задан NameParameterMethodCall. Зачем: Сначала нужен параметр этого метода вызова.

Create PCECreate PCE.VF

Когда: Новая форма новой процедуры. Зачем: Сначала нужен владелец формы.

Create PCE.VFCreate PCE.VF.Priv

Когда: Создаётся назначение формы. Зачем: Назначение ссылается на готовую форму.

Create PCE.VFCreate PCE.VF.App

Когда: Создаётся связь с приложением. Зачем: Связь ссылается на готовую форму.

Create APPCreate PCE.VF.App

Когда: Задан код приложения. Зачем: Приложение должно существовать.

Delete PCE.VF.PrivDelete PCE.VF

Когда: Удаляется форма с назначениями. Зачем: Назначения снимаются до формы.

Delete PCE.VF.AppDelete PCE.VF

Когда: Удаляется форма со связями приложений. Зачем: Связи снимаются до формы.

Create PCECreate PCE.Link

Когда: Создаётся подключение новой процедуры. Зачем: Сначала нужна сама процедура.

Create CLSCreate / Update PCE.Link

Когда: Задан UnitCode. Зачем: Подключение требует существующего класса.

Update PCE.Param, отдающий NameUpdate PCE.Param, занимающий Name

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

Входящая ссылка из формы класса1 правило
Create / Update PCECreate / Update CLS.VF

Когда: XML формы класса содержит UserProcedureCode. Зачем: Кнопка получает описание процедуры до записи формы. Это ребро на корень PCE, не на все PCE.Param / PCE.Link.

Общие правила3 правила
SCR с When = BeforeКоманды PCE и частей

Когда: Исполняемый скрипт относится к PCE или ко всему переносу. Зачем: Подготовка скрипта выполняется раньше команд.

Команды PCE и частейSCR с When = After

Когда: Исполняемый скрипт относится к PCE или ко всему переносу. Зачем: Завершение скрипта выполняется после команд.

Create / Update зависимости OracleКоманда PCE, ссылающаяся на неизменяющуюся реализацию

Когда: В составе есть описание реализации с сохранёнными зависимостями, а её корень не меняется. Зачем: Общий проход добавляет зависимости неизменившегося объекта; для зависимой таблицы учитывает и реальные Create / Update её колонок.

Правила без удаления самого объекта3 правила
Delete PCE.ParamDelete PCE

Когда: Правило задано для удаления параметра. Зачем: Удаление целой PCE текущий план не формирует.

Delete PCE.LinkDelete PCE

Когда: Правило задано для удаления подключения. Зачем: Удаление целой PCE текущий план не формирует.

Delete PCE.LinkDelete CLS

Когда: Правило задано для класса удаляемого подключения. Зачем: Удаление целого класса текущий план не формирует.

Условия и границы зависимостей

Реализация PCE выбирается по СУБД приёмника: Oracle JPR, PostgreSQL JFP или JPP. Без приёмника БД тип выводится из источника/состава; при недостатке сведений используется JFP. Рёбра ждут Create и Update нужной реализации; автоматического перевода SQL нет.

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

Нет общего ожидания Update PCE у всех её частей. У PCE нет собственного ребра на дополнительный словарь, на MEC по ShowMethod формы или на папку. Папка готовится внутри корневой команды. Роли и пользователи проверяются в приёмнике, но не создаются командами назначений.

Поиск ссылок внутри XML работает для CLS.VF, а не для PCE.VF. Ребро кнопки класса ждёт корень PCE, но не все параметры и подключения. Не считайте его общей гарантией готовности пользовательской операции к запуску.

В коллекции удаления строятся с конца текущего списка перед изменениями и созданиями. Это исходная очередность среди готовых команд, а не дополнительные рёбра. Position задаёт место параметра в Парусе, не очередь исполнения плана.

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

Начните с каталога CustomProcedure/. Во всех трёх способах один файл содержит реквизиты PCE, программные блоки, параметры, формы и подключения. Тексты форм и их назначения находятся внутри форм; отдельных файлов PCE.Param или PCE.VF нет.

Git

YAML
CustomProcedure/ProcessRequest.yaml

Поля с заглавной буквы: Parameters, VisualForms, LinksClass. У параметра — LinkIng.

Holkas сохраняет описание PCE в YAML и восстанавливает его из YAML. В корне репозитория — .holkas.

S3

JSON в ZIP
CustomProcedure/ProcessRequest.json

Один JSON с parameters, visualForms, linksClass. У параметра — linkIng.

ZIP хранится в S3. Состав берётся из manifest.json, PCE загружается целиком.

Файл пакета

JSON в ZIP
CustomProcedure/ProcessRequest.json

Скачиваемый ZIP содержит такой же JSON PCE со всеми частями. Отдельной записи манифеста на каждый параметр нет.

При загрузке состав сверяется с manifest.json, и восстанавливается описание процедуры.

Для PCE запись в оба ZIP (S3 и файл пакета) и загрузка из них сохраняют и восстанавливают описание вместе с частями. Это проверено для PCE и не обобщается на раскладку всех типов. В manifest.json запись объекта — {"typeCode":"PCE","name":"ProcessRequest"}; подробнее — формат пакета.

Небезопасные символы кодируются в имени файла: / становится %2F. Сам Code от этого не меняется. Папка CrnName и её путь CrnPath — поля внутри файла, они не меняют каталог CustomProcedure/ на диске. Реализация БД, классы, приложения и пиктограммы имеют собственные файлы, если включены в выгрузку.

Одни и те же поля в YAML и JSON

Сокращённые учебные фрагменты показывают код PCE и один параметр. Другие поля и списки опущены. Это иллюстрация устройства, не готовые файлы для загрузки.

Git — CustomProcedure/ProcessRequest.yaml

Code: ProcessRequest
Parameters:
  - Position: 1
    ParameterName: SNOTE
    LinkIng: 0
    DefaultValue: Учебное значение

S3 и «Файл пакета» — CustomProcedure/ProcessRequest.json

{
  "code": "ProcessRequest",
  "parameters": [
    {
      "position": 1,
      "parameterName": "SNOTE",
      "linkIng": 0,
      "defaultValue": "Учебное значение"
    }
  ]
}

Для ручной правки используйте полный экспорт: сохраните все нужные части и ссылки. [] означает пустой список в источнике, а не «остальное опущено». При записи поля с null опускаются; нули и пустые списки сохраняются. Тексты XML и блоков остаются строками внутри YAML/JSON.

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

Основа: сохранённый опыт E020 на Oracle / Парус 27.08.2026 и Holkas 0.1.26 (Windows и web в указанных границах); руководство КОР 2026, с. 69–71, 75–76 — кнопки вызова; решение о родителе и словаре параметра с зеркальными проверками Паруса 28.02.2024; текущие модель, команды, применение и три транспорта Holkas 0.1.30. Сам системный раздел пользовательских процедур не описан в указанной главе руководства КОР. Сверено 9 ноября 2026. ProcessRequest — учебный пример. Новый перенос в БД и проверка запуска процедуры при подготовке страницы не выполнялись.