Esta guía le muestra cómo crear, configurar, ejecutar y descargar los resultados de un flujo de trabajo de Download Patrols en Ecoscope.

Este tipo de flujo de trabajo está diseñado para exportar datos de patrulla desde su fuente de datos EarthRanger conectada. Los resultados están disponibles en formato CSV o Parquet, lo que facilita el uso de los datos en herramientas externas o para análisis posteriores.

Este tipo de flujo de trabajo está disponible tanto en Ecoscope Web como en Ecoscope Desktop ( versión 1.0.0 y posteriores). Las diferencias más importantes, cuando corresponda, se detallan a continuación.

Panel de resultados

Cuando un flujo de trabajo se ejecuta correctamente, la pantalla de resultados puede mostrar (dependiendo de la configuración):

• Panel de contexto: Un resumen de la configuración de su flujo de trabajo, que incluye el título, la descripción, el rango de tiempo y la zona horaria utilizada.
• Pestaña del panel de control: se describe a continuación.
• Pestaña Archivos: se describe a continuación

Pestaña del panel de control

Esta pestaña es visual y funcionalmente idéntica en la versión en la nube y en la versión de escritorio.

La pestaña del panel de control puede mostrar (dependiendo de la configuración):

• Mapa de patrullas: Vista espacial de las trayectorias de las patrullas representadas en un mapa, codificadas por colores según la categoría seleccionada durante la configuración (por ejemplo, Tema de la patrulla).

Pestaña Archivos

Esta pestaña presenta sutiles diferencias visuales y de comportamiento en la versión en la nube y en la versión de escritorio. Consulte a continuación para obtener más detalles.

Ecoscope Web

La pestaña del panel de control puede mostrar (dependiendo de la configuración):

• Lista de archivos descargables: Una tabla con los archivos descargables de los datos de patrulla exportados. Puede hacer clic en el icono de descarga de cualquier fila para guardar el archivo en su ordenador.

Ten en cuenta que los enlaces de descarga en la nube permanecen válidos durante 20 minutos (desde que se carga la pestaña Archivos) para proteger tus datos. Puedes iniciar la descarga en cualquier momento antes de que transcurran los 20 minutos. Si permaneces en esta pantalla durante más de 20 minutos, verás un botón que te pedirá que actualices los enlaces de descarga. Si actualizas tu navegador mientras estás en la pestaña Archivos, el temporizador de 20 minutos se reiniciará con nuevos enlaces para los mismos archivos.

Si su panel de control tiene varias vistas seleccionables desde el panel de contexto, al cambiar a una nueva vista se actualizará la pestaña Archivos para mostrarle los archivos descargables asociados con esa vista.

Ecoscope Desktop

La pestaña del panel de control puede mostrar (dependiendo de la configuración):

• Abrir carpeta de resultados: Un botón situado en la parte superior derecha del panel de control para descargar los archivos de datos exportados.
• Lista de archivos descargables: Una tabla con los archivos descargables de los datos de patrulla exportados. Puede hacer clic en el icono de descarga de cualquier fila para guardar el archivo en la carpeta que prefiera.

Tenga en cuenta que los enlaces de descarga en el escritorio no caducan, ya que los archivos ya existen en su disco duro.

Si su panel de control tiene varias vistas seleccionables desde el panel de contexto, al cambiar a una nueva vista se actualizará la pestaña Archivos para mostrarle los archivos descargables asociados con esa vista.

Antes de comenzar

Este flujo de trabajo está disponible tanto en Ecoscope Web como en Ecoscope Desktop .

En Ecoscope Web , está disponible por defecto en la biblioteca de plantillas de flujo de trabajo para todos los usuarios.

En Ecoscope Desktop , debe importarse desde el catálogo de plantillas de flujo de trabajo antes de poder configurarlo o ejecutarlo.
Si aún no lo ha hecho, siga los pasos descritos en «Agregar plantillas de flujo de trabajo en Ecoscope Desktop» para importar el flujo de trabajo «Descargar patrullas» a su instancia. Una vez agregada la plantilla, vuelva a este artículo para continuar.

Configurar nuevo flujo de trabajo

Para crear un nuevo flujo de trabajo, vaya a Plantillas de flujo de trabajo en la barra de navegación superior y seleccione Flujo de trabajo de descarga de patrullas.

Detalles del flujo de trabajo

Esta sección le permite nombrar y describir su flujo de trabajo para que sea fácil de encontrar e identificar.

• Nombre del flujo de trabajo: Debe ser único. Si intenta enviar un nombre que ya se haya utilizado, recibirá un error de validación.
• Descripción del flujo de trabajo: Este campo es opcional. La descripción se mostrará en la vista de resultados para ayudarle a usted o a su equipo a recordar el contexto de configuración o el propósito de la exportación.

Rango de tiempo

Esta sección define el intervalo de tiempo de los datos que desea exportar. El rango de tiempo seleccionado determina qué patrullas se extraerán de su fuente de datos.

Usted configurará:

• Desde – Fecha y hora de inicio
• Hasta – Fecha y hora de finalización
• Zona horaria: necesaria para garantizar la fidelidad en la selección precisa de la hora.

Fuente de datos

Seleccione una fuente de datos en el menú desplegable.

Si solo se configura una fuente de datos, se seleccionará automáticamente y se mostrará la página de configuración del flujo de trabajo.

Tipos de patrulla y eventos

Especifique qué tipos de patrulla y tipos de eventos se incluyen en la exportación.

Tipos de patrulla
Seleccione el/los tipo(s) de patrulla que desea descargar en el menú desplegable.

• Deje esta sección vacía para descargar todos los tipos de patrulla.

