Generazione di report esterni
Esporta i dati dei tuoi impianti da Mirox nella tua pipeline di reportistica, così puoi creare report con il tuo marchio, alimentare strumenti di business intelligence o rispettare un formato che i report integrati non coprono.
Apri in Mirox
Esportazione dati ▸ Template per scegliere o creare le colonne del tuo report, poi Esportazione dati ▸ Costruttore API per il link letto dal tuo strumento.
Perché creare report fuori da Mirox?
Mirox ha i propri report, con modelli, capitoli, il tuo logo e cinque formati di download. Esportare i dati ha senso quando:
- Layout — ti serve un layout o un marchio che va oltre ciò che lo stile del report offre.
- Altri dati — combini i dati di Mirox con quelli di altri sistemi in un solo report.
- I tuoi strumenti — la tua organizzazione lavora con Power BI, Tableau o modelli Excel.
- Normativa — un report deve seguire un formato o un calcolo prescritto.
- Flusso di lavoro — i report devono passare attraverso un processo documentale o di approvazione esistente.
Che cosa puoi esportare
| Dati | Come | Formato |
|---|---|---|
| Metriche come serie temporali — produzione, irradiazione, disponibilità, perdite, per impianto, componente, sensore, turbina o livello di batteria | Metric Export | CSV, JSON |
| Informazioni sull'impianto — dati anagrafici, posizione, potenza di picco | Informazioni sull'impianto | JSON |
| Eventi — con periodo e priorità | Eventi | CSV |
| Un report finito con tutte le sue tabelle | download Excel, CSV o JSON di un report | Excel, CSV (ZIP), JSON |
La strada verso il link di un report
- Scegli le colonne. Apri Esportazione dati ▸ Template. Usa un modello di sistema come Report tecnico, oppure crea un modello con le metriche che servono al tuo report. Un modello mantiene fisse le colonne e il loro ordine, così il programma che legge il file resta stabile.
- Ottieni il link. Apri Esportazione dati ▸ Costruttore API, scegli il modello e gli impianti e imposta periodo e passo. La pagina mostra il link e un'anteprima.
- Scegli gli ID come intestazioni di colonna se il file viene letto da un programma. Gli ID non cambiano quando una metrica viene rinominata o la lingua cambia.
- Crea un token. Prova crea un token API del gruppo Metric Export e mostra comandi pronti all'uso.
- Leggi il link dal tuo strumento, con la cadenza che ti serve. Un link con il periodo Mese precedente fornisce ogni volta il mese completo più recente.
Più impianti in una sola richiesta
Un link copre più impianti o interi portfolio, riuniti in una colonna per metrica oppure con una colonna per impianto. Vedi Più impianti.
Modelli legacy
Un modello creato prima del Metric Export porta il contrassegno Legacy nella scheda Template. Il suo link continua a funzionare e fornisce le stesse colonne di prima. Converti in nuovo modello crea da esso un nuovo modello senza modificare quello legacy, così puoi spostare il tuo report quando ti è comodo. Vedi Modelli legacy e conversione.
Route deprecata
La route per un solo impianto sotto /v1/export/report/{park_uid}/data/template/… è deprecata. Usa GET /v1/export/series/template/{template_uid} per i modelli del Metric Export, oppure GET /v1/export/metrics/template/{template_uid} per i modelli legacy.
Esempi
- Generatore di report esterni — le richieste con curl e uno script Python completo che costruisce un report PDF.
- Metric Export per Excel — link pronti all'uso e la connessione Power Query per cartelle di lavoro che si aggiornano da sole.
Buone pratiche
- Tieni i token fuori dai file. Carica il token da una variabile d'ambiente e usa un token del gruppo Metric Export, che può leggere le esportazioni e nient'altro.
- Richiedi gli ID come intestazioni di colonna in tutto ciò che viene letto da un programma.
- Usa gli stessi periodi in tutti i report che vengono confrontati tra loro.
- Tratta le celle vuote come «nessun dato». L'esportazione lascia vuota una cella quando non c'è alcun valore; non scrive mai zero al suo posto.
- Leggi le note. Ti dicono che cosa Mirox ha fatto di propria iniziativa, ad esempio che un impianto che non puoi leggere è stato escluso. Vedi Note.
- Confronta con Mirox. Confronta una volta i valori di un nuovo report con le pagine in Mirox.
Cose da sapere
- Un'esportazione ha una dimensione limitata. Un'esportazione grande viene divisa per tempo, impianto o metrica — vedi Quando un'esportazione è troppo grande.
- I dati risalgono fin dove l'impianto è stato misurato, al più presto al 2020.
- I file sono in UTF-8. Alcuni strumenti richiedono di indicare la codifica all'importazione.
Il separatore di colonna e il separatore decimale devono essere diversi
Scegli tu il separatore di colonna e il separatore decimale. Non devono essere lo stesso carattere. I valori predefiniti (; e ,) sono adatti agli strumenti con impostazioni internazionali italiane o tedesche.
Se nell'esportazione manca qualcosa, scrivi a support@mirox.io.
Funzionalità correlate
- Metric Export — la pagina Esportazione dati
- Metric Export API — ogni parametro, limite ed errore
- API di esportazione legacy — i link precedenti, le informazioni sull'impianto e gli eventi
- Report — i report che Mirox genera da sé
- Utilizzo dei token API — crea il token usato dai tuoi strumenti