Коннектор обмена данными между системами Directum RX

Представляем вам коннектор обмена данными между разными системами Directum RX – инструмент для передачи и обмена заданиями с вложенными документами в рамках двух и более систем Directum RX.

Основные функции коннектора

• Передача документов между системами посредством создания задачи с сохранением версий документов, электронных подписей, основных полей документов, приложений из области вложений задачи, текстом и темой задачи, сроками и исполнителями.
• Формирование заданий на исполнителя, указанного по умолчанию в системе получателя.
• Передача статусов выполнения заданий из системы получателя в систему отправителя.
• Автоматизированный контроль задач, не отправленных в связи с возможными техническими проблемами.
• Декодирование и распаковка архива при поступлении в стороннюю систему.

Протоколы обмена

• Open Data Protocol (OData) – это веб-протокол на основе ресурсов для запроса и обновления данных. Open Data Protocol (OData) определяет операции с ресурсами, используя HTTP-команды, и идентифицирует эти ресурсы по стандартному синтаксису URI. При межсистемном взаимодействии используется POST запрос. 
• POST-запрос отправляется в виде строки, которая содержит следующие параметры: ZipBase64 – используется для кодирования архива, который формируется при отправке из одной системы в другую; appeal – используется для указания типа передаваемого пакета.

Справочники

Для настройки обмена справочники имеют тематическое разделение по группам: данные адресов; администрирование. Справочники размещены в модуле «Передача документов между системами», который доступен администраторам системы.

К группе «Настройки» относятся:

1. Справочник «Адреса узлов», используется для указания получателей в сторонней системе. На указанных в записи справочника сотрудников можно формировать задачи, которые отправятся по коннектору.

2. Справочник «ГУИДы наших организаций», используется для указания получателей внешних заданий из сторонней системы.

К группе «Администрирование» относятся:

1. Справочник «Пакеты для коннектора», используется для хранения и дальнейшей аналитики состояний успешно отправленных задач.

2. Справочник «Настройки папок обмена», предназначен для добавления записи с информацией о пути к серверной папке для выгрузки. Должен содержать не менее 6 записей путей:

3. Справочник «Информация о данных, передаваемых по коннектору», предназначен для хранения записей о загруженных и выгруженных задачах, в которых приводится сопоставление свойств задачи в исходной системе и системе получателя.

Процесс передачи данных в стороннюю систему

Процесс обмена обеспечивает передачу следующих объектов:

1. Пакет с типом «Запрос» и его содержимое.
2. Пакет с типом «Ответ» и его содержимое.
3. Информацию о статусах задач: прекращение, продление срока.
4. Изменения в передаваемых документах.

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

Передача подписей

Между системами передаются два типа подписей: утверждающая и визирующая. Передача происходит по следующим направлениям:

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

2. Подпись на документе в составе ответного пакета: когда поступает задание, логика которого требует подписания входящего документа (задание на подписание, согласование, утверждение документов), то в ответном пакете передаётся в стороннюю систему и прикрепляется к документу файл формата p7s/sig/sgm.

Папки на сервере

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

Содержимым папок обмена являются передаваемые пакеты, имя которых формируется по следующему принципу: ИД_Задачи_ИД_Задания_ИД_Документа.

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

Фоновые процессы для отправки и получения внешних задач

Фоновые процессы, которые обеспечивают работоспособность коннектора:

• Отправка задач в другую систему,
• Выгрузка архивов из папки в стороннюю систему,
• Загрузка архивов поступивших из сторонней системы.

1. Фоновый процесс по отправке заданий в стороннюю систему «Отправка задач в другую систему» обрабатывает (прочитывает) непрочитанные входящие задания сотрудников, указанных в адресах узлов и формирует по ним пакеты для отправки в стороннюю систему.
2. Фоновый процесс «Выгрузка архивов из папки в стороннюю систему» осуществляет отправку пакетов из папки «Export» в системе отправителя в папку «Import» в системе получателя.

Попадая в стороннюю систему, сравниваются GUID-ы, указанные:

• В системе отправителя: в записи справочника «Адреса узлов»
• В системе получателя: в записи справочника «ГУИДы наших организаций»

При совпадении ГУИДов формируется задание на указанных в справочнике «ГУИДы наших организаций» получателей. Если задание отправлено, то в системе отправителя в текст задания пишется следующее сообщение «Задание выгружено в стороннюю систему» и в системах, между которыми происходит обмен, добавляются записи в справочник «Информация о данных, передаваемых по коннектору» с сопоставлением свойств отправленной и полученной задачи.

Если задание не отправилось, то пользователям, включенным в роль «Администраторы коннектора» поступает уведомление об ошибке выгрузки в системе отправителя.

3. Фоновый процесс «Загрузка архивов, поступивших из сторонней системы» осуществляет импорт содержимого пакета (документ, информация о задаче, подписи и т.д.), который поступил из сторонней системы.

Логирование ошибок

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

Текст ошибки выгружается в файл в одной из папок на сервере:

• папка «in_error»: лог-файл помещается в созданную папку с именем передаваемого архива,
• папка «out_error»: лог-файл помещается в созданную папку с именем передаваемого архива.

Выбор папки зависит от момента возникновения ошибки. Если возникает ошибка отправки исходящего пакета, то отчет об ошибке помещается в папку«out_error», если ошибка возникает в процессе отправки ответного пакета, то отчет об ошибке помещается в папку «in_error». Имя файла с отчетом имеет вид: ИДзадачи_log.txt. ИД задачи берется из той системы, в которой возникла ошибка. Формат файла – текстовый. Файл содержит текст ошибки, по причине которой обмен можно считать некорректным, дату и время возникновения ошибки. Пример текста, который попадает в файл:

2024-05-10 13:08:45.112: не удалось установить блокировку. Запись «Наименование» с идентификатором 111111 уже заблокирована пользователем «Иванов Иван Иванович» в «05.05.2024 10:10:33»

Отправка уведомлений об ошибках

В случае возникновения ошибки при отправке пакетов в стороннюю систему помимо записи в папке с назначением «error» формируется уведомление об ошибке отправки в системе отправителя. Получатели уведомления – пользователи из роли «Администраторы» и (при включенном свойстве «Отправлять автору задачи уведомление») автор задачи. Уведомление содержит информацию о причине сбоя. Во вложении - ссылка на задачу, при отправке которой возникла ошибка.

Ограничения

Если в системе перекрывали карточки входящего письма, распоряжения или обращения и добавляли в них новые обязательные свойства, тогда может понадобиться перекрытие коннектора и добавление этих свойств. Кроме этого никаких требований к согласованности нет.