Создание пользовательского пакета
Glossary Item Box
Общие сведения
В bpm'online все элементы конфигурации сгруппированы в пакеты.
Пакет bpm'online — это совокупность конфигурационных элементов (схем, данных, скриптов, дополнительных библиотек), которые реализуют определенный блок функциональности. Физически пакет представляет собой каталог, содержащий определенный набор подкаталогов и файлов. Основные сведения о пакетах приведены в статьях "Структура и состав пакетов" и "Зависимости пакетов. Основные пакеты системы".
Создание пользовательского пакета
Чтобы создать новый пользовательский пакет необходимо в контекстном меню на вкладке [Пакеты] раздела [Конфигурация] выбрать действие [Добавить] (рис. 1, 1).
Рис. 1. — Добавление нового пакета.
В результате откроется карточка пакета (рис. 2).
Рис. 2. — Карточка пакета.
Основные поля карточки пакета:
- [Версия] — версия пакета. Обязательное для заполнения поле. Версия пакета может содержать цифры, символы латинского алфавита и знаки "." и "_". Добавляемое значение должно начинаться с цифры или буквы. Все элементы пакета имеют ту же версию, что и сам пакет. Версия пакета не обязательно должна совпадать с версией приложения.
- [Название] — название пакета. Обязательное для заполнения поле. Не может совпадать с названием уже существующих пакетов.
- [Хранилище системы контроля версий] — название хранилища системы контроля версий, в котором будут фиксироваться изменения пакета. Список доступных хранилищ формируется из списка хранилищ системы контроля версий. Хранилища, которые находятся в списке хранилищ конфигурации, но не помечены как активные, не попадут в выпадающий список доступных хранилищ. Поле является обязательным для заполнения.
- [Позиция] — позиция пакета в иерархии. Обязательное для заполнения поле. По умолчанию имеет значение 0.
- [Описание] — описание пакета, например, расширенная информация о функциональности, которая реализуется в пакете. Не обязательное поле.
ВАЖНО Поле [Хранилище системы контроля версий] заполняется при создании нового пакета и в дальнейшем недоступно для редактирования. Если система контроля версий не используется, то это поле не отображается. |
К СВЕДЕНИЮ При создании нового пакета сразу же указать его зависимости нельзя. Добавление зависимости выполняется при редактировании уже созданного пакета. Если пользователь не авторизовался в выбранном для пакета хранилище системы контроля версий, ему будет предложено пройти авторизацию перед созданием пакета. |
Содержимое основных полей карточки пакета будет сохранено в его метаданных:
{ "Descriptor": { "UId": "8bc92579-92ee-4ff2-8d44-1ca61542aa1b", "PackageVersion": "7.8.0", "Name": "UsrCustomPackage", "ModifiedOnUtc": "\/Date(1477652941000)\/", "Maintainer": "Customer", "Description": "Пакет пользователя", "DependsOn": [ { "UId": "e14dcfb1-e53c-4439-a876-af7f97083ed9", "PackageVersion": "7.8.0", "Name": "SalesEnterprise" } ] } }
Кроме этих свойств метаданные пакета содержат информацию о зависимостях (свойство DependsOn) и информацию о разработчике (Maintainer). Значение свойства Maintainer устанавливается с помощью системной настройки [Издатель].
После заполнения всех полей карточки и нажатия на кнопку [ОК] пакет будет создан и отобразится на вкладке [Пакеты] (рис. 3).
Рис. 3. — Новый пакет на вкладке [Пакеты]
Для того чтобы созданный пакет имел всю функциональность, которая заложена в систему, для него нужно определить зависимости. При этом достаточно указать самый последний пакет в иерархии предустановленных пакетов. Чтобы определить какой из пакетов в иерархии предустановленных пакетов является последним, нужно перейти на вкладку [Зависимости пакетов] раздела [Конфигурация]. Далее необходимо найти первый пакет, который находится выше пакета [Custom]. Например, на рисунке 4 последним в иерархии предустановленных пакетов будет пакет [SalesEnterpriseSoftkey_RUS]. Как добавить пакет в зависимости показано в статье "Зависимости пакетов. Основные пакеты системы".
К СВЕДЕНИЮ Пакет [Custom] добавить в зависимости нового пакета нельзя. Причины этого приведены в статье "Пакет [Custom]". |
Рис. 4. — Определение последнего пакета в иерархии предустановленных пакетов конфигурации
В пакете [Custom] должны быть установлены зависимости от всех пакетов приложения. Поэтому необходимо удостовериться в том, что в нем установлена зависимость от созданного пакета.
Завершающим этапом создания нового пакета является его фиксация в хранилище системы контроля версий (рис. 1, 2).