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

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

Пользовательское приложение

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

Парус · Oracle и PostgreSQL

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

Программа UAP в КОР Парус 8: все поля, действия, параметры, подключения, рёбра команд и фактическое хранение в Git и ZIP.

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

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

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

ИдентификаторUAP + Code
ПрограммаФайл внутри описания UAP
Удаление приложенияНе формируется

Программа в Парусе

Тип объекта в Holkas: UAP «Пользовательское приложение». Он переносится между базами Паруса на Oracle и PostgreSQL. Запись содержит сам файл программы — скрипт, XLA или COM-библиотеку — и описание её действий. Действия имеют параметры и могут использовать другие пользовательские приложения. Чтобы вызвать действие из раздела, его подключают к этому разделу.

Условная программа RequestTools предоставляет действие RUN «Обработать». У подключения к классу Request может быть собственный заголовок «Обработать заявки». В кнопке формы свойство UserApplicationCode содержит RUN — код действия, а не RequestTools — код программы. Для такой кнопки требуется подключение действия к разделу формы.

Приложение / рабочее место APP описывает рабочее место и его меню. UAP описывает программу с действиями. Глава 3 руководства КОР называет пользовательскими приложениями также рабочие места; при выборе типа Holkas ориентируйтесь на объект, который переносите.

Holkas сохраняет файл в базе, но не запускает его как скрипт автора SCR. Между Oracle и PostgreSQL байты не переводятся: если программа обращается к конкретной СУБД, её совместимость требует отдельной проверки.

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

Готовятся отдельно: домены DOM, классы CLS, методы вызова MEC и их параметры, другие приложения UAP, дополнительные словари. Права на пользовательские приложения в этот состав не входят.
Схема показывает принадлежность. В файле UAP все четыре списка находятся рядом: ActionCode связывает параметр, зависимость и подключение со своим действием. Ссылочная программа и раздел не становятся вложенными объектами UAP.

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

40 полей · 5 групп

Все задаваемые поля программы и четырёх видов её частей. В строке показаны имя Git YAML, соответствующее имя JSON, тип и роль. Ограничения записи относятся к приёмнику БД; особенности файлов разобраны отдельно.

Как читать обозначения

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

Для нового объекта поля передаются при Create. Для существующего — при Update. null и пустая строка равны в сравнении строк; null и числовой 0 различаются. Это правила сравнения, а не обещание одинаковой обработки пустых ссылок процедурами Паруса.

