Управление поставками в WorkspaceConsole

Средний
PDF

Creatio предоставляет различные инструменты поставок функциональности.

Инструменты управления поставками, которые предоставляет Creatio:

  • Creatio IDE.
  • Утилита WorskspaceConsole.

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

WorkspaceConsole — это утилита, которая предназначена для выполнения операций с пакетами и схемами конфигурационных элементов (клиентских модулей, объектов и исходного кода (C#)) Creatio.

Использование утилиты WorkspaceConsole в качестве инструмента переноса решений позволяет:

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

WorkspaceConsole на .NET Framework 

Перед использованием утилиты WorkspaceConsole необходимо выполнить ее настройку.

Настроить утилиту WorkspaceConsole 

  1. Узнайте значение используемой строки подключения.

    Для этого откройте файл ..\Terrasoft.WebApp\DesktopBin\WorkspaceConsole\Terrasoft.Tools.WorkspaceConsole.exe.config. Строка подключения содержится в атрибуте connectionStringName XML-элемента <db>.

    Файл Terrasoft.Tools.WorkspaceConsole.exe.config
    <terrasoft>
        ...
        <db>
            <general connectionStringName="db" securityEngineType="Terrasoft.DB.MSSql.MSSqlSecurityEngine, Terrasoft.DB.MSSql" ... />
        </db>
        ...
    </terrasoft>
    
  2. Отредактируйте строку подключения.

    Для этого откройте файл ConnectionStrings.config, который находится в корневом каталоге приложения. Строка подключения содержится в атрибуте name XML-элемента <connectionStrings>. Значение атрибута name файла ConnectionStrings.config должно совпадать со значением атрибута connectionStringName файла Terrasoft.Tools.WorkspaceConsole.exe.config.

    Файл ConnectionStrings.config
    <connectionStrings>
        <add name="db" connectionString="Data Source=dbserver\MSSQL2016; Initial Catalog=YourDBName; Persist Security Info=True; MultipleActiveResultSets=True; Integrated Security = true; Pooling = true; Max Pool Size = 100" />
        <add name="dbOracle" connectionString="Data Source=(DESCRIPTION = (ADDRESS_LIST = (ADDRESS = (PROTOCOL = TCP)(HOST = dbOracleServer.yourdomain.com)(PORT = 1521))) (CONNECT_DATA = (SERVICE_NAME = TSOra10) (SERVER = DEDICATED)));User Id=CreatioUser;Password=CreatioUserPassword;" />
    </connectionStrings>
    

    Виды строк подключения, которые настроены в конфигурационном файле:

    • Строка с названием "db" — используется для подключения к базе данных MS SQL Server.
    • Строка с названием "dbOracle" — используется для подключения к базе данных Oracle.

    Если с помощью WorkspaceConsole необходимо выполнить разовую операцию, то утилиту можно запустить с параметром -webApplicationPath. В этом параметре необходимо указать путь к каталогу с установленным приложением. В таком случае утилита самостоятельно определит все необходимые параметры подключения к базе данных из файла ConnectionStrings.config. При этом параметры подключения из файла Terrasoft.Tools.WorkspaceConsole.exe.config будут проигнорированы.

  3. Включите возможность загрузки из удаленных источников. Для этого в файле Terrasoft.Tools.WorkspaceConsole.exe.config установите значение true для атрибута enabled элемента loadFromRemoteSources.

    <loadFromRemoteSources enabled="true" />
    
  4. Установите утилиту WorkspaceConsole.

    Для этого с правами администратора запустите на выполнение предустановленный пакетный файл команд, который находится по пути ..\Terrasoft.WebApp\DesktopBin\WorkspaceConsole\. Это необходимо для установки версии исполняемого файла утилиты и библиотек, которые используются утилитой.

    Пакетные файлы команд утилиты WorkspaceConsole:

    • Для 32-битной операционной системы необходимо запустить файл PrepareWorkspaceConsole.x86.bat.
    • Для 64-битной операционной системы необходимо запустить файл PrepareWorkspaceConsole.x64.bat.
  5. Настройте утилиту на выполнение операций с хранилищем SVN (опционально).

    Для этого скопируйте файлы SharpPlink-x64.svnExe, SharpSvn.dll и SharpSvn-DB44-20-x64.svnDll из соответствующего каталога в каталог ...\Terrasoft.WebApp\DesktopBin\WorkspaceConsole.

    • Для 32-битной операционной системы скопируйте файлы из каталога ...\Terrasoft.WebApp\DesktopBin\WorkspaceConsole\x86.
    • Для 64-битной операционной системы скопируйте файлы из каталога ...\Terrasoft.WebApp\DesktopBin\WorkspaceConsole\x64.

Выполнить перенос решений 

Исполняемый файл утилиты Terrasoft.Tools.WorkspaceConsole.exe расположен в каталоге ..\Terrasoft.WebApp\DesktopBin\WorkspaceConsole, а версия утилиты совпадает с версией приложения.

Важно. Версия утилиты WorkspaceConsole должна совпадать с версией приложения Creatio. Например, если текущая версия приложения 7.18.1.1794, а пакеты необходимо обновить до версии 7.18.2.1658, то используйте утилиту версии 7.18.2.1658. Чтобы получить утилиту требуемой версии, обратитесь в службу поддержки.

Утилита WorkspaceConsole работает напрямую с базой данных приложения. Поэтому для корректной работы утилиты необходимо внести информацию о базе данных в конфигурационный файл Terrasoft.Tools.WorkspaceConsole.exe.config утилиты. Если приложение развернуто в облаке, то работать с утилитой могут только сотрудники отдела облачных сервисов. В таком случае для переноса изменений необходимо обратиться в службу поддержки.

Команды для WorkspaceConsole рекомендуется формировать в пакетном файле (*.bat или *.cmd), который создан в текстовом редакторе.

Чтобы выполнить перенос решений с помощью утилиты WorkspaceConsole:

  1. Проверьте привязки данных.
  2. Выполните резервное копирование базы данных.
  3. Выполните резервное копирование пакетов.
  4. Экспортируйте пакеты.
  5. Импортируйте пакеты.
  6. Восстановите конфигурацию из резервной копии базы данных (опционально).
  7. Перезапустите приложение в IIS.

1. Проверить привязки данных 

Перед экспортом пакета проверьте правильность привязки данных к пакету. К привязанным данным относятся наполнение справочников, новые системные настройки, демонстрационные записи раздела и т. д.

Если раздел был создан при помощи мастера, то данные, которые необходимы для работы раздела, автоматически привязываются мастером раздела. Чтобы после импорта раздел отобразился в рабочем месте, необходимо привязать соответствующее значение объекта SysModuleInWorkplace.

2. Выполнить резервное копирование базы данных 

Перед внесением изменений в приложение с помощью утилиты WorkspaceConsole выполните резервное копирование базы данных. Это позволит восстановить приложение при некорректном использовании команд и параметров утилиты.

3. Выполнить резервное копирование пакетов 

Начиная с версии 8.0.2, Creatio позволяет выполнить резервное копирование пакетов с использованием утилиты WorkspaceConsole. Для этого в WorkspaceConsole реализована команда для создания резервных копий пакетов, новые версии которых планируется установить на рабочую среду. Механизм работает аналогично функциональности резервного копирования, который доступен при установке приложений или пакетов с использованием пользовательских средств.

Чтобы выполнить резервное копирование пакетов:

  1. Cформируйте команду для выполнения резервного копирования пакетоа.

    Сигнатура команды, которую необходимо выполнить в интерпретаторе команд (консоли) Windows, для выполнения операции резервного копирования пакетов приведена ниже.

    [Путь к WorkspaceConsole]\Terrasoft.Tools.WorkspaceConsole.exe -operation=BackupConfiguration -sourcePath=[Путь к SVN-хранилищу] -destinationPath=[Путь к локальному каталогу] -backupPath=[Путь к локальному каталогу] -confRuntimeParentDirectory=[Путь к локальному каталогу] -logPath=[Путь к локальному каталогу]
    
    Параметры WorkspaceConsole для выполнения резервного копирования базы данных
    Параметр
    Значение
    Описание
    -operation
    BackupConfiguration

    Выполняет создание резервных копий пакетов.

    Требует указания параметров -sourcePath и -backupPath.

    -sourcePath
    Путь к локальному каталогу
    Путь к локальному каталогу на диске. В этом каталоге находятся *.gz-архивы пакетов, резервные копии которых необходимо создать. Значение текущего параметра должно совпадать со значением параметра -sourcePath при выполнении импорта пакетов.
    -destinationPath
    Путь к локальному каталогу
    Путь к временному локальному каталогу на диске. В этот каталог будут разархивированы пакеты, которые определены в параметре -sourcePath.
    -backupPath
    Путь к локальному каталогу
    Путь к локальному каталогу на диске. В этом каталоге будут сохранены резервные копии *.gz-архивов пакетов, которые определены в параметре -sourcePath.
    -confRuntimeParentDirectory
    Путь к локальному каталогу
    Путь к родительскому каталогу директории ..\Terrasoft.WebApp\conf.
    -logPath
    Путь к локальному каталогу
    Путь к каталогу, в который будет сохранен файл с логом операции. Название файла состоит из даты и времени запуска операции. Необязательный параметр.
  2. Запустите утилиту.

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

4. Экспортировать пакеты 

Утилита WorkspaceConsole позволяет экспортировать пакет из базы данных или из хранилища SVN.

Экспортировать пакеты из базы данных 
  1. Cформируйте команду для экспорта пакетов из базы данных.

    Сигнатура команды, которую необходимо выполнить в интерпретаторе команд (консоли) Windows, для выполнения операции экспорта пакетов из базы данных приведена ниже.

    [Путь к WorkspaceConsole]\Terrasoft.Tools.WorkspaceConsole.exe -operation=SaveDBContent -contentTypes=Repository -workspaceName=[Название рабочего пространства] -destinationPath=[Путь к локальному каталогу] -webApplicationPath=[Путь к каталогу приложения] -configurationPath=[Путь к локальному каталогу]
    
    Параметры WorkspaceConsole для экспорта пакетов
    Параметр
    Значение
    Описание
    -operation
    SaveDBContent

    Сохраняет содержимое базы данных в файловую систему. Тип содержимого определяется значением параметра -contentTypes. Место в файловой системе, куда будет экспортировано содержимое, определяется параметром -destinationPath.

    Требует указания одного из параметров -webApplicationPath или -configurationPath.

    -contentTypes
    Repository
    Тип содержимого, которое экспортируется из базы данных на диск. Значение Repository определяет экспорт рабочего пространства, имя которого задается значением параметра -workspaceName, в каталог, путь к которому задается значением параметра -destinationPath.
    -workspaceName
    Название рабочего пространства
    Название рабочего пространства (конфигурации), в котором выполняется операция. По умолчанию все пользователи работают в рабочем пространстве Default.
    -destinationPath
    Путь к локальному каталогу
    Путь к локальному каталогу на диске. В этот каталог будут экспортированы *.gz-архивы пакетов.
    -webApplicationPath
    Путь к локальному каталогу
    Путь к каталогу на диске, в который установлено приложение Creatio. По этому пути из файла ConnectionStrings.config будет считана информация по соединению с базой данных. Если параметр не указан, то устанавливается соединение с базой данных, которая указана в строке соединения в конфигурационном файле утилиты.
    -configurationPath
    Путь к локальному каталогу
    Путь к каталогу ..\Terrasoft.WebApp\Terrasoft.Configuration. В этот каталог экспортируются исходные коды и ресурсы схем пользовательских пакетов в режиме разработки в файловой системе.
  2. Запустите утилиту.

На заметку. Во время выполнения операции экспорта пакетов, экспортируются все пакеты рабочего пространства. Процесс может занять несколько десятков минут.

В результате выполнения архивы пакетов указанного рабочего пространства будут экспортированы в локальный каталог.

Экспортировать пакеты из хранилища SVN 
  1. Cформируйте команду для экспорта пакетов из SVN.

    Сигнатура команды, которую необходимо выполнить в интерпретаторе команд (консоли) Windows, для выполнения операции экспорта пакетов из SVN-хранилища приведена ниже.

    [Путь к WorkspaceConsole]\Terrasoft.Tools.WorkspaceConsole.exe -operation=SaveVersionSvnContent -workspaceName=[Название рабочего пространства] -destinationPath=[Путь к локальному каталогу] -workingCopyPath=[Путь к локальному каталогу] -sourcePath=[Путь к SVN-хранилищу] -packageName=[Имя пакета] -packageVersion=[Версия пакета] -sourceControlLogin=[Имя пользователя SVN] -sourceControlPassword=[Пароль пользователя SVN] -cultureName=[Языковая культура] -excludeDependentPackages=true -logPath=[Путь к локальному каталогу]  
    
    Параметры WorkspaceConsole для экспорта пакетов
    Параметр
    Значение
    Описание
    -operation
    SaveVersionSvnContent
    Выгружает иерархию пакетов в виде *.zip-архивов. Место в файловой системе, куда будет экспортировано содержимое, определяется параметром -destinationPath. SVN-хранилища определяются параметром -sourcePath.
    -workspaceName
    Название рабочего пространства
    Название рабочего пространства (конфигурации), в котором выполняется операция. По умолчанию все пользователи работают в рабочем пространстве Default.
    -destinationPath
    Путь к локальному каталогу
    Путь к локальному каталогу на диске. В этот каталог будут экспортированы *.gz-архивы пакетов.
    -workingCopyPath
    Путь к локальному каталогу
    Локальный каталог для рабочей копии пакетов, которые хранятся в SVN.
    -sourcePath
    Путь к SVN-хранилищу
    Адрес хранилища SVN для хранения структуры и метаданных пакетов. Может принимать несколько значений, которые указаны через запятую.
    -packageName
    Имя пакета
    Имя пакета в SVN-хранилище, которое будет использоваться для экспорта. Все пакеты, от которых зависит текущий пакет, также будут задействованы.
    -packageVersion
    Версия пакета
    Версия пакета в SVN-хранилище, которое будет использоваться для экспорта.
    -sourceControlLogin
    Имя пользователя SVN
    Логин пользователя хранилища SVN.
    -sourceControlPassword
    Пароль пользователя SVN
    Пароль пользователя хранилища SVN.
    -cultureName
    Языковая культура
    Код языковой культуры. Например, en-US.
    -excludeDependentPackages
    true или false
    Признак необходимости экспорта пакетов, от которых зависит пакет, указанный в параметре -packageName.
    -logPath
    Путь к локальному каталогу
    Путь к каталогу, в который будет сохранен файл с логом операции. Название файла состоит из даты и времени запуска операции. Необязательный параметр.
  2. Запустите утилиту.

В результате выполнения архивы пакетов указанного рабочего пространства будут экспортированы в локальный каталог.

5. Импортировать пакеты 

  1. Cформируйте команду для импорта пакетов в базу данных.

    Сигнатура команды, которую необходимо выполнить в интерпретаторе команд (консоли) Windows, для выполнения операции импорта пакетов в базу данных приведена ниже.

    [Путь к WorkspaceConsole]\Terrasoft.Tools.WorkspaceConsole.exe -operation=InstallFromRepository -packageName=[Имя пакета] -workspaceName=[Название рабочего пространства] -packageName=[Имя пакета] -sourcePath=[Путь к локальному каталогу] -destinationPath=[Путь к локальному каталогу] -skipConstraints=false -skipValidateActions=true -regenerateSchemaSources=true -updateDBStructure=true -updateSystemDBStructure=true -installPackageSqlScript=true -installPackageData=true -continueIfError=true  -webApplicationPath=[Путь к локальному каталогу] -confRuntimeParentDirectory=[Путь к локальному каталогу] -logPath=[Путь к локальному каталогу] -configurationPath=[Путь к локальному каталогу]
    
    Параметры WorkspaceConsole для импорта пакетов
    Параметр
    Значение
    Описание
    -operation
    InstallFromRepository

    Импортирует в конфигурацию содержимое и метаданные пакетов из *.zip-архивов. При необходимости выполняются привязанные SQL-скрипты, перегенерация исходных кодов, установка привязанных данных. Работает только с измененными или новыми пакетами и их элементами. Требует указания одного из параметров -webApplicationPath или -configurationPath.

    Требует указания параметра -confRuntimeParentDirectory.

    -packageName
    Имя пакета
    Имя пакета в конфигурации, которая указана в параметре -workspaceName. Все пакеты, от которых зависит текущий пакет, также будут задействованы. Если параметр не указан, то используются все пакеты конфигурации.
    -workspaceName
    Название рабочего пространства
    Название рабочего пространства (конфигурации), в котором выполняется операция. По умолчанию все пользователи работают в рабочем пространстве Default.
    -sourcePath
    Путь к локальному каталогу
    Путь к локальному каталогу на диске. В этом каталоге находятся *.gz-архивы пакетов, которые необходимо установить.
    -destinationPath
    Путь к локальному каталогу
    Путь к временному локальному каталогу на диске. В этот каталог будут разархивированы пакеты, которые определены в параметре -sourcePath.
    -skipConstraints
    false
    Пропустить создание внешних ключей в таблицах базы данных. Принимает значения true или false.
    -skipValidateActions
    true
    Пропустить проверку возможности создания индексов таблиц при обновлении структуры базы данных. Принимает значения true или false.
    -regenerateSchemaSources
    true
    Указывает на необходимость перегенерации исходных кодов после сохранения пакетов в базе данных. Принимает значения true или false. По умолчанию — true.
    -updateDBStructure
    true
    Указывает на необходимость обновления структуры базы данных после сохранения пакетов. Принимает значения true или false. По умолчанию — true.
    -updateSystemDBStructure
    true
    Указывает на необходимость изменения структуры базы данных системных схем перед выполнением установки пакетов. Также создает все отсутствующие индексы в системных таблицах. Принимает значения true или false.
    -installPackageSqlScript
    true
    Указывает на необходимость выполнения SQL скриптов до и после сохранения пакетов. Принимает значения true или false. По умолчанию — true.
    -installPackageData
    true
    Указывает на необходимость установки привязанных к пакету данных после сохранения пакетов. Принимает значения true или false. По умолчанию — true.
    -continueIfError
    true
    Указывает на необходимость прервать выполнение процесса установки при получении первой ошибки. Если значение параметра — true, то процесс установки пройдет до конца, а пользователь получит список всех возникших ошибок. Принимает значения true или false. По умолчанию — false.
    -webApplicationPath
    Путь к локальному каталогу
    Путь к каталогу на диске, в который установлено приложение Creatio. По этому пути из файла ConnectionStrings.config будет считана информация по соединению с базой данных. Если параметр не указан, то устанавливается соединение с базой данных, которая указана в строке соединения в конфигурационном файле утилиты.
    -confRuntimeParentDirectory
    Путь к локальному каталогу
    Путь к родительскому каталогу директории ..\Terrasoft.WebApp\conf.
    -logPath
    Путь к локальному каталогу
    Путь к каталогу, в который будет сохранен файл с логом операции. Название файла состоит из даты и времени запуска операции. Необязательный параметр.
    -configurationPath
    Путь к локальному каталогу
    Путь к каталогу ..\Terrasoft.WebApp\Terrasoft.Configuration. В этот каталог экспортируются исходные коды и ресурсы схем пользовательских пакетов в режиме разработки в файловой системе.
  2. Запустите утилиту.
  3. Cформируйте команду для генерации статического контента в файловую систему.

    Сигнатура команды, которую необходимо выполнить в интерпретаторе команд (консоли) Windows, для выполнения операции генерации статического контента в файловую систему приведена ниже.

    [Путь к WorkspaceConsole]\Terrasoft.Tools.WorkspaceConsole.exe -operation=BuildConfiguration -workspaceName=[Название рабочего пространства] -destinationPath=[Путь к локальному каталогу] -webApplicationPath=[Путь к локальному каталогу] -confRuntimeParentDirectory=[Путь к локальному каталогу] -logPath=[Путь к локальному каталогу] -configurationPath=[Путь к локальному каталогу]
    
    Параметры WorkspaceConsole для генерации статического контента
    Параметр
    Значение
    Описание
    -operation
    BuildConfiguration

    Выполняет генерацию статического контента в файловую систему.

    Требует указания одного из параметров -webApplicationPath или -configurationPath.

    -workspaceName
    Название рабочего пространства
    Название рабочего пространства (конфигурации), в котором определены экспортируемые пакеты. По умолчанию все пользователи работают в рабочем пространстве Default.
    -destinationPath
    Путь к локальному каталогу
    Путь к локальному каталогу на диске. В этот каталог будут экспортированы *.gz-архивы пакетов, которые определены в параметре -sourcePath.
    -webApplicationPath
    Путь к локальному каталогу
    Путь к каталогу на диске, в который установлено приложение Creatio. По этому пути из файла ConnectionStrings.config будет считана информация по соединению с базой данных. Если параметр не указан, то устанавливается соединение с базой данных, которая указана в строке соединения в конфигурационном файле утилиты.
    -confRuntimeParentDirectory
    Путь к локальному каталогу
    Путь к родительскому каталогу директории ..\Terrasoft.WebApp\conf.
    -logPath
    Путь к локальному каталогу
    Путь к каталогу, в который будет сохранен файл с логом операции. Название файла состоит из даты и времени запуска операции. Необязательный параметр.
    -force
    true или false

    Задает условия генерации файлового контента. Если значение параметра равно true, то генерация файлового контента выполняется по всем схемам. Если значение параметра равно false, то генерация файлового контента выполняется по измененным схемам. По умолчанию — false.

    Требует указания одного из параметров -webApplicationPath или -configurationPath.

    -configurationPath
    Путь к локальному каталогу
    Путь к каталогу ..\Terrasoft.WebApp\Terrasoft.Configuration. В этот каталог экспортируются исходные коды и ресурсы схем пользовательских пакетов в режиме разработки в файловой системе.
  4. Запустите утилиту.

На заметку. Пакеты, импортируемые в приложение с помощью WorkspaceConsole, считаются предустановленными и недоступны для изменения.

Не рекомендуется использовать утилиту WorkspaceConsole для импорта пакетов в базу данных при включенном режиме разработки в файловой системе. Если утилита будет использована, то исходный код измененных схем будет изменен в базе данных, но останется без изменений в файловой системе. Т. е. при открытии схемы конфигурационного элемента в Creatio IDE отобразится неизмененный код из файловой системы. При этом дата модификации схемы конфигурационного элемента будет обновлена. Это приводит к ложному ощущению, что перенос схемы прошел корректно.

Чтобы импортировать пакеты в базу данных при включенном режиме разработки в файловой системе:

  1. Импортируйте пакеты в базу данных с помощью утилиты WorkspaceConsole. Для этого воспользуйтесь инструкцией, которая приведена в пункте 4. Импортировать пакеты.
  2. На панели инструментов в группе действий Разработка в файловой системе (File system development mode) выберите Выгрузить все пакеты в файловую систему (Download packages to file system).

В результате все пакеты будут выгружены по пути ..\Terrasoft.WebApp\Terrasoft.Configuration\Pkg в каталог с соответствующим названием пакета.

6. Восстановить конфигурацию из резервной копии пакетов (опционально) 

Этот шаг необходимо выполнить, если при импорте пакета получена ошибка. Начиная с версии 8.0.2, Creatio позволяет выполнить восстановление конфигурации с резервной копии пакетов с использованием утилиты WorkspaceConsole. Механизм работает аналогично функциональности восстановления конфигурации из резервной копии, который доступен при установке приложений или пакетов с использованием пользовательских средств.

Чтобы восстановить конфигурацию из резервной копии пакетов:

  1. Cформируйте команду для восстановления конфигурации из резервной копии пакетов, которая была получена на шаге 3.

    Сигнатура команды, которую необходимо выполнить в интерпретаторе команд (консоли) Windows, для выполнения операции восстановления конфигурации из резервной копии пакетов приведена ниже.

    [Путь к WorkspaceConsole]\Terrasoft.Tools.WorkspaceConsole.exe -operation=RestoreConfiguration -backupPath=[Путь к локальному каталогу] -installPackageData=true -confRuntimeParentDirectory=[Путь к локальному каталогу] -configurationPath=[Путь к локальному каталогу] -logPath=[Путь к локальному каталогу]
    
    Параметры WorkspaceConsole для восстановления конфигурации из резервной копии пакетов
    Параметр
    Значение
    Описание
    -operation
    RestoreConfiguration

    Выполняет восстановление конфигурации из резервных копий пакетов.

    Требует выполнения операции BackupConfiguration. Требует указания параметров -installPackageData и -backupPath.

    -backupPath
    Путь к локальному каталогу
    Путь к локальному каталогу на диске с резервными копиями *.gz-архивов пакетов. Значение текущего параметра совпадает со значением параметра -backupPath при выполнении резервного копирования пакетов.
    -installPackageData
    true
    Указывает на необходимость установки привязанных к пакету данных после сохранения пакетов. Принимает значения true или false. По умолчанию — true.
    -confRuntimeParentDirectory
    Путь к локальному каталогу
    Путь к родительскому каталогу директории ..\Terrasoft.WebApp\conf.
    -configurationPath
    Путь к локальному каталогу
    Путь к каталогу ..\Terrasoft.WebApp\Terrasoft.Configuration. В этот каталог экспортируются исходные коды и ресурсы схем пользовательских пакетов в режиме разработки в файловой системе.
    -logPath
    Путь к локальному каталогу
    Путь к каталогу, в который будет сохранен файл с логом операции. Название файла состоит из даты и времени запуска операции. Необязательный параметр.
  2. Запустите утилиту.

В результате выполнения конфигурация будет восстановлена из резервной копии пакетов.

7. Перезапустить приложение в IIS 

Для применения изменений перезапустите приложение в IIS. Это необходимо, поскольку утилита WorkspaceConsole вносит изменения напрямую в базу данных.

WorkspaceConsole на .NET Core 

Creatio позволяет использовать утилиту WorkspaceConsole для генерации и компиляции приложения на платформе .NET Core.

Чтобы выполнить генерацию и компиляцию приложения на платформе .NET Core:

  1. Отредактируйте строку подключения.

    Для этого откройте файл Terrasoft.Tools.WorkspaceConsole.dll.config, который находится в каталоге ..\WorkspaceConsole. Строка подключения содержится в атрибуте name XML-элемента <connectionStrings>. Значение строки з названием "db" файла Terrasoft.Tools.WorkspaceConsole.dll.config должно совпадать со значением соответствующей строки файла СonnectionStrings.config.

    Файл Terrasoft.Tools.WorkspaceConsole.dll.config
    <connectionStrings>
       ...
        <add name="db" connectionString="Pooling=true; Database=7.18.4(netcore); Host=; Port=5432; Integrated Security=true; Username=; Timeout=5; CommandTimeout=400" />
        ...
    </connectionStrings>
    

    Строка с названием "db" используется для подключения к базе данных MS SQL Server.

  2. Откройте командную строку и перейдите в каталог ..\WorkspaceConsole. Для этого выполните команду, которая приведена ниже.

    cd [Путь к каталогу WorkspaceConsole]
    
  3. Cформируйте команды для генерации и компиляции приложения на платформе .NET Core.

    Сигнатура команд, которые последовательно необходимо выполнить в интерпретаторе команд (консоли), для генерации и компиляции приложения на платформе .NET Core приведена ниже.

    dotnet Terrasoft.Tools.WorkspaceConsole.dll -operation=RegenerateSchemaSources -workspaceName=Default -configurationPath=[Путь к локальному каталогу] -confRuntimeParentDirectory=[Путь к локальному каталогу] -logPath=[Путь к локальному каталогу]
    
    dotnet Terrasoft.Tools.WorkspaceConsole.dll -operation=RebuildWorkspace -workspaceName=Default -configurationPath=[Путь к локальному каталогу] -webApplicationPath=[Путь к локальному каталогу] -confRuntimeParentDirectory=[Путь к локальному каталогу] -logPath=[Путь к локальному каталогу]
    
    dotnet Terrasoft.Tools.WorkspaceConsole.dll -operation=BuildConfiguration -force=True -workspaceName=Default -configurationPath=[Путь к локальному каталогу] -destinationPath=[Путь к локальному каталогу] -confRuntimeParentDirectory=[Путь к локальному каталогу] -logPath=[Путь к локальному каталогу]
    
    Параметры WorkspaceConsole для генерации и компиляции приложения на платформе .NET Core
    Параметр
    Значение
    Описание
    -operation
    RegenerateSchemaSources

    Выполняет перегенерацию исходных кодов и их компиляцию.

    Требует указания параметра -confRuntimeParentDirectory.

    ReBuildWorkspace

    Перекомпилирует рабочее пространство (конфигурацию). Используется при разработке схем с помощью Visual Studio.

    Требует указания параметра -confRuntimeParentDirectory.

    BuildConfiguration

    Выполняет генерацию статического контента в файловую систему.

    Требует указания одного из параметров -webApplicationPath или -configurationPath.

    -workspaceName
    Название рабочего пространства
    Название рабочего пространства (конфигурации). По умолчанию все пользователи работают в рабочем пространстве Default.
    -configurationPath
    Путь к локальному каталогу
    Путь к каталогу ..\Terrasoft.Configuration. В этот каталог экспортируются исходные коды и ресурсы схем пользовательских пакетов в режиме разработки в файловой системе.
    -confRuntimeParentDirectory
    Путь к локальному каталогу
    Путь к родительскому каталогу приложения.
    -logPath
    Путь к локальному каталогу
    Путь к каталогу, в который будет сохранен файл с логом операции. Необязательный параметр.
    -webApplicationPath
    Путь к локальному каталогу
    Путь к каталогу на диске, в который установлено приложение Creatio. По этому пути из файла ConnectionStrings.config будет считана информация по соединению с базой данных. Если параметр не указан, то устанавливается соединение с базой данных, которая указана в строке соединения в конфигурационном файле утилиты.
    -force
    True или False

    Задает условия генерации файлового контента. Если значение параметра равно True, то генерация и компиляция исходных кодов выполняется по всем схемам. Если значение параметра равно False, то генерация и компиляция исходных кодов выполняется по измененным схемам.

    Требует указания одного из параметров -webApplicationPath или -configurationPath.

    -destinationPath
    Путь к локальному каталогу
    Путь к локальному каталогу на диске. В этот каталог будут экспортированы *.gz-архивы пакетов.