Перейти к основному содержимому

Свойства узла процесса интеграции вида «Http»

Узел, в котором выполняется запрос по протоколу HTTP к внешнему ресурсу. Запрос формируется из входящего в узел сообщения. Из результата выполнения запроса формируется исходящее из узла сообщение. По умолчанию тело сообщения помещается в тело запроса, а параметры сообщения попадают в заголовки запроса. Настроить формирование запроса можно в обработчике ПодготовкаЗапроса.

Узел выполняет запрос в момент поступления сообщения. Для периодического выполнения запроса следует поставить перед этим узлом Таймер.

Свойства узла

Uri

URI ресурса, к которому делается запрос

Длительность хранения доставленных сообщений в формате ДД.ЧЧ

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

Длительность задается в формате ДД:ЧЧ (например, 10:02 — 10 дней и 2 часа). Если указать длительность равную 00:00, то доставленные сообщения для данного узла не будут сохраняться в «1С:Шине». Длительность хранения должна быть равна 00:00 (по умолчанию) либо больше или равна 00:01.

ИгнорироватьКодОтвета

При значении этого свойства Ложь, если код состояния HTTP в ответе HTTP-сервера не равен 200, вызывается исключение, и обработка сообщения прерывается. В противном случае, при значении этого свойства Истина, обработка сообщения продолжается, и следующие узлы имеют возможность анализировать свойства заголовков Http.ResponseCode и Http.ResponseText

Имя

Имя узла, уникальное в рамках процесса интеграции. Используется для обращения к узлу из встроенного языка (УзелСхемыИнтеграции.Имя). Должно начинаться с буквы, за которой следуют буквы, цифры или символы '_' (нижнее подчеркивание). Минимальная длина — 2 символа

ИмяПользователя

Имя пользователя, которое используется для аутентификации на сервере, к которому делается запрос

Метод

  • Из заголовка сообщения

    Метод определяется значением заголовка Http.Method

  • GET

    HTTP-метод GET

  • POST

    HTTP-метод POST

  • PUT

    HTTP-метод PUT

  • DELETE

    HTTP-метод DELETE

  • HEAD

    HTTP-метод HEAD

  • OPTIONS

    HTTP-метод OPTIONS

  • TRACE

    HTTP-метод TRACE

  • PATCH

    HTTP-метод PATCH

Описание

Произвольное описание узла для разработчика. Используется при редактировании схемы процесса интеграции. Недоступно из встроенного языка

Пароль

Пароль пользователя, который используется для аутентификации на сервере, к которому делается запрос

ПодготовкаЗапроса

Обработчик на встроенном языке, который будет вызван для настройки HTTP-запроса. Сообщение находится в параметре Сообщение. Параметры заголовка и тело сообщения модифицировать нельзя.

Пример обработчика:

метод ПодготовкаЗапроса(Контекст: ПроцессИнтеграции.КонтекстВызоваИнтеграции, Сообщение: ПроцессИнтеграции.Сообщение, Запрос: ЗапросHttp): ЗапросHttp
возврат Запрос.УстановитьАутентификацию(новый АутентификацияHttp("username", "password"))
;

Пример использования

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

Задача: Обеспечить гарантированную публикацию информации на страницу интернет магазина о каждом новом товаре, созданном в информационной базе офиса.

Решение: Используем Канал1СИсточник («ИзОфиса») для того, чтобы получить сообщение в «1С:Шина». После запуска процесса интеграции для информационной системы, входящей в группу участников «Офис», автоматически создается индивидуальная очередь сообщений. В эту очередь поступают сообщения от внешней информационной системы, в которых содержится информация о новом товаре. Затем из этой же очереди «1С:Шина» отправляет на сайт интернет-магазина POST-запрос, в теле которого содержится информация о новом товаре.

В свойстве Uri Http-узла «ОбменССайтом» укажем адрес интернет-магазина и API, при помощи которого осуществляется публикация новых товаров.

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

В свойстве Метод укажем значение POST.

Примеры