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

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

Приложение

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

Парус · Oracle и PostgreSQL

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

Рабочее место КОР Парус 8: настройки и меню, модули, отображение разделов, все поля и правила переноса Holkas.

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

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

Приложение задаёт рабочее место: его доступность, главное меню, подключённые модули и способы отображения разделов в WIN и WEB.

ИдентификаторAPP + AppCode
Вложенные частиМодули и отображение разделов
Удаление приложенияНе формируется

Приложение в КОР

Приложение объединяет разделы в рабочее место пользователя. Например, рабочее место «Обработка заявок» может открывать разделы «Заявки» и «Архив», показывать их по-разному в Windows и web-клиенте и иметь собственное главное меню. Его описание в Holkas имеет код типа APP.

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

Альтернативное рабочее место использует меню и лицензию основного приложения, но позволяет уточнить видимость разделов. Например, в «Мини-бухгалтерии» можно скрыть все разделы основного места и включить только нужные.

APP и пользовательское приложение UAP — разные типы. UAP переносит программу с действиями и параметрами; APP описывает рабочее место. Права входа в приложение, пользовательские настройки и документы разделов в APP не входят.

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

Модули и настройки отображения принадлежат приложению и загружаются вместе с ним. FormData — реквизит самого приложения; отдельной части «меню» в командном плане нет.

Выбор приложения не добавляет автоматически основное приложение, приложения-образцы и классы разделов. Если в «Обработке заявок» используется новый класс Request, включите его отдельно или подготовьте в приёмнике. Файлы модулей и права пользователей также подготавливаются отдельно. Приложение не хранится в папках каталога ACATALOG: имя или полный путь папки для APP не передаётся.

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

20 полей · 3 группы

Все поля модели переноса: 11 реквизитов приложения, два списка, два поля модуля и пять полей настройки раздела. Техническое имя — как в Git YAML; рядом имя в JSON для S3 и «Файла пакета».

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

Ключ определяет приложение или элемент внутри него. Сравнивается — разница учитывается в плане. По элементам — список сопоставляется по ключам записей. Изменение одного списка не требует Update APP, если реквизиты приложения совпадают.

При создании задаются реквизиты новой записи. Update APP передаёт все изменяемые настройки приложения и обрабатывает меню; Update APP.Sec — все настройки соответствующего раздела. Парус проверяет допустимость записи. После отказа по виду или типу приложения оставшиеся команды этого объекта пропускаются; уже выполненные части не откатываются в обычном режиме.

