Generazione di report esterni

Esporta i dati dei tuoi impianti da Mirox verso la tua pipeline di reportistica, così da poter creare report personalizzati, alimentare strumenti di business intelligence o soddisfare un formato normativo che i report integrati non coprono. Questa guida spiega quali funzionalità di esportazione utilizzare quando devi generare report al di fuori della piattaforma.

Apri in Mirox: Esportazione dati ▸ Builder — apri la pagina Esportazione dati e seleziona la scheda Builder per comporre un export in modo interattivo, oppure passa alla scheda Templates per riutilizzare un layout di colonne salvato.

Perché usare la generazione di report esterni?

La piattaforma offre report integrati, ma esportare i dati per la tua pipeline ha senso quando:

  1. Personalizzazione avanzata — hai bisogno di una formattazione o di un branding specifici, oltre le opzioni dei report integrati.
  2. Integrazione dei dati — vuoi combinare i dati Mirox con informazioni provenienti da altri sistemi in un unico report.
  3. Strumenti di business intelligence — la tua organizzazione utilizza già strumenti come Power BI, Tableau o template Excel personalizzati.
  4. Requisiti normativi — devi produrre report che seguono un formato o un calcolo normativo specifico.
  5. Integrazione nel flusso di lavoro — i report devono inserirsi in un flusso di lavoro esistente di gestione documentale o di approvazione.

Funzionalità di esportazione

La piattaforma espone i propri dati tramite un'API REST, così puoi estrarre esattamente ciò di cui il tuo strumento di reportistica ha bisogno:

  • Informazioni sull'impianto — metadati, specifiche tecniche e dettagli di configurazione.
  • Eventi operativi — filtrati per periodo e priorità.
  • Metriche di prestazione — aggregate secondo la risoluzione scelta (giornaliera, settimanale, mensile, trimestrale o annuale).
  • Formati standard — CSV e JSON, pronti per i comuni strumenti di business intelligence.
  • Filtraggio temporale flessibile — per anno, trimestre, mese, settimana o singolo giorno.
  • Template personalizzati — definisci quali metriche includere in ciascun export, così le colonne corrispondono al layout del tuo report.

L'esportazione canonica delle metriche

Per i dati di produzione e prestazione, utilizza l'esportazione delle metriche basata su template:

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

Questo è il percorso consigliato per la generazione di report esterni. Restituisce un CSV le cui colonne sono definite da un template di export — un elenco ordinato di metriche che tu (o i template di sistema integrati della piattaforma) hai scelto. L'ordine delle colonne, le unità di misura e le intestazioni tradotte seguono esattamente il template, così il parser a valle rimane stabile.

Crea un template senza scrivere codice

Non devi costruire la richiesta a mano. Apri la pagina Esportazione dati in Mirox, usa la scheda Builder per scegliere le tue metriche e la risoluzione, quindi salvalo nella scheda Templates per ottenere un template riutilizzabile per la chiamata API qui sopra.

Esportazione multi-impianto in un'unica richiesta

Una singola chiamata può coprire più impianti o interi portafogli passando i parametri di query park e portfolio separati da virgola. Questo abilita la reportistica a livello di portafoglio senza una chiamata separata per ogni impianto, con i dati aggregati secondo la risoluzione scelta. Consulta la Guida all'API di esportazione delle metriche per il riferimento completo dei parametri.

Usa il percorso corrente

Un vecchio percorso per singolo impianto sotto /v1/export/report/{park_uid}/data/template/... è deprecato. Le nuove integrazioni dovrebbero usare /v1/export/metrics/template/{template_uid}, che supporta più impianti, risoluzioni aggiuntive e output sensibile alla localizzazione. Consulta la documentazione live dell'API su service.mirox.io/docs per il contratto corrente.

Per i metadati degli impianti e l'esportazione degli eventi, i percorsi info ed events sotto /v1/export/report/... rimangono disponibili e sono mostrati negli esempi API qui sotto.

Esempi API

Per esempi eseguibili delle API di esportazione — endpoint, chiamate curl, formati di richiesta e risposta e un generatore di report Python completo — consulta Esempi API per la generazione di report esterni.

Buone pratiche

Per una generazione efficace di report esterni:

  1. Usa i token API in modo sicuro — non inserire mai i token direttamente negli script; caricali da variabili d'ambiente. Consulta Uso dei token API.
  2. Automatizza i report ricorrenti — pianifica l'esecuzione degli script a intervalli regolari per una reportistica coerente.
  3. Esegui test approfonditi — verifica che i dati esportati appaiano correttamente nei tuoi report prima di farci affidamento.
  4. Documenta la tua logica di elaborazione — mantieni una registrazione chiara di qualsiasi trasformazione dei dati applicata.
  5. Valida i calcoli — confronta le metriche derivate con le dashboard Mirox.
  6. Applica intervalli temporali coerenti — usa gli stessi intervalli di date nei report, così i risultati restano confrontabili.

Considerazioni

Quando lavori con i dati esportati:

  • I limiti di frequenza dell'API si applicano come per gli altri endpoint Mirox.
  • La disponibilità dei dati storici dipende da quanto tempo l'impianto raccoglie dati.
  • Gli export CSV usano la codifica UTF-8, che alcuni strumenti richiedono di impostare esplicitamente all'importazione.

Il separatore CSV e il separatore decimale devono essere diversi

L'esportazione delle metriche ti permette di scegliere il separatore di campo CSV e il separatore decimale. Non devono essere lo stesso carattere, altrimenti l'output non può essere analizzato. I valori predefiniti (separatore di campo ;, decimale ,) sono sicuri per gli strumenti con localizzazione tedesca.

Se riscontri problemi con le esportazioni dei dati o vuoi suggerire formati o metriche aggiuntivi, contatta il nostro team all'indirizzo support@mirox.io.

Funzionalità correlate

MIT Licensed | Copyright 2026 Mirox Verwaltungs GmbH