Génération de rapports externes

Exportez les données de vos centrales depuis Mirox vers votre propre chaîne de reporting, afin de créer des rapports à votre image, d'alimenter des outils de business intelligence ou de respecter un format que les rapports intégrés ne couvrent pas.

Ouvrir dans Mirox

Export de données ▸ Modèles pour choisir ou créer les colonnes de votre rapport, puis Export de données ▸ Constructeur API pour le lien que lit votre outil.

Pourquoi créer des rapports en dehors de Mirox ?

Mirox dispose de ses propres rapports, avec modèles, chapitres, votre logo et cinq formats de téléchargement. Exporter les données est pertinent lorsque :

  1. Mise en page — vous avez besoin d'une mise en page ou d'une identité visuelle au-delà de ce qu'offre la conception des rapports.
  2. Autres données — vous combinez les données de Mirox avec celles d'autres systèmes dans un seul rapport.
  3. Vos outils — votre organisation travaille avec Power BI, Tableau ou des modèles Excel.
  4. Réglementation — un rapport doit suivre un format ou un calcul prescrit.
  5. Flux de travail — les rapports doivent passer par un processus documentaire ou de validation existant.

Ce que vous pouvez exporter

DonnéesCommentFormat
Indicateurs sous forme de séries temporelles — production, irradiation, disponibilité, pertes, par centrale, composant, capteur, éolienne ou niveau de batterieMetric ExportCSV, JSON
Informations de centrale — données de base, emplacement, puissance crêteInformations de centraleJSON
Événements — avec période et prioritéÉvénementsCSV
Un rapport terminé avec tous ses tableauxtéléchargement Excel, CSV ou JSON d'un rapportExcel, CSV (ZIP), JSON

Le chemin vers un lien de rapport

  1. Choisissez les colonnes. Ouvrez Export de données ▸ Modèles. Utilisez un modèle système tel que Rapport technique, ou créez un modèle avec les indicateurs dont votre rapport a besoin. Un modèle maintient les colonnes et leur ordre fixes : le programme qui lit le fichier reste donc stable.
  2. Obtenez le lien. Ouvrez Export de données ▸ Constructeur API, choisissez le modèle et les centrales, puis définissez la période et le pas. La page affiche le lien et un aperçu.
  3. Choisissez les identifiants comme en-têtes de colonne si un programme lit le fichier. Les identifiants ne changent pas lorsqu'un indicateur est renommé ou que la langue change.
  4. Créez un jeton. Essayer crée un jeton d'API du groupe Metric Export et affiche des commandes prêtes à l'emploi.
  5. Lisez le lien depuis votre outil, au rythme dont vous avez besoin. Un lien avec la période Mois précédent fournit à chaque fois le mois complet le plus récent.

Plusieurs centrales dans une seule requête

Un lien couvre plusieurs centrales ou des portefeuilles entiers, regroupés en une colonne par indicateur ou avec une colonne par centrale. Voir Plusieurs centrales.

Anciens modèles

Un modèle créé avant le Metric Export porte le badge Ancien dans l'onglet Modèles. Son lien continue de fonctionner et fournit les mêmes colonnes qu'auparavant. Convertir en nouveau modèle crée un nouveau modèle à partir de celui-ci sans modifier l'ancien : vous pouvez ainsi migrer votre rapport quand cela vous convient. Voir Anciens modèles et conversion.

Route obsolète

La route pour une seule centrale sous /v1/export/report/{park_uid}/data/template/… est obsolète. Utilisez GET /v1/export/series/template/{template_uid} pour les modèles du Metric Export, ou GET /v1/export/metrics/template/{template_uid} pour les anciens modèles.

Exemples

Bonnes pratiques

  1. Gardez les jetons hors des fichiers. Chargez le jeton depuis une variable d'environnement, et utilisez un jeton du groupe Metric Export, qui peut lire les exports et rien d'autre.
  2. Demandez les identifiants comme en-têtes de colonne dans tout ce qu'un programme lit.
  3. Utilisez les mêmes périodes dans tous les rapports qui sont comparés entre eux.
  4. Traitez les cellules vides comme « pas de données ». L'export laisse une cellule vide lorsqu'il n'y a pas de valeur ; il n'écrit jamais zéro à sa place.
  5. Lisez les remarques. Elles vous disent ce que Mirox a fait de lui-même, par exemple qu'une centrale que vous ne pouvez pas lire a été laissée de côté. Voir Remarques.
  6. Vérifiez par rapport à Mirox. Comparez une fois les chiffres d'un nouveau rapport avec les pages de Mirox.

À savoir

  • La taille d'un export est bornée. Un export volumineux se scinde par période, par centrale ou par indicateur — voir Quand un export est trop volumineux.
  • Les données remontent aussi loin que la centrale a été mesurée, au plus tôt à 2020.
  • Les fichiers sont en UTF-8. Certains outils exigent que l'encodage soit indiqué à l'import.

Le séparateur de colonnes et le séparateur décimal doivent différer

Vous choisissez le séparateur de colonnes et le séparateur décimal. Ils ne doivent pas être le même caractère. Les valeurs par défaut (; et ,) conviennent aux outils dont les paramètres régionaux sont français ou allemands.

S'il manque quelque chose dans l'export, écrivez à support@mirox.io.