Externe Berichtserstellung
Exportieren Sie Ihre Anlagendaten aus Mirox in Ihre eigene Reporting-Pipeline, um Berichte mit individuellem Branding zu erstellen, Business-Intelligence-Werkzeuge zu speisen oder ein Format zu erfüllen, das die integrierten Berichte nicht abdecken.
In Mirox öffnen
Daten-Export ▸ Vorlagen, um die Spalten Ihres Berichts zu wählen oder zu erstellen, danach Daten-Export ▸ API-Builder für den Link, den Ihr Werkzeug liest.
Warum Berichte außerhalb von Mirox erstellen?
Mirox hat eigene Berichte, mit Vorlagen, Kapiteln, Ihrem Logo und fünf Download-Formaten. Die Daten zu exportieren ist sinnvoll, wenn:
- Layout — Sie ein Layout oder Branding brauchen, das über das Berichtsdesign hinausgeht.
- Andere Daten — Sie Mirox-Daten mit Daten anderer Systeme in einem Bericht zusammenführen.
- Ihre Werkzeuge — Ihre Organisation mit Power BI, Tableau oder Excel-Vorlagen arbeitet.
- Regulierung — ein Bericht einem vorgeschriebenen Format oder einer vorgeschriebenen Berechnung folgen muss.
- Arbeitsablauf — Berichte einen bestehenden Dokumenten- oder Freigabeprozess durchlaufen müssen.
Was Sie exportieren können
| Daten | Wie | Format |
|---|---|---|
| Metriken als Zeitreihe — Produktion, Einstrahlung, Verfügbarkeit, Verluste, je Anlage, Komponente, Sensor, Turbine oder Batterieebene | Metric Export | CSV, JSON |
| Anlageninformationen — Stammdaten, Standort, Spitzenleistung | Anlageninformationen | JSON |
| Ereignisse — mit Zeitraum und Priorität | Ereignisse | CSV |
| Ein fertiger Bericht mit allen seinen Tabellen | Download Excel, CSV oder JSON eines Berichts | Excel, CSV (ZIP), JSON |
Der Weg zu einem Berichts-Link
- Spalten wählen. Öffnen Sie Daten-Export ▸ Vorlagen. Nutzen Sie eine Systemvorlage wie Technischer Bericht oder erstellen Sie eine Vorlage mit den Metriken, die Ihr Bericht braucht. Eine Vorlage hält die Spalten und ihre Reihenfolge fest, sodass das Programm, das die Datei liest, stabil bleibt.
- Link holen. Öffnen Sie Daten-Export ▸ API-Builder, wählen Sie die Vorlage und die Anlagen und legen Sie Zeitraum und Schrittweite fest. Die Seite zeigt den Link und eine Vorschau.
- IDs als Spaltenköpfe wählen, wenn ein Programm die Datei liest. IDs ändern sich nicht, wenn eine Metrik umbenannt wird oder die Sprache wechselt.
- Token erstellen. Ausprobieren erstellt ein API-Token der Gruppe Metric Export und zeigt fertige Befehle.
- Link lesen — aus Ihrem Werkzeug, in dem Rhythmus, den Sie brauchen. Ein Link mit dem Zeitraum Vormonat liefert jedes Mal den jüngsten vollständigen Monat.
Mehrere Anlagen in einer Anfrage
Ein Link umfasst mehrere Anlagen oder ganze Portfolios, zusammengefasst zu einer Spalte je Metrik oder mit einer Spalte je Anlage. Siehe Mehrere Anlagen.
Legacy-Vorlagen
Eine Vorlage, die vor dem Metric Export erstellt wurde, trägt auf dem Tab Vorlagen die Kennzeichnung Legacy. Ihr Link funktioniert weiter und liefert dieselben Spalten wie bisher. In neue Vorlage umwandeln erstellt daraus eine neue Vorlage, ohne die Legacy-Vorlage zu verändern, sodass Sie Ihren Bericht umstellen können, wann es Ihnen passt. Siehe Legacy-Vorlagen und Umwandlung.
Veraltete Route
Die Route für eine einzelne Anlage unter /v1/export/report/{park_uid}/data/template/… ist veraltet. Nutzen Sie GET /v1/export/series/template/{template_uid} für Vorlagen des Metric Export oder GET /v1/export/metrics/template/{template_uid} für Legacy-Vorlagen.
Beispiele
- Externer Berichtsgenerator — die Anfragen mit curl und ein vollständiges Python-Skript, das einen PDF-Bericht erstellt.
- Metric Export für Excel — fertige Links und die Power-Query-Verbindung für Arbeitsmappen, die sich selbst aktualisieren.
Bewährte Praxis
- Halten Sie Tokens aus Dateien heraus. Laden Sie das Token aus einer Umgebungsvariablen und nutzen Sie ein Token der Gruppe Metric Export, das Exporte lesen kann und sonst nichts.
- Fordern Sie IDs als Spaltenköpfe an — bei allem, was ein Programm liest.
- Nutzen Sie dieselben Zeiträume in allen Berichten, die miteinander verglichen werden.
- Behandeln Sie leere Zellen als „keine Daten“. Der Export lässt eine Zelle leer, wenn es keinen Wert gibt; er schreibt an ihrer Stelle nie null.
- Lesen Sie die Hinweise. Sie sagen Ihnen, was Mirox von sich aus getan hat, zum Beispiel dass eine Anlage, die Sie nicht lesen können, ausgelassen wurde. Siehe Hinweise.
- Gleichen Sie mit Mirox ab. Vergleichen Sie die Zahlen eines neuen Berichts einmal mit den Seiten in Mirox.
Wissenswertes
- Ein Export ist in seiner Größe begrenzt. Ein großer Export wird nach Zeit, Anlage oder Metrik aufgeteilt — siehe Wenn ein Export zu groß ist.
- Die Daten reichen so weit zurück, wie die Anlage gemessen wird, frühestens bis 2020.
- Die Dateien sind UTF-8. Manche Werkzeuge brauchen beim Import die Angabe der Kodierung.
Spaltentrennzeichen und Dezimaltrennzeichen müssen sich unterscheiden
Sie wählen das Spaltentrennzeichen und das Dezimaltrennzeichen. Sie dürfen nicht dasselbe Zeichen sein. Die Standardwerte (; und ,) passen zu Werkzeugen mit deutschen Regionaleinstellungen.
Wenn im Export etwas fehlt, schreiben Sie an support@mirox.io.
Verwandte Funktionen
- Metric Export — die Seite Daten-Export
- Metric-Export-API — jeder Parameter, jede Grenze und jeder Fehler
- Legacy-Export-API — die bisherigen Links, Anlageninformationen und Ereignisse
- Berichte — die Berichte, die Mirox selbst erstellt
- API-Token-Nutzung — das Token erstellen, das Ihre Werkzeuge verwenden