Aller au contenu
JelinaJelina DocumentationDocumentation technique
Retour au site officiel

Export des données historiques

L’export génère les fichiers en arrière-plan pour conserver les données brutes détaillées ou les analyser avec d’autres outils, sans maintenir le navigateur en attente de la requête.

  1. Sélectionnez les points et la plage temporelle ; pour les points partagés, indiquez l’équipement source.
  2. Consultez l’estimation d’espace disque, puis créez la tâche d’export.
  3. Suivez son état dans la liste : en attente, en cours, terminée ou échouée. Annulez-la si elle n’est plus nécessaire.
  4. Après réussite, obtenez un justificatif de téléchargement temporaire, puis téléchargez le CSV ou ZIP.

Les tâches sont limitées par la plage temporelle, la taille du fichier, la concurrence et l’espace libre. Un espace insuffisant entraîne le refus ou l’arrêt de l’export ; les limites dépendent de la configuration de l’équipement.

  • Historique acquis, agrégé et partagé pris en charge ; ne sélectionnez pas plusieurs fois le même point d’un équipement.
  • Le CSV conserve un marqueur nul pour distinguer absence de données et chaîne vide.
  • Le justificatif de téléchargement expire ; obtenez-en un nouveau après expiration et ne le partagez pas publiquement.
  • L’export couvre les données encore conservées dans la plage demandée ; l’historique supprimé par la rétention ne peut pas être récupéré.
Opération Interface
Estimation d’espace GET /ems-data/export/disk-space
Créer / lister les tâches POST /ems-data/export/tasks / GET /ems-data/export/tasks
Consulter / annuler une tâche GET /ems-data/export/tasks/:taskId / DELETE /ems-data/export/tasks/:taskId
Obtenir un justificatif de téléchargement POST /ems-data/export/tasks/:taskId/download-ticket

À la création, transmettez format (CSV ou CSV_ZIP), dataKeys, startTime et endTime. Le téléchargement n’est disponible qu’après réussite ; l’acceptation de la tâche ne signifie pas que le fichier est généré.

Pour une analyse ponctuelle, utilisez Historique ; pour une conservation continue, Archivage périodique ; pour migrer la configuration, Sauvegarde et restauration. Le Skill d’export décrit les appels par agent.