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

Утилита WorkspaceConsole — это программа, предназначенная для выполнения различных операций с пакетами bpm'online. Наиболее часто используемые операции, выполняемые с помощью утилиты:

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

Исполняемый файл утилиты Terrasoft.Tools.WorkspaceConsole.exe расположен в каталоге приложения bpm'online по следующему пути:

[Путь к каталогу с установленным приложением]\Terrasoft.WebApp\DesktopBin\WorkspaceConsole\

Версия утилиты совпадает с версией приложения.

ВАЖНО При обновлении версии приложения посредством применения пакетов должна использоваться WorkspaceConsole версии сборки, до которой необходимо обновить текущее приложение. Например, если текущая версия сборки 7.8.2.1035, а необходимо обновить пакеты до версии 7.8.2.1561, то необходимо использовать утилиту версии 7.8.2.1561.

Настройка WorkspaceConsole

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

Для этого необходимо в XML-элементе <db> конфигурационного файла узнать название используемой строки подключения. Затем в элементе <connectionStrings> необходимо в используемой строке подключения изменить значение атрибута connectionString так, чтобы оно совпадало со значением, используемым в строке подключения конфигурационного файла ConnectionStrings.config. Подробнее о настройке параметров файла ConnectionStrings.config можно узнать из статьи "Как развернуть приложение on-site". Пример секций <db> и <connectionStrings> файла Terrasoft.Tools.WorkspaceConsole.exe.config:

<terrasoft>
 ...
  <db>
    <general connectionStringName="db" ... />
  </db>
</terrasoft>
<connectionStrings>
 ...
  <add name="db" connectionString="Data Source=DBServer; Integrated Security=SSPI; Initial Catalog=DBName; MultipleActiveResultSets=True; Pooling=true; Async=true" />
</connectionStrings>

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

Для корректной работы утилите необходимы библиотеки, используемые приложением bpm'online. Поэтому, прежде чем начать работу с утилитой, необходимо скопировать содержимое папки [Путь к каталогу с установленным приложением]\Terrasoft.WebApp\bin в папку [Путь к каталогу с установленным приложением]\Terrasoft.WebApp\DesktopBin\WorkspaceConsole.

Также необходимо выбрать версию файла Terrasoft.Tools.WorkspaceConsole.exe, соответствующую версии операционной системы — с 32-битной или с 64-битной архитектурой. Соответствующие исполняемые файлы находятся в каталогах [Путь к каталогу с установленным приложением]\Terrasoft.WebApp\DesktopBin\WorkspaceConsole\х86 и [Путь к каталогу с установленным приложением]\Terrasoft.WebApp\DesktopBin\WorkspaceConsole\х64.

Чтобы избежать появления возможных ошибок при копировании вручную с утилитой WorkspaceConsole поставляются пакетные файлы PrepareWorkspaceConsole.x86.bat и PrepareWorkspaceConsole.x64.bat. Запуск пакетного файла, соответствующего версии операционной системы, выполнит все необходимые операции по подготовке WorkspaceConsole автоматически.