Реквизиты приложения · APP13 полей
AppCodeJSON: appCodeстрокаКлючКод приложения
Назначение
Уникальный код рабочего места, например Requests. Это адрес приложения в Holkas, а не его наименование в окне входа.
При переносе:
Holkas находит приложение по коду. Новый код означает другое приложение: если его ещё нет в приёмнике, появится Create APP. Приложение с прежним кодом автоматически не удаляется.
AppNameJSON: appNameстрокаСравниваетсяНаименование
Назначение
Название приложения для человека, например «Обработка заявок».
При переносе:
Изменение даёт Update APP и передаёт новое наименование в Парус. Код остаётся прежним. Для стандартного приложения изменение может быть запрещено Парусом.
AppTypeJSON: appTypeцелоеСравниваетсяТип приложения
Назначение
0 — рабочее место. Парус различает также серверные и сервисные приложения; Holkas сохраняет числовой код, а не преобразует один тип в другой.
При переносе:
Create APP в базе разрешён только при AppType = 0. Разница типа существующего приложения видна как Update APP с предупреждением, но команда отказывает до записи всех его настроек. Подробности — в ограничениях ниже.
WorkPlaceAltJSON: workPlaceAltцелоеСравниваетсяАльтернативное рабочее место
Назначение
0 — обычное рабочее место; 1 — альтернативное, использующее основное приложение из MainWorkPlaceCode. Альтернативное место наследует меню и лицензию основного.
При переносе:
Признак задаётся при Create APP. Его смена у существующего приложения даёт предупреждение и отказ всей Update APP до записи. Смена самого основного приложения при неизменном признаке — отдельный, поддерживаемый случай.
MainWorkPlaceCodeJSON: mainWorkPlaceCodeстрока / nullСравниваетсяОсновное рабочее место
Назначение
Код основного приложения, обязательный для альтернативного рабочего места. Например, Admin, а не «Администратор» и не внутренний номер RN. Для обычного рабочего места — null.
При переносе:
Перед записью Holkas ищет в приёмнике приложение по коду и передаёт Парусу его местное наименование. Если код задан, он должен разрешаться в существующее приложение. Смена кода даёт Update APP; null передаётся как отсутствие ссылки, а не просьба сохранить прежнюю.
LockWorkPlaceWinJSON: lockWorkPlaceWinцелоеСравниваетсяЗаблокировать рабочее место в WIN
Назначение
1 блокирует запуск рабочего места в Windows-клиенте; 0 снимает блокировку. Это общая доступность приложения.
При переносе:
Create / Update APP записывает признак. Например, значение 1 закроет вход в это рабочее место через WIN, даже если отдельные разделы отмечены как отображаемые. WEB управляется другим полем.
LockWorkPlaceWebJSON: lockWorkPlaceWebцелоеСравниваетсяЗаблокировать рабочее место в WEB
Назначение
1 блокирует запуск рабочего места в web-клиенте; 0 снимает блокировку.
При переносе:
Передаётся в Create / Update APP. Блокировка WEB не меняет LockWorkPlaceWin и не удаляет приложение или его меню.
ShowUnitsCustomWinJSON: showUnitsCustomWinцелоеСравниваетсяПриоритет Конструктора в WIN
Назначение
1 отдаёт приоритет конструкторскому способу отображения разделов, 0 — стандартному. Применяется, если у раздела есть оба варианта и нет своего уточнения.
При переносе:
Меняется через Create / Update APP. ShowWinMode в записи конкретного раздела имеет более высокий приоритет. Саму форму Конструктора этот признак не создаёт.
NotShowUnitWinJSON: notShowUnitWinцелоеСравниваетсяНе отображать все разделы в WIN
Назначение
1 задаёт общее скрытие разделов в Windows-клиенте, 0 — общее отображение. Индивидуальная запись DisplayedSections уточняет это правило.
При переносе:
Записывается через Create / Update APP. Например, при значении 1 раздел с ShowWin = 1 всё равно может отображаться. Это настройка видимости, а не удаление класса или пунктов из XML меню.
NotShowUnitWebJSON: notShowUnitWebцелоеСравниваетсяНе отображать все разделы в WEB
Назначение
Общее правило web-клиента: 1 — скрывать разделы, 0 — отображать. Индивидуальное ShowWeb имеет приоритет.
При переносе:
Записывается через Create / Update APP независимо от WIN. Чтобы показывать в альтернативном рабочем месте только несколько разделов, можно скрыть все этим флагом и включить нужные через ShowWeb.
FormDataJSON: formDataстрока / nullСравниваетсяОписание главного меню
Назначение
XML меню из USERFORMSAPPS: пункты, подменю и их настройки. Это один текст внутри приложения, а не список APP.Sec. null означает отсутствие собственной записи меню.
При переносе:
Изменение даёт Update APP. Непустой текст записывается целиком; если записи меню нет, Holkas создаёт её. При null существующая запись меню удаляется. Пустая строка отличается от null при сравнении. Проверка XML описана ниже.
ModulesJSON: modulesсписокПо элементамМодули приложения
Назначение
Привязки модулей к приложению: код файла и доступность. В Git, S3 и «Файле пакета» список находится внутри файла приложения.
При переносе:
Элементы сопоставляются по Code. Новые добавляются, доступность существующих меняется, отсутствующие в источнике удаляются из выбранного приложения. [] снимает все перечисленные привязки; содержимое DLL и других файлов не переносится.
DisplayedSectionsJSON: displayedSectionsсписокПо элементамОтображение разделов
Назначение
Индивидуальные настройки показа классов в приложении. Это уточнения общих флагов, а не перечень всех доступных разделов и не дерево меню.
При переносе:
Сопоставляются по UnitCode. Новые строки создаются, настройки совпавших меняются, лишние строки удаляются. [] снимает все уточнения. Сам класс и пункты XML меню от удаления строки не удаляются.
Модули · APP.Mod2 полей
CodeJSON: codeстрокаКлючКод модуля
Назначение
Идентификатор подключаемого модуля, например com_dict.dll. В Парусе выбирается из раздела «Модули».
При переносе:
Ключ APP.Mod внутри приложения. При замене Code и удалении прежнего элемента из источника план снимает старую привязку и создаёт новую. Это не переименование и не копирование файла модуля.
AccessibleJSON: accessibleцелоеСравниваетсяМодуль доступен
Назначение
1 — подключённый модуль доступен, 0 — недоступен.
При переносе:
Разница даёт Update APP.Mod, при создании значение передаётся в Create APP.Mod. Допустимость отключения или удаления конкретного модуля проверяет Парус; наличие команды в плане не снимает его запретов.
Отображение разделов · APP.Sec5 полей
UnitCodeJSON: unitCodeстрокаКлючКод раздела
Назначение
Код класса Паруса, для которого задано индивидуальное отображение. Например, Request.
При переносе:
Ключ APP.Sec внутри приложения. Смена класса означает Delete прежней записи и Create новой, если прежний код убран из источника. Для Create / Update класс должен существовать; его описание и данные этим полем не переносятся.
ShowWinJSON: showWinцелоеСравниваетсяРаздел отображается в WIN
Назначение
1 показывает, 0 скрывает раздел в Windows-клиенте. Это уточнение имеет приоритет над NotShowUnitWin приложения.
При переносе:
Меняется через Create / Update APP.Sec. Например, ShowWin = 0 скрывает раздел даже при общем разрешении показа. Удаление самой записи APP.Sec возвращает действие общих настроек.
ShowWinModeJSON: showWinModeцелоеСравниваетсяСпособ отображения в WIN
Назначение
0 — стандартный способ, 1 — Конструктор. Для раздела с обоими вариантами это уточнение важнее ShowUnitsCustomWin приложения. Если вариант только стандартный, применяется он.
При переносе:
Передаётся в Create / Update APP.Sec. Holkas не создаёт недостающую форму выбранного способа и не переводит её в другой формат. Приложение-образец стандартного способа задаётся отдельно в TemplateName.
TemplateNameJSON: templateNameстрока / nullСравниваетсяПриложение-образец
Назначение
Несмотря на имя поля, здесь код AppCode приложения-образца стандартного WIN-клиента, а не AppName. Оно определяет стандартный вариант раздела, когда его предоставляют несколько модулей.
При переносе:
Create / Update APP.Sec ищет образец по коду в приёмнике и передаёт процедуре его наименование. При null передаётся отсутствие образца. Например, код Accounting выбирает вариант из приложения с этим кодом, даже если его название в приёмнике другое.
ShowWebJSON: showWebцелоеСравниваетсяРаздел отображается в WEB
Назначение
1 показывает, 0 скрывает раздел в web-клиенте. Имеет приоритет над общим NotShowUnitWeb.
При переносе:
Передаётся в Create / Update APP.Sec. Это отдельная настройка WEB: изменение не меняет ShowWin, ShowWinMode или XML меню.
null, ноль, пустая строка и списки

