HTTP

Выход HTTP в ArcGIS Velocity позволяет отправлять объекты и другой текст в конечную точку HTTP через запросы POST, PUT и DELETE. Запрос будет отправлен для каждого выходного объекта, отправленного в выходной оператор.

Пример

Аналитик настраивает выход HTTP для отправки объектов в настраиваемом формате JSON на назначенный веб-перехватчик.

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

При работе с выходными данными HTTP нужно учитывать следующее:

  • При отправке JSON в теле сообщения оберните JSON выражением Text() Arcade, чтобы правильно отформатировать JSON.
  • При использовании выхода HTTP важно понимать скорость передачи данных. Каждая запись, отправленная на выход, будет генерировать отдельный запрос. Это может быстро привести к перегрузке настроек ограничения емкости или скорости веб-сервера. Используйте выход HTTP для инцидентов, которые, как ожидается, будут происходить не часто.
  • При использовании аутентификации OAuth:
    • Выходной тип поддерживает аутентификацию, используя конечные точки OAuth 2.0 for HTTP, соответствующие назначенным типам Учетные данные пользователя или Пароль. Эти типы OAuth соответствуют образцу, включающему конфигурацию запроса HTTP согласно токену доступа. Во время настройки запроса токена доступа, вам будет предложено идентифицировать токен доступа и поля окончания срока действия JSON в ответе от сервера авторизации OAuth. Если выбран срок окончания действия, необходимо задать тип окончания срока действия (продолжительность или метка времени) и единицы измерения.
    • При возвращении к конфигурации запроса данных, необходимо использовать глобальную переменную $accessToken, чтобы задать, где будет использоваться токен доступа. Часто это происходит в настраиваемом заголовке Authorization, со значением Bearer $accessToken.

Параметры

Ниже приведены параметры выходных данных HTTP:

ПараметрОписаниеТип данных

URL

URL-адрес для отправки запросов выхода.

Строка

Метод HTTP

Метод HTTP для запроса. Доступные варианты: POST, PUT и DELETE

Строка

Текст POST

Выражение JSON Arcade.

Выражение Arcade

Content-Type

Заголовок content-type для исходящих запросов.

  • Простой текст: text/plain
  • JSON: application/json
  • CSV: text/csv
  • XML: text/xml

Строка

Тип аутентификации

Выберите между отсутствием аутентификации, Базовой аутентификацией и аутентификацией OAuth.

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

Если настроена аутентификация OAuth, появится всплывающее окно, в котором можно задать:

  • Доступ к токену точки доступа
  • Метод HTTP
  • Параметры URL
  • Пользовательские заголовки

После задания, указанного выше, подключение будет проверено, и вы должны выполнить щелчок, чтобы идентифицировать токен доступа в ответе JSON

Различные параметры

Параметры URL

Дополнительные параметры URL, включающиеся в URL запроса HTTP, отправляемого на указанный веб-сайт.

Хотя параметры также могут быть отправлены с помощью указанного выше параметра URL, параметры URL, указанные здесь как отдельное свойство, имеют приоритет над соответствующими параметрами, заданными в параметре URL.

Заданные в этом свойстве URL-параметры всегда будут закодированы в URL.

Пара ключ-значение

Пользовательские заголовки

Дополнительные пользовательские заголовки, включающиеся в запрос HTTP, отправляемый на указанный веб-сайт. Например, пользовательские заголовки могут использоваться для указания стороннего ключа API или заголовка.

Пара ключ-значение

Дополнительное ведение журнала

При необходимости включите ведение журнала запросов и ответов HTTP, издаваемых Velocity.

Примечание:

Этот параметр следует включать только в целях устранения неполадок и отключать после завершения устранения неполадок. После включения запустите аналитику, и журналы уровня отладки будут доступны на странице журналов аналитики. При необходимости обратитесь в Службу технической поддержки Esri за помощью в устранении неполадок.

Boolean

Советы и ограничения

Ниже приведены соображения и ограничения при использовании выходных данных HTTP:

  • При использовании аутентификации OAuth:
    • При создании выходных данных выполняется множество запросов к серверу авторизации и связанной конечной точке данных. Некоторые API используют ограничение количества запросов, что может сказаться на создании выходных данных.
    • В целях безопасности POST сообщения запросов токенов доступа и обновлений должны быть переконфигурированы, если отредактированы параметры аутентификации.
  • Веб-сервер должен быть доступен через Интернет.