Esportazione Dati Raw per Excel

L'esportazione raw fornisce le misurazioni così come registrate — qualsiasi finestra temporale, qualsiasi risoluzione (da 5 minuti fino a un giorno), senza vincolo di giornate intere — come CSV che puoi aprire direttamente in Excel o LibreOffice. Questa guida illustra i quattro casi di tutti i giorni: la produzione di un singolo parco, più parchi affiancati, singoli inverter e singole stringhe.

Mentre l'esportazione tramite template è pensata per script di reportistica automatizzati e ripetibili, l'esportazione raw è fatta per l'analisi manuale: porta una finestra in un foglio di calcolo, crea una pivot, un grafico, fatto.

Prerequisiti

Account Mirox con il permesso di leggere il parco che esporti
Token API con il gruppo di permessi Reporting — consulta Utilizzo dei Token API. (In un browser con sessione attiva, il link condivisibile funziona senza token.)

La Via più Semplice: Copia il Link dall'Interfaccia

Non devi mai costruire un URL a mano. Apri Esportazione dati ▸ Dati raw, scegli i tuoi parchi, le metriche, la finestra e la risoluzione — la pagina mostra un'anteprima live dell'URL API che rispecchia esattamente la tua selezione, incluse le scelte dei componenti. Copialo, aggiungi l'header con il tuo token in curl (oppure aprilo semplicemente nel browser), e hai il CSV.

Gli esempi qui sotto mostrano come appaiono quegli URL, così puoi adattarli negli script o salvarne delle varianti nei preferiti.

Le Modalità di Valore

I contatori di energia nei dati raw sono cumulativi — non fanno che crescere. Il parametro value decide cosa finisce nel tuo foglio di calcolo:

`value`	Significato	Usalo per
`plain` (predefinito)	Il contatore così come registrato, che si accumula lungo la finestra di esportazione	Verifiche in stile lettura del contatore
`start_at_zero`	Ogni serie traslata in modo da partire da 0	Confrontare curve di crescita
`use_delta`	La variazione per intervallo — ad es. l'energia prodotta in ogni slot di 15 minuti	Analisi della produzione — è quello che di solito vuoi in Excel

Ricetta 1: Produzione di un Singolo Parco

Una settimana di produzione di rete di un parco a risoluzione di 15 minuti, come energia per intervallo:

curl --compressed "https://service.mirox.io/api/v1/export/raw/query?metrics=raw_grid_energy_total&park=ABC123DEF456&start=2026-07-01T00:00:00Z&end=2026-07-08T00:00:00Z&step=15m&value=use_delta" \
  -H "Authorization: Bearer YOUR_API_TOKEN" -o production_week.csv

Date;Grid Production (Wh)
2026-07-01 00:00;0,00
2026-07-01 00:15;0,00
2026-07-01 06:15;1250,50
...

Un anno intero a 15 minuti funziona allo stesso modo — imposta start/end a un anno di distanza (il selettore nell'app ha i preset Quest'anno e Anno scorso esattamente per questo). È la finestra più grande per serie che l'esportazione consente; per finestre pluriennali passa a step=1h o 1d.

Il catalogo delle metriche raw (id, nomi, unità) è disponibile su GET /v1/metrics/raw; fino a 20 metriche per richiesta, separate da virgola.

Ricetta 2: Confronto Multi-Parco

Più parchi in un unico file, una colonna per parco (multi_park_agg=split):

curl --compressed "https://service.mirox.io/api/v1/export/raw/query?metrics=raw_grid_energy_total&park=ABC123DEF456,DEF456ABC123&start=2026-07-01T00:00:00Z&end=2026-08-01T00:00:00Z&step=1h&value=use_delta&multi_park_agg=split" \
  -H "Authorization: Bearer YOUR_API_TOKEN" -o parks_compare.csv

Date;Sunnyside - Grid Production (Wh);Riverbend - Grid Production (Wh)
2026-07-01 00:00;0,00;0,00
...

multi_park_agg=merge (il predefinito) combina invece i parchi in una sola colonna per metrica — sommata per energia/potenza, mediata per temperature e rapporti.
portfolio=<uid> delimita l'esportazione a tutti i parchi di un portafoglio senza elencarli.
Un'esportazione split è limitata a 50 colonne (metriche × parchi).

