Источник данных HTTP Poller в ArcGIS Velocity будет отправлять HTTP-запрос на указанный URL. Он получает данные, которые могут быть извлечены в веб-браузере по этому URL.
Пример
Ниже приведён пример использования для источника данных:
ГИС-аналитик хочет загрузить полигоны районов, хранящиеся в файле .csv на веб-сервере в Velocity.
Примечания по использованию
При работе с источником данных учитывайте следующее:
- После задания свойств исходного подключения настройте входные данные, чтобы задать схему и ключевые свойства.
- Оба параметра Параметры 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>>).
Параметры
Ниже приведены параметры источника данных:
| Параметр | Описание | Тип данных |
|---|---|---|
| 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-запросы и ответы, отправленные Velocity. Примечание:Включайте этот параметр только в целях устранения неполадок и отключайте его после завершения устранения неполадок. После включения запустите канал, журналы уровня отладки будут доступны на странице журналов канала. При необходимости обратитесь в Esri Technical Поддержка за помощью в устранении неполадок. | Boolean |
Советы и ограничения
При использовании источника данных учитывайте следующее:
- Конечная точка HTTP должна быть доступна извне через интернет.
- Размер ответа HTTP или файла потока не должен превышать 16 МБ. Если данные или файл превышают 16 МБ, объекты не будут приняты.
- При использовании аутентификации OAuth происходит следующее:
- Во время авторизации выполняется множество запросов к серверу авторизации и связанной конечной точке данных. Некоторые API используют ограничение количества запросов, что может сказаться на авторизации канала.
- В целях безопасности POST сообщения токенов доступа и обновлений должны быть переконфигурированы, если отредактированы параметры аутентификации.
- Если для источника HTTP Poller указан URL и попытка подключения не удалась, рекомендуется просмотреть раздел Дополнительные сведения в сообщении об ошибке. Эта информация может содержать необработанные данные запроса и ответа, которые могут помочь диагностировать и понять причину сбоя.