El tipo de feed Capa de entidades de ArcGIS Velocity sondea una capa de entidades de ArcGIS Online o ArcGIS Server para obtener entidades.
Ejemplos
A continuación se enumeran algunos ejemplos de casos de uso del feed:
- Un usuario configura un feed que hace referencia a una capa de entidades alojada de ArcGIS Server para cargar las entidades agregadas por los usuarios.
- Un analista SIG proporciona la dirección URL a una capa de entidades de ArcGIS Server (como https://sampleserver6.arcgisonline.com/arcgis/rest/services/Wildfire/FeatureServer/2) que contiene las entidades que se desea cargar cada minuto, para su uso en un análisis en tiempo real.
Notas de uso
Tenga en cuenta lo siguiente al trabajar con el feed:
- El feed sondea la capa de entidades para cargar las entidades a la velocidad definida en el paso Intervalo de sondeo de feed del asistente de configuración del feed.
- El valor del campo de marca de hroa es el campo de fecha para obtener las últimas entidades. Puede definir el valor del campo de marca de hora en el paso de campo de marca de hora. Si no se especifica un valor de campo de marca de tiempo, en cada intervalo, el feed de la capa de entidades carga todas las entidades de la capa de entidades como eventos para procesar.
- Si se especifica un valor de campo de marca de tiempo, la primera vez que Velocity sondea la capa de entidades, todas las entidades se cargan con un campo de marca de hora datetime dentro del último minuto y anterior a la primera hora de sondeo de feed que cumpla los criterios de la cláusula WHERE. En cada sondeo posterior solo se cargan las entidades con un valor de campo de marca de tiempo entre el último tiempo de sondeo y el sondeo actual que también cumpla los criterios de la cláusula WHERE.
- Velocity requiere que los valores de marca de tiempo se almacenen en la hora universal coordinada (UTC). Si se especifica un valor de fecha y hora, pero los valores no se almacenan en UTC, el sondeo de la capa de entidades puede devolver datos inesperados.
- A la hora de explorar para elegir un elemento de la capa de entidades, puede filtrar por carpetas, favoritos, grupos u organización. A continuación, puede filtrar más detalladamente por fecha de modificación, fecha de creación y etiquetas.
- Las capas de entidades de ArcGIS Server también se pueden cargar mediante el uso de una URL. Debe ser una dirección URL REST del directorio de servicios de ArcGIS Server (por ejemplo, https://sampleserver6.arcgisonline.com/arcgis/rest/services/Wildfire/FeatureServer/2). Esta URL debe terminar en /FeatureServer/# o /MapServer/#, donde # es el número de capa.
- Para cargar una capa de entidades protegida desde una URL, primero debe agregar un servicio o documento desde la URL a ArcGIS Online y elegir el almacenamiento de credenciales. A continuación, puede ir al elemento registrado de ArcGIS Online para seleccionar la capa de entidades protegida.
- Cuando se establece una frecuencia de sondeo, el sondeo se produce en intervalos de reloj 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 5 minutos y se inicia a las 8:03 de la mañana, la primera solicitud de datos se realiza a las 8:05 de la mañana, la próxima, a las 8:10, y así sucesivamente.
- Tenga cuidado al definir el intervalo de sondeo del feed. Debe asegurarse de que la capa de entidades que se está sondeando puede devolver respuestas dentro del intervalo de sondeo especificado. Se recomienda probar el tiempo de respuesta de una solicitud de consulta a esta capa de entidades utilizando la misma consulta aplicada en la configuración del feed. No establezca nunca el intervalo de sondeo en un intervalo más corto que el tiempo de respuesta habitual de la consulta de capa de entidades. Para obtener más información sobre la programación de intervalos de sondeo de feeds, consulte Programar el intervalo de sondeo de feeds.
- Después de configurar los parámetros de conexión de la capa de entidades, configure los datos de entrada para definir el esquema y los parámetros clave.
Parámetros
Los siguientes son los parámetros del feed:
| Parámetro | Explicación | Tipo de datos |
|---|---|---|
| Cláusula WHERE | El parámetro Claúsula WHERE especifica una cláusula SQL (Lenguaje estructurado de consultas) que se utiliza para filtrar las entidades cargadas desde la capa de entidades especificada. El valor predeterminado es cargar todas las entidades utilizando 1=1. Esta cláusula WHERE predeterminada se puede modificar para incluir valores de atributos específicos y condiciones lógicas. La sintaxis de la cláusula WHERE SQL-92 de los campos de la capa es compatible con la mayoría de las capas de entidades. Las capas de entidades generadas por Velocity que se ejecutan en una fuente de datos espaciotemporales tienen restricciones en cuanto a lo que admiten; solo admiten un subconjunto de SQL-92. A continuación se muestra una lista de SQL-92 compatible con dichas capas de entidades:
Puede actualizar este parámetro en el paso de filtrado de datos. | QueryString |
| Campos de salida | El parámetro Campos de salida especifica los campos que se cargarán desde la capa de entidades en Velocity. El valor predeterminado es un asterisco (*), que indica que se cargan todos los campos. Si se facilitan campos específicos, deben enumerarse como nombres de campo separados por comas, por ejemplo: device_id,timestamp,horizontal_accuracy,latitude,longitude Puede actualizar este parámetro en el paso de filtrado de datos. | Cadena de caracteres |
| Referencia espacial de salida (opcional) | El parámetro Referencia espacial de salida especifica el Id. conocido (WKID) de una referencia espacial. El WKID predeterminado es 4326. Velocity carga datos de la capa de entidades en la referencia espacial definida en este parámetro. Puede actualizar este parámetro en el paso de filtrado de datos. | Cadena de caracteres |
| Registro adicional (Opcional) | Especifica si está habilitado el registro de solicitudes sin procesar emitidas por Velocity. El valor predeterminado es Falso. Nota:Active este parámetro para la localización de averías y desactívelo cuando haya finalizado. Una vez activado, inicie el feed; 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 equipo de Esri técnico de Soporte para que le ayuden a solucionar los problemas. | Booleano |
| Campo de marca de tiempo | Especifica un campo de fecha para recuperar solo las entidades más recientes. Si no se especifica un valor de campo de marca de tiempo en cada intervalo, el feed carga todas las entidades de la capa de entidades como eventos para procesar. Si se especifica un valor de campo de marca de tiempo, la primera vez que Velocity sondea la capa de entidades, carga todas las entidades con el campo de marca de tiempo datetime que estén dentro del último minuto y sean anteriores al primer tiempo de sondeo de feed que también cumpla los criterios de la cláusula WHERE. En cada sondeo posterior solo se cargan las entidades con un valor de campo de marca de tiempo entre el último tiempo de sondeo y el tiempo de sondeo actual que también cumplan los criterios de la cláusula WHERE. | Cadena de caracteres |
Consideraciones y limitaciones
Plantéese lo siguiente al utilizar el feed:
- La capa de entidades debe estar accesible a través de Internet.
- No establezca el intervalo de sondeo en un intervalo más corto que el tiempo de respuesta habitual de la consulta de la capa de entidades.
- Velocity no admite capas que requieran créditos para las consultas de datos.
- Si las credenciales del usuario no son válidas, el feed vuelve a intentar la conexión hasta tres veces. En los registros aparecen errores de credenciales no válidas. El feed intenta reiniciarse automáticamente tras un retraso, según el programa de recurrencia configurado.