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 personnalisés, d'alimenter des outils de business intelligence ou de répondre à un format réglementaire que les rapports intégrés ne couvrent pas. Ce guide explique quelles capacités d'export utiliser lorsque vous devez générer des rapports en dehors de la plateforme.

Ouvrir dans Mirox : Export de données ▸ Constructeur — ouvrez la page Export de données et choisissez l'onglet Constructeur pour assembler un export de manière interactive, ou basculez sur l'onglet Modèles pour réutiliser une disposition de colonnes enregistrée.

Pourquoi utiliser la génération de rapports externes ?

La plateforme propose des rapports intégrés, mais exporter les données vers votre propre chaîne est pertinent lorsque :

  1. Personnalisation avancée — vous avez besoin d'une mise en forme ou d'une identité visuelle spécifique au-delà des options de rapport intégrées.
  2. Intégration de données — vous souhaitez combiner les données Mirox avec des informations provenant d'autres systèmes dans un seul rapport.
  3. Outils de business intelligence — votre organisation utilise déjà des outils tels que Power BI, Tableau ou des modèles Excel personnalisés.
  4. Exigences réglementaires — vous devez produire des rapports conformes à un format ou à un calcul réglementaire précis.
  5. Intégration au flux de travail — les rapports doivent s'insérer dans un flux existant de gestion documentaire ou de validation.

Capacités d'export

La plateforme expose ses données via une API REST afin que vous puissiez extraire exactement ce dont votre outil de reporting a besoin :

  • Informations sur la centrale — métadonnées, spécifications techniques et détails de configuration.
  • Événements d'exploitation — filtrés par période et par priorité.
  • Métriques de performance — agrégées selon la résolution de votre choix (quotidienne, hebdomadaire, mensuelle, trimestrielle ou annuelle).
  • Formats standard — CSV et JSON, prêts pour les outils de business intelligence courants.
  • Filtrage temporel flexible — par année, trimestre, mois, semaine ou journée unique.
  • Modèles personnalisés — définissez quelles métriques chaque export inclut, pour que les colonnes correspondent à la mise en page de votre rapport.

L'export de métriques canonique

Pour les chiffres de production et de performance, utilisez l'export de métriques basé sur un modèle :

GET /v1/export/metrics/template/{template_uid}

C'est la route recommandée pour la génération de rapports externes. Elle renvoie un CSV dont les colonnes sont définies par un modèle d'export — une liste ordonnée de métriques que vous (ou les modèles système intégrés à la plateforme) avez choisies. L'ordre des colonnes, les unités et les en-têtes traduits suivent exactement le modèle, de sorte que votre analyseur en aval reste stable.

Créer un modèle sans écrire de code

Vous n'avez pas à construire la requête à la main. Ouvrez la page Export de données dans Mirox, utilisez l'onglet Constructeur pour choisir vos métriques et votre résolution, puis enregistrez-le sous l'onglet Modèles afin d'obtenir un modèle réutilisable pour l'appel d'API ci-dessus.

Export multi-centrales en une seule requête

Un seul appel peut couvrir plusieurs centrales ou des portefeuilles entiers en passant les paramètres de requête park et portfolio séparés par des virgules. Cela permet un reporting au niveau du portefeuille sans appel distinct par centrale, avec les données agrégées selon la résolution de votre choix. Consultez le Guide de l'API d'export de métriques pour la référence complète des paramètres.

Utilisez la route actuelle

Une ancienne route mono-centrale sous /v1/export/report/{park_uid}/data/template/... est dépréciée. Les nouvelles intégrations doivent utiliser /v1/export/metrics/template/{template_uid}, qui prend en charge plusieurs centrales, des résolutions supplémentaires et une sortie adaptée à la locale. Vérifiez la documentation d'API en direct sur service.mirox.io/docs pour le contrat actuel.

Pour les exports de métadonnées de centrale et d'événements, les routes info et events sous /v1/export/report/... restent disponibles et sont présentées dans les exemples d'API ci-dessous.

Exemples d'API

Pour des exemples exécutables des API d'export — endpoints, appels curl, formats de requête et de réponse, et un générateur de rapports Python complet — consultez Exemples d'API de génération de rapports externes.

Bonnes pratiques

Pour une génération de rapports externes efficace :

  1. Utilisez les jetons d'API de manière sécurisée — ne codez jamais les jetons en dur dans les scripts ; chargez-les depuis des variables d'environnement. Consultez Utilisation des jetons d'API.
  2. Automatisez les rapports récurrents — planifiez l'exécution des scripts à intervalles réguliers pour un reporting cohérent.
  3. Testez minutieusement — vérifiez que les données exportées apparaissent correctement dans vos rapports avant de vous y fier.
  4. Documentez votre logique de traitement — conservez une trace claire de toutes les transformations de données que vous appliquez.
  5. Validez les calculs — recoupez les métriques dérivées avec les tableaux de bord Mirox.
  6. Appliquez des périodes cohérentes — utilisez les mêmes plages de dates d'un rapport à l'autre pour que les résultats restent comparables.

Points à considérer

Lorsque vous travaillez avec des données exportées :

  • Des limites de débit s'appliquent comme pour les autres endpoints Mirox.
  • La disponibilité des données historiques dépend de la durée pendant laquelle la centrale a collecté des données.
  • Les exports CSV utilisent l'encodage UTF-8, que certains outils exigent de définir explicitement à l'import.

Le séparateur CSV et le séparateur décimal doivent différer

L'export de métriques vous laisse choisir le séparateur de champ CSV et le séparateur décimal. Ils ne doivent pas être le même caractère, sinon la sortie ne peut pas être analysée. Les valeurs par défaut (; comme séparateur de champ, , comme séparateur décimal) conviennent aux outils en locale française.

Si vous rencontrez des problèmes avec les exports de données ou souhaitez proposer des formats ou des métriques supplémentaires, contactez notre équipe à support@mirox.io.

Fonctionnalités associées

MIT Licensed | Copyright 2026 Mirox Verwaltungs GmbH