Export de données & API (CSV and API) (fr)

Vue d'ensemble

Cet article de référence décrit toutes les métriques disponibles via l'export de données (CSV) et l'API. Les métriques sont divisées en deux catégories :

Métriques universelles — renvoyées pour tous les appareils électriques, y compris les capteurs de courant et les compteurs d'énergie.
Métriques des compteurs d'énergie — renvoyées exclusivement pour les compteurs d'énergie, fournissant des mesures électriques étendues.

Conseil : Si une colonne apparaît dans votre export mais affiche des valeurs NULL, vérifiez que votre appareil est un compteur d'énergie et que le type de mesure concerné est pris en charge par votre configuration matérielle.

Métriques universelles

Les métriques suivantes sont renvoyées pour tous les appareils électriques, que ce soit dans les exports CSV ou dans les réponses API.

Nom de colonne	Description
`external_id`	Un identifiant unique attribué à l'actif sélectionné. Utilisé pour référencer l'appareil dans des systèmes externes et des intégrations.
`asset_name`	Le nom de l'actif tel que configuré dans la plateforme.
`Customer`	Le nom du site client auquel appartient l'actif.
`time_zone`	Le fuseau horaire dans lequel se trouve l'actif. Voir ici pour une liste complète des identifiants de fuseau horaire pris en charge et leurs descriptions.
`measured_at`	L'horodatage de la mesure en heure locale (basé sur le fuseau horaire configuré de l'actif).
`utc_time`	L'horodatage de la mesure en Temps Universel Coordonné (UTC).
`power`	Puissance active mesurée. Ce champ contient toujours une valeur — si aucune mesure n'a été reçue de l'appareil, la valeur par défaut est 0. Pour les capteurs de courant, il s'agit d'une valeur calculée à partir du courant mesuré, du facteur de puissance configuré et de la tension configurée. Pour les compteurs d'énergie, cette valeur est mesurée directement par l'appareil.
`energy`	Énergie calculée. Dérivée directement de la valeur de puissance mesurée ou calculée au fil du temps.

Métriques des compteurs d'énergie

Les métriques suivantes ne sont renvoyées que pour les compteurs d'énergie. Elles n'apparaîtront pas dans les exports des capteurs de courant. Certains champs peuvent contenir des valeurs NULL si un type de mesure spécifique n'est pas pris en charge par le matériel connecté.

Nom de colonne	Description
`active_power_total`	Puissance active mesurée. Équivalent au champ power, sauf qu'il affiche les valeurs manquantes (NULL) lorsqu'aucune mesure n'a été reçue de l'appareil.
`apparent_power_total`	Puissance apparente mesurée. Représente la puissance totale circulant dans le circuit, incluant les composantes active et réactive.
`reactive_power_total`	Puissance réactive mesurée. Représente la part de puissance qui n'effectue pas de travail utile.
`current_l1`	Courant mesuré sur la phase 1 (L1).
`current_l2`	Courant mesuré sur la phase 2 (L2).
`current_l3`	Courant mesuré sur la phase 3 (L3).
`current_n`	Courant neutre mesuré.
`current_total`	Le courant de ligne triphasé équivalent. Calculé comme : apparent_power_total ÷ (√3 × voltage_ll_average).
`power_factor_total`	Facteur de puissance mesuré (plage de -1 à 1). Représente le rapport entre la puissance active et la puissance apparente. Une valeur de 1 ou -1 indique une charge purement résistive ; les valeurs proches de 0 indiquent une plus faible proportion de puissance réactive.
`voltage_average`	Tension moyenne ligne à neutre sur toutes les phases.
`voltage_l1_l2`	Tension ligne à ligne mesurée entre la phase 1 (L1) et la phase 2 (L2).
`voltage_l1_n`	Tension ligne à neutre mesurée sur la phase 1 (L1).
`voltage_l2_l3`	Tension ligne à ligne mesurée entre la phase 2 (L2) et la phase 3 (L3).
`voltage_l2_n`	Tension ligne à neutre mesurée sur la phase 2 (L2).
`voltage_l3_l1`	Tension ligne à ligne mesurée entre la phase 3 (L3) et la phase 1 (L1).
`voltage_l3_n`	Tension ligne à neutre mesurée sur la phase 3 (L3).
`voltage_ll_average`	Tension moyenne ligne à ligne sur toutes les paires de phases.

Notes complémentaires

Valeurs NULL vs. zéro

Il existe une distinction importante entre les champs power et active_power_total :

power contient toujours une valeur numérique. Les mesures manquantes sont représentées par 0.
active_power_total peut contenir NULL lorsqu'aucune mesure n'a été reçue, vous permettant de distinguer une lecture nulle réelle d'un point de données manquant.

Capteurs de courant vs. compteurs d'énergie

Certaines métriques sont calculées différemment selon le type d'appareil :

Capteurs de courant calculent la puissance indirectement à partir du courant mesuré combiné à la tension et au facteur de puissance configurés.
Compteurs d'énergie mesurent la puissance active directement et fournissent un ensemble plus complet de mesures électriques, incluant les tensions et courants par phase ainsi que le facteur de puissance.

Calcul de l'énergie

Le champ energy est dérivé du champ power par intégration temporelle. Il reflète la consommation d'énergie cumulée sur l'intervalle de mesure.