Ir al contenido
JelinaJelina DocumentationDocumentación técnica
Volver al sitio oficial

Exportación de datos históricos

La exportación histórica genera archivos en segundo plano para conservar detalles originales o analizarlos con otras herramientas, sin mantener el navegador esperando a que termine la consulta.

  1. Selecciona puntos e intervalo temporal; para puntos compartidos, especifica el dispositivo de origen.
  2. Consulta la estimación de espacio en disco y crea la tarea.
  3. Revisa en la lista si está en cola, en ejecución, completada o fallida. Puedes cancelarla si ya no es necesaria.
  4. Una vez completada, obtén una credencial temporal de descarga y descarga el CSV o ZIP.

Las tareas están limitadas por intervalo temporal, tamaño de archivo, concurrencia y espacio libre. Si falta espacio, la exportación se rechaza o se detiene. Los límites concretos dependen de la configuración del dispositivo.

  • Se admiten históricos adquiridos, agregados y compartidos. No selecciones dos veces el mismo punto del mismo dispositivo.
  • El CSV conserva un indicador de valor nulo para distinguir ausencia de datos de una cadena vacía.
  • Las credenciales de descarga caducan; obtén una nueva si es necesario y no la compartas públicamente.
  • Solo se exportan los datos que aún se conservan dentro del intervalo indicado. No se recuperan históricos eliminados por la política de retención.
Operación Interfaz
Estimar capacidad GET /ems-data/export/disk-space
Crear tarea / consultar lista POST /ems-data/export/tasks / GET /ems-data/export/tasks
Consultar / cancelar una tarea GET /ems-data/export/tasks/:taskId / DELETE /ems-data/export/tasks/:taskId
Obtener credencial de descarga POST /ems-data/export/tasks/:taskId/download-ticket

Al crear una tarea, proporciona format (CSV o CSV_ZIP), dataKeys, startTime y endTime. Solo se puede descargar cuando la tarea termina correctamente; su aceptación no implica que el archivo ya exista.

Utiliza Consultas históricas para análisis puntuales, Archivado periódico para conservación continua y Copia de seguridad y restauración para migrar configuraciones. Consulta las llamadas mediante agentes en la Skill de exportación.