Группа «Интеграции»

MQ

Опубликовать в топик MQ / Kafka publish

Задача: создать подключение к MQ и отправить сообщение.

Решение: воспользоваться действием «Создать подключение к MQ», «Опубликовать в топик MQ», «Разорвать подключение».

Реализация:

  • Собрать схему робота, состоящую из действий:

  • Настроить параметры для действия «»Создать подключение к MQ».

  • Настроить параметры для действия «Опубликовать в топик MQ».

  • Настроить параметры для действия «Разорвать подключение к MQ».

  • Нажать на кнопку «Старт» в верхней панели.

Результат:

Программный робот отработал успешно. Сообщение отправлено.

Получить сообщение из топика MQ / MQ consume

Задача: создать подключение к MQ , получить сообщение из топика и разорвать подключение.

Решение: воспользоваться действием «Создать подключение к MQ», «Получить сообщение из топика», «Разорвать подключение».

Реализация:

  • Собрать схему робота, состоящую из действий:

  • Настроить параметры для действия «»Создать подключение к MQ».

  • Настроить параметры для действия «Получить сообщение из топика».

  • Настроить параметры для действия «Разорвать подключение к MQ».

  • Нажать на кнопку «Старт» в верхней панели.

Результат:

Программный робот отработал успешно. Сообщение получено.

Разорвать подключение к MQ / Break connection to MQ

Задача: создать подключение к MQ , отправить сообщение и разорвать подключение.

Решение: воспользоваться действием «Создать подключение к MQ», «Опубликовать в топик MQ», «Разорвать подключение».

Реализация:

  • Собрать схему робота, состоящую из действий:

  • Настроить параметры для действия «»Создать подключение к MQ».

  • Настроить параметры для действия «Опубликовать в топик MQ».

  • Настроить параметры для действия «Разорвать подключение к MQ».

  • Нажать на кнопку «Старт» в верхней панели.

Результат:

Программный робот отработал успешно. Сообщение отправлено.

Создать подключение к MQ / MQ connect

Задача: создать подключение к MQ.

Решение: воспользоваться действием «Создать подключение к MQ».

Реализация:

  • Перенести действие «Создать подключение к MQ» на рабочую область и настроить его параметры:

  • Нажать на кнопку «Старт» в верхней панели.

Результат:

Программный робот отработал успешно. Подключение к MQ выполнено.

REST

Отправить запрос / Send request

Задача: необходимо отправить rest-запрос на сервис https://dadata.ru/ для получения актуальных данных об организации и разобрать ответ от сервиса.

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

Решение: воспользоваться действием «Отправить запрос».

  • Перенести действие «Отправить запрос» на рабочую область и настроить его параметры.

Разберем подробно параметры действия:

Поле «URL REST-сервиса» - это адрес, к которому необходимо подключиться. Подключаться мы будем к сервису dadata. Тело запроса выглядит в одну строчку. Данные формируются в формате JSON.

Поле «Метод» - в нашем случае необходимо указать значение POST.

Поле «Тело запроса» - необходимо указать текст тела запроса.

Если параметры должны быть переданы не в теле, а в URL, то в этом случае параметры запроса необходимо указать сразу в URL. Зависит это от сервиса, т.е как сервис ожидает получить запрос (в теле запроса или в URL).

Поле «Параметры формы» - в данном поле можно заполнить значения для тела запроса. Отличие от поля «Тело запроса» : «Тело запроса»- это строка, «Параметры формы» - словарь. Поле «Параметры формы» используется для метода POST. В словаре указываются в виде ключей названия объектов JSON , название элементов и далее значения по этим элементам.

Поле «Параметры запроса» - нужно на тот случай, если сервис ожидает, что параметры запроса будут переданы через URL, а не через тело запроса.

Поле «Заголовки запроса» - словарь, в котором необходимо указать название заголовков и их ключи. В нашем случае словарь из 3-х записей:

Пример заполнения поля «Заголовки запроса»:

Один из заголовков - это заголовок с авторизацией. Его можно указать в поле «Авторизация», но так же ошибкой не будет, если данный заголовок будет указан в поле «Заголовки запросов». Поле «Путь к файлу для отправки методом POST»- необходимо указать путь до файла с запросом, если он требуется.

Все остальные поля не имеют отношения к смыслу запроса и его формату. Поля начиная с «Выбор прокси-сервера» и заканчивая полем «Пароль пользователя для подключения к прокси-серверу» - это все поля, которые относятся к настройке прокси-сервера, если он необходим.

В поле «Выбор прокси-сервера» необходимо выбрать какой вариант использовать. Если системный прокси-сервер, то будут использоваться настройки сервера, которые установлены в самой вашей системе под которой работает робот. Если выбрано значение «Без прокси-сервера» , то в этом случае не используются ни системные настройки , ни какие-либо другие. При выборе значений «Системный прокси-сервер» или «Без прокси-сервера», поля ниже можно не заполнять. Только если выбрано значение «Пользовательский прокси-сервер» необходимо заполнить поля ниже (выделены на скрине).

