Une fonction agrégée est un calcul effectué sur plusieurs valeurs dans un intervalle de temps donné, et qui restitue une seule valeur. Vous pouvez déterminer l’intervalle en définissant une plage de temps pour le tableau de bord.
C’est important car les valeurs sont compressées lorsqu’elles sont affichées dans un widget. Présenter chaque valeur individuelle donnerait une image floue et complexe, à partir de laquelle il est difficile de tirer des conclusions. Il y a généralement plus d’intérêt à connaître les chiffres complets qu’aux détails. Lorsque vous zoomez sur la timeline du widget, vous verrez plus de points de données individuels.
Exemples
Disons qu’un capteur mesure la consommation d’eau en litres. Dans un intervalle de temps, elle émet les valeurs suivantes :
1 1 2 0 1 0 2 3
Selon l’ensemble d’agrégation, votre widget affichera la valeur suivante :
Agrégation | Valeur affichée | Énoncé |
|---|---|---|
COMTE | 8 | Le nombre de valeurs envoyées dans l’intervalle de temps. Il fonctionne aussi bien sur des valeurs numériques que sur des chaînes de caractères (texte). |
AVG | 1.25 | La valeur moyenne dans l’intervalle de temps. Il est généralement utilisé pour obtenir une vue d’ensemble d’une situation, ou lorsqu’il est important de connaître les moyennes. |
MAX | 3 | La plus grande valeur reçue depuis l’intervalle de temps. Utile si vous vérifiez une limite supérieure, par exemple. |
MIN | 0 | La plus petite valeur dans l’intervalle de temps. Utile si vous vérifiez une limite inférieure, par exemple. |
PREMIÈRE | 1 | La première valeur reçue dans l’intervalle de temps. |
DERNIER | 3 | La dernière valeur reçue dans l’intervalle de temps. |
DIFF | 2 | La différence entre la première et la dernière valeur dans l’intervalle de temps. Cette fonctionnalité est utile lorsque vous comptez les totaux et que vous souhaitez connaître l’augmentation ou la diminution de vos valeurs. |
SUM | 10 | La somme de toutes les valeurs reçues dans l’intervalle de temps. Cette fonctionnalité est utile lorsque votre capteur est un compteur, par exemple, et que vous souhaitez connaître les totaux. |
Si vous ne sélectionnez pas d’agrégation, elle sera par défaut LAST.
Attention !
Pour savoir quand utiliser SUM ou DIFF, il est important de comprendre comment votre capteur mesure la valeur.
Si vous obtenez les valeurs suivantes : 1 1 0 2, vous pouvez utiliser SUM pour obtenir le total des valeurs mesurées. Le calcul ressemble à ceci : 1 + 1 + 0 + 2 = 4
Si vous obtenez les valeurs suivantes : 1, 3, 6, 5, le capteur additionnera les valeurs mesurées. Vous pouvez aussi utiliser DIFF pour savoir à quel point les valeurs ont changé. Le calcul ressemble à ceci : 5 - 1 = 4
Comment utiliser l’agrégation dans les widgets
Lors de la configuration d’un widget, vous pouvez définir le nombre maximal de points de données à afficher. Les points de données sont les valeurs qu’un capteur envoie au portail. Au fil du temps, ces valeurs sont compressées pour plus de clarté. La compression des points de données est contrôlée par le paramètre Max Data Points . Plus vous réglez ce maximum haut, plus de points seront affichés sur votre widget, et moins ils seront compressés.
Graphique linéaire
Il s’agit d’un graphique linéaire avec des données provenant d’un seul capteur (courant de phase A), répété trois fois, mais avec des agrégations différentes :
La ligne bleu foncé indique la valeur maximale (#MAX).
La ligne bleu clair indique la valeur moyenne (#AVG).
La ligne verte indique la valeur minimale (#MIN).
.png?sv=2022-11-02&spr=https&st=2026-04-23T20%3A37%3A10Z&se=2026-04-23T20%3A50%3A10Z&sr=c&sp=r&sig=pPSkZrEvs0fUDjcfxvx1v4vzHqY4ISlqkKNOrRq7Z84%3D)
Graphique à barres
C’est un graphique à barres avec des données provenant d’un seul capteur (heures de fonctionnement absolues).
Comme les valeurs sont de nature incrémentale, une agrégation #DIFF est utilisée pour obtenir un aperçu des heures de fonctionnement, avec un intervalle fixe d’un jour.
Bloc unique
Il s’agit d’un seul bloc affichant la consommation de gaz sur une période donnée.
Comme les valeurs proviennent d’un compteur d’impulsions, une agrégation #SUM est utilisée pour compter le nombre total d’impulsions, afin d’obtenir la quantité de gaz consommée sur une période.
Et un seul bloc affichant la dernière adresse connue d’un actif.
Comme la valeur n’est pas une valeur numérique, mais une chaîne de types, une agrégation #STR_LASTKNOWN est utilisée pour obtenir la dernière adresse connue.