Программа и состав приложения UAP · 16
CodeJSON: codeстрокаКлючМнемокод программы
Назначение
Код приложения Паруса, например RequestTools, без схемы БД.
При переносе:
Другой Code означает другое приложение. Если нового кода в приёмнике нет, создаётся новый UAP; прежний автоматически не удаляется. Подключения и кнопки на новое имя сами не перенастраиваются.
NameJSON: nameстрокаСравниваетсяНаименование
Назначение
Название программы для человека, например «Обработка заявок».
При переносе:
Изменение даёт Update UAP при прежнем Code. Описание записывается отдельно от содержимого файла.
ProgramTypeJSON: programTypeцелоеСравниваетсяТип программы
Назначение
0 — скрипт, 1 — XLA, 2 — COM-библиотека. Это вид программы, а не тип рабочего места APP.
При переносе:
Передаётся в Create / Update UAP. Holkas не преобразует программу при смене вида или СУБД; допустимость сочетания с языком и ProgId проверяет Парус.
ScriptLanguageJSON: scriptLanguageцелое / nullСравниваетсяЯзык скрипта
Назначение
Числовой код языка из настроек Паруса. Сохраняйте значение полного экспорта для выбранного языка; Holkas не заменяет его названием языка.
При переносе:
Сравнивается и передаётся вместе с ProgramType. null отличается от 0; язык не определяется по расширению ProgramName. Текст автоматически на другой язык не переводится.
ProgIdJSON: progIdстрока / nullСравниваетсяИдентификатор COM
Назначение
Идентификатор COM-компонента для соответствующего вида программы.
При переносе:
Передаётся в Create / Update UAP. Запись идентификатора не регистрирует компонент на рабочих компьютерах; необходимую установку выполняют отдельно.
ProgramNameJSON: programNameстрока / nullСравниваетсяИмя файла программы
Назначение
Сохранённое имя файла, например requests.pas. Это реквизит программы, а не имя YAML/JSON приложения.
При переносе:
Изменение даёт Update UAP и передаёт имя Парусу. Сам файл остаётся в Program; Holkas не ищет его на диске по ProgramName.
ProgramSizeJSON: programSizeцелое / nullСравниваетсяРазмер файла
Назначение
Сохранённый размер программы в байтах.
При переносе:
Изменение размера даёт Update UAP и дополнительную запись Program, даже если байты совпадают. Holkas передаёт размер из описания, не вычисляет его заново; при ручной правке согласуйте его с файлом.
ProgramDateJSON: programDateдата и время / nullСравниваетсяДата файла
Назначение
Дата файла программы из Паруса. В JSON — строка ISO без обязательного часового пояса.
При переносе:
Сравнивается и записывается через UAP. Это переносимый реквизит файла; служебная дата загрузки LOAD_DATE в модель не входит и остаётся на стороне приёмника.
ProgramAttributesJSON: programAttributesцелое / nullСравниваетсяАтрибуты файла
Назначение
Сохранённая числовая маска атрибутов файла.
При переносе:
Передаётся Парусу без расшифровки и пересчёта. Это реквизит файла в базе, а не команда сменить права Linux или Windows на выгруженный YAML/JSON.
ProgramCrcJSON: programCrcстрока / nullСравниваетсяКонтрольная сумма программы
Назначение
Сохранённая контрольная сумма из настроек программы.
При переносе:
Сравнивается независимо от Program. Её изменение вызывает Update UAP с повторной записью файла. Holkas не пересчитывает сумму и не использует совпадение суммы вместо сравнения байтов.
NoteJSON: noteстрока / nullСравниваетсяПримечание
Назначение
Дополнительный текст описания приложения.
При переносе:
Изменение даёт Update UAP. При сравнении null и пустая строка равны; если команда возникла по другим полям, передаётся желаемое значение.
ProgramJSON: programбайтыСравниваетсяСодержимое программы
Назначение
Сам файл скрипта, XLA или библиотеки. ProgramName задаёт лишь имя.
При переносе:
Сравнивается по каждому байту и записывается без перекодировки. Даже смена CRLF на LF даёт Update UAP. Текстовый показ скрипта в плане не заменяет эти байты; особенности пустого файла разобраны в ограничениях.
ActionsJSON: actionsсписокПо элементамДействия программы
Назначение
Полный список действий, которые предоставляет программа.
При переносе:
Сопоставляются по Code. UAP.Action создаёт новые, обновляет подписи и удаляет отсутствующие действия. [] действительно снимает все действия выбранного UAP.
ParametersJSON: parametersсписокПо элементамПараметры действий
Назначение
Параметры всех действий приложения. Каждая запись указывает ActionCode.
При переносе:
Ключ — ActionCode + Code. UAP.Param создаёт, меняет и удаляет параметры. В файле список общий, но каждый параметр принадлежит своему действию.
DependenciesJSON: dependenciesсписокПо элементамЗависимости действий
Назначение
Записи об использовании действием другого пользовательского приложения UAP.
При переносе:
Ключ — ActionCode + ApplicationCode. UAP.Depend добавляет и снимает связи. Другое приложение не включается в перенос автоматически.
Действие программы UAP.Action · 2
CodeJSON: codeстрокаКлючМнемокод действия
Назначение
Код действия внутри программы, например RUN. Именно его указывают в UserApplicationCode кнопки формы.
При переносе:
Замена кода в полном списке даёт Delete прежнего и Create нового действия. Согласуйте ActionCode во всех трёх списках и ссылку кнопки; Holkas их автоматически не переименовывает.
NameJSON: nameстрока / nullСравниваетсяНаименование действия
Назначение
Человекочитаемая подпись действия.
При переносе:
Изменение даёт Update UAP.Action, меняющий подпись при прежнем Code. Это не изменение текста программы и не переименование действия.
Параметр действия UAP.Param · 12
ActionCodeJSON: actionCodeстрокаЧасть ключаДействие-владелец
Назначение
Мнемокод действия из Actions этого приложения.
При переносе:
Вместе с Code образует ключ. Перенос параметра к другому действию даёт удаление старой и создание новой записи. При создании параметр ждёт Create своего действия.
CodeJSON: codeстрокаЧасть ключаМнемокод параметра
Назначение
Технический код параметра внутри действия, например SNOTE.
При переносе:
Смена кода означает Delete / Create, если прежняя запись убрана из полного списка. Ссылки InitParameterCode у других параметров нужно согласовать отдельно.
NameJSON: nameстрокаСравниваетсяНаименование параметра
Назначение
Подпись параметра для человека; уникальна внутри действия в модели Паруса.
При переносе:
Меняется через Update UAP.Param. Имя и код — разные поля; Если значение переходит от одного элемента к другому, Holkas сначала освобождает его, а обмен по кругу не переносит и называет в плане — см. «Параметры меняются подписями».
DomainCodeJSON: domainCodeстрокаСравниваетсяДомен
Назначение
Код домена Паруса, задающего тип значения параметра.
При переносе:
Передаётся по коду; параметр ждёт Create DOM, когда домен создаётся в том же плане. Домен нужно включить отдельно либо подготовить в приёмнике.
LinkingJSON: linkingцелоеСравниваетсяТип привязки
Назначение
Способ получения значения: 0 — без привязки, 1 — к методу вызова, 2 — к дополнительному словарю.
При переносе:
Передаётся в Create / Update UAP.Param вместе с полями ссылки. Holkas не подбирает тип привязки по заполненным полям; согласуйте его с UnitCode, методом, родителем и словарём.
UnitCodeJSON: unitCodeстрока / nullСравниваетсяРаздел параметра
Назначение
Код раздела, к которому относится привязка параметра.
При переносе:
Передаётся Парусу кодом; при заполненном коде параметр ждёт Create CLS. Само приложение подключается к разделам отдельными записями Links.
MethodCodeJSON: methodCodeстрока / nullСравниваетсяМетод вызова
Назначение
Код метода вызова раздела UnitCode, используемого привязкой.
При переносе:
При непустых UnitCode и MethodCode UAP.Param ждёт Create MEC. Ссылка разрешается процедурами Паруса; это не имя хранимой процедуры БД.
MethodParameterNameJSON: methodParameterNameстрока / nullСравниваетсяПараметр метода вызова
Назначение
Имя параметра указанного метода вызова.
При переносе:
При заданных разделе, методе и имени UAP.Param ждёт Create MEC.Param. Одинаковые имена у разных методов не означают одну ссылку.
InitParameterCodeJSON: initParameterCodeстрока / nullСравниваетсяИнициализирующий параметр
Назначение
Код родительского параметра, от которого зависит получение значения текущего параметра.
При переносе:
Передаётся Парусу. Непустая ссылка на другой код даёт ожидание Create UAP.Param в том же действии. Это ожидание создания, а не гарантия порядка любых обновлений или удалений родителя.
AdditionalDictionaryCodeJSON: additionalDictionaryCodeстрока / nullСравниваетсяДополнительный словарь
Назначение
Код словаря, используемого соответствующей привязкой.
При переносе:
Передаётся в P_UAMAPARAM_INSERT / UPDATE. Наличие словаря план UAP не проверяет и отдельного ребра не строит; подготовьте его заранее. Перенос такого параметра в живом Парусе в сохранённых проверках не подтверждён.
MandatoryJSON: mandatoryцелоеСравниваетсяОбязательность
Назначение
Признак обязательного заполнения: 1 — да, 0 — нет.
При переносе:
Передаётся через UAP.Param. Он задаёт поведение параметра в Парусе, а не обязательность команды Holkas.
PositionJSON: positionцелоеСравниваетсяПозиция параметра
Назначение
Место параметра в списке своего действия; позиции должны быть уникальны.
При переносе:
Изменение даёт Update UAP.Param. Если место занято другим параметром, при применении этот другой параметр временно переносится на MAX(Position)+1. Его собственная команда должна вернуть его на место, заданное источником; отдельного SetOrder нет.
Зависимость действия UAP.Depend · 2
ActionCodeJSON: actionCodeстрокаЧасть ключаДействие-владелец
Назначение
Код действия, использующего другое приложение.
При переносе:
Вместе с ApplicationCode образует ключ связи. Смена кода снимает прежнюю связь и создаёт новую; само действие от снятия связи не удаляется.
ApplicationCodeJSON: applicationCodeстрокаЧасть ключаДругое приложение
Назначение
Код другого UAP, а не рабочего места APP.
При переносе:
Новый код даёт Create UAP.Depend, прежняя отсутствующая связь — Delete. Создание связи ждёт Create другого UAP; его файл и действия переносятся только при отдельном включении этого UAP.
Полные списки и пустые коллекции

