Такое действие можно использовать для создания интеграций, например, для отправки запросов во внешнюю систему. Настройки действия выполняются на трёх вкладках: Настройки, Контекст, Сценарии.
Вкладка «Настройки»
На вкладке Настройки укажите:
- Название — наименование действия;
- Название по умолчанию — наименование, отображающееся на блоке действия при добавлении его на схему бизнес-процесса;
- Цвет блока — цвет, в который будет окрашен блок действия на схеме процесса;
- Описание — описание функциональных возможностей действия и его особенностей;
- Устаревшее — опция позволяет скрыть элемент из дизайнера бизнес-процессов, чтобы пользователи не смогли добавлять его на схемы новых процессов. Устаревшие действия продолжат работать без изменений в уже созданных процессах. Например, можно включить опцию для блока после обновления модуля;
- Модель выполнения — способ выполнения действия:
- Синхронное — простое выполнение заданного в действии сценария, то есть синхронное исполнение функции action;
- Запрос результата — после выполнения заданного сценария во внешний сервис отправится запрос о значении статуса. Для реализации такого подхода в действии нужно определить функцию проверки результата check. Она должна вызываться с заданной периодичностью. Бизнес-процесс продолжится только после того, как функция check вернёт ответ true;
- Обратный вызов — в обращении к внешнему сервису передаётся url, на который необходимо вернуть результат. То есть в параметрах вызова передаётся адрес, который будет вызван после выполнения задачи внешним сервисом, и на который будут отправлены результаты выполнения. Url ответа передается как входной аргумент функции action. Любой запрос на данный url передается в функцию callback. После этого выполнение процесса продолжится;
- Количество повторов при ошибке — укажите количество попыток выполнения действия;
- Пауза между повторами при ошибке (сек)* — определите частоту попыток.
Вкладка «Контекст»
На вкладке Контекст вы можете добавить переменные, используемые для настройки действия. Для этого нажмите + Добавить. Подробнее о типах переменных читайте в статье «Типы данных в системе».
Контекстные переменные действия можно передавать в бизнес-процесс, который содержит это действие. В свою очередь, действие может получать контекстные переменные процесса, в котором оно используется.
Для передачи переменных необходимо определить, какие переменные являются входными и выходными. Затем после добавления действия на схему процесса вы сможете сопоставить эти переменные с контекстом процесса. Подробнее об этом читайте в статье «Особенности действий в бизнес-процессах».
Вкладка «Сценарии»
На вкладке Сценарии создается сценарий действия. Для написания сценариев используется язык программирования TypeScript. Более подробно про принципы написания сценариев в ELMA365 вы можете прочитать в справке ELMA365 TS SDK.
При написании сценариев можно использовать константу Global. Она дает доступ к переменным, содержащимся в разделах, и к глобальным параметрам. Использование этого объекта препятствует дальнейшей выгрузке модуля. То есть, если использовать константу Global в сценарии действия, то модуль с этим действием нельзя будет экспортировать.
Чтобы разрешить доступ к константе Global в верхнем меню нажмите Настройки. В открывшемся окне выберите опцию Global.
После внесения данных о действии нажмите Сохранить и Опубликовать на верхней панели окна настроек.
Действие будет доступно в дизайнере бизнес-процессов, на панели инструментов справа от поля для моделирования, на вкладке Интеграции.