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

Документация Avanpost IDM 7 : 6.1.5. Настройка интеграции с брокерами сообщений

 Навигатор по разделу

Общие сведения

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

Стандартные библиотеки коннекторов, доступные при настройке ресурсов, не подходят для создания сервиса брокера сообщений

Для настройки интеграции требуется коннектор к брокеру сообщений. Коннектор, представляющий из себя библиотеку dll, устанавливается на сервере Avanpost IDM. С помощью коннектора создается подключение к брокеру сообщений.

Доступен готовый коннектор для интеграции с брокером сообщений RabbitMQ. Скачать библиотеку коннектора можно по ссылке: Avanpost.Iga.Plugins.RabbitMq-7.8.2-rc.21.zip

О разработке коннекторов к другим брокерам сообщений см. статью "10.1. Разработка коннекторов" руководства разработчика.

Настройка интеграции с брокером сообщений RabbitMQ

Для настройки интеграции с брокером сообщений RabbitMQ требуется выполнить шаги:

Шаг 1. Установка библиотеки коннектора

Для этого необходимо:

  1. Поместить библиотеку коннектора "Avanpost.Iga.Plugins.RabbitMq.dll" на сервер Avanpost IDM в папку "/opt/avanpost/connectors" или на удаленный сервис коннекторов.
  2. Скачать библиотеку коннектора можно по ссылке: Avanpost.Iga.Plugins.RabbitMq-7.8.2-rc.21.zip

О настройке удаленного сервиса коннекторов см. статью "5.4. Установка и настройка удаленного сервиса коннекторов Avanpost IDM" руководства по установке.

Шаг 2. Создание подключения в веб-интерфейсе администратора Avanpost IDM

  1. В разделе "Интеграции" → "Брокеры сообщений" веб-интерфейса администратора нажать .
  2. В открывшейся форме заполнить параметры:
ПараметрОписание
НазваниеУказать произвольное название для создаваемого подключения к брокеру сообщений
Библиотека коннектора Выбрать из выпадающего списка библиотеку коннектора, установленную на шаге 1
Строка подключения

Формат строки подключения

Параметры в строке подключения записываются последовательно с указанием передаваемых значений после знака равно (=). Разделителем между параметрами служит точка с запятой (;).

Шаблон строки подключения
hostname=[Имя сервера RabbitMQ];publish-queue=[ключ маршрутизации];receive-queue=[ключ маршрутизации];username=[Имя пользователя RabbitMQ];password=[Пароль];port=[Порт RabbitMQ];vhost=[URI виртуального хоста RabbitMQ];
Пример строки подключения
hostname=localhost;publish-queue=iga;receive-queue=iga;username=guest;password=guest

Обязательные параметры строки подключения

ПараметрОписание

hostname

Имя сервера RabbitMQ

publish-queueОчередь ответов на запросы (ключ маршрутизации)
receive-queueОчередь для входящих запросов (ключ маршрутизации)

Необязательные параметры строки подключения

ПараметрОписание
usernameИмя пользователя RabbitMQ
passwordПароль пользователя RabbitMQ
portПорт RabbitMQ
vhostURI виртуального хоста RabbitMQ
ВключенУстановить флажок для включения интеграции с брокером сообщений

Шаг 3. Настроить прием и передачу сообщений

  1. Настроить обработчик событий "ExternalBrokerContextEvent".
    Подробная инструкция по настройке обработчиков событий приведена в статье "6.1.12. Обработка событий".
  2. Для отправки сообщений в очередь брокера сообщений необходимо использовать метод "ExternalEventBrokers.Publish" в скрипте и настроить использование этого скрипта в бизнес-процессах.

    Метод "ExternalEventBrokers.Publish" принимает на вход две строки: имя настроенного подключения к RabbitMQ и сообщение, которое требуется отправить.

    Метод "ExternalEventBrokers.Publish" ничего не возвращает.

Пример скрипта для отправки сообщений
ExternalEventBrokers.Publish("RabbitMQ", "Сообщение")

О настройке бизнес-процессов см. статью "6.1.10. Настройка бизнес-процессов" руководства по администрированию.

Обсуждение