Парус 8 · Конструктор отраслевых расширений
Приложение задаёт рабочее место: его доступность, главное меню, подключённые модули и способы отображения разделов в WIN и WEB.
APP + AppCodeПриложение в КОР
Приложение объединяет разделы в рабочее место пользователя. Например, рабочее место «Обработка заявок» может открывать разделы «Заявки» и «Архив», показывать их по-разному в Windows и web-клиенте и иметь собственное главное меню. Его описание в Holkas имеет код типа APP.
Меню и отображение разделов решают разные задачи. XML меню задаёт пункты и их вызовы. Запись отображения уточняет, показывать ли конкретный раздел и каким способом. Наличие такой записи само по себе не подключает раздел к приложению. У стандартных разделов для этого нужны соответствующие модули.
Альтернативное рабочее место использует меню и лицензию основного приложения, но позволяет уточнить видимость разделов. Например, в «Мини-бухгалтерии» можно скрыть все разделы основного места и включить только нужные.
APP и пользовательское приложение UAP — разные типы. UAP переносит программу с действиями и параметрами; APP описывает рабочее место. Права входа в приложение, пользовательские настройки и документы разделов в APP не входят.
Что входит в перенос
Выбор приложения не добавляет автоматически основное приложение, приложения-образцы и классы разделов. Если в «Обработке заявок» используется новый класс Request, включите его отдельно или подготовьте в приёмнике. Файлы модулей и права пользователей также подготавливаются отдельно. Приложение не хранится в папках каталога ACATALOG: имя или полный путь папки для APP не передаётся.
Справочник полей
20 полей · 3 группыВсе поля модели переноса: 11 реквизитов приложения, два списка, два поля модуля и пять полей настройки раздела. Техническое имя — как в Git YAML; рядом имя в JSON для S3 и «Файла пакета».
Как читать обозначения и правила
Наведите указатель на значок, перейдите к нему клавишей Tab или нажмите его — появится пояснение.
Ключ определяет приложение или элемент внутри него. Сравнивается — разница учитывается в плане. По элементам — список сопоставляется по ключам записей. Изменение одного списка не требует 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 меню.
Команды плана
Три кода покрывают приложение и его части. Create означает создание, Update — изменение, Delete — удаление. Подписи значков действий доступны по наведению, фокусу клавиатуры и нажатию. SetOrder и Delete APP не формируются.
APPНастройки приложения и меню
Create создаёт отсутствующее приложение и записывает собственное меню, если FormData не null. Update меняет настройки и записывает либо удаляет меню. Изменение только модулей или отображения разделов не создаёт Update APP. Вид и тип имеют отдельные ограничения применения в Парусе.
Ключ: Код приложения
APP.ModПривязка модуля
Добавляет модуль в приложение, меняет Accessible совпавшего модуля или снимает привязку, отсутствующую в источнике. Код модуля — ключ; его замена даёт удаление старой и создание новой привязки. Сам файл модуля команда не переносит и не удаляет.
Ключ: Код приложения|Код модуля
APP.SecОтображение раздела
Создаёт индивидуальную настройку показа класса, меняет её признаки и образец либо удаляет отсутствующую в источнике строку. 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 у него не означает отсутствие меню для пользователя.
Удаление меню и пустой текст — разные состояния
Если 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 правильно отсортировать команды перед применением. Ребро связывает две команды и указывает, какая должна выполниться раньше. Например, прежде чем задать отображение нового класса в приложении, нужно создать этот класс.
Create CLS · RequestCreate APP.Sec · Requests|RequestКаталог включает собственные правила 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
YAMLApplication/Requests.yamlВ одном YAML — AppCode, FormData и вложенные списки Modules и DisplayedSections. Имена полей начинаются с заглавной буквы; меню остаётся строкой XML.
Holkas восстанавливает приложение вместе с частями из YAML. В корне репозитория — .holkas со сведениями о нём.S3
JSON в ZIPApplication/Requests.jsonВнутри ZIP файл приложения с полями appCode, formData, modules и displayedSections. Обе коллекции вложены в JSON.
Holkas берёт состав из manifest.json и читает файл приложения целиком. ZIP хранится в S3.Файл пакета
JSON в ZIPApplication/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, выгрузить и загрузить файл пакета.