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

Este tipo de flujo de trabajo está diseñado para exportar datos detallados del sujeto —incluido el historial de ubicación y los atributos de seguimiento— desde su fuente de datos EarthRanger conectada. Los resultados están disponibles en formato CSV o Parquet para su uso en herramientas de análisis externas.

Panel de resultados

Cuando se ejecuta correctamente un flujo de trabajo de descarga de historiales de sujetos, se genera un panel de resultados con un resumen de la configuración y un mapa de las trayectorias de sujetos exportadas.

La vista de resultados puede mostrar (dependiendo de la configuración):

• Descargar resultados: Un botón en la parte superior derecha del panel de control para descargar el archivo de datos exportado.
• 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.
• Mapa de trayectorias de sujetos: Una representación espacial de las trayectorias de los sujetos trazadas en un mapa.

Antes de comenzar

Este flujo de trabajo solo está disponible en Ecoscope Desktop y 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 detalles del sujeto» 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 Descargar flujo de trabajo de pistas temáticas.

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.

Obtenga observaciones del grupo de sujetos de EarthRanger

Introduzca el nombre exacto del grupo temático para el que desea exportar las observaciones, tal como aparece en EarthRanger (eg Ecoscope) .

• Los nombres de los grupos temáticos se pueden encontrar en su sitio de administración EarthRanger en Observaciones → Grupos temáticos .
• Este campo es obligatorio. El flujo de trabajo no se ejecutará sin un nombre de grupo de temas válido. 
   

Observaciones del proceso

Esta sección permite aplicar filtros y transformaciones a los datos de observación del sujeto antes de exportarlos. Los datos disponibles aquí incluyen todas las columnas de los pasos anteriores, además de los detalles normalizados del sujeto y la observación. Todas las subsecciones se encuentran en Configuraciones avanzadas y son opcionales.

Persistir las trayectorias de los sujetos

Seleccione el formato de salida para los datos de trayectoria del sujeto exportados. Puede seleccionar uno o ambos:

• 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.

Elija Parquet cuando trabaje con grandes volúmenes de datos o cuando utilice herramientas que lo admitan, para reducir significativamente el tamaño de los archivos y el tiempo de procesamiento. 
 

Generar mapas

Habilite la opción Saltar mapa para ejecutar el flujo de trabajo sin generar un mapa espacial de las rutas de patrulla.

Se recomienda omitir el mapa cuando:

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

Deshabilitar el mapa no afecta la integridad de los datos exportados.

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).
• 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.