Парус 8 · Конструктор отраслевых расширений
Пользовательское приложение хранит программу, её действия и настройки вызова из разделов. Например, одна программа обработки заявок предоставляет действие RUN и подключает его к разделу «Заявки».
UAP + CodeПрограмма в Парусе
Тип объекта в Holkas: UAP «Пользовательское приложение». Он переносится между базами Паруса на Oracle и PostgreSQL. Запись содержит сам файл программы — скрипт, XLA или COM-библиотеку — и описание её действий. Действия имеют параметры и могут использовать другие пользовательские приложения. Чтобы вызвать действие из раздела, его подключают к этому разделу.
Условная программа RequestTools предоставляет действие RUN «Обработать». У подключения к классу Request может быть собственный заголовок «Обработать заявки». В кнопке формы свойство UserApplicationCode содержит RUN — код действия, а не RequestTools — код программы. Для такой кнопки требуется подключение действия к разделу формы.
Приложение / рабочее место APP описывает рабочее место и его меню. UAP описывает программу с действиями. Глава 3 руководства КОР называет пользовательскими приложениями также рабочие места; при выборе типа Holkas ориентируйтесь на объект, который переносите.
Holkas сохраняет файл в базе, но не запускает его как скрипт автора SCR. Между Oracle и PostgreSQL байты не переводятся: если программа обращается к конкретной СУБД, её совместимость требует отдельной проверки.
Что входит в перенос
Справочник полей
40 полей · 5 группВсе задаваемые поля программы и четырёх видов её частей. В строке показаны имя Git YAML, соответствующее имя JSON, тип и роль. Ограничения записи относятся к приёмнику БД; особенности файлов разобраны отдельно.
Как читать обозначения
Наведите указатель на значок, перейдите к нему клавишей Tab или нажмите его.
Ключ находит объект, часть ключа используется вместе с другими полями. Сравнивается — разница может дать команду; по элементам — список сопоставляется по ключам записей. Перестановка строк списка без изменения 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 добавляет и снимает связи. Другое приложение не включается в перенос автоматически.
LinksJSON: linksсписокПо элементамПодключения к разделам- Назначение
- Подключения действий к разделам Паруса с папкой, заголовком и настройками запуска.
- При переносе:
- Ключ — ActionCode + UnitCode. UAP.Link создаёт, меняет и снимает подключения. [] убирает все подключения этого приложения, но сохраняет сами разделы.
Действие программы 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.
Подключение действия к разделу UAP.Link · 8
ActionCodeJSON: actionCodeстрокаЧасть ключаПодключённое действие- Назначение
- Код действия этой программы, доступного в разделе.
- При переносе:
- Вместе с UnitCode образует ключ подключения. Смена действия даёт Delete / Create подключения. Для нового подключения сначала создаётся действие.
UnitCodeJSON: unitCodeстрокаЧасть ключаРаздел- Назначение
- Код раздела, из которого вызывают действие.
- При переносе:
- Смена раздела даёт Delete / Create. При применении в приёмнике находится его UNITNAME, и он передаётся Парусу; если раздела нет, запись отклоняется. Создание и изменение подключения ждут Create CLS.
CrnNameJSON: crnNameстрокаСравниваетсяПапка подключения- Назначение
- Имя папки раздела «Пользовательские приложения». Папка принадлежит этому подключению, а не программе UAP.
- При переносе:
- Create / Update UAP.Link ищет папку по имени: в разделе одной организации и версии двух одноимённых папок не бывает. Если её нет, создаёт недостающие папки по пути CrnPath. Update переносит подключение в найденную папку. «Решение/Обработка» в CrnName — одно имя, а не путь.
CrnPathJSON: crnPathсписок строк / nullСравниваетсяПуть папки подключения- Назначение
- Имена папок от первого уровня под корнем раздела «Пользовательские приложения» до папки подключения включительно, например «Решение», «Обработка»; последний элемент равен CrnName. Корень раздела в путь не входит: в приёмнике берётся корень его организации и версии. [] — подключение лежит прямо в корне; отсутствие поля — путь неизвестен (файл прежней версии Holkas).
- При переносе:
- В базе Паруса сравнивается только имя папки: одноимённая папка приёмника используется там, где лежит, и не перемещается. Отсутствующую папку Holkas создаёт по пути: имеющиеся уровни использует, недостающие создаёт под предыдущим. В Git, S3 и «Файле пакета» сравнивается весь путь; его изменение даёт Update UAP.Link. В плане путь показан как «Решение / Обработка», пустой — «(корень)». Путь, который кончается не папкой CrnName, отклоняет план до применения.
CaptionJSON: captionстрокаСравниваетсяЗаголовок подключения- Назначение
- Название действия в данном разделе, например «Обработать заявки».
- При переносе:
- Изменение даёт Update UAP.Link. Подпись другого подключения того же действия и Name самого действия остаются отдельными настройками.
EnabledJSON: enabledцелоеСравниваетсяДоступность подключения- Назначение
- 1 — подключение доступно, 0 — отключено.
- При переносе:
- Записывается через UAP.Link. Отключение сохраняет запись, программу и действие; доступ пользователя дополнительно зависит от прав Паруса.
GroupRecordsJSON: groupRecordsцелоеСравниваетсяГрупповая обработка- Назначение
- Признак групповой обработки записей для этого подключения.
- При переносе:
- Сравнивается и передаётся в UAP.Link. Holkas не выполняет обработку при переносе и не проверяет, как программа принимает группу записей.
RefreshRecordsJSON: refreshRecordsцелоеСравниваетсяОбновление записей- Назначение
- Настройка обновления записей раздела после выполнения действия.
- При переносе:
- Сравнивается и передаётся в UAP.Link. Это поведение клиента Паруса после запуска программы, а не повторное сравнение или обновление данных средствами Holkas.
Команды плана
Пять кодов и 13 сочетаний кода с действием. Create — создать, Update — изменить, Delete — удалить. Подписи пиктограмм доступны по наведению, клавиатуре и нажатию.
Программа и части5 кодов
UAPПрограмма и её реквизиты
Создаёт отсутствующее приложение или меняет описание и файл существующего. При Update сначала передаёт описание без файла, затем отдельно файл, если изменились Program, ProgramSize или ProgramCrc. Разница только в списках частей не создаёт Update UAP. Список действий не передаётся Парусу на автоматическую сверку: действия изменяются своими командами.
Ключ: Код приложения
UAP.ActionДействие программы
Создаёт действие с новым Code, меняет Name при прежнем Code или удаляет отсутствующее действие. Перед удалением снимаются его параметры, зависимости и подключения. Эта команда не редактирует исходный текст программы.
Ключ: Код приложения|Код действия
UAP.ParamПараметр действия
Создаёт, меняет или удаляет параметр. Передаёт тип привязки и все её реквизиты. Позицию пишет вместе с параметром, при необходимости временно освобождая место; отдельного SetOrder нет.
Ключ: Код приложения|Код действия|Код параметра
UAP.DependЗависимость от другого приложения
Добавляет или снимает связь действия с другим UAP. Здесь только ключевые поля, поэтому Update не возникает. Удаление связи сохраняет обе программы и действие.
Ключ: Код приложения|Код действия|Код другого приложения
UAP.LinkПодключение к разделу
Создаёт подключение, обновляет его папку, заголовок и признаки либо снимает подключение. Снятие делает действие недоступным через это подключение; программу, её действие и сам раздел команда не удаляет.
Ключ: Код приложения|Код действия|Код раздела
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.Action→Create UAP.LinkКогда: Добавляется подключение действия к разделу.
Сначала создаётся подключаемое действие.
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 и завершение всех её частей это ребро не ожидает.
Create CLS→Create / Update UAP.LinkКогда: Подключение указывает UnitCode.
Подключение записывается после создания раздела.
Перед удалением действия3
Delete UAP.Param→Delete UAP.ActionКогда: Убирается действие вместе с параметрами.
Параметры снимаются до каскадного удаления действия в Парусе.
Delete UAP.Depend→Delete UAP.ActionКогда: Убирается действие с зависимостями.
Записи зависимостей удаляются до их владельца.
Delete UAP.Link→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
YAMLUserApplication/RequestTools.yamlИмена с заглавной буквы: Code, Program, Actions, Parameters, Dependencies, Links. Program — последовательность чисел-байтов.
В корне — .holkas. Вычисляемые Key и ProgramText в файл не пишутся; при чтении программа и все части восстанавливаются.S3
JSON в ZIPUserApplication/RequestTools.jsonВ ZIP — одно описание UAP с camelCase: code, program, actions, parameters, dependencies, links. Program записан строкой Base64.
manifest.json перечисляет UAP один раз. ZIP хранится в S3; программа и все части восстанавливаются из JSON.Файл пакета
JSON в ZIPUserApplication/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 и схемы — учебные примеры. В этой работе выполнены локальные проверки файлов и построения плана; нового переноса в БД, запуска программы или проверки клиента Паруса не было.