DrxUtil – вспомогательная утилита Directum RX. Представляет собой клиентское приложение, которое взаимодействует с сервером приложений (СП) и обеспечивает обмен данными между СП и внешними системами. В стандартной системе Directum RX утилита используется для:

•обеспечения синхронизации данных Directum RX с системой 1С с конфигурацией «1C: Бухгалтерия предприятия 2.0»;

•автоматическое подписание извещений о получении документов из сервисов обмена электронными юридически значимыми документами;

•обращения к локальным ресурсам через публичные клиентские функции Directum RX.

ВАЖНО. Утилита DrxUtil и сервер приложений – устаревшие компоненты, оставленные для совместимости. Для всех последующих настроек интеграции нужно использовать новые средства: сервис интеграции, кроссплатформенную утилиту RxCmd.

Размещение и настройка утилиты

Если вы работаете с системой Directum RX в облаке, то запросите архив с утилитой в службе поддержки и распакуйте его. Если система установлена локально, то утилита находится в папке DirectumLauncher\etc\_builds\DirectumRX\DrxUtil.

Общий порядок настройки утилиты зависит от варианта ее запуска:

•если планируется запускать утилиту через скрипты развертывания, то перед началом работ заполните параметры утилиты в конфигурационном файле config.yml в секции DrxUtil;

•если планируется запускать утилиту напрямую через исполняемый файл, то заполните параметры утилиты в конфигурационном файле config.yml в секции DrxUtil, а также в файле _ConfigSettings.xml.

При облачной поставке файл _ConfigSettings.xml выдается службой поддержки Directum RX. При локальной установке файл необходимо создать вручную на основе входящего в поставку примера _ConfigSettings.xml.example.

Для настройки интеграции с 1С через DrxUtil.exe используйте примеры конфигурационных файлов. Они находятся в папке с утилитой:

•_settings.xml.example – файл параметров синхронизации данных с информационной базой 1С;

•_ConfigSettings.xml.example – файл параметров подключения к серверу приложений Directum RX.

Для анализа ошибок работы с DrxUtil используйте лог-файлы утилиты.

ПРИМЕЧАНИЕ. Если после настройки и запуска утилиты возникает ошибка о том, что истекло время ожидания ответа сервера, рекомендуется увеличить время тайм-аута в настройках утилиты. Для этого в файле Services.client.config найдите все строки с параметром sendTimeout и увеличьте его значение. Файл находится в папке с утилитой.

Запуск утилиты через исполняемый файл

Исполняемый файл утилиты вызывается из командной строки. При запуске указываются параметры утилиты. Состав параметров может меняться в зависимости от выполняемого действия.

-n <login> – пользователь, от имени которого запускается утилита.

-p <password> – пароль пользователя, от имени которого запускается утилита.

Важно. Параметры -n и -p указываются, только если используется аутентификация по паролю. Если подключаетесь под текущим пользователем с помощью windows-аутентификации, то данные параметры указывать не нужно.

-f <call> или --call – вызвать статическую клиентскую функцию, которая не возвращает значение. Например, -f Sungero.Docflow.Module.ShowMessage SomeMessage. Разрешены функции со строковыми параметрами, которые перечисляются через пробел. Все символы после названия функции считаются параметрами функции.

-a <ShowFunctions> – показать прикладные функции, которые можно вызвать.

-b <Sync1C> или --Sync1C – синхронизация с 1С. После параметра укажите имя файла _Settings.xml с настройками синхронизации.

-v <SyncAD> – синхронизация сотрудников с Active Directory.

-y <settings> – указать путь к файлу с настройками конфигурации 1C.

Пример запуска синхронизации с 1С

"D:\DirectumLauncher\etc\_builds\DirectumRX\DrxUtil\DrxUtil.exe" -n "Integration Service" -p 11111 --Sync1C _Settings.xml

Пример вызова справки справки по утилите

"D:\DirectumLauncher\etc\_builds\DirectumRX\DrxUtil\DrxUtil.exe" --help

Запуск утилиты через скрипты развертывания

Если система установлена локально, то утилиту можно запускать с помощью скриптов развертывания.

Список команд:

generate-config-settings – создание конфигурационного файла _ConfigSettings.xml с настройками утилиты.

import_templates – импорт стандартных шаблонов документов из базовой поставки Directum RX.

run --command='<Команда>' – выполнение произвольных команд. Здесь указываются такие же команды и опции, как при запуске утилиты через исполняемый файл: --call, --Sync1C и др.

Пример запуска синхронизации с 1С

do drxutil run --command='-n "Integration Service" -p 11111 --Sync1C _Settings.xml'

Пример вызова справки по утилите

do drxutil run --command='--help'

Устранение неисправностей

Если в настройках системы допущены ошибки, то при запуске утилиты может возникнуть ошибка вида «No access rights to the system - invalid username or password». Причин может быть несколько. В разделе описаны варианты устранения неисправностей:

© Компания Directum, 2024