Числовые поля APP обязательны в модели: 0 — настоящее значение, а не «не переносить». Для флагов 0 выключает, 1 включает; у AppType и ShowWinMode число имеет смысл кода. Сохраняйте все поля полного экспорта при ручной правке.

У FormData значение null означает удалить собственную запись меню. Это отличается от поведения текстов визуальных форм класса, где null может сохранять прежний текст. У MainWorkPlaceCode и TemplateName null передаёт отсутствие ссылки. Пустая строка у этих двух ссылок сравнивается как null, но при записи ищется как заданный код: используйте null для отсутствующей ссылки.

Для FormData null и пустая строка различаются. Окончания CRLF/LF не дают изменения; пробелы, структура XML и порядок атрибутов не нормализуются. Перестановка записей Modules или DisplayedSections без изменения их ключей и полей команд не добавляет; SetOrder у приложения нет.

Оба списка описывают полный состав частей выбранного приложения. При загрузке из S3 и «Файла пакета» отсутствующие modules/displayedSections и null вместо них отвергаются. [] — настоящий пустой список с удалением лишних привязок и настроек, а не обозначение пропущенных элементов. При загрузке из Git такая же проверка неполного YAML не обещается.

Какие сведения Паруса не входят в модель

Внутренние RN/PRN, технология и производитель, признак фиксированного меню и базовое APPLIST.APPMENU не имеют отдельных переносимых полей APP. FormData читается из USERFORMSAPPS. Назначения приложения ролям и пользователям, персональные настройки, лицензия и файлы подключаемых модулей в это описание не входят.

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

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

