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

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

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

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

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

Последовательность установки пакетов подробно описана в статье "Перенос изменений при помощи SVN".

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

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

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

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

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

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

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

{
  "Descriptor": {
    "UId": "974305e3-b01c-4020-b511-6fe9ac644d95",
    "PackageVersion": "7.8.0",
    "Name": "UsrDependentPackage",
    "ModifiedOnUtc": "\/Date(1478766323000)\/",
    "Maintainer": "Customer",
    "Description": "Пример пакета, зависящего от других пакетов",
    "DependsOn": [
      {
        "UId": "8bc92579-92ee-4ff2-8d44-1ca61542aa1b",
        "PackageVersion": "7.8.0",
        "Name": "UsrCustomPackage"
      },
      {
        "UId": "0ece3a34-413f-415b-919b-7b29bb31701f",
        "PackageVersion": "7.8.0",
        "Name": "SalesEnterpriseSoftkey_RUS"
      }
    ]
  }
}

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

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

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

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

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