Конвертация пакетов

Средний
PDF

Виды конвертации, которые позволяет выполнять Creatio:

  • Конвертация простого пакета в пакет-сборку. Доступна для Creatio версии 8 Atlas и выше.
  • Конвертация пакет-сборки в простой пакет. Доступна для Creatio версии 8 Atlas и выше.
  • Конвертация пакета-проекта в пакет-сборку. Доступна для Creatio версии 8.0.1 Atlas и выше.
  • Конвертация пакета-сборки в пакет-проект. Доступна для Creatio версии 8.0.1 Atlas и выше.

Конвертация пакетов доступна для on-site приложений, поскольку требует доступа к базе данных. Для приложений cloud можно выполнить перемещение отдельных конфигурационных элементов в пакет-сборку.

Конвертировать простой пакет в пакет-сборку 

  1. В меню пакета выберите Свойства (Properties).
  2. Установите признак Компилировать в отдельную сборку (Compile into a separate assembly).
  3. Для применения изменений нажмите Применить (Apply).

    Действия, которые выполняются при сохранении свойств пакета:

    • Изменение в базе данных типа пакета (значение колонки [Type]). При установленном признаке Компилировать в отдельную сборку (Compile into a separate assembly) значение меняется с "0" (простой пакет) на "1" (пакет-сборка). При неустановленном признаке — с "1" (пакет-сборка) на "0" (простой пакет).
    • Изменение в базе данных пути к проекту пакета-сборки (значение колонки [ProjectPath]). По умолчанию Files/PackageName.csproj, где PackageName — имя пакета-сборки. Для простых пакетов колонка содержит пустое значения. Если для пакета-сборки (т. е. в колонке [Type] установлено значение "1") колонка [ProjectPath] содержит пустое значение, то это приводит к неработоспособности приложения.
    • Удаление файлов пакета-сборки при неустановленном признаке Компилировать в отдельную сборку (Compile into a separate assembly).
    • Генерация всех требующих генерации схем.
  4. При необходимости выполните компиляцию конфигурации. Уведомление о необходимости выполнения компиляции отобразится в информационном окне.

    Важно. Без выполнения компиляции конфигурации при ее необходимости конвертация простого пакета в пакет-сборку считается незавершенной.

В результате простой пакет будет конвертирован в пакет-сборку.

Конвертировать пакет-сборку в простой пакет 

  1. В меню пакета-сборки, который планируется конвертировать в простой пакет, выберите Свойства (Properties) и уберите признак Компилировать в отдельную сборку (Compile into a separate assembly).

    Для применения изменений нажмите Применить (Apply).

  2. Для пакет-сборки, который ранее был конвертирован из пакета-проекта, пересоберите библиотеки проекта. В результате конвертации эти библиотеки были удалены.

В результате пакет-сборка будет конвертирован в простой пакет.

Конвертировать пакет-проект в пакет-сборку 

Начиная с версии 8.0.1, Creatio позволяет конвертировать пакет-проект в пакет-сборку.

Чтобы конвертировать пакет-проект в пакет-сборку:

  1. В каталогах Files\Bin и Files\Bin\netstandard удалите все файлы.
  2. В C#-проекте пакета-проекта добавьте свойство <AssemblyName> или измените его значение. Имя сборки пакета-проекта не должно совпадать с именем пакета-сборки.

    Шаблон свойства <AssemblyName>
    <AssemblyName>PackageProjectAssemblyName</AssemblyName>
    

    PackageProjectAssemblyName — имя сборки пакета-проекта.

  3. Скомпилируйте C#-проект пакета-проекта.
  4. В каталоге Files создайте файл bootstrapAssemblies.json. Используйте структуру файла, которая приведена ниже.

    Шаблон структуры файла bootstrapAssemblies.json
    {
        "assemblies": [
            "PackageProjectAssemblyName.dll"
        ]
    }
    

    PackageProjectAssemblyName — имя сборки пакета-проекта.

  5. В меню пакета-проекта, который планируется конвертировать в пакет-сборку, выберите Свойства (Properties) и установите признак Компилировать в отдельную сборку (Compile into a separate assembly).

    Для применения изменений нажмите Применить (Apply).

  6. Скомпилируйте пакет-сборку. Выполнение этого шага зависит от состояния режима разработки в файловой системе.

    При включенном режиме разработки в файловой системе.

    1. Выгрузите пакет-сборку в файловую систему. Для этого в группе действий Разработка в файловой системе (File system development mode) выпадающего списка Действия (Actions) панели инструментов раздела Конфигурация (Configuration) нажмите Выгрузить пакеты в файловую систему (Download packages to file system).

    2. В файле PackageName.csproj пакета-сборки добавьте исключение из компиляции пакета-проекта.

      Шаблон добавления исключения
      <Compile Remove="$(RelativeCurrentPkgFolderPath)Files/PackageProjectFolder/**" />
      

      PackageProjectFolder — имя каталога пакета-проекта.

    3. Скомпилируйте пакет-сборку. Для этого в меню пакета-сборки нажмите Компилировать (Compile).

    При отключенном режиме разработки в файловой системе.

    1. Скомпилируйте пакет-сборку. Для этого в меню пакета-сборки нажмите Компилировать (Compile).

      Компиляция выполняется с ошибкой.

    2. В файле PackageName.csproj пакета-сборки добавьте исключение из компиляции пакета-проекта.

      Шаблон добавления исключения
      <Compile Remove="$(RelativeCurrentPkgFolderPath)Files/PackageProjectFolder/**" />
      

      PackageProjectFolder — имя каталога пакета-проекта.

    3. Повторно скомпилируйте пакет-сборку. Для этого в меню пакета-сборки нажмите Компилировать (Compile).

В результате пакет-проект будет конвертирован в пакет-сборку.

Конвертировать пакет-сборку в пакет-проект 

Начиная с версии 8.0.1, Creatio позволяет конвертировать пакет-сборку в пакет-проект.

На заметку. Creatio позволяет конвертировать пакет-сборку, который ранее был конвертирован из пакета-проекта. Конвертацию ранее неконвертированного пакета-сборки выполнить невозможно.

Чтобы конвертировать пакет-сборку в пакет-проект:

  1. В меню пакета-сборки, который планируется конвертировать в пакет-проект, выберите Свойства (Properties) и уберите признак Компилировать в отдельную сборку (Compile into a separate assembly).

    Для применения изменений нажмите Применить (Apply).

  2. Скомпилируйте пакет-проект.
  3. Скомпилируйте конфигурацию. О компиляции читайте в статье Операции в Creatio IDE.

В результате пакет-сборка будет конвертирован в пакет-проект.