Tipos de eventos
Seleccione el/los tipo(s) de evento que desea descargar en el menú desplegable.

• Deje esta sección vacía para descargar todos los tipos de eventos.

Incluir eventos sin ubicación
Los eventos sin coordenadas (punto o polígono) seguirán apareciendo en la descarga.

Configuraciones avanzadas (opcional)

• Estado de la patrulla : seleccione incluir solo las patrullas con un estado determinado. Deje este campo en blanco para incluir patrullas de todos los estados.
• Las patrullas se superponen con el rango de fechas : elija si desea incluir las patrullas que comienzan o terminan fuera del rango de tiempo seleccionado.

Filtrar datos (opcional)

Limita tu exportación utilizando una o más de las siguientes opciones:

• Cuadro delimitador : limita los resultados a las patrullas que se encuentren dentro de un área específica.
• Coordenadas exactas : filtra por una ubicación precisa.
• Filtro de trayectoria : filtro basado en patrones de movimiento.

Datos del grupo (opcional)

Utilice esta configuración para dividir las rutas y eventos de su patrulla en vistas separadas para la elaboración de informes y mapas.

• Seleccione + Agregar para crear un grupo.
• Agregue tantos grupos como necesite; cada uno se exporta y se asigna como su propio conjunto de datos.

Refinar los datos de patrulla (opcional)

Reorganiza y modifica tus datos antes de descargarlos. Esto se aplica únicamente a los archivos descargados, no al mapa generado. Todo lo que se muestra aquí se encuentra en Configuraciones avanzadas.

Eliminar columnas
Las columnas que se enumeran aquí no se incluirán ni en el mapa generado ni en la descarga. Si no está seguro de cuáles eliminar, intente ejecutar primero el flujo de trabajo para ver todas las columnas disponibles.

Aplicar consulta SQL
Escribe una consulta SQL para filtrar o transformar tus datos. Deja este campo en blanco para omitir este paso. Usa df como nombre de la tabla (por ejemplo, SELECT * FROM df WHERE status = 'active' ). Las consultas se aplican solo a los archivos descargados, no al mapa generado.

Formato de descarga del archivo Patrol Track

Elige el formato de archivo para descargar tu pista de Patrol.

• CSV : formato legible para humanos, compatible con herramientas de hojas de cálculo.
• Parquet : formato columnar comprimido, ideal para grandes conjuntos de datos y uso programático.
• GPKG (GeoPackage) : un formato geoespacial abierto y basado en estándares, compatible con herramientas SIG como QGIS y ArcGIS.
• GeoParquet : una extensión geoespacial de Parquet, optimizada para grandes conjuntos de datos espaciales con soporte de geometría nativo.

En la sección de Configuración avanzada , establezca un prefijo para el nombre del archivo : un nombre que se añadirá al principio de los archivos de salida de seguimiento de Patrol. Se añadirá automáticamente un identificador único al final para evitar duplicados.

Formato de archivo de descarga del evento

Elige el formato de archivo para la descarga de tu evento.

• CSV : formato legible para humanos, compatible con herramientas de hojas de cálculo.
• Parquet : formato columnar comprimido, ideal para grandes conjuntos de datos y uso programático.

En la sección de Configuración avanzada , establezca un prefijo para el nombre del archivo : un nombre que se añadirá al principio de los archivos de salida de eventos. Se añadirá automáticamente un identificador único al final para evitar duplicados.

Categoría de trayectoria

Diferencie las pistas por color utilizando la categoría seleccionada.

• Categoría : elige cómo se colorean las pistas en el mapa: tipo de patrulla, estado de la patrulla, sujeto de la patrulla o número de serie de la patrulla.

Generar mapas (opcional)

Utilice esta configuración para generar un mapa espacial de las rutas de su patrulla junto con el archivo de datos.

• La opción "Generar mapas en el panel de control" está marcada por defecto. No se recomienda para conjuntos de datos grandes.
• En Configuraciones avanzadas , configure las capas base del mapa.

Desmarca esta casilla cuando:

• Tu conjunto de datos es grande.
• Solo necesitas el archivo de datos, no una salida visual.
• Quieres minimizar el tiempo de procesamiento

Desactivar la generación de mapas no afecta la integridad de los datos exportados. Además, la pestaña del Panel de control quedará vacía.

Ejecutar el flujo de trabajo

Tras enviarlo, volverás a la vista Mis flujos de trabajo. Tu nuevo flujo de trabajo aparecerá en la lista con:

• Estado: Listo
• Aún no hay valores para Inicio de la última ejecución ni Duración de la última ejecución.
• Habrá un botón de Ejecutar disponible.

Haz clic en Ejecutar para comenzar el procesamiento. El estado cambiará a En ejecución.

Nota: El tiempo de procesamiento depende del volumen de datos y del formato de salida. La mayoría de los flujos de trabajo se completan en un minuto. Algunos flujos de trabajo pueden tardar hasta 10 minutos con conjuntos de datos muy grandes.

Si el flujo de trabajo falla, mostrará el estado "Fallido". Consulte la sección "Errores conocidos y soluciones" si esto le sucede.

Ver y descargar resultados

Una vez que el flujo de trabajo finalice correctamente (estado: Éxito), haga clic en el nombre del flujo de trabajo para abrir la vista de resultados.

Ahora puedes:

• Descarga el archivo exportado en el formato que hayas seleccionado (CSV o Parquet) desde la pestaña Archivos.
• Revise el recuento de registros y el resumen de exportación.
• Explore el panel del mapa que muestra las rutas de patrulla, si no habilitó la opción Saltar mapa.