Остальные поля связаны с получением файла от сервиса. Поле «Получить файл» - необходимо проставить чек-бокс при необходимости. Используется, когда необходимо получить файл от сервиса. Весь ответ от сервиса будет записан в отдельный файл.

Поле «Путь до папки» и «Имя файла» - необходимо заполнить, если проставлен чек-бокс в поле «Получить файл». В поле «Имя файла» необходимо указать расширение. Поле «Перезаписать» необходимо на тот случай, если в данной папке уже содержится файл с таким же названием и расширением.

При запуске робота необходимо нажать на кнопку «Старт» в верхней панели. В результате робот отработал успешно. Ответ от сервиса разобран роботом.

Задача: отправить GET запрос к сервису https://dadata.ru/api/find-party/ , сохранив результат ответа в файл формата json.

Решение: воспользоваться действием «Отправить запрос».

Реализация:

  • Перенести действие «Отправить запрос» на рабочую область и настроить его параметры.

  • Нажать на кнопку «Старт» в верхней панели.

Результат:

Программный робот отработал успешно.

Сохранен файл формата json с ответом от сервиса.

SOAP

Запрос / Request

Задача: отправить SOAP запрос к сервису http://speller.yandex.net/services/spellservice

Решение: воспользоваться действием «Открыть» (группа «XML»), «SOAP запрос».

Реализация:

  • Собрать схему робота, состоящую из действий:

  • Настроить параметры для действия «Открыть». Файл XML - sample2 — копия.xml

  • Настроить параметры для действия «SOAP запрос».

  • Нажать на кнопку «Старт» в верхней панели.

Результат:

Программный робот отработал успешно. Получен ответ от веб-сервиса.

Чатботы

Настройка подключения / Open context

Задача: Создать контект подключения к чатботу.

Решение: воспользоваться действием «Настройка подключения».

Реализация:

  • Перенести действие на рабочую область и настроить его параметры:

В параметр «Адрес подключения» необходимо ввести адрес на котором располагается Apache Kafka (полробнее о технологии: https://habr.com/ru/company/southbridge/blog/550934/) Индекс группы роботов всегда равен 1.

  • Нажать на кнопку «Старт» в верхней панели.

Результат:

Программный робот отработал успешно. Создан контекст подключения к чатботу.

Отправить сообщение / Send message

Задача: получить сообщение от чатбота (обязательная переменная ИНН), посчитать количество записей в сообщении, если записей больше 0, то сгенерировать случайное целое число и отправить результат чатботу.

Решение: воспользоваться действиями «Настройка подключения», «Получение сообщения», «Посчитать количество записей», «Больше чем», «Если», «Сгенерировать случайное число», «Конвертировать данные», «Соединить», «Отправить сообщение».

Реализация:

  • Собрать схему робота, состоящую из действий:

  • Настроить параметры для действия «Настройка подключения».

  • Настроить параметры для действия «Получение сообщения».

Топик - указывается такой же, как в чатботе. Так же, в поле «Обязательные переменные» необходимо указать имена переменных, которые требуется считать из Apache Kafka. В поле «Таймаут» желательно указывать значение более 10000

  • Настроить параметры для действия «Посчитать количество записей».

  • Настроить параметры для действия «Больше чем».

  • Настроить параметры для действия «Если».

  • Настроить параметры для действия «Сгенерировать случайное число».

  • Настроить параметры для действия «Конвертировать данные».

  • Настроить параметры для действия «Соединить».

  • Настроить параметры для действия «Отправить сообщение».

  • Нажать на кнопку «Старт» в верхней панели.

Результат:

Программный робот отработал успешно. Сообщение получено от чатбота и отправлен ответ в виде случайно сгенерированного числа.

Получение сообщения / Get message

Задача: получить сообщение от чатбота (обязательная переменная ИНН), посчитать количество записей в сообщении, если записей больше 0, то сгенерировать случайное целое число и отправить результат чатботу.

Решение: воспользоваться действиями «Настройка подключения», «Получение сообщения», «Посчитать количество записей», «Больше чем», «Если», «Сгенерировать случайное число», «Конвертировать данные», «Соединить», «Отправить сообщение».

Реализация:

  • Собрать схему робота, состоящую из действий:

  • Настроить параметры для действия «Настройка подключения».

  • Настроить параметры для действия «Получение сообщения».

Топик - указывается такой же, как в чатботе. Так же, в поле «Обязательные переменные» необходимо указать имена переменных, которые требуется считать из Apache Kafka. В поле «Таймаут» желательно указывать значение более 10000

  • Настроить параметры для действия «Посчитать количество записей».

  • Настроить параметры для действия «Больше чем».

  • Настроить параметры для действия «Если».

  • Настроить параметры для действия «Сгенерировать случайное число».

  • Настроить параметры для действия «Конвертировать данные».

  • Настроить параметры для действия «Соединить».

  • Настроить параметры для действия «Отправить сообщение».

  • Нажать на кнопку «Старт» в верхней панели.

Результат:

Программный робот отработал успешно. Сообщение получено от чатбота и отправлен ответ в виде случайно сгенерированного числа.