Выгрузка пакетов из базы данных при помощи WorkspaceConsole
Glossary Item Box
Общие сведения
Для переноса пользовательских пакетов между рабочими средами, не связанными общим SVN-хранилищем (например, средой разработки и тестовой средой), сначала необходимо выгрузить нужные пакеты в файловую систему. Для выгрузки пакетов из базы данных используется операция SaveDBContent утилиты WorkspaceConsole. Подробно основные операции, выполняемые с помощью WorkspaceConsole, а также ее параметры описаны в статье "Параметры утилиты WorkspaceConsole".
Прежде чем запускать на выполнение WorkspaceConsole, необходимо удостовериться в правильности ее настроек. Особенности настройки утилиты подробно описаны в статье "Настройка утилиты WorkspaceConsole".
Для выгрузки пакетов из базы данных необходимо запустить утилиту WorkspaceConsole со следующими значениями параметров (табл. 1):
Табл. 1. — Параметры WorkspaceConsole для выгрузки пакетов из базы данных
| Параметр | Значение | Описание |
|---|---|---|
| -operation | SaveDBContent |
Сохраняет содержимое базы данных в файловую систему. Тип содержимого определяется значением параметра contentTypes. Место в файловой системе, куда будет выгружено содержимое, определяется параметром destinationPath. Требует указания одного из параметров -webApplicationPath или -configurationPath. |
| -contentTypes | Repository | Тип содержимого, выгружаемого из базы данных в дисковое пространство. Значение Repository определяет выгрузку рабочего пространства, имя которого задается значением параметра workspaceName, в каталог, путь к которому задается значением параметра destinationPath. |
| -workspaceName | [Название рабочего пространства] | Название рабочего пространства (конфигурации), в котором определены выгружаемые пакеты. По умолчанию все пользователи работают в рабочем пространстве Default. |
| -destinationPath | [Путь к локальному каталогу] |
Путь к локальному каталогу в дисковой системе. В этот каталог будут выгружены заархивированные в формате *.gz пакеты. |
| -webApplicationPath | [Путь к локальному каталогу] |
Путь к каталогу на диске, в который установлено приложение Creatio. По этому пути из файла ConnectionStrings.config будет считана информация по соединению с базой данных. Если параметр не указан, то будет установлено соединение с базой данных, указанной в строке соединения в конфигурационном файле утилиты. Если указан — соединение будет установлено с базой данных, указанной в файле ConnectionStrings.config приложения Creatio. |
| -configurationPath | [Путь к локальному каталогу] |
Путь к подкаталогу Terrasoft.Configuration в каталоге, в который установлено приложение. Например, C:\сreatio7.12.2\Terrasoft.WebApp\Terrasoft.Configuration. В этот каталог выгружаются исходные коды и ресурсы схем пользовательских пакетов в режиме разработки в файловой системе. |
Во время выполнения операции выгрузки пакетов, выгружаются все пакеты рабочего пространства. Поэтому длительность этой операции — до нескольких десятков минут.
Прежде чем выгружать пакеты, необходимо проверить правильность привязки данных. К таким данным относятся, например, системные настройки, справочники, наполнение раздела и т.п.
Подробнее о привязке данных можно узнать из статьи "Привязка данных к пакету".
Сигнатура команды, которую необходимо выполнить в интерпретаторе команд (консоли) Windows для выполнения операции выгрузки из базы данных:
[Путь к WorkspaceConsole]\Terrasoft.Tools.WorkspaceConsole.exe -operation=SaveDBContent -contentTypes=Repository -workspaceName=[Название рабочего пространства] -destinationPath=[Путь к локальному каталогу] -webApplicationPath=[Путь к каталогу приложения]
Команду удобно формировать в пакетном файле (*.bat), созданном в любом текстовом редакторе.
Пример выполнения выгрузки пакетов в файловую систему
Описание кейса
Для приложения, установленного в каталог C:\сreatio7.12.4, выгрузить все пакеты рабочего пространства Default в каталог C:\SavedPackages.
Реализация кейса
Формирование команды запуска утилиты WorkspaceConsole удобно выполнять с помощью любого текстового редактора в файле пакетных команд Windows (*.bat или *.cmd). В этот файл необходимо поместить команду запуска утилиты:
C:\creatio\Terrasoft.WebApp\DesktopBin\WorkspaceConsole\Terrasoft.Tools.WorkspaceConsole.exe -operation=SaveDBContent -contentTypes=Repository -workspaceName=Default -destinationPath=C:\SavedPackages -webApplicationPath=C:\creatio --logPath=C:\Logs
pause
После сохранения пакетного файла и его запуска на выполнение (двойным кликом из проводника Windows), появится консольное окно, в котором будет отображаться процесс выполнения WorkspaceConsole с заданными значениями параметров (рис. 1).
Рис. 1. — Процесс выполнения WorkspaceConsole
В результате выполнения команды в каталог C:\SavedPackages будут выгружены zip-архивы, содержащие все пакеты конфигурации Default (рис. 2).
Рис. 2. — Выгруженные в файловую систему zip-архивы с пакетами Creatio
