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

Виды конвертации, которые позволяет выполнять 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 позволяет конвертировать пакет-сборку в пакет-проект.

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

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

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

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

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