Работа с внешними системами
Раздел содержит описание шагов, которые отвечают за обмен данными с внешними системами.
Отправка
Шаг Отправка предназначен для передачи выбранной переменной в сервис или внешнюю систему.
На вкладке Основные доступны следующие настройки шага:
В поле Описание указывается текст, который будет отображаться в названии шага на схеме.
В поле Комментарий указывается подробная информация об использовании шага при настройке процесса.
В поле Сообщение указывается передаваемое сообщение в виде фиксированного выражения в «». Также доступен выбор значения переменной из выпадающего меню при нажатии на кнопку ....
Примечание
Если это поле не заполнено, то в качестве объекта передаваемого сообщения используется системная переменная InitMessage.
В поле Обработчик указывается обработчик, который необходимо применить при отправке. Также доступен выбор значения переменной из выпадающего меню при нажатии на кнопку ....
Примечание
Если это поле не заполнено, и при этом выбрана внешняя система 1С, к которой привязан один обработчик с направлением Из Platform и с незаполненным типом данных, то этот обработчик будет выбран по умолчанию.
В выпадающем меню Тип получателя доступен следующий выбор типов:
Модуль: в поле ниже (Получатель) выбирается из перечня сервис / система, или переменная, содержащая их guid.
Папка: в поле ниже (Получатель) указывается папка с сервисами / системами, или переменная, содержащая guid папки.
Запрос: в поле ниже (Получатель) указывается запрос с направлением на систему / сервис. Например, name:ФайловыйАдаптер1.
В поле Получатель указывается получатель сообщения. Также доступен выбор значения переменной из выпадающего меню при нажатии на кнопку ....
В выпадающем меню Ожидание доступен следующий выбор вариантов ожидания после завершения отправки:
Ожидание не требуется: шаг завершается сразу после передачи сообщения.
Если выбран этот вариант, но в системе-получателе и ее обработчике предусмотрен и настроен возврат ответа, то ответ будет возвращен в Платформу в виде нового сообщения.
Ожидать доставки: Платформа приостанавливает выполнение шага и ожидает подтверждения о том, что сообщение успешно доставлено получателю.
Время ожидания ограничено таймаутом.
Ожидать ответа: Платформа приостанавливает выполнение шага и ожидает от внешней системы ответа на отправленный запрос.
Время ожидания ограничено таймаутом. Если ответ от внешней системы придет после истечения таймаута, то Платформа не обрабатывает и удаляет такой ответ, а в журнале фиксируется ошибка.
В поле Время ожидания (параметр доступен в случае выбора в настройке Ожидание Ожидать доставки или Ожидать ответа) указывается время ожидания в миллисекундах. Диапазон допустимых значений 0 мс - 1 800 000 мс (30 мин), где 0 - значение по умолчанию, равное 30 мин.
Флаг Интерпретировать таймаут как ошибку (параметр доступен в случае выбора в настройке Ожидание Ожидать доставки и Ожидать ответа) определяет, как обрабатывается таймаут:
Если флаг не активен, то в случае истечения времени ожидания сработает выход «-», в архив ничего не упадет.
Если флаг активен и нет шагов из выхода Исключение, то Платформа поместит сообщение в архив.
Если флаг активен и есть шаги из выхода Исключение, то Платформа считает сообщение обработанным и не помещает его в архив.
Флаг Это ответ устанавливается в случае, если в шаге производится отправка ответа на другое сообщение.
Условия выхода из шага Отправка:
Выход +: внешняя система успешно обработала запрос и своевременно вернула ответ.
Выход —: истекло время ожидания ответа при выключеннном флаге Интерпретировать таймаут как ошибку либо остановлен Базовый сервис обработки процессов.
Выход Исключение:
внешняя система недоступна или вернула ошибку;
ответ пришел с признаком ошибки;
истек таймаут при включенном флаге Интерпретировать таймаут как ошибку;
сбой платформы при обработке;
есть ошибки в настройках конфигурации.
Примечание
Если выход Исключение не настроен, то Платформа поместит сообщение в архив.
На вкладке Локальные переменные возможно настроить маппинг переменных со значениями бизнес-процесса. Настройка доступна при соблюдении двух условий:
В схеме выбран Обработчик и Получатель.
В выбранном обработчике есть Переменные.
Пример настройки маппинга:
Пример выбранных Обработчика и Получателя:
Пример обработчика с настроенными Переменными:
Получатели
Выполнение шагов из папки Получатели настраивается по аналогии с шагом Отправка, но в них предварительно заполнены и скрыты поля, связанные с идентификацией получателя.
Отправка получателям
Шаг предназначен для передачи выбранной переменной в сервис или внешнюю систему, при этом на выходе формируется массив получателей. Есть возможность исключения из рассылки инициатора.
На вкладке Основные доступны следующие настройки шага:
В поле Описание указывается текст, который будет отображаться в названии шага на схеме.
В поле Комментарий указывается подробная информация об использовании шага при настройке процесса.
В поле Сообщение указывается передаваемое сообщение в виде фиксированного выражения в кавычках. Также доступен выбор значения переменной из выпадающего меню при нажатии на кнопку ....
Примечание
Если это поле не заполнено, в качестве объекта передаваемого сообщения используется системная переменная InitMessage.
Флаг Исключить из рассылки инициатора устанавливается в случае, если инициатор не должен получить это сообщение.
В поисковой строке осуществляется поиск получателей, для выбора получателей из списка найденных устанавливаются флаги.
Примечание
Если в системе-получателе и ее обработчике предусмотрен и настроен возврат ответа, то ответ будет возвращен в Платформу в виде нового сообщения.
Примечание
Если установлен флаг Исключить из рассылки инициатора при наличии выбранной системы и источника, то при выполнении шага система генерирует следующее сообщение: Шаг [Отправка подписчику] не выполнился по причине отсутствия получателей. Инициатор сообщения был удален из получателей.
Шаги из папки Источники
Шаги из папки Источники используются для получения сообщения от выбранной системы. При необходимости можно указать обработчик системы, время ожидания и выполнить маппинг полученного от системы сообщения в какую-либо переменную на вкладке Результат выполнения.
На вкладке Основные доступны следующие настройки шага:
В поле Описание указывается текст, который будет отображаться в названии шага на схеме.
В поле Комментарий указывается подробная информация об использовании шага при настройке процесса.
В поле Обработчик указывается обработчик, который необходимо применить при шаге. Также доступен выбор значения переменной из выпадающего меню при нажатии на кнопку ....
В выпадающем меню Ожидание доступен следующий выбор вариантов ожидания:
Ожидание не требуется
Примечание
Если в шаге выбран вариант ожидания Ожидание не требуется, а в системе и ее обработчике предусмотрен и настроен возврат ответа, то ответ будет возвращен в Платформу в виде нового сообщения.
Ожидать доставки
Ожидать ответа
Примечание
Если ответ от внешней системы приходит после истечения таймаута ожидания, такой ответ не обрабатывается и удаляется. В журнале фиксируется ошибка.
В поле Время ожидания (параметр доступен в случае выбора в настройке Ожидание Ожидать доставки или Ожидать ответа) указывается время ожидания в миллисекундах. Диапазон допустимых значений 0 мс - 1 800 000мс (30мин), где 0 - значение по умолчанию, равное 30 мин.
Флаг Интерпретировать таймаут как ошибку (параметр доступен в случае выбора в настройке Ожидание Ожидать доставки) определяет, как обрабатывается таймаут:
Если флаг не активен, то в случае истечения времени ожидания сработает выход «-», в архив ничего не упадет.
Если флаг активен и нет шагов из выхода исключение, то сообщение упадет в архив.
Если флаг активен и есть шаги из выхода исключение, то оно считается обработанным и не упадет в архив.
Регистрация сообщения
Шаг используется для регистрации нового сообщения. Зарегистрированное сообщение будет передано в библиотеку Определение функции для обработки соответствующими сервисами Платформы.
На вкладке Основные доступны следующие настройки шага:
В поле Описание указывается текст, который будет отображаться в названии шага на схеме.
В поле Комментарий указывается подробная информация об использовании шага при настройке процесса.
В поле Сообщение указывается передаваемое сообщение в виде фиксированного выражения в «». Также доступен выбор значения переменной из выпадающего меню при нажатии на кнопку ....
Примечание
Если это поле не заполнено, в качестве объекта передаваемого сообщения используется системная переменная InitMessage.
