Metric Export per Excel

Il Metric Export fornisce qualsiasi metrica dei tuoi impianti come file CSV che Excel e LibreOffice aprono direttamente. Questa pagina mostra i casi di tutti i giorni come link pronti all'uso e spiega come collegare Excel a un link, così che una cartella di lavoro si aggiorni da sola.

Prerequisiti

Un account Mirox che possa leggere le misure dell'impianto che esporti.
Un token API del gruppo Metric Export — vedi Utilizzo dei token API. In un browser in cui hai effettuato l'accesso, un link funziona senza token.

Il modo più semplice: copia il link dall'app

Non devi costruire un link a mano.

Apri in Mirox

Esportazione dati ▸ Metriche — scegli impianti, metriche, periodo e passo. L'URL API sotto l'anteprima è il link esattamente di quella selezione, compresi i componenti che hai scelto. Prova prepara un token e comandi pronti all'uso.

Le ricette seguenti mostrano che aspetto hanno questi link, così puoi adattarli.

Ricetta 1: produzione di un impianto a 15 minuti

Una settimana di immissione in rete, come energia per quarto d'ora:

curl --compressed "https://service.mirox.io/api/v1/export/series?park=ABC123DEF456&metrics=plant.grid_feedin&start=2026-07-01&end=2026-07-07&step=15min&values=delta" \
  -H "Authorization: Bearer YOUR_API_TOKEN" -o production_week.csv

Date;UTC offset;Grid feed-in (kWh)
2026-07-01 00:00;+02:00;0,0
2026-07-01 00:15;+02:00;0,0
2026-07-01 06:15;+02:00;1,3
...

Gli orari sono l'ora locale dell'impianto. La colonna Scostamento UTC rende ogni riga univoca, anche nel giorno in cui cambia l'ora. offset_column=false la omette; tz=utc esporta in UTC.
end=2026-07-07 include il 7 luglio.
Per una curva della potenza invece dell'energia, esporta plant.grid_power.

Ricetta 2: il mese precedente, ogni mese

Un link con un periodo predefinito fornisce sempre il periodo completo più recente. Questo è il link per una cartella di lavoro che viene aggiornata una volta al mese:

curl --compressed "https://service.mirox.io/api/v1/export/series?park=ABC123DEF456&metrics=plant.grid_feedin,plant.rad_pyranometer,availability.inverter_park&window=previous_month&step=day" \
  -H "Authorization: Bearer YOUR_API_TOKEN" -o previous_month.csv

Date;Grid feed-in (kWh);Plant-plane radiation, pyranometer (kWh/m²);Inverter availability (park) (%)
2026-08-01;5321,4;6,8;99,6
...

Ricetta 3: più impianti affiancati

Una colonna per impianto con multi_park_agg=split:

curl --compressed "https://service.mirox.io/api/v1/export/series?park=ABC123DEF456,DEF456ABC123&metrics=plant.grid_feedin&window=previous_month&step=day&multi_park_agg=split" \
  -H "Authorization: Bearer YOUR_API_TOKEN" -o plants_compare.csv

Date;Sunnyside - Grid feed-in (kWh);Riverbend - Grid feed-in (kWh)
2026-08-01;5321,4;4102,9
...

multi_park_agg=merge, il valore predefinito, dà una sola colonna per tutti gli impianti insieme.
portfolio=<uid> sceglie tutti gli impianti di un portfolio.

Ricetta 4: ogni inverter

Una metrica del livello inverter dà una colonna per inverter:

curl --compressed "https://service.mirox.io/api/v1/export/series?park=ABC123DEF456&metrics=inverter.ac&start=2026-07-01&end=2026-07-07&step=15min" \
  -H "Authorization: Bearer YOUR_API_TOKEN" -o inverters.csv

Date;UTC offset;WR 01.01 - AC production per inverter (kWh);WR 01.02 - AC production per inverter (kWh);...
2026-07-01 06:15;+02:00;0,6;0,6;...

Senza una scelta, il file contiene tutti gli inverter, 50 per pagina. lane_page=2 dà i 50 successivi; lane_limit=100 ne dà 100 per pagina.
Per esportare solo determinati inverter, aggiungi components=inverter:1043,inverter:1044. La finestra dei componenti nella scheda Metriche inserisce i riferimenti nel link al posto tuo.
Stringhe e quadri di campo funzionano allo stesso modo, con string.power (energia per stringa) e gak.power (energia per quadro di campo).

Ricetta 5: ogni sensore di irraggiamento

Ogni sensore singolarmente, senza media:

curl --compressed "https://service.mirox.io/api/v1/export/series?park=ABC123DEF456&metrics=sensor.irradiance&window=yesterday&step=15min" \
  -H "Authorization: Bearer YOUR_API_TOKEN" -o sensors.csv

sensor.irradiation dà l'irradiazione per sensore in kWh/m², a ogni passo fino a un anno. Il modello di sistema Sensori di irraggiamento (CAFE1030CAFE) contiene entrambe, insieme all'irradiazione del piranometro dell'impianto.

Ricetta 6: turbine eoliche

Energia e velocità del vento di ogni turbina, per giorno:

curl --compressed "https://service.mirox.io/api/v1/export/series?park=ABC123DEF456&metrics=turbine.energy_ac,turbine.wind_speed&window=previous_month&step=day" \
  -H "Authorization: Bearer YOUR_API_TOKEN" -o turbines.csv

