Решение «Перенос данных между системами Directum RX»

Введение

Перенос данных между системами Directum RX вещь весьма актуальная. Не так давно компания Directum выпустила свое техническое решение Утилита для переноса справочных данных Directum RX.

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

Кто работал на Directum 5 и ниже, еще помнят механизм переноса справочников, выбрал что нужно, экспортировал и готово. Работало это не идеально, но с точки зрения использования механизм был весьма прост для "пользователей" (консультанты, тестировщики, администраторы и т.д.). И казалось странным, почему похожего механизма нет в RX.

Вызов принят )))

Задачи

• Сделать простой и понятный механизм переноса записей;
• Обеспечить работу со всеми кастомными или перекрытыми справочниками из коробки;
• Исключить из этой цепочки разработчика (пусть отдохнет бедолага);
• Обеспечить, в теории, возможности использования механизма для переноса данных из других систем;
• Обеспечить полную независимость решения.

Решение

Как работает решение, буду показывать на примере справочника "Журналы регистрации", где предварительно создал пару тестовых записей.

1) Заходим в обложку модуля "Перенос данных".

2) Запускаем диалог "Экспортировать записи":

   a) выбираем справочник;
   б) выбираем сколько и какие записи мы хотим экспортировать;
   в) заполняем состав значимых реквизитов, по которым будет осуществляться поиск в другой системе;
   г) нажимаем "Экспорт".

В результате экспорта получаем Zip-архив с XML-документом.

3) Переносим XML-документ на другую систему: запускаем диалог "Импортировать записи" и выбираем экспортированный XML.

По результатам импорта формируется отчет.

4) Проверяем результат - заходим в справочник "Журналы регистрации".

Небольшое видео: Демонстрация работы

Особенности работы

• Решение работает с любыми справочниками;
• В значимые реквизиты автоматически попадают все свойства справочника у которых установлена галочка "Уникальное", а так же свойство SID;
• Решение экспортирует/импортирует все коллекции и ссылочные типы записи.

Ограничения и недостатки

• Поскольку решение видит все справочники системы, то в список экспорта вполне могут попасть и те справочники, которые туда попадать не должны (пример: Фоновый процесс, Бинарный образ документа, Тип прав и т.д. и т.п.). Чтобы ограничить список выбора, на текущий момент нужен разработчик, который добавит в код Guid исключаемого справочника.
• В диалоге экспорта из поля "Значимый реквизит" исключены все ссылочные свойства, коллекции, BinaryData, Component, Image, а так же некоторый список других системных реквизитов (пример: Id, DisplayValue, SecureObject и т.д.).
• Для импорта ссылочных свойств в записи справочника, предварительно нужно перенести или создать записи справочников на которые ссылаются импортируемые записи, иначе ссылки не будут заполнены.
• Поиск дочерних записей происходит по имени. При нахождении нескольких записей с одинаковыми именами, для заполнения будет использована первая найденная запись. Если в справочнике поля "Имя" нет, то и дочерняя запись не будет найдена.
• Свойства с типами BinaryData, Component, Data пока не экспортируются.

Доступность решения

После проведения нагрузочного тестирования и шлифовки мелких деталей, опубликую исходники на Club или GitHub Directum. 

Но так как проектирование, разработка и тестирование ведется на 95% в свободное от работы время, которого особо нет, публикация может несколько затянуться.

Планы развития

Что планируется сделать, но пока не дошли руки:

• Экспорт/импорт документов с подписями (функционал спроектирован и частично реализован, но есть узкие моменты).
• Асинхронный обработчик или задача для импорта больших пакетов.
• Добавление в диалог импорта визуализации процесса загрузки.
• Debug-режим с полным логирование процессов экспорта и импорта.
• Импорт данных из Directum 5.
• Прочие доработки, которые придут в процессе разработки.

Вывод

Изначально поставленные цели на мой взгляд, вроде как, достигнуты.
Насколько решение окажется жизнеспособно, покажет комьюнити Directum RX.

Команда проекта 

Беляков Сергей