Actions, Parameters, Dependencies и Links задают полный состав выбранного приложения. [] — настоящий пустой список, способный дать удаления. При чтении обоих ZIP отсутствие или null этих списков отклоняется; Git читается иначе, одинаковая проверка неполного файла не гарантируется.

Вычисляемые поля и их запись в файлах

ProgramText вычисляется из Program только для текстового показа скрипта: UTF-8 с меткой BOM, иначе Windows-1251. Пустые байты или нулевой байт дают null. Он не задаёт программу и отсутствует в JSON. Key у параметра, зависимости и подключения вычисляется из двух кодов; в JSON он присутствует, но не задаётся при чтении. Это четыре служебных свойства сверх 40 задаваемых полей.

В Git YAML эти свойства не записываются. Файлы, сохранённые версиями 0.1.28–0.1.31, содержат Key и ProgramText; при чтении они пропускаются, см. ниже.

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

Пять кодов и 13 сочетаний кода с действием. Create — создать, Update — изменить, Delete — удалить. Подписи пиктограмм доступны по наведению, клавиатуре и нажатию.

Программа и части5 кодов
UAP
CreateUpdate

Программа и её реквизиты

Создаёт отсутствующее приложение или меняет описание и файл существующего. При Update сначала передаёт описание без файла, затем отдельно файл, если изменились Program, ProgramSize или ProgramCrc. Разница только в списках частей не создаёт Update UAP. Список действий не передаётся Парусу на автоматическую сверку: действия изменяются своими командами.

