Modèles de flux – Hermetry

Un modèle est un flux prêt à l’emploi que vous copiez et adaptez. Les modèles d’Hermetry proviennent de la plateforme et des solutions prêtes à l’emploi. En utiliser un est le moyen le plus rapide d’obtenir une racine de flux correcte ou un flux de notification fonctionnel.

Où trouver les modèles

Automation > onglet Templates : les modèles de chaque hôte, chacun avec son badge d’hôte, une zone de recherche (Search the templates) et Use.
New flow > Start from : les modèles de l’hôte choisi, ou An empty flow.

Utiliser un modèle crée un nouveau flux avec les blocs du modèle. Le nouveau flux vous appartient : modifiez-le, déployez-le, supprimez-le. Il n’est pas lié au modèle.

Les modèles

Modèle	Hôte	Ce qu’il fait
Default root flow	IoT	Le chemin de stockage que chaque racine requiert : règles d’alarme, puis télémétrie et attributs client enregistrés, requêtes des appareils et autres messages journalisés, erreurs journalisées. Partez de ce modèle pour chaque racine de profil.
Water site: alarm notifications	IoT	Chaque alarme d’un réservoir ou d’une station de pompage qui s’ouvre ou se ferme est envoyée aux administrateurs de l’organisation.
Remote sites: alarm notifications	IoT	Chaque alarme d’un contrôleur de site ou d’une passerelle UPS qui s’ouvre ou se ferme est envoyée aux administrateurs.
Remote sites: UPS root	IoT	Une racine pour les passerelles UPS : le chemin de stockage de la racine par défaut plus un watchdog par unité UPS ; une unité qui ne signale plus sa tension pendant cinq minutes déclenche un avertissement « silent » jusqu’à ce qu’elle signale à nouveau.
Sensor regions: alarm notifications	IoT	Chaque alarme de seuil, de batterie ou de hors-ligne d’un capteur ou d’une station météo qui s’ouvre ou se ferme est envoyée aux administrateurs.
Personnel tracking: alarm escalation	IoT	L’alarme d’un traceur (chute, immobilité, SOS, appel à l’aide, zone interdite) est envoyée aux administrateurs à son ouverture, lorsqu’un opérateur l’acquitte, et à sa fermeture.

Votre organisation peut voir davantage de modèles lorsque d’autres modules sont activés.

Fonctionnement des modèles de notification d’alarme

Device message (types: alarm; profiles: the solution's) → Switch on msg.metadata.alarm.transition
    created      → Notify (role ADMIN, urgency critical): "Alarm opened on <device>: <title> (<severity>)."
    cleared      → Notify (role ADMIN, urgency normal): "The alarm on <device> cleared: <title>."
    acknowledged → Notify (personnel tracking only)

Les blocs Notify s’adressent au rôle Admin. Les membres joints via un rôle sont informés dans l’application, par push et dans leurs applications de messagerie liées, selon leurs préférences ; un rôle ne les atteint pas par e-mail ou SMS. Pour envoyer un e-mail ou un SMS, ajoutez des lignes de types address ou phone avec les adresses et numéros. Voir Alarm, command and notify blocks.

Pour en adapter un :

Utilisez le modèle, puis ouvrez le bloc Device message et choisissez vos propres profils d’appareils sous profiles (vide = tous les profils).
Modifiez les destinataires, les textes et l’urgence dans chaque bloc Notify.
Déployez.

Fonctionnement de la racine UPS

La racine UPS est une racine de profil : elle remplace la racine à l’échelle du locataire pour le profil de passerelle UPS. À côté du chemin de stockage, pour chaque unité :

Message type = telemetry → Switch "Carries ups_a_voltage" (nempty)
  → Watchdog (5 min, key msg.metadata.deviceId)
       timeout → Raise alarm ups_a_offline (warning) "UPS A stopped reporting"
       ok      → Clear alarm ups_a_offline

Utilisez le même schéma pour tout appareil qui doit signaler une clé régulièrement. Voir Counters, statistics and watchdogs et le Flow cookbook.

Modèles installés avec une solution

Lorsque vous installez une solution prête à l’emploi, ses flux sont créés sur les profils d’appareils de la solution (les flux de notification sont enregistrés désactivés jusqu’à ce que vous les activiez) ; les modèles ci-dessus sont les mêmes flux, proposés pour vos propres profils. Voir Install a solution.

La racine par défaut initiale

Le Default root flow est créé et lié à l’ensemble du locataire automatiquement au démarrage de votre organisation. Il ne compte pas dans les flux de votre forfait. Lorsqu’Hermetry publie une version plus récente :

une copie que personne n’a modifiée adopte seule la nouvelle version, sous forme de nouvelle version créée par System ;
une copie modifiée se voit seulement proposer la mise à jour, avec la liste des changements. L’appliquer est un déploiement normal de votre part.

Si vous supprimez la racine initiale, elle n’est pas recréée.

Flux créés par les modules

Les règles de la carte Rules s’exécutent sous forme de flux que le module de règles construit et conserve. Ils apparaissent dans la liste avec un badge Built by et le filtre Built by (A module (read-only here) ou People (ordinary flows)). Ce ne sont pas des modèles. Pour en modifier un dans l’éditeur, sélectionnez Detach into an ordinary flow : « Après le détachement, … ne le modifie plus : il continue de fonctionner tel quel, vous le modifiez ici comme n’importe quel flux, et il compte dans les flux de votre forfait. Cette action est irréversible. »

Partager vos propres flux

Il n’existe pas de « save as template ». Pour réutiliser un flux, Export-le puis Import-le en tant que copie, dans la même organisation ou une autre. Voir Versions, testing and rollback.