Компании могут использовать сразу несколько систем для ведения бизнеса. Объединение систем в экосистемы становится логичным шагом для дальнейшего роста и развития. Правильно настроенные интеграции облегчают выполнение бизнес-процессов и работу сотрудников.

Система Directum RX готова к обмену информацией с учетной системой 1С, службами каталогов Active Directory и Samba (Directory Service), редакторами ONLYOFFICE и другими системами. Список всех готовых интеграций можно посмотреть на сайте Directum RX, на странице «Функциональные возможности». Кроме этого, с помощью сервиса интеграции можно объединить Directum RX с любыми системами, которые предоставляют инструменты интеграции.

По умолчанию сервис интеграции устанавливается вместе с остальными серверными компонентами. Он создан на основе концепции REST API с использованием открытого протокола OData версии 4.0. Подробнее о протоколе см. в официальной документации Microsoft.

Сервис предоставляет базовые операции для работы с данными: создание, чтение, изменение и удаление. Взаимодействие с сервисом реализовано с помощью HTTP(S)-запросов. Запросы позволяют внешней системе выполнять действия в Directum RX, например создавать документы, записи справочников и задачи.

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

Схема интеграции:

Предположим, внешняя система отправляет запрос к сервису интеграции. Перед обработкой запрос проходит аутентификацию в сервисе. После этого сервис с помощью OData-контроллеров определяет, что нужно сделать: найти документ, получить свойство справочника, вызвать функцию и т.п. Для этого используется API Directum RX. Полученный результат (ответ) преобразовывается в структурированный формат JSON и передается внешней системе. Подробный порядок действий см. в разделе «Настройка интеграции».

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

СМ. ТАКЖЕ