Externe Reporterstellung

Exportieren Sie Ihre Anlagendaten aus Mirox in Ihre eigene Reporting-Pipeline, um Reports mit individuellem Branding zu erstellen, Business-Intelligence-Tools zu speisen oder ein regulatorisches Format abzudecken, das die integrierten Reports nicht bieten. Diese Anleitung erklärt, welche Exportmöglichkeiten Sie nutzen sollten, wenn Sie Reports außerhalb der Plattform erstellen möchten.

In Mirox öffnen: Datenexport ▸ Builder — öffnen Sie die Seite „Datenexport" und wählen Sie den Tab Builder, um einen Export interaktiv zusammenzustellen, oder wechseln Sie zum Tab Vorlagen, um ein gespeichertes Spaltenlayout wiederzuverwenden.

Warum externe Reporterstellung nutzen?

Die Plattform bietet integrierte Reports, doch das Exportieren von Daten für Ihre eigene Pipeline ist sinnvoll, wenn:

Erweiterte Anpassung — Sie eine bestimmte Formatierung oder ein Branding benötigen, das über die integrierten Report-Optionen hinausgeht.
Datenintegration — Sie Mirox-Daten mit Informationen aus anderen Systemen in einem einzigen Report kombinieren möchten.
Business-Intelligence-Tools — Ihre Organisation bereits Tools wie Power BI, Tableau oder eigene Excel-Vorlagen verwendet.
Regulatorische Anforderungen — Sie Reports erstellen müssen, die einem bestimmten regulatorischen Format oder einer bestimmten Berechnung folgen.
Workflow-Integration — Reports in einen bestehenden Dokumentenmanagement- oder Freigabe-Workflow passen müssen.

Exportmöglichkeiten

Die Plattform stellt ihre Daten über eine REST-API bereit, sodass Sie genau das abrufen können, was Ihr Reporting-Tool benötigt:

Anlageninformationen — Metadaten, technische Spezifikationen und Konfigurationsdetails.
Betriebsereignisse — gefiltert nach Zeitraum und Priorität.
Leistungsmetriken — aggregiert auf der von Ihnen gewählten Auflösung (täglich, wöchentlich, monatlich, quartalsweise oder jährlich).
Standardformate — CSV und JSON, bereit für gängige Business-Intelligence-Tools.
Flexible Zeitfilterung — nach Jahr, Quartal, Monat, Woche oder einem einzelnen Tag.
Individuelle Vorlagen — legen Sie fest, welche Metriken jeder Export enthält, sodass die Spalten zu Ihrem Report-Layout passen.

Der maßgebliche Metrik-Export

Für Produktions- und Leistungskennzahlen verwenden Sie den vorlagenbasierten Metrik-Export:

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

Dies ist der empfohlene Weg für die externe Reporterstellung. Er liefert eine CSV-Datei, deren Spalten durch eine Export-Vorlage definiert sind — eine geordnete Liste von Metriken, die Sie (oder die integrierten Systemvorlagen der Plattform) ausgewählt haben. Spaltenreihenfolge, Einheiten und übersetzte Spaltenüberschriften folgen exakt der Vorlage, sodass Ihr nachgelagerter Parser stabil bleibt.

Eine Vorlage ohne Code erstellen

Sie müssen die Anfrage nicht von Hand erstellen. Öffnen Sie die Seite „Datenexport" in Mirox, wählen Sie im Tab Builder Ihre Metriken und Auflösung aus und speichern Sie diese anschließend im Tab Vorlagen, um eine wiederverwendbare Vorlage für den obigen API-Aufruf zu erhalten.

Mehrere Anlagen in einer Anfrage exportieren

Ein einzelner Aufruf kann mehrere Anlagen oder ganze Portfolios abdecken, indem Sie kommagetrennte park- und portfolio-Query-Parameter übergeben. Das ermöglicht Reporting auf Portfolio-Ebene ohne einen separaten Aufruf je Anlage, wobei die Daten auf die von Ihnen gewählte Auflösung aggregiert werden. Die vollständige Parameterreferenz finden Sie im Leitfaden zur Metrik-Export-API.

Den aktuellen Pfad verwenden

Ein älterer Pfad für einzelne Anlagen unter /v1/export/report/{park_uid}/data/template/... ist veraltet. Neue Integrationen sollten /v1/export/metrics/template/{template_uid} verwenden, das mehrere Anlagen, zusätzliche Auflösungen und locale-bewusste Ausgaben unterstützt. Den aktuellen Vertrag finden Sie in der Live-API-Dokumentation unter service.mirox.io/docs.

Für Exporte von Anlagenmetadaten und Ereignissen bleiben die Info- und Ereignis-Pfade unter /v1/export/report/... verfügbar und werden in den API-Beispielen unten gezeigt.

API-Beispiele

Lauffähige Beispiele für die Export-APIs — Endpunkte, curl-Aufrufe, Anfrage- und Antwortformate sowie einen vollständigen Python-Report-Generator — finden Sie unter API-Beispiele zur externen Reporterstellung.

Best Practices

Für eine effektive externe Reporterstellung:

API-Tokens sicher verwenden — Tokens niemals fest in Skripte einbetten; laden Sie sie aus Umgebungsvariablen. Siehe API-Token-Nutzung.
Wiederkehrende Reports automatisieren — planen Sie Skripte so, dass sie in regelmäßigen Abständen laufen, für konsistentes Reporting.
Gründlich testen — überprüfen Sie, ob die exportierten Daten korrekt in Ihren Reports erscheinen, bevor Sie sich darauf verlassen.
Ihre Verarbeitungslogik dokumentieren — halten Sie alle angewandten Datentransformationen klar fest.
Berechnungen validieren — gleichen Sie abgeleitete Metriken mit den Mirox-Dashboards ab.
Einheitliche Zeiträume anwenden — verwenden Sie über Reports hinweg dieselben Zeiträume, damit die Ergebnisse vergleichbar bleiben.

Zu beachten

Beim Arbeiten mit exportierten Daten:

API-Ratenbegrenzungen gelten wie bei anderen Mirox-Endpunkten.
Die Verfügbarkeit historischer Daten hängt davon ab, wie lange die Anlage bereits Daten erfasst.
CSV-Exporte verwenden UTF-8-Kodierung, die manche Tools beim Import explizit eingestellt haben müssen.

CSV-Trennzeichen und Dezimaltrennzeichen müssen sich unterscheiden

Beim Metrik-Export können Sie das CSV-Feldtrennzeichen und das Dezimaltrennzeichen wählen. Sie dürfen nicht dasselbe Zeichen sein, sonst lässt sich die Ausgabe nicht parsen. Die Standardwerte (; als Feldtrennzeichen, , als Dezimaltrennzeichen) sind für Tools im deutschen Format sicher.

Wenn Sie auf Probleme beim Datenexport stoßen oder zusätzliche Formate oder Metriken vorschlagen möchten, wenden Sie sich an unser Team unter support@mirox.io.