Тип канала HTTP Poller в ArcGIS Velocity будет отправлять HTTP-запрос на указанный URL веб-сайта. Он собирает данные, которые могут быть извлечены в веб-браузере по этому URL.
Пример
Обновленные значения загружаются из API каждую минуту.
Примечания по использованию
При работе с каналом HTTP Poller учитывайте следующее:
- Канал будет опрашивать конечную точку HTTP для загрузки данных с частотой, определяемой параметром на шаге Интервал опроса канала в мастере настройки.
- Когда задан интервал опроса, опрос происходит через регулярные временные интервалы, в противоположность времени запуска канала. Например, если канал настроен на опрос данных каждые пять минут и канал запускается в 8:03, первый запрос данных произойдет в 8:05, следующий - в 8:10 и т.д.
- Будьте внимательны при задании значения Интервала опроса канала. Убедитесь, что опрашиваемая конечная точка HTTP способна возвращать ответы в течение указанного интервала опроса. Рекомендуется проверить время ответа запроса на веб-сайт, используя тот же запрос, который вы применяете в конфигурации канала. Не задавайте интервал опроса короче, чем стандартное время ответа запроса на веб-сайт. Более подробно см. в разделе Установка интервала опроса канала.
- Параметры Тело POST, Параметры URL и Пользовательские заголовки поддерживают глобальные переменные канала . По умолчанию, глобальные переменные канала конвертируются во время эпохи (миллисекунды с 1 января 1970 UTC). При необходимости можно преобразовать глобальные переменные канала в секунды эпохи (секунды с 1 января 1970 года) и строковый формат даты и времени . При первом запуске канала после запуска или перезапуска время $feed.FeedLastScheduledStart будет равно текущему времени запуска минус пять минут. Ниже перечислены аналитические переменные канала и время, которое они представляют:
- $feed.FeedStartTime - время запуска канала
- $feed.FeedScheduledStartTime - запланированное время следующего запуска
- $feed.FeedLastScheduledStartTime - запланированное время последнего запуска
- Уровни лицензий ArcGIS Velocity подписки имеют ограничения на объем данных, который может быть получен с помощью канала, как указано ниже. Если каналы превышают предел приема данных вашего уровня лицензии, в журналы записывается сообщение, и вам отправляется электронное письмо с уведомлением о достижении предела. Если скорость приема данных канала превышает предел уровня подписки больше часа, канал останавливается. Подробнее о лицензировании ArcGIS Velocity см. в разделе Лицензирование. При необходимости проконсультируйтесь со своим представителем Esri или Службой технической поддержки Esri, чтобы изучить уровни лицензий Velocity, которые поддерживают ваши рабочие процессы. Уровни лицензий следующие:
- Standard — прием и обработка данных со скоростью 25 КБ/с (примерно 100 событий в секунду).
- Advanced — прием и обработка данных со скоростью 250 КБ/с (примерно 1000 событий в секунду).
- Dedicated — прием и обработка данных со скоростью 2,500 КБ/с (примерно 10000 событий в секунду).
- После настройки параметров подключения канала изучите раздел Настройка входных данных, чтобы научиться задавать схему и ключевые параметры.
Аутентификация OAuth
Тип канала HTTP Poller поддерживает аутентификацию, используя конечные точки OAuth 2.0 for HTTP, соответствующие назначенным типам Учетные данные пользователя или Пароль. Эти типы OAuth соответствуют образцу, включающему конфигурацию запроса HTTP согласно токену доступа, и дополнительно настраивают запрос на использование токена обновления для получения новых токенов доступа. Они являются дополнением к запросу данных, который обычно настраивается как часть любого типа канала HTTP Poller.
Во время настройки запроса токена доступа, вам будет предложено идентифицировать токен доступа и дополнительные токен обновления и поля окончания срока действия JSON в ответе от сервера авторизации OAuth. Если выбран срок окончания действия, необходимо задать тип окончания срока действия (продолжительность или метка времени) и единицы измерения.
Если по запросу токена доступа идентифицируется токен обновления, необходимо использовать глобальную переменную $refreshToken, чтобы определить, где в конфигурации запроса токена обновления будет использоваться токен обновления.
Наконец, при возвращении к конфигурации запроса данных, необходимо использовать глобальную переменную $accessToken, чтобы задать, где будет использоваться токен доступа. Часто это происходит в настраиваемом заголовке Authorization, со значением Bearer $accessToken. $accessToken может также быть использован в теле POST-запроса , параметрах URL и в самом URL-адресе (например, https://<<company.domain>>/$accessToken/<<method>>?<<url params>>).
Во время обработки, канал с настроенной аутентификацией OAuth будет управлять токеном доступа и соответственно обрабатывать любые ошибки получения данных. Например, если заданы запрос токена обновления и окончание срока действия, канал будет использовать токен обновления, первоначально полученный с токеном доступа, для запроса нового токена, если срок действия предыдущего закончился.
При создании канала с OAuth учитывайте следующее:
- Во время авторизации выполняется множество запросов к серверу авторизации и связанной конечной точке данных. Некоторые API используют ограничение количества запросов, что может сказаться на авторизации канала.
- В целях безопасности, POST сообщения запросов токенов доступа и обновлений должны быть переконфигурированы, если отредактированы параметры аутентификации.
Параметры
Ниже перечислены параметры канала 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. | Пара ключ-значение |
Длительный опрос | Определяет будет опрашивать веб-сервер и поддерживать открытое подключение, ожидая отправку новых данных с сервера. Когда будут получены новые данные, будет сразу же отправлен новый запрос. Примечание:Это уникальная конфигурация веб-сервера, не характерная для большинства веб-серверов. | Boolean |
Глобальные переменные | Преобразуйте глобальные переменные канала в пользовательский формат даты и времени. Это дополнительный параметр. Этот параметр поддерживает глобальные переменные канала и $accessToken. Дополнительные сведения о настройке формата даты (миллисекунды эпохи, секунды эпохи и формат строки) см. в разделе Параметры даты и времени. | Строка |
Дополнительное ведение журнала | Указывает, будет ли включено ведение журнала необработанных HTTP-запросов и ответов, издаваемых Velocity. Это дополнительный параметр. Примечание:Включайте этот параметр только в целях устранения неполадок и отключайте его после завершения устранения неполадок. После включения запустите канал, и журналы уровня отладки будут доступны на странице журналов канала. При необходимости обратитесь в Службу технической поддержки Esri за помощью в устранении неполадок . | Boolean |
Советы и ограничения
Ниже приведены рекомендации и ограничения при использовании канала HTTP Poller:
- Конечная точка HTTP должна быть доступна извне через интернет.
- Размер ответа fHTTP или файла не должен превышать 16 МБ. Если запрашиваемые данные превышают 16 МБ, объекты не будут приняты.
- Рекомендуется использовать этот тип канала для данных в реальном времени со скоростью около 3000 точечных объектов в секунду или менее. Поддерживаемая скорость будет варьироваться в зависимости от количества атрибутов в данных, формата входящих данных и сложности полилинейных или полигональных объектов.