Создание пользовательского пакета

Общие сведения

Пакет bpm'online — это совокупность конфигурационных элементов (схем, данных, скриптов, дополнительных библиотек), которые реализуют определенный блок функциональности. Физически пакет представляет собой каталог, содержащий определенный набор подкаталогов и файлов. Основные сведения о пакетах приведены в статьях "Структура и состав пакетов" и "Зависимости пакетов".

Создание пользовательского пакета

Чтобы создать новый пользовательский пакет необходимо в контекстном меню на вкладке [Пакеты] ([Packages]) раздела [Конфигурация] ([Configuration]) выбрать действие [Добавить] ([Add]) (рис. 1, 1).

Рис. 1. — Добавление нового пакета

В результате откроется карточка пакета (рис. 2).

Рис. 2. — Карточка пакета

Основные поля карточки пакета:

• [Название] ([Name]) — название пакета. Обязательное для заполнения поле. Не может совпадать с названием уже существующих пакетов.
• [Позиция] ([Position]) — позиция пакета в иерархии (см. "Работа с локализуемыми ресурсами конфигурации. Реализация мультиязычия"). Обязательное для заполнения поле. По умолчанию имеет значение 0.
• [Хранилище системы контроля версий] ([Version Control System Repository]) — название хранилища системы контроля версий, в котором будут фиксироваться изменения пакета. Список доступных хранилищ формируется из списка хранилищ системы контроля версий (см. "Разработка во встроенной IDE. Раздел [Конфигурация]"). Хранилища, которые находятся в списке хранилищ конфигурации, но не помечены как активные, не попадут в выпадающий список доступных хранилищ. Поле является обязательным для заполнения.

• [Версия] — версия пакета. Обязательное для заполнения поле. Версия пакета может содержать цифры, символы латинского алфавита и знаки "." и "_". Добавляемое значение должно начинаться с цифры или буквы. Все элементы пакета имеют ту же версию, что и сам пакет. Версия пакета не обязательно должна совпадать с версией приложения.
• [Описание] — описание пакета, например, расширенная информация о функциональности, которая реализуется в пакете. Не обязательное поле.

Содержимое основных полей карточки пакета будет сохранено в его метаданных:

{
  "Descriptor": {
    "UId": "1c1443d7-87df-4b48-bfb8-cc647755c4c1",
    "PackageVersion": "7.8.0",
    "Name": "NewPackage",
    "ModifiedOnUtc": "\/Date(1522657977000)\/",
    "Maintainer": "Customer",
    "DependsOn": []
  }
}

Кроме этих свойств метаданные пакета содержат информацию о зависимостях (свойство DependsOn) и информацию о разработчике (Maintainer). Значение свойства Maintainer устанавливается с помощью системной настройки [Издатель].

После заполнения всех полей карточки и нажатия на кнопку [ОК] пакет будет создан и отобразится на вкладке [Пакеты] ([Packages]) (рис. 3).

Рис. 3. — Новый пакет на вкладке [Пакеты]

Чтобы созданный пакет имел всю функциональность, которая заложена в систему, для него нужно определить зависимости. При этом достаточно указать самый последний пакет в иерархии предустановленных пакетов. Чтобы определить какой из пакетов в иерархии предустановленных пакетов является последним, нужно перейти на вкладку [Зависимости пакетов] раздела [Конфигурация]. Далее необходимо найти предустановленные пакеты, которые находятся выше пакета [Custom]. Например, на рисунке 4 последними в иерархии предустановленных пакетов будут пакеты [SalesEnterpriseSoftkey_ENU] и устаревший [SalesEnterpriseSoftkey_Obsolete]. Как добавить пакет в зависимости показано в статье "Зависимости пакетов".

Рис. 4. — Определение последнего пакета в иерархии предустановленных пакетов конфигурации

В пакете [Custom] должны быть установлены зависимости от всех пакетов приложения. Поэтому необходимо удостовериться в том, что в нем установлена зависимость от созданного пакета.