La potenza di una turbina, turbine.power_ac, è una metrica a 15 minuti: esportala con step=15min.

Ricetta 7: batteria

Energia caricata e scaricata e stato di carica dell'accumulo, per giorno:

curl --compressed "https://service.mirox.io/api/v1/export/series?park=ABC123DEF456&metrics=battery.energy_in_ac,battery.energy_out_ac,battery.soc&window=previous_month&step=day" \
  -H "Authorization: Bearer YOUR_API_TOKEN" -o battery.csv

Per singoli container, rack, moduli o celle, usa le metriche di quei livelli, ad esempio battery_box.soc o battery_cell.voltage. Un impianto ha molte celle; scegli quelle che ti servono nella finestra dei componenti.

Excel con Power Query

Power Query legge un link direttamente, con il token nell'header Authorization. La cartella di lavoro si aggiorna poi con Dati ▸ Aggiorna tutti.

In Excel scegli Dati ▸ Recupera dati ▸ Da altre origini ▸ Query vuota.
Apri l'Editor avanzato e incolla la query seguente. Sostituisci l'impianto, le metriche e il token.
Quando Excel chiede come connettersi, scegli Anonimo. Il token è già nell'header; con qualsiasi altra scelta Excel rifiuta l'header.

let
    Source = Csv.Document(
        Web.Contents(
            "https://service.mirox.io",
            [
                RelativePath = "api/v1/export/series",
                Query = [
                    park = "ABC123DEF456",
                    metrics = "plant.grid_feedin,plant.rad_pyranometer",
                    window = "previous_month",
                    step = "day",
                    header = "id",
                    separator_csv = ",",
                    separator_decimal = "."
                ],
                Headers = [Authorization = "Bearer YOUR_API_TOKEN"]
            ]
        ),
        [Delimiter = ",", Encoding = 65001, QuoteStyle = QuoteStyle.Csv]
    ),
    Promoted = Table.PromoteHeaders(Source, [PromoteAllScalars = true]),
    Typed = Table.TransformColumnTypes(
        Promoted,
        {
            {"timestamp", type date},
            {"plant.grid_feedin", type number},
            {"plant.rad_pyranometer", type number}
        },
        "en-US"
    )
in
    Typed

header=id rende le intestazioni di colonna ID stabili. La query continua a funzionare quando una metrica viene rinominata o la lingua cambia.
Con separator_decimal = "." e la cultura "en-US", i numeri vengono letti allo stesso modo su ogni computer, qualunque siano le sue impostazioni internazionali.
Con un passo sotto il giorno, la colonna timestamp contiene data e ora: usa type datetime. La colonna utc_offset è un testo.
Le celle vuote restano vuote. Significano «nessun dato», non zero.
Per un modello, usa RelativePath = "api/v1/export/series/template/CAFE1000CAFE" e ometti metrics.

Tieni il token fuori dalle cartelle di lavoro condivise

Il token fa parte della query e viaggia con la cartella di lavoro. Crea un token del gruppo Metric Export solo per questo scopo: può leggere le esportazioni e nient'altro, e puoi revocarlo senza toccare gli altri tuoi token.

Aprire il file CSV in Excel

Separatori: i valori predefiniti (; tra le colonne, , come segno decimale) si aprono direttamente in un Excel con impostazioni internazionali italiane o tedesche. Per le impostazioni inglesi aggiungi separator_csv=,&separator_decimal=. — i due devono essere diversi.
Date: datetime_format accetta un modello come %d.%m.%Y %H:%M se ti serve un altro formato.
Codifica: i file sono in UTF-8. Se i caratteri speciali appaiono sbagliati, importa il file con Dati ▸ Da testo/CSV.
Nomi delle colonne: language=it (oppure de, es, fr, pt) li traduce.
Dimensione: i file grandi vengono compressi durante il trasferimento quando il client lo accetta — da qui --compressed negli esempi. I browser ed Excel lo fanno da soli.

Limiti

Limite	Valore
Metriche per link	20
Impianti per link	50
Componenti per metrica e pagina	50, al massimo 100
Colonne	400
Valori per colonna	180 000 — 125 giorni a 1 minuto, cinque anni a 15 minuti
Valori in totale	1 800 000

Un link che chiede di più viene rifiutato con 400 over_budget, e la risposta nomina il passo o il periodo che ci starebbe. Come dividere un'esportazione grande è descritto nella Metric Export API.

I link che usi già continuano a funzionare

I link della precedente esportazione di dati raw continuano a fornire le stesse colonne. In una cartella di lavoro che li usa non deve cambiare nulla:

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

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

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

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

I loro equivalenti nel Metric Export sono le ricette 1, 3 e 4 qui sopra. Tre cose differiscono: l'energia è in kWh invece che in Wh, gli orari sono l'ora locale dell'impianto invece di UTC, e le metriche hanno i nomi usati dai report. La guida alla migrazione elenca ogni ID precedente con la sua metrica; i link precedenti sono descritti nell'API di esportazione legacy.

Metric Export — la pagina Esportazione dati
Metric Export API — ogni parametro, limite ed errore
Generatore di report esterni — un esempio completo in Python
Utilizzo dei token API — crea il token usato dagli esempi
FAQ sull'esportazione dati