Creatio development guide
PDF
Документация по разработке
Это документация Creatio версии 7.13.0. Мы рекомендуем использовать новую версию документации.

Установка пакета из хранилища

Glossary Item Box

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

Установка пакета из хранилища — это процесс добавления пакета и всех его зависимостей из хранилища системы контроля версий (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-архивов, установка пакета не будет выполнена.

Необходимо предварительно установить пакеты, от которых зависит устанавливаемый пользовательский пакет, либо его пакеты-зависимости.

© Terrasoft 2002-2019.

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

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