La fuente de datos HTTP Poller de ArcGIS Velocity envía una solicitud HTTP a la URL especificada. Con ello se procesa cualquier dato que se pueda recuperar en un navegador web navegando a la misma URL.
Ejemplo
Un analista SIG desea cargar a .csv polígonos de distrito almacenados en un archivo Velocity en un servidor web.
Notas de uso
- Se debe poder acceder externamente al extremo HTTP en Internet.
- El tamaño de la respuesta HTTP o del archivo sondeado no puede exceder los 16 MB. Si los datos o el archivo que se desea sondear supera los 16 MB, las entidades no se procesarán.
- Después de configurar los parámetros de conexión de origen, configure los datos de entrada para definir el esquema y los parámetros clave.
- Tanto los Parámetros de URL como los parámetros de Encabezados personalizados pueden usar variables globales de análisis para programar análisis de big data recurrentes. Cuando se ejecutan los análisis, estas variables globales se convierten en tiempo Epoch (milisegundos desde el 1 de enero de 1970 UTC). A continuación, se describen las variables de análisis disponibles y el tiempo que representan.
- $analytic.AnalyticLastScheduledStartTime: la hora de inicio programada para la última ejecución del análisis
- $analytic.AnalyticScheduledStartTime: la hora de inicio programada para la ejecución actual del análisis
- $analytic.AnalyticLastEndTime: la hora de finalización de la última ejecución del análisis
- $analytic.AnalyticStartTime: la hora de inicio de la ejecución actual del análisis (la diferencia entre esta hora y $analytic.AnalyticScheduledStartTime es la demora de inicio)
- Si se utiliza la autenticación de OAuth:
- El origen HTTP Poller admite la autenticación mediante OAuth 2.0 para extremos HTTP que siguen los tipos de concesión Credenciales de cliente o Contraseña. Estos tipos de concesión de OAuth siguen un patrón que incluye la configuración de una solicitud HTTP para obtener un token de acceso. Estas se agregan a la solicitud de datos que normalmente se configura como parte de cualquier tipo de origen HTTP Poller.
- Durante la configuración de la solicitud de token de acceso, se le pide que identifique el token de acceso de la respuesta del servidor de autorización de OAuth.
- Al volver a la configuración de la solicitud de datos, debe utilizar la variable global $accessToken para definir dónde se utilizará el token de acceso. Suele ser en un encabezado personalizado de Authorization con el valor Bearer $accessToken. $accessToken también se puede utilizar en el cuerpo POST y en la URL misma (por ejemplo, https://<<company.domain>>/$accessToken/<<method>>?<<url params>>).
Parámetros
| Parámetro | Descripción | Tipo de datos |
|---|---|---|
URL | URL completa del extremo HTTP accesible externamente. Este parámetro admite la variable global de $accessToken. | Cadena de caracteres |
Método HTTP | El método HTTP utilizado para el extremo HTTP, ya sea GET o POST. Si se elige POST, se puede especificar opcionalmente un cuerpo de mensaje. | Cadena de caracteres |
Cuerpo POST | El cuerpo de mensaje que se desea incluir al enviar una solicitud HTTP POST. Proporciona una selección entre x-www-form-urlencoded y otros tipos de contenido de texto genérico. También establece el encabezado Content-type. Este parámetro solo se aplica si el parámetro Método HTTP tiene el valor POST. Este parámetro admite variables analíticas y globales de $accessToken. | Cadena de caracteres |
Autenticación | El tipo de autenticación utilizado para acceder al extremo HTTP. Las opciones de autenticación son Ninguna, Básica, Certificado y OAuth. | Cadena de caracteres |
Nombre de usuario | El nombre de usuario para acceder al extremo HTTP. Este parámetro solo se aplica si el parámetro Autenticación tiene el valor Básico. | Cadena de caracteres |
Contraseña | La contraseña para acceder al extremo HTTP. Esta propiedad solo se aplica si el parámetro Autenticación tiene el valor Básico. | Contraseña |
URL de certificado | La ubicación URL del certificado de cliente para acceder al extremo HTTP. Este parámetro solo se aplica si el parámetro Autenticación tiene el valor Certificado. | Cadena de caracteres |
Contraseña | La contraseña del certificado de cliente, si se ha definido una. Este parámetro solo se aplica si el parámetro Autenticación tiene el valor Certificado. | Contraseña |
Encabezados personalizados | Encabezados personalizados opcionales que se incluirán en la solicitud HTTP que se envía al extremo HTTP especificado. Por ejemplo, es posible utilizar encabezados personalizados para especificar una clave API de terceros o un encabezado de autorización. Este parámetro admite variables analíticas y globales de $accessToken. | Par de clave-valor |
Parámetros de la URL | Parámetros de URL opcionales que se incluirán en la URL de la solicitud HTTP enviada al extremo HTTP. Aunque los parámetros también se pueden establecer en el parámetro URL, los parámetros de URL introducidos aquí invalidarán cualquier parámetro coincidente suministrado en el parámetro URL. Los parámetros definidos aquí siempre tendrán codificación URL. Este parámetro admite variables analíticas y globales de $accessToken. | Par de clave-valor |
Consideraciones y limitaciones
- Se debe poder acceder externamente al extremo HTTP en Internet.
- Tenga en cuenta lo siguiente al crear un origen con OAuth:
- Se producen varias solicitudes a un servidor de autorización y el extremo de datos asociado durante la creación. Algunas API implementan una limitación de velocidad para determinadas solicitudes, lo que podría afectar a la creación del feed.
- Por motivos de seguridad, el cuerpo POST del token de acceso se debe reconfigurar al editar los parámetros de autenticación.