El tipo de feed HTTP Poller de ArcGIS Velocity envía una solicitud HTTP a la URL especificada. Con ello se recopila cualquier dato que se pueda recuperar en un navegador web navegando a la misma URL.
Ejemplo
Los valores de sensor actualizados se cargan desde una API cada minuto.
Notas de uso
- El feed sondeará el extremo HTTP para cargar los datos a la velocidad definida en el paso Intervalo de sondeo de feed del asistente de configuración.
- Se debe poder acceder externamente al extremo HTTP en Internet.
- El tamaño de la respuesta HTTP o del archivo sondeado no debe exceder los 16 MB. Si los datos que se desea sondear superan los 16 MB, las entidades no se procesarán.
- Cuando se establece un intervalo de sondeo, el sondeo se produce en intervalos de tiempo regulares en lugar de a la hora de inicio del feed. Por ejemplo, si un feed está configurado para realizar un sondeo de datos cada cinco minutos y el feed se inicia a las 8:03 de la mañana, la primera solicitud de datos se realizará a las 8:05 de la mañana, la próxima, a las 8:10, y así sucesivamente.
- Tenga cuidado al especificar el valor de Intervalo de sondeo de feed. Asegúrese de que el extremo HTTP que se desea sondear sea capaz de devolver respuestas dentro del intervalo de sondeo especificado. Se recomienda probar el tiempo de respuesta de una solicitud al sitio web, utilizando la misma solicitud que se aplica en la configuración del feed. No establezca el intervalo de sondeo en un intervalo más corto que el tiempo de respuesta habitual de la solicitud al sitio web. Para obtener más información, consulte Programar el intervalo de sondeo del feed.
- Los parámetros Cuerpo POST, Parámetros de URL y Encabezados personalizados pueden usar variables globales de feed. De forma predeterminada, las variables globales de feed se convierten en tiempo Epoch (milisegundos desde el 1 de enero de 1970 UTC). Opcionalmente, puede convertir las variables globales de feed a segundos de Epoch (segundos desde el 1 de enero de 1970) y a una cadena de caracteres de formato de fecha y hora. A continuación, se describen las variables de análisis de feed y el tiempo que representan.
- $feed.FeedStartTime: la hora de inicio del feed
- $feed.FeedScheduledStartTime: la hora a la que está programada la próxima recurrencia del feed
- $feed.FeedLastScheduledStartTime: la hora a la que se programó la última recurrencia del feed
- Los niveles de licencia de suscripción de ArcGIS Velocity tienen límites en cuanto a la cantidad de datos que puede incorporar un feed, tal y como se resume a continuación. Si los feeds superan el límite de procesamiento de su nivel de licencia, se escribe un mensaje en los registros y se envía un correo electrónico al usuario notificándole que se ha alcanzado el límite. Si el procesamiento de datos se mantiene por encima del límite durante más de una hora, se interrumpirá el feed. Para obtener más información sobre licenciamiento de ArcGIS Velocity, consulte Licenciamiento. Si es necesario, trabaje con su representante de Esri o el Soporte técnico de Esri para explorar los niveles de licencia de Velocity compatibles con sus flujos de trabajo.
- Standard: incorpora y procesa datos a 25 KB/segundo (aproximadamente 100 eventos por segundo).
- Advanced: incorpora y procesa datos a 250 KB/segundo (aproximadamente 1000 eventos por segundo).
- Dedicated: incorpora y procesa datos a 2500 KB/segundo (aproximadamente 10.000 eventos por segundo).
Después de configurar los parámetros de conexión del feed, consulte Configurar datos de entrada para obtener información sobre cómo definir el esquema y los parámetros clave.
Autenticación de OAuth
El tipo de feed 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 y, opcionalmente, configurar una solicitud para usar un token de refresco para recuperar nuevos tokens de acceso. Estas se agregan a la solicitud de datos que normalmente se configura como parte de cualquier tipo de feed HTTP Poller.
Durante la configuración de la solicitud de token de acceso, se le pide que identifique el token de acceso y los campos JSON clave opcionales de caducidad y token de refresco de la respuesta del servidor de autorización de OAuth. Si se selecciona una caducidad, debe definir el tipo de caducidad (duración o marca de tiempo) y las unidades.
Si se identificó un token de refresco en la solicitud del token de acceso, debe utilizar la variable global $refreshToken para definir dónde se utilizará el token de refresco en la configuración de la solicitud del token de refresco.
Por último, 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>>).
Mientras se ejecuta, un feed con autenticación de OAuth configurada administra el token de acceso y administra cualquier error al recuperar los datos según corresponda. Por ejemplo, si se definen una solicitud de token de refresco y una caducidad, el feed utiliza el token de refresco que recuperó inicialmente con la solicitud de token de acceso para recuperar un nuevo token si el token ha caducado.
Tenga en cuenta lo siguiente al crear un feed 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, los cuerpos POST de las solicitudes de token de acceso y token de refresco se deben reconfigurar al editar los parámetros de autenticación.
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 de feed 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. 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 enviada 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 de feed 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 especificado. 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 de feed y globales de $accessToken. | Par de clave-valor |
Sondeo largo | ArcGIS Velocity sondeará el servidor web y mantendrá una conexión abierta hasta que el servidor envíe nuevos datos. Cuando Velocity recibe datos, se envía inmediatamente una nueva solicitud. Nota:Esta es una configuración única del servidor web que no es común a la mayoría de los servidores web. | Booleano |
Variables globales | Parámetro opcional que puede utilizarse para convertir las variables globales de feed a un formato de fecha y hora personalizado. Este parámetro admite variables de feed y globales de $accessToken. Más información acerca de la configuración de un formato de fecha (milisegundos de Epoch, segundos de Epoch y formato de cadena de caracteres) en Parámetros de fecha y hora. | Cadena de caracteres |
Registro adicional | Opcionalmente active el registro de solicitudes y respuestas HTTP sin procesar emitidas por Velocity. Nota:Este parámetro solo debe activarse con fines de resolución de problemas y desactivarse cuando la resolución de problemas haya finalizado. Una vez activado, inicie el feed y los registros del nivel de depuración estarán disponibles en la página de registros del feed. En caso necesario, póngase en contacto con el Soporte técnico de Esri para que le ayude a solucionar los problemas. | Booleano |
Consideraciones y limitaciones
- 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.
- No establezca el intervalo de sondeo en un intervalo más corto que el tiempo de respuesta habitual de la solicitud al extremo HTTP. Para obtener más información, consulte Programar el intervalo de sondeo del feed.
- Como práctica recomendada, utilice este tipo de feed para datos en tiempo real con velocidades de aproximadamente 3.000 entidades de puntos por segundo o menos. Las velocidades admitidas variarán en función del número de atributos de datos, el formato de los datos entrantes y la complejidad de las entidades de polilínea o polígono.