APP
CreateUpdate

Настройки приложения и меню

Create создаёт отсутствующее приложение и записывает собственное меню, если FormData не null. Update меняет настройки и записывает либо удаляет меню. Изменение только модулей или отображения разделов не создаёт Update APP. Вид и тип имеют отдельные ограничения применения в Парусе.

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

APP.Mod
CreateUpdateDelete

Привязка модуля

Добавляет модуль в приложение, меняет Accessible совпавшего модуля или снимает привязку, отсутствующую в источнике. Код модуля — ключ; его замена даёт удаление старой и создание новой привязки. Сам файл модуля команда не переносит и не удаляет.

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

APP.Sec
CreateUpdateDelete

Отображение раздела

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

Ключ: Код приложения|Код класса

Эти команды описывают план изменения существующего приёмника, например базы или Git. Выгрузка в S3 или «Файл пакета» сохраняет снимок выбранного приложения в новый ZIP.

Пример: удалить настройку раздела — не значит скрыть его

В Requests стоит NotShowUnitWeb = 0: общее отображение WEB включено. В приёмнике есть индивидуальная строка Archive, ShowWeb = 0, скрывающая «Архив». В источнике этой строки больше нет; остальные настройки совпадают.

План содержит Delete APP.Sec · Requests|Archive. После удаления уточнения «Архив» снова подчиняется общему разрешению отображения. Если у него есть пункт меню и выполнены условия доступа, он может стать видимым. Чтобы именно скрыть раздел, оставьте строку с ShowWeb = 0. Класс Archive и его данные в обоих случаях сохраняются.

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

Смена вида рабочего места у существующего приложения

Например, в источнике Requests — альтернативное место, в приёмнике — обычное. План показывает Update APP с предупреждением о невыполнимой команде. При выполнении Update APP Holkas отказывает до записи реквизитов и меню этой командой; оставшиеся команды приложения пропускаются. Повтор не устраняет расхождение. Особый случай с частью, выполненной раньше отказа, разобран ниже.

Автоматического пересоздания нет: удаление в Парусе стирает связанные права и пользовательские настройки. Если ими можно пожертвовать, удалите приложение в приёмнике средствами Паруса и перенесите заново. Основное приложение с альтернативными рабочими местами сначала требует удалить их; другие связи, например задания, тоже могут мешать удалению. Смена MainWorkPlaceCode у уже альтернативного места остаётся обычным обновлением.

Создание или смена типа приложения

В базе Create APP поддерживает AppType = 0. При другом типе план предупреждает и создание отказывает до записи. Смена AppType существующего приложения тоже отклоняется целиком, в том числе 1 → 0. Не пытайтесь устранить это повтором или прямой правкой системных таблиц. Для переноса настроек подготовьте приложение допустимого типа либо, если права и настройки можно потерять, согласованно пересоздайте его средствами Паруса.

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

Часть приложения может выполниться раньше отказа его настроек

В обычном режиме каждая команда фиксируется отдельно. Например, Requests меняется с обычного места на альтернативное и ссылается на новое Main из того же переноса. Одновременно из Requests удаляется привязка модуля. Корневая Update APP ждёт создание Main, а Delete APP.Mod этого ожидания не имеет.

Построенный план даёт порядок: удалить привязку модуля → создать Main → попытаться изменить Requests. Последняя команда откажет по виду рабочего места. В обычном режиме уже выполненная часть при этом не откатывается. Новый перенос в БД для этого случая не проверялся.

Поэтому не рассчитывайте, что предупреждение у Update APP само оставит весь объект неизменным. До устранения несовместимости не применяйте это приложение: исключите все его команды. Отказ одной команды не равен предварительному запрету всех частей.

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

