Creatio development guide

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

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).

© Terrasoft 2002-2017.

Был ли данный материал полезен?

Как можно улучшить эту статью?