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
Tenga en cuenta lo siguiente al trabajar con la fuente de datos Sondeador HTTP:
- 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 admiten variables globales de análisis para programar análisis de big data recurrentes. De forma predeterminada, estas variables globales se convierten en tiempo Epoch (milisegundos desde el 1 de enero de 1970 UTC). A continuación, se indican 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, lo siguiente será de aplicación:
- 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 los en los parámetros de URL, así como en la URL (por ejemplo, https://<<company.domain>>/$accessToken/<<method>>?<<url params>>).
Parámetros
A continuación se indican los parámetros de la fuente de datos Sondeador HTTP:
| 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 | Especifica 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 | Especifica el tipo de autenticación utilizado para acceder al extremo HTTP. Las opciones 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. Este parámetro 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 proporcionado 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
A continuación se indican las consideraciones y limitaciones de uso de la fuente de datos Sondeador HTTP:
- 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 consumirán.
- Cuando se utiliza la autenticación de OAuth, lo siguiente será de aplicación:
- 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, al editar los parámetros de autenticación, es necesario configurar de nuevo el cuerpo POST del token de acceso.