Metric Export pour Excel

Le Metric Export fournit n'importe quel indicateur de vos centrales sous forme de fichier CSV qu'Excel et LibreOffice ouvrent directement. Cette page présente les cas quotidiens sous forme de liens prêts à l'emploi, et montre comment connecter Excel à un lien pour qu'un classeur s'actualise de lui-même.

Prérequis

Un compte Mirox qui peut lire les mesures de la centrale que vous exportez.
Un jeton d'API du groupe Metric Export — voir Utilisation des jetons d'API. Dans un navigateur où vous êtes connecté, un lien fonctionne sans jeton.

La voie facile : copier le lien depuis l'application

Vous n'avez pas à construire un lien à la main.

Ouvrir dans Mirox

Export de données ▸ Métriques — choisissez les centrales, les indicateurs, la période et le pas. L'URL d'API sous l'aperçu est le lien de cette sélection exacte, y compris les composants que vous avez choisis. Essayer prépare un jeton et des commandes prêtes à l'emploi.

Les recettes ci-dessous montrent à quoi ressemblent ces liens, afin que vous puissiez les adapter.

Recette 1 : production d'une centrale à 15 minutes

Une semaine d'injection réseau, en énergie par quart d'heure :

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
...

Les heures sont l'heure locale de la centrale. La colonne Décalage UTC (UTC offset) rend chaque ligne sans ambiguïté, y compris le jour du changement d'heure. offset_column=false la supprime ; tz=utc exporte en UTC.
end=2026-07-07 inclut le 7 juillet.
Pour une courbe de la puissance plutôt que de l'énergie, exportez plant.grid_power.

Recette 2 : le mois précédent, chaque mois

Un lien avec une période prédéfinie fournit toujours la période complète la plus récente. C'est le lien qu'il faut à un classeur actualisé une fois par mois :

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
...

Recette 3 : plusieurs centrales côte à côte

Une colonne par centrale avec 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, la valeur par défaut, donne une colonne pour toutes les centrales ensemble.
portfolio=<uid> sélectionne toutes les centrales d'un portefeuille.

Recette 4 : chaque onduleur

Un indicateur du niveau onduleur donne une colonne par onduleur :

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;...

Sans sélection, le fichier contient tous les onduleurs, 50 par page. lane_page=2 donne les 50 suivants ; lane_limit=100 en donne 100 par page.
Pour n'exporter que certains onduleurs, ajoutez components=inverter:1043,inverter:1044. La boîte de dialogue des composants de l'onglet Métriques place les références dans le lien à votre place.
Les strings et les boîtes de jonction fonctionnent de la même façon, avec string.power (énergie par string) et gak.power (énergie par boîte de jonction).

Recette 5 : chaque capteur d'irradiance

Chaque capteur séparément, sans moyenne :

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 donne l'irradiation par capteur en kWh/m², à chaque pas jusqu'à l'année. Le modèle système Capteurs d'irradiance (CAFE1030CAFE) contient les deux, avec l'irradiation du pyranomètre de la centrale.

Recette 6 : éoliennes

Énergie et vitesse du vent de chaque éolienne, par jour :

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 puissance d'une éolienne, turbine.power_ac, est un indicateur à 15 minutes : exportez-la avec step=15min.

Recette 7 : batterie

Énergie chargée et déchargée et état de charge du stockage, par jour :

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

Pour des conteneurs, racks, modules ou cellules individuels, utilisez les indicateurs de ces niveaux, par exemple battery_box.soc ou battery_cell.voltage. Une centrale compte de nombreuses cellules ; choisissez celles dont vous avez besoin dans la boîte de dialogue des composants.

Excel avec Power Query

Power Query lit un lien directement, avec le jeton dans l'en-tête Authorization. Le classeur s'actualise ensuite avec Données ▸ Actualiser tout.

Dans Excel, choisissez Données ▸ Obtenir des données ▸ À partir d'autres sources ▸ Requête vide.
Ouvrez l'Éditeur avancé et collez la requête ci-dessous. Remplacez la centrale, les indicateurs et le jeton.
Lorsqu'Excel demande comment se connecter, choisissez Anonyme. Le jeton se trouve déjà dans l'en-tête ; tout autre choix amène Excel à refuser l'en-tête.

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 fait des en-têtes de colonne des identifiants stables. La requête continue de fonctionner lorsqu'un indicateur est renommé ou que la langue change.
Avec separator_decimal = "." et la culture "en-US", les nombres sont lus de la même façon sur chaque ordinateur, quels que soient ses paramètres régionaux.
À un pas inférieur à un jour, la colonne timestamp contient la date et l'heure : utilisez type datetime. La colonne utc_offset est un texte.
Les cellules vides restent vides. Elles signifient « pas de données », et non zéro.
Pour un modèle, utilisez RelativePath = "api/v1/export/series/template/CAFE1000CAFE" et omettez metrics.

Gardez le jeton hors des classeurs partagés

Le jeton fait partie de la requête et voyage avec le classeur. Créez un jeton du groupe Metric Export réservé à cet usage : il peut lire les exports et rien d'autre, et vous pouvez le révoquer sans toucher à vos autres jetons.

Ouvrir le fichier CSV dans Excel

Séparateurs : les valeurs par défaut (; entre les colonnes, , comme marque décimale) s'ouvrent directement dans un Excel aux paramètres régionaux français ou allemands. Pour des paramètres anglais, ajoutez separator_csv=,&separator_decimal=. — les deux doivent différer.
Dates : datetime_format accepte un motif tel que %d.%m.%Y %H:%M si vous avez besoin d'un autre format.
Encodage : les fichiers sont en UTF-8. Si les caractères spéciaux s'affichent mal, importez le fichier avec Données ▸ À partir d'un fichier texte/CSV.
Noms de colonne : language=fr (ou de, es, it, pt) les traduit.
Taille : les fichiers volumineux sont compressés pendant le transfert lorsque le client l'accepte — d'où --compressed dans les exemples. Les navigateurs et Excel le font d'eux-mêmes.

Limites

Limite	Valeur
Indicateurs par lien	20
Centrales par lien	50
Composants par indicateur et par page	50, au plus 100
Colonnes	400
Valeurs par colonne	180 000 — 125 jours à 1 minute, cinq ans à 15 minutes
Valeurs au total	1 800 000

Un lien qui demande davantage est refusé avec 400 over_budget, et la réponse nomme le pas ou la période qui conviendrait. La façon de scinder un export volumineux est décrite dans l'API Metric Export.

Les liens que vous utilisez déjà continuent de fonctionner

Les liens de l'ancien export de données brutes continuent de fournir les mêmes colonnes. Rien ne doit changer dans un classeur qui les utilise :

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

Leurs équivalents dans le Metric Export sont les recettes 1, 3 et 4 ci-dessus. Trois choses diffèrent : l'énergie est en kWh au lieu de Wh, les heures sont l'heure locale de la centrale au lieu de l'UTC, et les indicateurs portent les noms utilisés par les rapports. Le guide de migration liste chaque ancien identifiant avec son indicateur ; les liens précédents sont décrits dans l'API de l'ancien export.

Metric Export — la page Export de données
API Metric Export — chaque paramètre, limite et erreur
Générateur de rapports externe — un exemple Python complet
Utilisation des jetons d'API — créez le jeton qu'utilisent les exemples
FAQ sur l'export de données