Источник данных HTTP Poller в ArcGIS Velocity будет отправлять HTTP-запрос на указанный URL. Он получает данные, которые могут быть извлечены в веб-браузере по этому URL.
Пример
ГИС-аналитик хочет загрузить полигоны районов, хранящиеся в файле .csv на веб-сервере в Velocity.
Примечания по использованию
При работе с источником HTTP Poller учитывайте следующее:
- После задания свойств исходного подключения настройте входные данные, чтобы задать схему и ключевые свойства.
- Оба параметра Параметры URL и Пользовательские заголовки поддерживают глобальные переменные аналитики для настройки расписания повторяющегося анализа больших данных. По умолчанию, эти глобальные переменные конвертируются во время эпохи (миллисекунды с 1 января 1970 UTC). Ниже перечислены доступные аналитические переменные и время, которое они представляют.
- $analytic.AnalyticLastScheduledStartTime — запланированное время последнего запуска аналитики.
- $analytic.AnalyticScheduledStartTime — запланированное время текущего запуска аналитики.
- $analytic.AnalyticLastEndTime — время окончания последнего запуска аналитики.
- $analytic.AnalyticStartTime — время начала текущего запуска аналитики. Различие между этим значением и $analytic.AnalyticScheduledStartTime состоит в задержке запуска.
- При использовании аутентификации OAuth происходит следующее:
- Источник HTTP Poller поддерживает аутентификацию, используя конечные точки OAuth 2.0 for HTTP, соответствующие назначенным типам Учетные данные пользователя или Пароль. Эти типы OAuth соответствуют образцу, включающему конфигурацию запроса HTTP согласно токену доступа. Они являются дополнением к запросу данных, который обычно настраивается как часть любого источника HTTP Poller.
- Во время настройки запроса токена доступа, вам будет предложено идентифицировать токен доступа в ответе от сервера авторизации OAuth.
- При возвращении к конфигурации запроса данных, необходимо использовать глобальную переменную $accessToken, чтобы задать, где будет использоваться токен доступа. Часто это происходит в настраиваемом заголовке Authorization, со значением Bearer $accessToken. $accessToken может также быть использован в теле POST-запроса, параметрах URL и в самом URL-адресе (например, https://<<company.domain>>/$accessToken/<<method>>?<<url params>>).
Параметры
Ниже перечислены параметры источника HTTP Poller:
| Параметр | Описание | Тип данных |
|---|---|---|
URL | Полный URL на внешне доступную конечную точку HTTP. Этот параметр поддерживает глобальную переменную $accessToken. | Строка |
Метод HTTP | Определяет метод HTTP, используемый на для конечной точки HTTP, GET или POST. Если выбран метод POST, можно задать текст сообщения. | Строка |
Текст POST | Текст сообщения, которое будет включено при отправке HTTP-запроса POST. Обеспечивает выбор между x-www-form-urlencoded и другими типами текстовых ресурсов. Также задает заголовок Content-type. Этот параметр применяется только в том случае, когда для параметра Метод HTTP задано POST. Этот параметр поддерживает глобальные переменные $accessToken аналитики. | Строка |
Аутентификация | Задает тип аутентификации, используемый при доступе к конечной точке HTTP. Доступные опции: Нет, Базовая, Сертификат и OAuth. | Строка |
Имя пользователя | Имя пользователя, использующееся для доступа к конечной точке HTTP. Этот параметр применяется только если для параметра Аутентификация выбрано Базовая. | Строка |
Пароль | Пароль для доступа к конечной точке HTTP. Этот параметр применяется только если для параметра Аутентификация выбрано Базовая. | Пароль |
URL сертификата | URL местоположения сертификата клиента для доступа к конечной точке HTTP. Этот параметр применяется только если для параметра Аутентификация задано Сертифицированная. | Строка |
Пароль | Пароль сертификата клиента, если он задан. Этот параметр применяется только если для параметра Аутентификация задано Сертифицированная. | Пароль |
Пользовательские заголовки | Дополнительные пользовательские заголовки, включающиеся в запрос HTTP, отправляемый на указанную конечную точку HTTP. Например, пользовательские заголовки могут использоваться для указания стороннего ключа API или заголовка. Этот параметр поддерживает глобальные переменные $accessToken аналитики. | Пара ключ-значение |
Параметры URL | Дополнительные параметры URL, включающиеся в URL запроса HTTP, отправляемого на указанную конечную точку HTTP. Хотя параметры также могут быть заданы в параметре URL, параметры URL, указанные здесь, имеют приоритет над соответствующими параметрами, заданными в параметре URL. Заданные здесь параметры всегда будут закодированы в URL. Этот параметр поддерживает глобальные переменные $accessToken аналитики. | Пара ключ-значение |
Советы и ограничения
Ниже приведены рекомендации и ограничения при использовании источника HTTP Poller:
- Конечная точка HTTP должна быть доступна извне через интернет.
- Размер ответа HTTP или файла потока не должен превышать 16 МБ. Если данные или файл превышают 16 МБ, объекты не будут приняты.
- При использовании аутентификации OAuth происходит следующее:
- Во время авторизации выполняется множество запросов к серверу авторизации и связанной конечной точке данных. Некоторые API используют ограничение количества запросов, что может сказаться на авторизации канала.
- В целях безопасности POST сообщения токенов доступа и обновлений должны быть переконфигурированы, если отредактированы параметры аутентификации.