Statut du site et clé de statut

Chaque lieu de Hermetry Twin a un statut : Critique, Avertissement, OK ou Inconnu. Les tableaux et cartes des sites colorent les sites selon ce statut, les tableaux détaillés colorent les étages et les pièces, et les scènes 3D teintent les pièces et les zones avec lui. Cette page explique d’où vient le statut.

Le statut d’un appareil

Le statut d’un appareil est le pire de trois éléments :

1. 
   Sa clé de statut. La dernière valeur d’une clé de télémesure, par défaut status :

   Dernière valeur (casse quelconque, espaces ignorés)	Statut
   critical, alarm, error, fault, danger, 2, true	Critique
   warning, warn, 1	Avertissement
   toute autre valeur, par exemple ok, normal, 0, running	OK
   aucune valeur	(rien de connu par la clé)

2. 
   Ses alarmes actives. Toute alarme ouverte ou acquittée rend l’appareil au moins Avertissement ; une alarme CRITIQUE le rend Critique. Les alarmes ne comptent que pour les personnes autorisées à les voir.
3. 
   Sa connexion. Lorsque ni l’un ni l’autre ne donne d’indication, un appareil en ligne, ou actif au cours des 10 dernières minutes, est OK.

Un appareil dont on ne sait rien (ni valeur de statut, ni alarme, ni signe de vie) est Inconnu. L’ordre du pire au meilleur est Critique, Avertissement, OK, Inconnu.

Agrégation

Le statut d’un lieu est le pire statut des appareils placés sur celui-ci ou en dessous. Une pièce tire son statut de ses appareils, un étage de ses pièces, un bâtiment de ses étages, un site de tout ce qui se trouve en dessous. Un seul capteur critique dans une pièce rend critiques la pièce, l’étage, le bâtiment et le site.

Les appareils que vous ne pouvez pas lire ne comptent pour rien. Un lieu sans appareil, ou sans appareil que vous pouvez lire, est Inconnu.

Où il est affiché

Où	Quoi
Modèle de tableau Sites	Le badge Statut du tableau des sites, la couleur des repères de la carte, l’en-tête de la page du site
Tableaux détaillés (Statut sous un actif)	Une ligne par enfant avec son statut, ses appareils et ses alarmes ouvertes, du pire au meilleur
Scènes 3D	Les éléments dont la clé correspond au code d’un actif Room ou Area sont teintés avec le statut de cet actif ; un élément critique pulse
Tableau Valeurs en direct sur une page de site	Le statut propre à chaque appareil

La page Sites & Assets et sa carte affichent les alarmes, et non ce statut : la carte est colorée par l’alarme active la plus grave.

Utiliser une autre clé

Chaque tableau de statut, carte et en-tête de site lit une clé, par défaut status. Dans les paramètres de données de la carte, Clé de statut des appareils permet d’utiliser une autre clé, par exemple state ou health, avec le même vocabulaire. Une clé comporte jusqu’à 64 lettres, chiffres, _, . ou -.

Calculer le statut dans un flux

La plupart des appareils n’envoient pas de clé status. Calculez-en une à partir de ce qu’ils envoient, dans le flux racine de l’appareil, et enregistrez-la avec Enregistrer la télémesure :

1. 
   Ouvrez le flux racine du profil (ou le flux racine de l’hôte IoT).
2. 
   Après le message entrant, ajoutez un bloc Calculer avec cible msg.payload.status et une expression, par exemple pour une chambre froide :

   msg.payload.temperature > 8 ? "critical" : (msg.payload.temperature > 6 ? "warning" : "ok")

3. 
   Vérifiez que la branche se termine par Enregistrer la télémesure, pour que status soit stocké avec les mesures.
4. 
   Déployez le flux.

Conseils :

• Calculez le statut dans le même message que les mesures dont il découle, afin que les deux restent toujours cohérents. Voir Valeurs dérivées.
• Stockez du texte (ok, warning, critical) pour les couleurs des sites. Pour les graphiques, stockez aussi un nombre (status_code : 0, 1, 2), car les graphiques lisent des nombres.
• Un statut calculé à partir de plusieurs appareils (par exemple « une pompe de la station est à l’arrêt ») appartient à un appareil qui représente la station, ou à une règle d’alarme : les alarmes ouvertes élèvent d’elles-mêmes le statut du lieu.
• Si une règle d’alarme couvre déjà la condition, vous n’avez peut-être pas besoin de clé de statut : l’alarme fait passer le lieu à Avertissement ou Critique tant qu’elle est ouverte.

Comparaison du statut, des alarmes et des couleurs

	Clé de statut	Alarme
Provient de	La dernière valeur de la clé pour l’appareil	Une règle, un flux ou un opérateur
Persistance	Jusqu’à la valeur suivante	Jusqu’à sa résolution
Notifie	Non	Oui, si la règle le prévoit
Permission d’alarme requise pour la voir	Non	Oui
Idéal pour	Colorer les lieux selon la propre vision de l’appareil	Les situations que les personnes doivent traiter

Dépannage

Problème	Cause
Un lieu est Inconnu	Aucun appareil situé en dessous n’envoie la clé, n’a d’alarme ouverte ou n’était actif au cours des 10 dernières minutes ; ou les appareils ne sont pas placés sous ce lieu
Un lieu est rouge alors que tout va bien	Un appareil envoie true, 1, 2 ou un mot tel que error dans sa clé de statut ; ou une alarme CRITIQUE est encore ouverte
Un collègue voit du vert là où vous voyez du rouge	Il ne peut pas voir les alarmes, donc les alarmes ouvertes ne comptent pas pour lui
Une pièce de la scène 3D n’est pas teintée	La clé de l’élément ne correspond pas au code de la pièce, ou le type de l’actif n’est ni Room ni Area