Парус 8 · Пользовательские процедуры
Пользовательская процедура описывает прикладную операцию: её реализацию, ввод параметров и подключение к разделам. Например, «Обработать заявку» получает примечание и вызывает подготовленную процедуру базы.
PCE + CodeПользовательская процедура в Парусе
PCE — описание операции в системном разделе «Пользовательские процедуры» Паруса. В доработке КОР (Конструктора отраслевых расширений) её можно вызвать кнопкой формы класса. Подключение к классу и кнопка, которая ссылается на код процедуры, — разные настройки.
В учебном примере ProcessRequest операция «Обработать заявку» вызывает P_PROCESS_REQUEST и получает строковый параметр SNOTE с подписью «Примечание». Параметр, подпись подключения к разделу и текст подтверждения входят в PCE. Исходный код P_PROCESS_REQUEST — отдельный объект процедуры БД или функции.
Holkas переносит метаданные PCE на Oracle и PostgreSQL. Тексты блоков не переводятся между диалектами SQL. Перенос описания не является запуском прикладной операции или выполнением скрипта автора SCR; реализацию для целевой СУБД нужно подготовить отдельно.
Что входит в перенос
PCEПользовательская процедураКод, наименование, папка, тип и способ исполнения, имя реализации, программные блоки, блокировка и пиктограммаСправочник полей
52 поля · 5 группВсе задаваемые поля модели: 14 у процедуры, 15 у параметра, 6 у подключения, 15 у формы и 2 у назначения. Техническое имя совпадает с Git YAML; рядом — имя в JSON для S3 и «Файла пакета».
Как читать обозначения и правила
Наведите указатель на пиктограмму, перейдите к ней клавишей Tab или нажмите её — появится пояснение.
Ключ определяет объект или элемент внутри родителя. У назначения заполняют ровно одно поле: 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.Link6 полей
UnitCodeJSON: unitCodeстрокаКлючКод раздела- Назначение
- Класс Паруса, из которого доступна операция.
- При переносе:
- Create связи ждёт Create PCE, а Create / Update связи — Create CLS. Смена кода снимает прежнюю связь и создаёт новую, сохраняя классы.
NameJSON: nameстрокаСравниваетсяНазвание подключения- Назначение
- Наименование операции в настройках связи с этим разделом.
- При переносе:
- Изменение даёт Update PCE.Link. При записи UNITNAME определяется по UnitCode в приёмнике; внутренние номера источника не переносятся.
ReloadViewJSON: reloadViewцелоеСравниваетсяОбновление после выполнения- Назначение
- Режим обновления представления раздела после выполнения операции; Парус допускает коды 0, 1, 2.
- При переносе:
- Передаётся через PCE.Link без подбора режима. Сохраняйте значение из экспорта: это поведение клиента Паруса, а не повторное чтение плана Holkas.
CommitSignJSON: commitSignцелоеСравниваетсяЗавершение транзакции- Назначение
- Признак завершения транзакции при выполнении операции Паруса: 0 или 1.
- При переносе:
- Сравнивается и записывается через PCE.Link. Не задаёт границу транзакций переноса Holkas и не обещает откат всего переноса.
ConfirmationSignJSON: confirmationSignцелоеСравниваетсяПодтверждение выполнения- Назначение
- Признак запроса подтверждения операции Паруса: 0 или 1.
- При переносе:
- Сравнивается и передаётся через PCE.Link. Это подтверждение запуска прикладной операции, а не подтверждение применения плана Holkas.
ConfirmationTextJSON: confirmationTextстрока / nullСравниваетсяТекст подтверждения- Назначение
- Текст вопроса пользователю перед выполнением операции.
- При переносе:
- Передаётся вместе с ConfirmationSign. Парус не принимает заданный текст из одних пробелов; не используйте его вместо осмысленного вопроса.
Визуальная форма · 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:Логин. Пользователь должен существовать. Членство в ролях и права разделов этим назначением не переносятся.
Команды плана
Шесть кодов охватывают саму процедуру и все её части. Create — создание, Update — изменение, Delete — удаление. Пиктограммы имеют подписи по наведению, клавиатурному фокусу и нажатию.
Процедура и вложенные части6 кодов
PCEПользовательская процедура
Создаёт описание новой операции либо меняет её реквизиты и программные блоки. Подготавливает папку, при необходимости создавая недостающие уровни пути; при обновлении перемещает процедуру. При создании удаляет параметры, которые Парус завёл автоматически: затем выполняются команды списка из источника. Изменение одних частей не требует Update PCE.
Ключ: Код процедуры
PCE.ParamПараметр процедуры
Добавляет новый параметр, записывает настройки и Position существующего либо удаляет отсутствующий. При записи ищет метод вызова, его параметр, родителя и словарь в приёмнике. Смена ParameterName означает удаление прежнего и создание нового.
Ключ: Процедура|Имя параметра
PCE.VFВизуальная форма
Создаёт форму, меняет её настройки и заданные текстовые поля либо удаляет форму. Ключ — FormClass. Изменение FormKind, ShowMethod или уже заданного EventsLanguage отклоняет Update в БД целиком. null в одном из четырёх тел пропускает запись именно этого тела.
Ключ: Процедура|Имя формы
PCE.VF.PrivНазначение формы
Назначает форму роли или пользователю Паруса либо снимает назначение. Другой получатель означает другую запись, Update нет. Роли, пользователи, членство и права разделов не создаются.
Ключ: Процедура|Форма|role:Роль или user:Логин
PCE.VF.AppПриложение формы
Подключает форму к приложению либо снимает связь. Код приложения — ключ записи, Update нет. При снятии связи сохраняются и форма, и приложение.
Ключ: Процедура|Форма|Код приложения
PCE.LinkПодключение к разделу
Подключает процедуру к классу, меняет подпись и настройки выполнения либо снимает подключение. Например, Delete для Request убирает эту связь, сохраняя PCE и класс Request.
Ключ: Процедура|Код класса
Удаление целой PCE по отсутствию в наборе не формируется. SetOrder нет. В Git команды сохраняют новое описание; вызовы процедур Паруса относятся к БД. S3 и «Файл пакета» создают новый ZIP.
Пример: удалить родителя, сохранить ребёнка
У ProcessRequest есть PARENT и CHILD с InitParameter = PARENT. В источнике остаётся CHILD без этой ссылки; PARENT удалён. Прочие настройки допустимы для нового состояния.
- Update PCE.Param · ProcessRequest|CHILD очищает InitParameter.
- 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 · CHILDDelete 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
YAMLCustomProcedure/ProcessRequest.yamlПоля с заглавной буквы: Parameters, VisualForms, LinksClass. У параметра — LinkIng.
S3
JSON в ZIPCustomProcedure/ProcessRequest.jsonОдин JSON с parameters, visualForms, linksClass. У параметра — linkIng.
Файл пакета
JSON в ZIPCustomProcedure/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 — учебный пример. Новый перенос в БД и проверка запуска процедуры при подготовке страницы не выполнялись.