Antes de ejecutar cualquier flujo de trabajo en Ecoscope, primero debe configurar al menos una fuente de datos. Las fuentes de datos proporcionan los datos de entrada que los flujos de trabajo consultan, procesan y visualizan.
Sin una fuente de datos configurada, los flujos de trabajo no pueden recuperar datos y, por lo tanto, no pueden ejecutarse.
¿Qué es una fuente de datos?
En Ecoscope, una fuente de datos representa una conexión a un sistema externo que contiene datos operativos, como observaciones GPS, registros de patrulla o registros de eventos.
Las fuentes de datos se pueden configurar en Ecoscope Web o Ecoscope Desktop, dependiendo de cómo se ejecuten los flujos de trabajo.
Una vez conectados, los datos de la fuente están disponibles para los flujos de trabajo correspondientes (como Seguimiento de Sujetos, Eventos o Patrullas). Estos flujos de trabajo utilizan dichos datos para generar mapas, gráficos y métricas resumidas.
Fuentes de datos compatibles
Las fuentes de datos disponibles actualmente difieren ligeramente dependiendo de si se utiliza Ecoscope Web o Ecoscope Desktop.
Ecoscope Web
Actualmente es compatible con:
- EarthRanger
Se prevé la compatibilidad futura con plataformas adicionales como SMART y otros proveedores de datos de conservación.
Ecoscope Desktop
Ecoscope Desktop admite integraciones adicionales diseñadas para flujos de trabajo más avanzados y entornos sin conexión, entre las que se incluyen:
- EarthRanger
- SMART
- Motor de búsqueda de Google Earth
Las integraciones de escritorio permiten a los usuarios configurar las conexiones localmente y pueden requerir la importación de credenciales o archivos de configuración en lugar de introducirlos directamente en un formulario.
Nota de escritorio de Ecoscope
En Ecoscope Desktop, las credenciales no siempre se validan durante la configuración inicial. Si las credenciales o los parámetros de configuración son incorrectos, es posible que solo aparezcan errores al ejecutar el flujo de trabajo.
Conectar una fuente de datos
El proceso para agregar una fuente de datos varía ligeramente entre Ecoscope Web y Ecoscope Desktop.
Conexión de una fuente de datos EarthRanger (Web)
Para conectar su instancia EarthRanger en Ecoscope Web :
- Diríjase a la pestaña Fuentes de datos en la barra de navegación superior.
- Haga clic en Conectar origen de datos .
- Complete los datos de conexión requeridos.
- Haz clic en Guardar para validar y almacenar la conexión.
Campos obligatorios
Nombre de la fuente de datos
Un nombre único para la conexión (por ejemplo, Serengeti_ER ).
URL EarthRanger
El dominio de tu instancia EarthRanger
(por ejemplo, https://<sudominio>.pamdas.com ).
Nombre de usuario
Tu nombre de usuario EarthRanger .
Nota: Este no es tu nombre de usuario de Ecoscope.
Contraseña
Tu contraseña EarthRanger .
Nota: Esta no es tu contraseña de Ecoscope.
Si la conexión se realiza correctamente, la fuente de datos aparecerá en la vista de lista de Fuentes de datos .
Consejo:
Si la conexión falla, compruebe que ha introducido sus credenciales EarthRanger en lugar de sus credenciales de acceso a Ecoscope.
Conexión de fuentes de datos en Ecoscope Desktop
En Ecoscope Desktop, las fuentes de datos se configuran localmente dentro de la aplicación.
A diferencia de Ecoscope Web, las integraciones de escritorio pueden requerir la importación de archivos de credenciales o la especificación de parámetros de configuración, según la fuente. La versión de escritorio también permite la conexión a fuentes de datos adicionales diseñadas para flujos de trabajo más avanzados o entornos donde los servicios en la nube no estén disponibles.
En Ecoscope Desktop, las credenciales no siempre se validan durante la configuración. Si las credenciales o los parámetros de configuración son incorrectos, es posible que solo aparezcan errores al ejecutar el flujo de trabajo.
El proceso general es el siguiente:
- Abra la sección Fuentes de datos en Ecoscope Desktop.
- Seleccione el tipo de fuente de datos que desea configurar.
- Proporcione las credenciales o los archivos de configuración necesarios.
- Guarda la configuración para que la fuente de datos esté disponible para los flujos de trabajo.
Los pasos de configuración específicos varían según la fuente de datos.
SMART (Escritorio)
Las fuentes de datos SMART permiten que los flujos de trabajo de Ecoscope Desktop accedan a los datos de patrullaje y eventos almacenados en una base de datos SMART.
Para configurar una fuente de datos SMART:
- Abra la sección Fuentes de datos en Ecoscope Desktop.
- Seleccione SMART como tipo de fuente de datos.
- Proporcione los detalles de conexión SMART necesarios.
- Guarda la configuración.
Una vez guardada, la fuente de datos SMART estará disponible al configurar flujos de trabajo que admitan datos SMART.
Google Earth Engine (versión de escritorio)
Ecoscope Desktop admite flujos de trabajo que utilizan datos de Google Earth Engine (GEE) . Para conectarse a Google Earth Engine, primero debe crear una cuenta de servicio y una clave privada en Google Cloud Platform.
Paso 1: Crea una cuenta de servicio en Google Cloud.
- Abra la consola de Google Cloud .
- Navegue a IAM y administración → Cuentas de servicio .
- Haga clic en Crear cuenta de servicio .
- Proporcione un nombre y una descripción para la cuenta de servicio.
- Crea la cuenta y otorga los permisos necesarios para acceder a Earth Engine.
Paso 2: Generar una clave privada.
- Abra la cuenta de servicio recién creada .
- Dirígete a la pestaña "Teclas" .
- Haz clic en Agregar clave → Crear nueva clave .
- Seleccione JSON como tipo de clave.
- Descarga el archivo de clave JSON generado.
Este archivo contiene:
- el correo electrónico de la cuenta de servicio
- el ID del proyecto
- Credenciales de autenticación requeridas por Earth Engine
Paso 3: Importar la clave JSON a Ecoscope Desktop.
- Fuentes de datos abiertos en Ecoscope Desktop.
- Seleccione Google Earth Engine como tipo de fuente de datos.
- Haz clic en Examinar para localizar el archivo de clave JSON que descargaste.
- Seleccione el archivo y confirme.
Ecoscope Desktop extraerá automáticamente el correo electrónico de la cuenta de servicio y el ID del proyecto del archivo JSON.
Una vez guardada, la fuente de datos de Google Earth Engine estará disponible al configurar flujos de trabajo que requieran datos de Earth Engine.
Comportamiento importante
A diferencia de Ecoscope Web, Ecoscope Desktop no valida las credenciales durante la configuración. Si las credenciales son incorrectas o faltan permisos para la cuenta de servicio de Google Earth Engine, el problema se manifestará al ejecutar el flujo de trabajo. En ese caso, el flujo de trabajo fallará y el mensaje de error se podrá consultar en los registros y el panel de metadatos.
Dado que las credenciales no se pueden editar en una fuente de datos existente, para solucionar un error de credenciales es necesario eliminar la fuente de datos, crear una nueva con las credenciales correctas y, a continuación, actualizar el flujo de trabajo para seleccionar la fuente de datos recién creada. Por lo tanto, le recomendamos que revise cuidadosamente sus credenciales al introducirlas en el formulario de configuración de la fuente de datos.
Visualización y gestión de fuentes de datos existentes
Todas las fuentes de datos configuradas aparecen en la vista de lista en la pestaña Fuentes de datos. Cada fila muestra información clave:
- Nombre de la fuente de datos : el nombre personalizado que le diste a la conexión.
- Dominio : la URL o el dominio de la instancia EarthRanger conectada.
- Tipo de conexión : Actualmente limitado a EarthRanger , pero próximamente se añadirán más opciones.
- Fecha de creación : marca de tiempo en la que se agregó la conexión.
-
Actualizado en : Marca de tiempo de la última actualización o reconfiguración exitosa.
¿Cuándo es necesaria una actualización?
En Ecoscope Web, los tokens de autenticación entre Ecoscope y su instancia de EarthRanger pueden caducar con el tiempo.
Cuando esto ocurra, se le pedirá que vuelva a conectar la fuente de datos antes de ejecutar nuevos flujos de trabajo.
Esta es una medida de seguridad habitual que garantiza que las conexiones permanezcan autenticadas y seguras.
En Ecoscope Desktop, los tokens de autenticación se crean sobre la marcha cuando se necesitan y se almacenan únicamente en memoria, por lo que no se aplican los flujos de reconexión.
