Web-запрос

Позволяет выполнять HTTP- и HTTPS- запросы к web-сервисам, настроенным в Каналах интеграции. Поддерживает методы GET, POST, PUT, HEAD, DELETE, PATCH, TRACE, OPTIONS с контентом и без. Поддерживает отправку асинхронных запросов и запросов с ожиданием ответов.

В случае ошибки переход осуществляется по ветке «Ошибка», и в переменную «Код ошибки» возвращается соответствующий код HTTP. Компонент поддерживает работу в сессиях, сохраняя и используя cookie, а также HTTPS и подтверждение сертификатов.

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

Рис. 1. Web-запрос

Название Описание

Название	Описание
Прокси	Использовать ли прокси сервер для подключения: Нет. Прямой запрос Да. Запрос через прокси сервер. Дополнительно надо определить: * Адрес прокси - IP/fqdn прокси сервера * Порт прокси - Port прокси сервера * Аутентификация: Да - необходима аутентификация на прокси * Логин прокси * Пароль прокси Нет - прокси без аутентификации
Макс. перенаправлений	Ограничение на максимальное число перенаправлений. Значение для HTTP-заголовка `Max-Forwards`. При каждом перенаправлении cookie-файлы накапливаются и передаются дальше.
Источник канала интеграции	Способ выбора канала интеграции, через URL которого отправлять HTTP-запрос. Из списка - необходимо в поле `Канал интеграции` выбрать канал По коду - необходимо в поле `Код канала интеграции` ввести аргументом Код канала интеграции, который настроен в системе.
Страница	Аргумент, содержащий страницу (endpoint, левая часть URL адреса) Итоговый URL для запроса формируется на основании URL канала интеграции и указанной страницы.
Источник запроса	Адрес сервера, с которого необходимо отправить запрос. По умолчанию запрос отправляется с сервера, где обработчик выполняет сценарий. Возможные форматы указания: * RoleId * RoleId:Iface RoleId – идентификатор роли в конфигурации, по роли определяется нода Iface – адрес сетевого интерфейса на сервере
Метод	POST GET PUT HEAD DELETE PATCH TRACE OPTIONS
Базовая аутентификация	Да - необходима базовая аутентификация (дополнительно надо ввести аргументы для полей `Логин` и `Пароль`) Нет - без базовой аутентификации
Заголовки	Позволяет переопределить некоторые стандартные заголовки, а также установить новые персональные заголовки. Вид: HeaderName1: Value1 HeaderName2: Value2
Куки	Позволяет установить дополнительные cookie значения. Строковый аргумент, подразумевающий присутствие одного или нескольких дуплетов "ключ=значение", разделенных переводом строки (вид аналогичный “Заголовки”).
Режим	Режим работы компонента после отправки запроса. Возможные варианты: Ожидание результата – Ожидание ответа от удаленной стороны без ограничения по времени. Асинхронный запуск – Управление сразу передается следующему компоненту. Обрыв по таймауту – Ожидание ответа в течение установленного времени, по истечению которого HTTP-подключение разрывается и управление передается следующему компоненту. Выход по таймауту – Ожидание ответа в течение установленного времени, по истечению которого управление передается следующему компоненту без разрыва подключения и прерывания процесса отправки.
Время, с	(для режимов `Обрыв по таймауту` и `Выход по таймауту`) Количество секунд ожидания ответа.
Заголовки ответа	(для всех режимов кроме `Асинхронный`) Сохранение заголовков ответа.
Ответ	(для всех режимов кроме `Асинхронный`) Сохранение тела ответа.
Кодировка ответа	(для всех режимов кроме `Асинхронный`) Авто из заголовка Авто из тела Unicode UTF-8 UTF-7 Windows-1251 Указать название – Задать название кодировки вручную.
Ошибка	Переменная для сохранения HTTP-кода ошибки.
Переход	Компонент, которому передается управление в случае успешного завершения операции асинхронной отправки, либо получения HTTP-ответа. Переход по умолчанию.
Переход, ошибка	Компонент, которому передается управление в случае ошибки отправки запроса, либо получения неудачного ответа (коды 4xx – 6xx).
Описание	Описание компонента

