search string side menu

Дизайнер бизнес-процессов > Графические процессы (BPMN) > Графические элементы / Webhook

Webhook

вебхукБлок Webhook позволяет автоматически передавать информацию об экземпляре процесса из ELMA365 во внешнюю систему.

Например, компания занимается продажей и поставкой оборудования. После того как сотрудник отдела продаж оформит заявку от клиента, она отправляется на склад, где заказ формируется для отправки. После выставления счёта клиенту и отправки заказа, Webhook автоматически отправляет данные о заказе в программу складского учёта.

1.PNG

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

начало внимание

Настраивать блок Webhook могут только пользователи, включённые в группу Администраторы.

конец внимание

Как настроить блок «Webhook» на схеме процесса

На странице процесса на панели инструментов справа от поля для моделирования откройте вкладку Интеграции. Перетащите блок Webhook на схему и разместите его там, где при исполнении процесса потребуется передать данные во внешнюю систему.

2a.PNG

Нажмите два раза на добавленный блок, чтобы открыть окно с настройками.

Вкладка «Основное»

Webhook_03

На этой вкладке формируется HTTP-запрос. Заполните следующие поля:

  • Название* — введите текст, который будет отображаться в блоке на схеме процесса;
  • URL — укажите URL запроса для обращения к методу API внешней системы, например, http://example.com/api/create-order/. Вы можете использовать также контекстные переменные процесса и функцию DateTime(). Чтобы добавить переменную, нажмите знак {+} в правой части поля. Для того чтобы использовать функцию DateTime(), нажмите символ f(x). Подробнее про использование функции DateTime() читайте в статье «Синтаксис шаблонов»;
  • Метод — выберите метод GET или POST. При выборе метода POST появится дополнительное поле Тип запроса;
  • Тип запроса — для метода POST доступны типы JSON, FORM и TEXT;
  • Данные — настройте связь полей процесса и полей вашего запроса. Нажмите кнопку + Параметр и в колонке Поля процесса выберите контекстную переменную, например, Серийный номер. Поле Параметры запроса заполненится автоматически.

Webhook_04

Если ранее в поле Тип запроса вы выбрали TEXT, то в разделе Данные вам потребуется указать текстовый шаблон, который будет передаваться в запросе. Для создания шаблона вы можете использовать любой текст, а также контекстные переменные процесса и функцию DateTime().

Webhook_05

Для того чтобы добавить переменную, нажмите на знак {+} в правой части поля. Чтобы использовать функцию DateTime(), нажмите на символ f(x). Про использование функции DateTime() в шаблонах можно подробно прочитать в статье «Синтаксис шаблонов».

Вкладка «Обработка ошибок»

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

Webhook_09

  • Повторить выполнение — отметьте флажком эту опцию, чтобы при ошибке запрос отправлялся повторно;
    • Количество повторений — укажите, сколько раз должна повториться попытка отправки запроса;
    • Время задержки между повторениями (сек) — определите частоту отправки;
  • Оповещение — включите опцию, а затем укажите пользователей, которым будет отправляться оповещение об ошибке в процессе. Можно выбрать текущего пользователя, группу пользователей, элемент оргструктуры или указать контекстную переменную, например, инициатора процесса. Обратите внимание, текущий пользователь — это сотрудник, который выполнил задачу, стоящую перед блоком Webhook на схеме процесса;
  • Прервать — установите флажок, чтобы в случае ошибки прервать операцию. Далее выберите переход, по которому процесс пойдет дальше, например, Завершить.

После того как вы указали все настройки, нажмите Сохранить.

initiative-notification.html 360011443400.html