Утилита для переноса справочных данных Directum RX

25 4

Представим, что для закрытия своих бизнес-задач компания N уже продолжительное время использует систему Directum RX. Теперь руководство компании решает выделить для хранения кадровых документов и работы с ними отдельный экземпляр системы. Чтобы полноценно использовать его, администратору придется выполнить первичные настройки системы. Например, настроить организационную структуру компании и документооборот. Делать это вручную долго и неэффективно, так как за время работы в исходной системе объем справочных данных увеличился. Кроме этой ситуации, перенести накопленную информацию часто необходимо из тестовой системы в продуктивную.

В любом из случаев, чтобы упростить перенос, можно воспользоваться «Утилитой переноса настроек Directum RX», которая предназначена для миграции информации из справочников одной системы Directum RX в другую. В базовую поставку утилиты входят правила, которые помогают перенести данные справочников, отвечающих за настройки документооборота:

  • правила и этапы согласования;
  • категории договоров;
  • виды документов;
  • настройки регистрации;
  • журналы регистрации;
  • роли.

На основании подготовленных правил утилита возьмет данные справочников одной инсталляции системы и передаст их в новую:

После этого администратор может продолжить настройку системы, сэкономив время на настройках документооборота.

Механизм работы

​​​​​Принцип работы утилиты достаточно прост:

1. Готовим её к экспорту информации: настраиваем подключение утилиты к серверу приложений системы-источника Directum RX, изменяя соответствующие параметры в конфигурационном файле _ConfigSettings.xml. 

2. Запускаем ее через командную строку с указанием нужных параметров:

  • имя пользователя системы-источника Directum RX и его пароль;
  • путь до файла, в который выгрузятся данные;
  • тип выгружаемого справочника.

Например:

DrxTransfer.exe -n administrator -p 11111 -x “C:\Roles.txt” -j Role

3. Чуть-чуть ждем и на выходе получаем файл в формате JSON с настроечными данными указанного типа справочника.

4. Готовим утилиту к импорту информации в систему-приемник: в том же конфигурационном файле меняем пути до сервера приложений. Теперь нам нужен сервер системы-приемника.

5. Запускаем утилиту на импорт, указав параметры:

  • имя пользователя системы-приемника Directum RX и его пароль;
  • путь до файла с выгруженными ранее данными.

Например:

DrxTransfer.exe -n administrator -p 11111 -i “C:\Roles.txt”

6. Переносим остальные справочники.

Если базовых правил недостаточно, утилиту можно модифицировать так, чтобы перенести данные и других справочников системы. Например, ускорить перенос справочников, содержащих структуру компании. Любые доработки выполняются по инструкции, которая входит в комплект утилиты.

Ограничения утилиты

Как из любого правила есть исключения, так и у любой программы есть ограничения.

 Один запуск утилиты = один тип настроек. За один присест можно перенести только один тип справочника. Например, только справочник Роли.

 Утилита не переносит документы или другие объекты системы. Перенести можно только справочники. Для миграции документов можно воспользоваться другой утилитой – импорта данных.

 К несчастью визуалов, у утилиты нет графического интерфейса. Весь перенос данных выполняется с помощью командной строки.

***

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

Исходные коды утилиты находятся в свободном доступе в хранилище Directum на GitHub.

Если останутся вопросы, пишите комментарии к статье или обращайтесь в службу поддержки Directum по тел. +7(3412)72-67-06 или по электронной почте support@directum.ru.

Анатолий Придыбайло

Есть несколько вопросов:

1. В свете тренда импортозамещения, утилита работать в Linux?

2. Зашел на GitHub и там указанно - "Адаптация под RX 3.5". С какими версиями системы работает утилита?

Пётр Рябов

Анатолий, добрый день!

1. Планируем обеспечить поддержку линукс систем с версии Directum RX 4.2

2. По умолчанию в гитхабе открывается ветка master, там действительно содержится старая версия и в скором времени сольем изменения для 4.1. В целом можно ориентироваться по названиям веток (1.0.4123.0 версия для 4.1, 1.0.4041.0 для 4.0 и т.д)

Александр Волошин

Пётр, добрый день! Скачал утилиту для RX 4.0, собрал. Пробую запускать - ошибка

Метод не найден: "NLog.Config.ISetupBuilder NLog.LogManager.Setup()".

Не могу понять, что я упустил.

Александр Волошин: обновлено 25.11.2021 в 13:02
Alexandr Kazennov

Пётр, добрый день, скажите пожалуйста, работает ли данная утилита на Линукс с версией DirectumRX 4.3?

Авторизуйтесь, чтобы написать комментарий