До 0.1.28 основное место записывалось числом mainWorkPlace — внутренним RN исходной базы. Текущая версия Holkas использует MainWorkPlaceCode: код, который можно найти в другой базе. Старое числовое поле не читается. Заново выгрузите такое приложение текущей версией Holkas; не переносите RN в новое строковое поле.

Основное приложение включите отдельно, если его нет в приёмнике. Альтернативное рабочее место наследует его меню; отсутствие собственной FormData у него не означает отсутствие меню для пользователя.

Ошибка или неполное описание меню

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

Правильный XML ещё не доказывает, что меню заработает: его классы и методы вызова должны быть подготовлены отдельно. Holkas не перестраивает меню по DisplayedSections и не переводит произвольный XML между версиями клиента.

Удаление меню и пустой текст — разные состояния

Если FormData = null, Update APP удаляет собственную запись меню. Это не команда «оставить прежнее». При непустом тексте меню записывается целиком, даже если Update APP возник из-за изменения другого реквизита.

Пустая строка сравнивается с null как другое состояние, но не является надёжным способом очистить меню в базе: Парус и СУБД проверяют допустимость тела. Для отсутствующей записи используйте null; для меню — полный экспортируемый XML.

Модуль или стандартная запись недоступны для изменения

APP.Mod переносит привязку и признак Accessible, но не файл DLL, лицензию или регистрацию модуля в отдельном разделе «Модули». Подготовьте необходимые модули в установке приёмника. Парус может запретить отключение или удаление стандартного модуля; команда плана не отменяет этого ограничения.

Так же проверяются изменения штатного приложения. Не заменяйте технологию производства прямой правкой базы ради применения: такого поля в модели APP нет.

Права входа и конфигурация web-клиента

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

Список приложений web-клиента может дополнительно задаваться конфигурацией его установки. В проверенной лаборатории требовалась запись в auth.config. Holkas APP не переносит эту конфигурацию; сама запись APPLIST не гарантирует появление приложения в web-форме входа.

Рёбра команд приложения

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

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

1 · СначалаСоздать класс «Заявки»Create CLS · Request
→
2 · ЗатемЗадать его отображениеCreate APP.Sec · Requests|Request
APP.Sec использует код класса, но не создаёт сам класс. Если Requests тоже новое, создание APP должно предшествовать APP.Sec.

Каталог включает собственные правила APP, прямые связи с назначениями визуальных форм и общие правила скриптов. Всего 14 правил; четыре описывают удаления APP или CLS, которые Holkas сейчас не формирует. Это число описаний правил, а не число рёбер любого плана.

Внутри приложения и его ссылки5 правил
Create / Update APP основного места→Create / Update APP альтернативного места

Когда: MainWorkPlaceCode задан; обе команды присутствуют в плане.

Приёмник должен найти основное приложение и его актуальное наименование.

Create APP→Create APP.Mod

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

Приложение должно существовать до регистрации его модуля.

Create APP→Create APP.Sec

Когда: Создаётся индивидуальная настройка раздела нового приложения.

Сначала создать приложение-владельца.

Create CLS→Create / Update APP.Sec

Когда: UnitCode указывает на этот класс.

Парус находит раздел по коду класса и берёт его наименование.

Create / Update APP образца→Create / Update APP.Sec

Когда: TemplateName задан и содержит код приложения-образца.

Настройка использует наименование образца из приёмника, поэтому ждёт и его изменения.

Привязки визуальных форм3 правил
Create APP→Create CLS.VF.App

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

Создать приложение до привязки к нему формы класса.

Create APP→Create REP.VF.App

Когда: Код приложения добавляется в Applications формы пользовательского отчёта.

Создать приложение до привязки к нему формы отчёта.

Create APP→Create PCE.VF.App

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

Создать приложение до привязки к нему формы процедуры.

Общие правила скриптов2 правил
SCR «до»→APP / APP.Mod / APP.Sec

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

Выполнить скрипт перед командами приложения. Без команд его объектов скрипт убирается из плана.

APP / APP.Mod / APP.Sec→SCR «после»

