Конфигуратор интеграций: No-code экспорт документов из Directum RX во внешние системы

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

Настоящее решение, разработанное компанией "СТАРКОВ Групп", представляет собой конфигурируемый механизм экспорта данных, который позволяет настраивать выгрузку документов через интуитивный веб-интерфейс без написания программного кода.

Предпосылки: реальный кейс от заказчика

Идея для решения родилась из конкретной задачи, с которой обратился заказчик. Требованием было создание реестра электронных доверенностей в Directum RX с автоматической передачей данных во внешнюю специализированную систему для формирования файлов PDF, которые затем должны возвращаться и прикрепляться к карточкам в Directum RX.

Ключевая сложность заключалась в деталях:

1. Данные сложной структуры: Для формирования доверенности нужны не только базовые реквизиты документа, но и цепочки связанных данных: автор, подписанты, их подразделения, список передаваемых полномочий (коллекция с кодами, датами, описаниями).

2. Отсутствие персональных данных в Directum RX: В целях безопасности полные ФИО, паспортные данные и другие персональные сведения сотрудников не хранятся в Directum RX. Они находятся в сторонней системе.

3. Требование к гибкости: Набор передаваемых полей и логика их обработки могли меняться. Заказчик хотел иметь возможность быстро адаптировать интеграцию под новые требования регуляторов или бизнес-процессов силами администраторов, без ожидания очереди на разработку.

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

Цели и задачи решения

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

Основные цели:

1.    Снижение стоимости и сроков интеграции: Исключить или минимизировать участие разработчика при подключении новых внешних систем.

2.    Передача логики на сторону бизнеса: Дать возможность администраторам и бизнес-аналитикам самостоятельно управлять настройками обмена данными.

3.    Обеспечение сложной логики сбора данных: Гарантировать, что инструмент сможет извлекать данные любой вложенности (массивы, связанные объекты) и обогащать их из внешних источников при необходимости.

Ключевые задачи:

Создать визуальный конструктор маппинга (сопоставления данных), понятный без знания программирования.

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

Разработать архитектуру, позволяющую легко расширять функционал под нестандартные запросы (как в кейсе с персональными данными).

Именно этот комплекс целей и задач стал катализатором для создания универсального решения, которое решает не только конкретный кейс, но и открывает путь для других сценариев no-code интеграции.

Решение

Рассмотрим процесс настройки на выдуманном примере. Допустим, нам необходимо выгружать документы типа «Электронная доверенность» в Учетную систему N. Требуется передать следующий набор данных:

• Идентификатор и версия документа.
• Идентификатор автора.
• Имя и подразделение подписанта.
• Код и даты действия полномочий (коллекция).
• Тело документа.

На выходе мы ожидаем получить JSON такой структуры:

{
	"entityDto": {
		"AuthorId": "",
		"SignatoryFio": "",
		"SignatoryDep": "",
		"Id": "",
		"Version": "",
		"Extension": "",
		"Authorities": [
			{
				"AuthorityCode": "",
				"AuthorityStartDate": "",
				"AuthorityEndDate": ""
			}
		]
	}
}

Предварительная настройка

Для начала необходимо доработать карточку документа. Через представление формы мы выводим новое свойство «Целевая система», которое будет использоваться для управления выгрузкой. Это единственное изменение в интерфейсе RX.

Рисунок 1. Новое свойство в представление формы документа.

Настройка интеграции

Точкой входа служит модуль «Настройка интеграции».

Рисунок 2. Обложка модуля.

Шаг 1: Определяем целевые системы.

В справочнике «Целевые системы» создается запись с именем системы кодом и данными для авторизации (логин/пароль).

Рисунок 3. Настройка параметров подключения к целевой системе.

Шаг 2: создаём правило маппинга.

В справочнике «Маппинг интеграции» создаём новую настройку. Здесь мы связываем RX и внешний мир:

1. Указываем имя правила.
2. Выбираем тип документа в RX (например, «Электронная доверенность»).
3. Указываем список целевых систем, для которых это правило актуально.
4. Прописываем конечный адрес (Endpoint) API целевой системы.
5. При необходимости задаём имя корневого объекта в итоговом JSON.
6. Заполнение маппинга полей между системами.

• Для каждого поля JSON администратор выбирает соответствующее свойство из дерева документа RX. Интерфейс позволяет «проваливаться» в любую вложенность: автор → подразделение → руководитель подразделения и т.д.
• Если нужно передать список элементов (как в примере с полномочиями Authorities), коллекция добавляется как отдельный узел, внутри неё точно так же настраиваются вложенные поля — система автоматически сформирует массив нужной структуры.
• Для данных, которые нельзя получить прямым маппингом (например, тело файла последней версии документа, расширение файла), администратор выбирает нужную функцию из предустановленного списка

Рисунок 4. Создание нового правила интеграции.

Ключевые особенности и преимущества

• No-code настройка: Администратор управляет интеграциями самостоятельно, без привлечения разработчиков. Время подключения новой системы сокращается с дней до часов.
• Визуальный конструктор: Интуитивный интерфейс настройки сложных цепочек свойств и коллекций.
• Расширяемость под нестандартные задачи: Если данных нет в карточке — есть возможность расширения функционала через серверные функции для сохранения гибкости.
• Прозрачность и безопасность: Все настройки хранятся внутри Directum RX, а передача данных защищена стандартными механизмами авторизации.
• Готовность к работе: Решение работает после минимальной первоначальной настройки, для введения новой интеграции не требуется публикаций разработки.

Пример настройки

На нашем примере настройка заняла менее 2-х минут.

Отправка документа в учетную систему производится по действию из карточки документа. В нашем примере имеем выходной JSON:

Рисунок 5. Пример полученных данных

Техническая реализация

Решение состоит из двух ключевых компонентов:

1. Модуль Directum RX: Содержит справочники («Целевые системы», «Маппинг интеграции»), серверные функции для обработки данных и логики выгрузки, а также расширение объекта «Официальный документ».
2. Сторонний компонент: Отвечает за визуальный интерфейс построения правил маппинга, предоставляя администратору удобный инструмент для настройки.

Перспективы и планы развития

Разработанное компанией “СТАРКОВ Групп” решение эффективно закрывает типовую, но ресурсоемкую задачу — организацию экспорта данных. Оно переносит фокус с написания кода на конфигурирование бизнес-логики, что значительно ускоряет процессы интеграции и делает их более управляемыми.

В планах развития:

1. Доработка пользовательского интерфейса
2. Расширение настроек для преобразования форматов данных к необходимым для целевых систем (например выбор формата даты, передача значения для bool)
3. Расширение функционала на другие ключевые сущности Directum RX
4. Добавление механизма настройки обработки ответов внешних систем.
5. Разработка механизма правил для автоматической выгрузки документов

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

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

ООО “СТАРКОВ Групп” - ведущий системный интегратор и Генеральный партнер компании DIRECTUM, специализирующийся на внедрении и сопровождение ECM-решений.

В проекте  команда “СТАРКОВ Групп” продемонстрировала глубокую экспертизу в области улучшения пользовательского опыта: разработала уникальное No-code решение для управления всплывающими подсказками, которое передало контроль над интерфейсом бизнес-аналитикам и администраторам, исключив зависимость от разработчиков при обновлении инструкций. Благодаря этому внедрению порог входа для сотрудников был значительно снижен, а качество взаимодействия с системой повышено. 

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