Ricetta 3: Singoli Inverter

L'esportazione per componente scende nel dettaglio dei componenti di un solo parco. Gli id delle metriche portano il prefisso comp_raw_ (catalogo: GET /v1/metrics/components?component_type=inverter):

curl --compressed "https://service.mirox.io/api/v1/export/raw/component/query?metrics=comp_raw_inverter_energy_ac&park=ABC123DEF456&component_type=inverter&start=2026-07-01T00:00:00Z&end=2026-07-08T00:00:00Z&step=15m&value=use_delta" \
  -H "Authorization: Bearer YOUR_API_TOKEN" -o inverters.csv

Date;WR 01.01 - Inverter Production (Wh);WR 01.02 - Inverter Production (Wh);...
2026-07-01 06:15;620,25;618,75;...

Senza una selezione components, l'esportazione scorre per pagine tutti gli inverter del parco (page/limit, fino a 50 per pagina).
Per sceglierne alcuni in particolare, passa components=<id1>,<id2>,... — gli id compaiono nel selettore dei componenti dell'interfaccia (e nel suo URL copiato), oppure nella lista components della risposta di esportazione.
component_type=gak funziona in modo identico per i quadri di campo.
multi_component_agg=merge comprime la selezione in una sola colonna (somma per l'energia, media per tensioni/temperature).

Ricetta 4: Singole Stringhe

Stesso endpoint con component_type=string — ideale per verificare una stringa sospetta rispetto alle sue vicine:

curl --compressed "https://service.mirox.io/api/v1/export/raw/component/query?metrics=comp_raw_string_energy&park=ABC123DEF456&component_type=string&components=1084279778457255938&start=2026-07-01T00:00:00Z&end=2026-07-08T00:00:00Z&step=15m&value=use_delta" \
  -H "Authorization: Bearer YOUR_API_TOKEN" -o string.csv

Il modo più semplice per ottenere gli id delle stringhe è il selettore nell'app nella scheda Dati raw (livello di dettaglio Stringa): seleziona le stringhe e poi copia l'URL in anteprima — contiene già la lista components.

Aprire il CSV in Excel

Separatori: i valori predefiniti (; per i campi, , per i decimali) si aprono direttamente in un Excel con localizzazione tedesca o italiana. Per le localizzazioni US/UK passa separator_csv=,&separator_decimal=. — i due devono essere diversi.
Date: i passi sotto il giorno includono l'orario; datetime_format accetta un pattern strftime (ad es. %d.%m.%Y) se la tua localizzazione lo richiede.
Codifica: i file sono in UTF-8; usa Dati ▸ Da testo/CSV se le dieresi appaiono errate.
Intestazioni localizzate: language=de (oppure es, fr, it, pt) traduce i nomi delle colonne.
Dimensione: le risposte grandi vengono compresse in gzip sulla rete quando il client lo accetta — da qui il --compressed negli esempi; i browser lo gestiscono automaticamente.

Limiti

Limite	Valore
Metriche per richiesta	20
Punti dati per serie (livello parco)	180.000 — 5 anni a risoluzione di 15 minuti ci rientrano
Campioni totali (livello parco)	1.800.000 (serie × punti dati per serie)
Punti dati per serie (livello componente)	36.000 — un anno intero a risoluzione di 15 minuti ci rientra
Colonne `split` per parco	50 (metriche × parchi)
Componenti selezionati esplicitamente	50
Colonne `split` per componente	100 (metriche × componenti)

Una richiesta oltre il budget viene rifiutata con 400 e un messaggio che indica il limite — aumenta il passo, accorcia la finestra o riduci la selezione. Il riferimento completo si trova nella Guida all'API di Esportazione Metriche.

Funzionalità Correlate

Generatore di Report Esterni — la controparte basata sull'esportazione tramite template: reportistica Python automatizzata
API di Esportazione Metriche — riferimento completo di parametri e limiti per tutti i percorsi di esportazione
Utilizzo dei Token API — crea il token usato dagli esempi curl
MiroxQL — costruisci metriche derivate per le esportazioni aggregate