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

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

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

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

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

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

Примечание:

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

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

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

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

Для этого необходимо поместить библиотеку коннектора "Avanpost.Iga.Plugins.RabbitMq.dll" на сервер Avanpost IDM в директорию "/opt/avanpost/connectors" или на удаленный сервис коннекторов.

Скачать библиотеку коннектора можно по ссылке: Avanpost.Iga.Plugins.RabbitMq-7.8.2-rc.21.zip

Примечание:

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

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

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

2.1. В разделе "Интеграции"→"Брокеры сообщений" веб-интерфейса администратора нажать .

2.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
ВключенОтметить чекбокс для включения интеграции с брокером сообщений

2.3. Нажать .

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

3.1. Для приема сообщений необходимо настроить обработчик событий "ExternalBrokerContextEvent". Подробная инструкция по настройке обработчиков событий приведена в статье: "6.1.12. Обработка событий".

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

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

Примечание:

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

Обсуждение