Le composant "intégrale" vous permet de calculer et de visualiser le cumul des valeurs d’une métrique, comme une consommation ou un débit, sur une période donnée.

Pour illustrer son fonctionnement, prenons l’exemple d’une consommation électrique mesurée en temps réel. Nous souhaitons calculer la consommation électrique quotidienne, puis la convertir en euros pour déterminer son coût.

Informations générales

Commencez par renseigner les informations générales nécessaires pour configurer le composant :

Titre : Donnez un titre à votre composant
Description (facultatif) : Ajoutez des détails pour préciser le contexte du composant.
Période des données :
- Si vous souhaitez appliquer un décalage temporel entre la période sélectionnée pour l'ensemble du tableau de bord et la période du composant, vous pouvez saisir un décalage temporel (pour plus de détails se référer au paragraphe dédié au décalage temporel)
- Si vous souhaitez appliquer au composant une période différente de celle sélectionnée pour l'ensemble du tableau de bord, vous pouvez utiliser le bouton "Verrouiller".
  
  Le bouton "Verrouiller" permet de forcer l'application de la période sélectionnée pour ce composant, dans le cas où une période est choisie pour l'ensemble du tableau de bord.
  
  Cliquez sur le bouton "Verrouiller", puis sélectionnez la période à utiliser :

Choix du mode de représentation

Déterminez comment le cumul sera affiché :

Une valeur simple représentant le cumul sur la période sélectionnée.
Un histogramme permettant de visualiser l’évolution du cumul sur la période sélectionnée.

Pour ce faire, placez le curseur ci-dessous vers le paramètre valeur ou histogramme :

Remarque : Il vous est possible de modifier le nom d'affichage de la métrique sélectionnée dans le composant :

Choix de la métrique

Vous pouvez maintenant sélectionner la métrique à utiliser, en cliquant sur le bouton Rechercher une métrique.

La fenêtre habituelle de recherche d'une métrique de io-base s'ouvre.

Plusieurs onglets permettent une recherche soit à partir de l'arborescence, soit par méta-données, soit par nom de métrique. Une fois la métrique souhaitée trouvée, cliquez sur le bouton permettant de les ajouter. Les métriques apparaissent dans le tableau de droite.

Vous pouvez supprimer les métriques du tableau de droite en vous servant de l'icône de suppression.

Remarque : Pour un composant intégrale, il n’est possible d’ajouter qu’une seule métrique.

Pour valider la sélection, cliquer sur "Sélectionner".

Une prévisualisation du graphique s'affiche sur la gauche.

Unité de temps pour l'intégration

Vous devez ensuite renseigner l'unité de temps pour l'intégration.

Ce paramètre définit l’intervalle sur lequel les données seront agrégées ou intégrées pour produire une mesure cumulée. Cette unité est essentielle car elle détermine comment les données brutes sont regroupées et utilisées pour calculer des volumes ou totaux sur une période donnée.

Par exemple, si vous saisissez “1h”, l’intégration calcule le cumul des mesures instantanées sur des tranches horaires. Cela signifie que chaque valeur de cumul est basée sur les données collectées pendant une heure.

Ajouter un Coefficient

Un coefficient peut être appliqué au résultat pour obtenir un cumul ajusté selon vos besoins.

Avec notre exemple : Si l'on souhaite convertir la consommation en euros, on peut appliquer un coefficient correspondant au prix unitaire d’un kWh d’électricité (ex. : 0,15 €/kWh).

Vous pouvez spécifier le coefficient de deux manières :

Une valeur fixe : Par exemple, un prix constant de 0,15 €/kWh.

Une métrique : Une métrique de conversion peut être utilisée si le prix varie dans le temps.
Remarque : la valeur multiplicatrice retenue sera la moyenne des valeurs renvoyées par la métrique dans la période.