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

Установка пакета из хранилища — это процесс добавления пакета и всех его зависимостей из хранилища системы контроля версий (SVN).

Установка пакета необходима:

• При одновременной работе над функциональностью пакета нескольких разработчиков.
• При переносе изменений между приложениями.

ВАЖНО Приведенные ниже сведения актуальны при работе с хранилищами SVN встроенными средствами bpm'online и не пригодны при включенном режиме разработки в файловой системе (см. "Работа с SVN в файловой системе").

Последовательность установки пакета из хранилища

ВАЖНО! Перед обновлением приложения пользователем с помощью SVN необходимо произвести резервное копирование базы данных. Если приложение развернуто в облаке, то необходимо обратиться в службу поддержки. Возможность возврата на предыдущую версию посредством SVN не предусмотрена!

Установка пакета из хранилища выполняется из раздела [Конфигурация]. Подробно об инструментах этого раздела можно узнать из статьи "Раздел [Конфигурация]".

Для установки пакета из хранилища необходимо на вкладке [Пакеты] ([Packages]) раздела [Конфигурация] выбрать из контекстного меню команду [Установить пакет из хранилища] ([Install package from repository]) (рис. 1).

Рис. 1. — Контекстное меню вкладки [Пакеты] ([Packages])

Затем в появившемся диалоговом окне необходимо выбрать хранилище, название и версию устанавливаемого пакета, после чего нажать на кнопку [Установить] ([Install]) (рис. 2).

Рис. 2. — Диалоговое окно установки пакета из хранилища

Во время установки пакета будут автоматически применены привязанные данные, а также будут установлены зависимости.

Если в силу каких-либо причин автоматическое применение изменений не было включено, то необходимо применить изменения вручную. Для этого необходимо для установленного пакета в разделе [Конфигурация] выполнить следующие действия:

1. Сгенерировать исходные коды для элементов, требующих генерации.
2. Компилировать измененное.
3. Обновить структуру базы данных.
4. Установить при необходимости SQL-скрипты.
5. Установить привязанные данные.

К СВЕДЕНИЮ При выполнении вручную обновления структуры базы данных, установки SQL-скриптов и привязанных данных в колонках [Требуется обновление БД] и [Требует установки в БД] дизайнеров отображается необходимость соответствующих действий для схем, скриптов и данных. В случае возникновения ошибок текст последней ошибки можно увидеть в колонке [Текст последней ошибки]. Не все эти колонки обтображаются в реестре вкладок [Схемы], [SQL сценарии] и [Данные] раздела [Конфигурация]. При необходимости их можно добавить при помощи команды контекстного меню [Настроить колонки].

ВАЖНО Начиная с версии bpm'online 7.11 после установки или обновлении пакета из SVN необходимо выполнить действие [Компилировать все]. Это необходимо для генерирования статического контента (см. "Статический клиентский контент в файловой системе").

Изменения в иерархии пакетов

При установке пользовательского пакета система проверяет его зависимости и дополнительно устанавливает либо обновляет все пакеты, от которых зависит данный пакет. Например, при установке из хранилища пакета [UsrCustomPackage] также будет установлен и пакет-зависимость [UsrDependentPackage] (рис. 3), который до этого еще не был установлен в рабочее пространство.

Рис. 3. — Окно [Изменения] ([Changes]) после установки пакета из SVN

При этом будет изменена иерархия пакетов в приложении (рис. 4).

Рис. 4. — Новая иерархия пакетов приложения

Изменения в иерархии пакетов при установке пользовательского пакета из SVN происходят следующим образом:

1) Приложение определяет все зависимости устанавливаемого пакета, которые указаны в его метаданных в свойстве DependsOn.

{
  "Descriptor": {
    "UId": "8bc92579-92ee-4ff2-8d44-1ca61542aa1b",
    "PackageVersion": "7.8.0",
    "Name": "UsrCustomPackage",
    "ModifiedOnUtc": "\/Date(1522671879000)\/",
    "Maintainer": "Customer",
    "Description": "Package created by user",
    "DependsOn": [
      {
        "UId": "51b3ed42-678c-4da3-bd16-8596b95c0546",
        "PackageVersion": "7.8.0",
        "Name": "UsrDependentPackage"
      },
      {
        "UId": "e14dcfb1-e53c-4439-a876-af7f97083ed9",
        "PackageVersion": "7.8.0",
        "Name": "SalesEnterprise"
      }
    ]
  }
}

2) Затем выполняется проверка, установлены ли пакеты-зависимости в конфигурацию. Если установлены, то они обновляются, если нет — устанавливаются.

ВАЖНО Если указанные в пакете зависимости не будут найдены в хранилищах (например, хранилище отсутствует в списке зарегистрированных или не активно), то появится сообщение об ошибке установки пакета. При установке пакета обновляется вся иерархия его зависимостей, поэтому все хранилища, в которых могут содержаться пакеты-зависимости, должны быть включены в конфигурацию и активированы.

3) При установке пакета устанавливаются или обновляются только те зависимости устанавливаемого пакета, которые установлены из системы контроля версий (SVN). Пакеты, установленные из zip-архивов, а также предустановленные пакеты не обновляются.

ВАЖНО Если в рабочем пространстве отсутствует какой-нибудь из предустановленных пакетов-зависимостей, установленных из zip-архивов, установка пакета не будет выполнена. Необходимо предварительно установить пакеты, от которых зависит устанавливаемый пользовательский пакет, либо его пакеты-зависимости.