Ключ: Код приложения

UAP.Action
CreateUpdateDelete

Действие программы

Создаёт действие с новым Code, меняет Name при прежнем Code или удаляет отсутствующее действие. Перед удалением снимаются его параметры, зависимости и подключения. Эта команда не редактирует исходный текст программы.

Ключ: Код приложения|Код действия

UAP.Param
CreateUpdateDelete

Параметр действия

Создаёт, меняет или удаляет параметр. Передаёт тип привязки и все её реквизиты. Позицию пишет вместе с параметром, при необходимости временно освобождая место; отдельного SetOrder нет.

Ключ: Код приложения|Код действия|Код параметра

UAP.Depend
CreateDelete

Зависимость от другого приложения

Добавляет или снимает связь действия с другим UAP. Здесь только ключевые поля, поэтому Update не возникает. Удаление связи сохраняет обе программы и действие.

Ключ: Код приложения|Код действия|Код другого приложения

Delete UAP и SetOrder не формируются. Команды частей адресуются через выбранное приложение, а не как самостоятельные строки каталога источника. В Git команды меняют описание в файле; в S3 и «Файле пакета» результат выгрузки — новый ZIP. Вызовы процедур Паруса относятся к приёмнику БД.

Пример: убрать действие и его подключения

В приёмнике у RequestTools есть RUN и OLD. У OLD есть параметр SNOTE, зависимость от RequestHelpers и подключение к Request. В источнике оставлен только RUN, записи OLD убраны из всех четырёх списков.

План содержит Delete UAP.Param · RequestTools|OLD|SNOTE, Delete UAP.Depend · RequestTools|OLD|RequestHelpers и Delete UAP.Link · RequestTools|OLD|Request. Все три выполняются перед Delete UAP.Action · RequestTools|OLD. Между самими тремя удалениями отдельного порядка не требуется.

Программа RequestTools, действие RUN, приложение RequestHelpers и раздел Request сохраняются. Кнопку OLD в форме нужно изменить отдельно: удаление действия её XML не переписывает.

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

Переименование и ссылки

Новый Code программы означает другой UAP: прежний сохраняется. Новый Code действия или параметра в полном списке означает Delete / Create. Прежде чем переименовать RUN в PROCESS, согласуйте Actions, ActionCode во всех частях и UserApplicationCode кнопок.

Папка подключения и дерево каталогов

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

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

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

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

Позиции параметров и частичное применение

Чтобы обменять параметры A и B местами, задайте A.Position = 2 и B.Position = 1. Команды UAP.Param временно освобождают занятые места. Переставить только строки JSON недостаточно.

В полном списке из источника позиции должны быть различны в пределах действия. Если A занял место B, а команда B снята или завершилась отказом, B может остаться на временной позиции. Отдельного завершающего SetOrder нет. Не переносите только половину согласованной перестановки.

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

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

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

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

Обмен подписями не равнозначен обмену позициями: позиции переставляет Position.

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

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

Пустой файл при обновлении

Пустая программа (Program = []) при Update очищает файл существующего приложения: байты, размер и контрольная сумма в приёмнике становятся такими же, как в источнике, и повторный план пуст. Проверено переносом на PostgreSQL и Oracle.

Привязка к дополнительному словарю

