Действия «Вызывать внешние API»
Last updated
Last updated
Аналогично с другими архитипами действия, действия «Вызвать внешние API» могут использоваться в процессах Случая, и они используются когда Вам нужно автоматически обратиться к другой системе, передать ей данные и потенциально получить от внешней системы обновленные настраиваемые данные обратно в Enate.
Вы можете найти информацию о том, как настроить действия «Вызвать внешние API» в соответствующей секции в Конструкторе.
Иногда возможны задержки, когда Вы ожидаете ответ от внешней системы. Когда это происходит, то есть когда действие «Вызвать внешние API» ожидает приход информации обратно от внешней системы, инфокарта Действия в Менеджере работ покажет состояние «Ожидание».
Когда внешняя система наконец отвечает Enate обновленными данными, результат будет помечен специальным маркером, сообщаюшим успешно прошла операция ИЛИ нет:
Если система отвечает с успешным завершением, то Действие автоматически переходит в состоянии «Закрыто», с методом урегулирования «Выполнено успешно».
Если система отвечает с неуспешным завершением, то Действие будет переведено в состоянии «Задачи», с причиной «Обновлено интеграцией». Внешние API могут также ответить с дополнительной информацией касательно причин неуспешного завершения. Эта информация появится в инфокарте Действия в секции «Причина отклонения».
Если действие не было завершено успешно, потому что оно не смогло завершиться в рамках установленного для него времени (это конфигурируется в Конструкторе), тогда оно перейдет в состояние «Задачи» с причиной «Превышение времени ожидания» и оно будет распределено в Очередь / пользовать-человек, на основании сконфигурированных правил распределения.
Такие неуспешные Действия будут теперь представлять из себя стандартные действия для работы вручную.
Пожалуйста, обратите внимание, что владелец Случая НЕ будет оповещен в таких ситуациях.
Если действие не сможет подключиться ко внешней системе, то оно будет автоматически пытаться подключиться снова столько раз, сколько сконфигурировано в Конструкторе в Вашей системе (больше информации Вы можете найти тут). Также Вы увидите сообщение об ошибке, которое покажет Вам:
когда произошла ошибка
когда система автоматически попробует установиться связь снова
сколько раз система автоматически пыталась установить связь, и
сколько раз система будет пытаться автоматически установить связь снова.
Тут Вы также можете вручную попытаться снова установить связь, нажав на кноку «Попробовать еще раз» в сообщении ошибки.
Пожалуйста, обратите внимание на то, что когда Вы совершаете попытку подключиться вручную, это будет засчитано за осуществленную попытку и потому будет включено в счетчик попыток, который показывает, сколько раз система пыталась установить связь снова.
Если действие не сможет установить связь после автоматических попыток (например, если в настройках количество попыток установлено до 5 раз, и система не сможет установить связь за последующие 5 автоматических попыток), оно перейдет в состояние «Закрыто» с оповещением «Невозможно завершить».
В этих обстоятельствах, когда Действие не может установить связь с внешней системой, оно будет переведено к Владельцу Случая, с пометкой в секции Действия на экране Случая, что это Действие «Закрыто – Выполнено неуспешно».
Когда Действие получит необходимую информацию, оно будет завершено автоматически.
Если настройки автоматических попыток в Конструкторе были изменены после того, как система автоматически пыталась установить связь с внешней системой повторно, то произойдет следующее.
Если, например, настройки попыток были изначально установлены на «5» и система автоматически попыталась подключить 5 раз, но неудачно, действие перейдет в состояние «Закрыто» с сообщением об ошибке, которое покажет количество предпринятых попыток 5/5.
Если настройки попыток будут изменены на большее количество попыток, чем 5, например, на 7, то сообщение об ошибке покажет счетчик попыток 5/7, но система НЕ БУДЕТ автоматически пытаться установить связь в 6й и 7й раз, так как действие будет уже закрыто. Однако, если действие не было перемещено в состояние «закрыто», поскольку еще не было совершено максимальное количество автоматических попыток (например, было совершено только 4 из 5 попыток установить связь), тогда увеличение попыток до 7 в настройках будет означать, что действие будет автоматически пытаться установить связь повторно пока счетчик попыток не достигнет 7 попыток.
И наоборот, если Вы уменьшите количество повторных попыток в настройках после того, как попытки начаты, например, Вы сейчас находитесь на попытке 4 из 10, но затем Вы уменьшаете максимальное количество попыток до 4, система по-прежнему будет показывать 4 из 10, но по факту уже попытки будут закрыты.