Прокси

Использовать ли прокси сервер для подключения:

Нет. Прямой запрос
Да. Запрос через прокси сервер. Дополнительно надо определить:

* Адрес прокси - IP/fqdn прокси сервера
* Порт прокси - Port прокси сервера
* Аутентификация:
** Да - необходима аутентификация на прокси
*** Логин прокси
*** Пароль прокси
** Нет - прокси без аутентификации

Макс. перенаправлений

Ограничение на максимальное число перенаправлений. Значение для HTTP-заголовка Max-Forwards. При каждом перенаправлении cookie-файлы накапливаются и передаются дальше.

Источник канала интеграции

Способ выбора канала интеграции, через URL которого отправлять HTTP-запрос.

Из списка - необходимо в поле Канал интеграции выбрать канал
По коду - необходимо в поле Код канала интеграции ввести аргументом Код канала интеграции, который настроен в системе.

Страница

Аргумент, содержащий страницу (endpoint, левая часть URL адреса) Итоговый URL для запроса формируется на основании URL канала интеграции и указанной страницы.

Источник запроса

Адрес сервера, с которого необходимо отправить запрос. По умолчанию запрос отправляется с сервера, где обработчик выполняет сценарий. Возможные форматы указания:

* RoleId
* RoleId:Iface

RoleId – идентификатор роли в конфигурации, по роли определяется нода Iface – адрес сетевого интерфейса на сервере

Метод

POST
GET
PUT
HEAD
DELETE
PATCH
TRACE
OPTIONS

Базовая аутентификация

Да - необходима базовая аутентификация (дополнительно надо ввести аргументы для полей Логин и Пароль)
Нет - без базовой аутентификации

Заголовки

Позволяет переопределить некоторые стандартные заголовки, а также установить новые персональные заголовки.
Вид:

HeaderName1: Value1
HeaderName2: Value2

Куки

Позволяет установить дополнительные cookie значения.
Строковый аргумент, подразумевающий присутствие одного или нескольких дуплетов "ключ=значение", разделенных переводом строки (вид аналогичный “Заголовки”).

Режим

Режим работы компонента после отправки запроса. Возможные варианты:

Ожидание результата – Ожидание ответа от удаленной стороны без ограничения по времени.
Асинхронный запуск – Управление сразу передается следующему компоненту.
Обрыв по таймауту – Ожидание ответа в течение установленного времени, по истечению которого HTTP-подключение разрывается и управление передается следующему компоненту.
Выход по таймауту – Ожидание ответа в течение установленного времени, по истечению которого управление передается следующему компоненту без разрыва подключения и прерывания процесса отправки.

Время, с

(для режимов Обрыв по таймауту и Выход по таймауту) Количество секунд ожидания ответа.

Заголовки ответа

(для всех режимов кроме Асинхронный) Сохранение заголовков ответа.

Ответ

(для всех режимов кроме Асинхронный) Сохранение тела ответа.

Кодировка ответа

(для всех режимов кроме Асинхронный)

Авто из заголовка
Авто из тела
Unicode
UTF-8
UTF-7
Windows-1251
Указать название – Задать название кодировки вручную.

Ошибка

Переменная для сохранения HTTP-кода ошибки.

Переход

Компонент, которому передается управление в случае успешного завершения операции асинхронной отправки, либо получения HTTP-ответа. Переход по умолчанию.

Переход, ошибка

Компонент, которому передается управление в случае ошибки отправки запроса, либо получения неудачного ответа (коды 4xx – 6xx).

Описание

Описание компонента

Адрес запроса формируется как поле URL из канала интеграции + значение из поля Страница