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
Tenga en cuenta lo siguiente al trabajar con el feed Sondeador HTTP:
- El feed sondea el extremo HTTP para cargar datos a la velocidad definida por el paso Intervalo de sondeo de feed del asistente de configuració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 admiten 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. La primera vez que el alimentador funcione después de arrancar o reiniciar, el tiempo $feed.FeedLastScheduledStart será la hora de inicio actual menos cinco minutos. A continuación, se indican 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 consumir un feed, tal y como se resume a continuación. Si los feeds superan el límite de consumo de su nivel de licencia, se escribe un mensaje en los registros y se envía un correo electrónico en el que se indica que se ha alcanzado el límite. Si el consumo de datos se mantiene por encima del límite durante más de una hora, el feed se interrumpe. Para obtener más información acerca del licenciamiento de ArcGIS Velocity, consulte Licenciamiento. Si es necesario, póngase en contacto con su representante de Esri o con el Soporte técnico de Esri, para explorar los niveles de licencia de Velocity compatibles con sus flujos de trabajo. Los niveles de licencia son los siguientes:
- Standard: consume y procesa datos a 25 KB/segundo (unos 100 eventos por segundo aproximadamente).
- Advanced: consume y procesa datos a 250 KB/segundo (unos 1000 eventos por segundo aproximadamente).
- Deidcated: consume y procesa datos a 250 KB/segundo (unos 1000 eventos por segundo aproximadamente).
- 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 los en los parámetros de URL, así como en la URL (por ejemplo, https://<<company.domain>>/$accessToken/<<method>>?<<url params>>).
Durante el procesamiento, 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
A continuación se indican los parámetros del feed 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 de feed 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 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 proporcionado 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 | Especifica si el servidor web se sondeará y se mantendrá una conexión hasta que el servidor envíe nuevos datos. Cuando se reciben nuevos 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 | Convierta las variables globales de feed a un formato de fecha y hora personalizado. Este parámetro es opcional. Este parámetro admite variables de feed y globales de $accessToken. Más información sobre 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 | Especifica si se activará el registro de solicitudes y respuestas HTTP sin procesar emitidas por Velocity. Este parámetro es opcional. Nota:Active este parámetro únicamente para resolver problemas y desactívelo una vez que estén resueltos. 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. Si es necesario, póngase en contacto con el Soporte técnico de Esri para que le ayude a solucionar los problemas. | Booleano |
Consideraciones y limitaciones
A continuación se indican las consideraciones y limitaciones de uso del feed Sondeador HTTP:
- 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, es posible que las entidades no se consuman.
- 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.