Для AdditionalDictionaryCode нет проверки наличия словаря в плане UAP. Передача кода не создаёт словарь; подготовьте его и проверьте привязку в приёмнике. В сохранённой проверке словарная привязка оставалась непроверенной.

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

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

Права на приложение

Права на пользовательские приложения не переносятся. Успешная запись UAP и Enabled = 1 не предоставляют пользователю доступ: права настраивают в Парусе приёмника.

Установка COM-компонента

ProgId и байты библиотеки не устанавливают и не регистрируют COM-компонент на компьютерах пользователей. Такая установка находится вне переноса Holkas; её результат в этой работе не проверялся.

Работоспособность программы в клиенте

Работоспособность программы и передачу параметров проверяют в используемом клиенте Паруса. Пустой повторный план доказывает совпадение переносимого описания, но не успешный запуск. Версии Паруса и допустимость настроек могут различаться; см. совместимость релизов.

Git-файлы, сохранённые версиями 0.1.28–0.1.31

Эти версии записывали в YAML вычисляемые Key у параметров, зависимостей и подключений и ProgramText у скрипта, а затем не могли прочитать такой файл: Property 'Key' not found или Property 'ProgramText' not found. Перенос из такого репозитория в базу останавливался на чтении.

Обновите Holkas: текущая версия эти поля при чтении пропускает, программа и части берутся из задаваемых полей. Править файлы вручную не нужно. При следующей записи приложения в Git лишние поля исчезнут из файла, и это будет видно в его diff.

Рёбра команд

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

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

Пример: подключить новое действие к разделу

Создать программу → создать действие → подключить действие к разделу. Если переносится и новая форма класса с кнопкой RUN, после подключения можно записать форму.

Create UAP · RequestTools → Create UAP.Action · RequestTools|RUN → Create UAP.Link · RequestTools|RUN|Request → Create CLS.VF

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

Части одного приложения6
Create UAP→Create UAP.Action

Когда: Новое действие ждёт создания своей программы.

Сначала появляется запись приложения, затем принадлежащее ей действие.

Create UAP.Action→Create UAP.Param

Когда: Создаётся параметр нового действия.

Параметру нужен существующий владелец.

Create UAP.Action→Create UAP.Depend

Когда: Добавляется зависимость действия от другого приложения.

Сначала создаётся действие-владелец.

Create UAP.Param→Create / Update UAP.Param

Когда: Задан InitParameterCode другого параметра того же действия.

Сначала создаётся инициализирующий параметр. При ссылке на собственный Code ребра нет; Update родителя здесь не ожидается.

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

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

Сначала освободить значение, потом занять: цепочка проходит за один перенос.

Внешние ссылки6
Create DOM→Create / Update UAP.Param

Когда: В параметре указан DomainCode.

Домен задаёт тип значения и должен существовать до записи параметра.

Create CLS→Create / Update UAP.Param

Когда: В параметре заполнен UnitCode.

Раздел, на который указывает привязка, должен существовать.

Create MEC→Create / Update UAP.Param

Когда: Непустые UnitCode и MethodCode.

Сначала создаётся метод вызова указанного раздела.

Create MEC.Param→Create / Update UAP.Param

Когда: Дополнительно заполнено MethodParameterName.

Сначала появляется параметр указанного метода вызова.

Create UAP→Create UAP.Depend

Когда: ApplicationCode называет другое приложение.

Используемая программа должна существовать; её Update и завершение всех её частей это ребро не ожидает.

Перед удалением действия3
Delete UAP.Param→Delete UAP.Action

Когда: Убирается действие вместе с параметрами.

Параметры снимаются до каскадного удаления действия в Парусе.

Delete UAP.Depend→Delete UAP.Action

Когда: Убирается действие с зависимостями.

Записи зависимостей удаляются до их владельца.

Кнопка формы класса1
Create / Update UAP.Link→Create / Update CLS.VF

Когда: XML формы класса содержит UserApplicationCode, и в переносимом наборе найден UAP с этим действием и подключением к разделу формы.

Сначала готовится подключение, затем форма с кнопкой. Код в XML — код действия. Это правило для форм класса CLS.VF; его нельзя автоматически переносить на формы REP или PCE.

Порядок относительно скриптов автора2
SCR «до»→команды UAP и его частей

Когда: Скрипт автора относится ко всему переносу или к этому UAP; приёмник исполняет скрипты.

Сначала выполняется подготовка. При отсутствии охраняемых изменений скрипт в план не входит.

Команды UAP и его частей→SCR «после»

Когда: Те же условия, но скрипт задан после изменений.

Скрипт ждёт команды выбранного приложения и его частей.