Когда: Та же область действия; время скрипта — After.

Выполнить скрипт после команд приложения.

Рёбра для удаления корней4 правил
Delete APP.Mod→Delete APP

Когда: Модуль удаляется; Delete APP сейчас не формируется.

Ребро задаёт порядок: снять часть до удаления родителя; само приложение оно не удаляет.

Delete APP.Sec→Delete APP владельца

Когда: Настройка раздела удаляется; Delete APP не формируется.

Сначала снять настройку раздела приложения. Команды удаления APP в плане нет.

Delete APP.Sec→Delete CLS

Когда: Удаляется настройка для данного UnitCode; Delete CLS не формируется.

Снять использование класса перед его удалением. Само удаление класса в план не добавляется.

Delete APP.Sec→Delete APP образца

Когда: У удаляемой настройки задан TemplateName; Delete APP не формируется.

Снять использование образца перед его удалением. Само приложение-образец не удаляется.

Что означает отсутствие ребра или команды

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

Создание части ждёт Create своего APP; отдельного ребра от Update владельца к каждой APP.Mod / APP.Sec нет. При обычной ошибке команды текущая операция также останавливает остальные команды этого объекта. Связь через MainWorkPlaceCode или TemplateName ждёт и Create, и Update указанного приложения; привязки визуальных форм ждут только Create APP.

Внутри списков команды строятся как удаления, изменения, создания. Это исходная очередность среди готовых команд, а не отдельные рёбра между всеми парами. Дерево меню не разбирается на зависимости к каждому его пункту; проверка правильности XML не доказывает наличие вызываемых разделов и методов. Собственных рёбер APP на физические объекты Oracle или каталог папок нет.

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

Начните с каталога Application/. Для учебного приложения Requests все три способа сохраняют настройки, меню и обе коллекции внутри одного файла. Самостоятельных файлов APP.Mod или APP.Sec нет.

Git

YAML
Application/Requests.yaml

В одном YAML — AppCode, FormData и вложенные списки Modules и DisplayedSections. Имена полей начинаются с заглавной буквы; меню остаётся строкой XML.

Holkas восстанавливает приложение вместе с частями из YAML. В корне репозитория — .holkas со сведениями о нём.

S3

JSON в ZIP
Application/Requests.json

Внутри ZIP файл приложения с полями appCode, formData, modules и displayedSections. Обе коллекции вложены в JSON.

Holkas берёт состав из manifest.json и читает файл приложения целиком. ZIP хранится в S3.

Файл пакета

JSON в ZIP
Application/Requests.json

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

При загрузке Holkas сверяется с manifest.json и восстанавливает реквизиты, меню и оба списка.

Для APP это устройство проверено независимо для S3 и «Файла пакета», и при выгрузке, и при загрузке. Оно не доказывает одинаковое хранение других типов объектов. Основное приложение, образцы, классы и формы, ссылающиеся на APP, сохраняются по собственным правилам, если включены в выгрузку.

В manifest.json приложение обозначено как {"typeCode":"APP","name":"Requests"}. Там же хранятся версия формата, СУБД и сведения об экспорте; подробнее — формат пакета. Небезопасные символы в имени файла кодируются: / превращается в %2F, а код внутри документа не меняется. Не переименовывайте файл отдельно от адреса объекта.

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

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

Git — Application/Requests.yaml

AppCode: Requests
Modules:
  - Code: com_dict.dll
    Accessible: 1
DisplayedSections:
  - UnitCode: Request
    ShowWin: 1
    ShowWinMode: 1
    ShowWeb: 0

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

{
  "appCode": "Requests",
  "modules": [
    {
      "code": "com_dict.dll",
      "accessible": 1
    }
  ],
  "displayedSections": [
    {
      "unitCode": "Request",
      "showWin": 1,
      "showWinMode": 1,
      "showWeb": 0
    }
  ]
}

При выгрузке поля с null опускаются; нули и пустые списки сохраняются. Отсутствующая FormData при чтении означает null и может удалить собственное меню приёмника. Поэтому при ручной правке используйте полный экспорт. Не подменяйте пропущенные в примере элементы списком []: он задаёт действительное удаление лишних частей.

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