Правила без удаления самих объектов2
Delete UAP.Action→Delete UAP

Когда: Удаление действия поставлено раньше удаления приложения.

Текущий план не создаёт Delete UAP, поэтому это правило сейчас не даёт исполняемого удаления корня.

Delete UAP.Link→Delete CLS

Когда: Удаление подключения поставлено раньше удаления класса.

Текущий план не создаёт Delete CLS. Снятие подключения само по себе класс не удаляет.

Границы зависимостей

Если нужный объект уже есть и не создаётся, ребро на Create не требует лишней команды. DOM, CLS и MEC здесь ожидаются только при создании, а не при любом Update. Обычные рёбра также связывают выбор и результат зависимых команд. Недостающую зависимость нужно включить отдельно или подготовить в приёмнике; см. разбор зависимостей.

Если в наборе нет UAP с нужным действием и подключением к разделу формы, CLS.VF получает примечание. Оно не доказывает, что приложения нет в приёмнике, и не добавляет UAP автоматически. Кнопка без подходящего подключения может быть недоступна.

У UAP нет ребра на папку, дополнительный словарь или серверный код, упомянутый внутри программы. Внутри каждого списка команды выпускаются в порядке: удаления, затем изменения, затем создания; это исходная очередность, а не ребро между каждой парой команд. У частей нет общего ожидания Update UAP.

Как пользовательское приложение хранится в файлах

Начните с UserApplication/. Файл программы вложен в описание UAP как Program, а не сохраняется отдельным requests.pas. Все действия, параметры, зависимости и подключения находятся в том же файле.

Git

YAML
UserApplication/RequestTools.yaml

Имена с заглавной буквы: Code, Program, Actions, Parameters, Dependencies, Links. Program — последовательность чисел-байтов.

В корне — .holkas. Вычисляемые Key и ProgramText в файл не пишутся; при чтении программа и все части восстанавливаются.

S3

JSON в ZIP
UserApplication/RequestTools.json

В ZIP — одно описание UAP с camelCase: code, program, actions, parameters, dependencies, links. Program записан строкой Base64.

manifest.json перечисляет UAP один раз. ZIP хранится в S3; программа и все части восстанавливаются из JSON.

Файл пакета

JSON в ZIP
UserApplication/RequestTools.json

В скачиваемом ZIP такое же устройство именно для UAP: реквизиты, байты в Base64 и четыре списка вместе.

Holkas читает его по manifest.json и загружает одно описание с частями. В локальной проверке оба вида ZIP прочитаны перекрёстно.

В манифесте запись имеет вид {"typeCode":"UAP","name":"RequestTools"}; устройство метаданных — в справке о пакете. Другое приложение, упомянутое в Dependencies, имеет собственный файл, если включено в выгрузку. То же относится к классам и доменам. Небезопасные символы имени файла кодируются: / становится %2F, значение Code внутри не меняется.

Одинаковые байты в YAML и JSON

Сокращённые фрагменты с условными байтами 00 01 02 FD FE FF. Это не рабочая программа и не готовые файлы для загрузки; остальные поля и списки опущены. YAML показывает, как байты записаны на самом деле.

Git — UserApplication/RequestTools.yaml

Code: RequestTools
ProgramType: 1
Program:
- 0
- 1
- 2
- 253
- 254
- 255

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

{
  "code": "RequestTools",
  "programType": 1,
  "program": "AAEC/f7/"
}

В полном JSON-файле параметры, зависимости и подключения имеют вычисляемое key, например RUN|SNOTE; в YAML его нет. При чтении он не назначается: ключ снова получается из полей ActionCode и Code. ProgramText нет ни в JSON, ни в YAML. При записи null опускается, но сохраняются нули и пустые списки. Исправлять только key недостаточно: меняйте исходные коды и согласованные ссылки.

Практические шаги и границы живого примера: перенести пользовательское приложение, выгрузить и загрузить файл пакета.

Основа справки: руководство КОР «ПАРУС-Бюджет 8», издание 2026, с. 75–76 (кнопка пользовательского приложения; глава 3 описывает рабочие места APP); сохранённые результаты разработки UAP и проверки Holkas 0.1.28 / 0.1.30 на Парусе 27.08.2026; текущие модель, читатели, писатели и команды Holkas 0.1.30. Сверено 9 ноября 2026. RequestTools и схемы — учебные примеры. В этой работе выполнены локальные проверки файлов и построения плана; нового переноса в БД, запуска программы или проверки клиента Паруса не было.