Ces blocs travaillent sur les données d’un appareil dans l’hôte IoT : ils stockent les mesures et attributs, évaluent les règles d’alarme et ajoutent les informations de l’appareil au message. Presque tous exigent un message dont l’origine est un appareil : un message d’appareil, ou un message qu’une racine a transmis avec Run flow. Les messages lancés par une planification, un inject, un événement ou une minuterie concernent l’organisation, pas un appareil ; ces blocs les refusent avec not_a_device.
Enregistrer la télémétrie
Stocke les paires clé-valeur du message comme télémétrie de l’appareil. Seul ce bloc stocke la télémétrie : une branche sans lui ne stocke rien. Seul msg.payload est stocké, jamais les métadonnées.
| Réglage | Signification | Défaut | Valeurs |
|---|---|---|---|
| clés | Seulement ces clés | toute clé | noms de clés |
| ts | Heure à laquelle l’enregistrement est stocké | heure d’enregistrement | heure d’enregistrement (msg.metadata.recordTs), heure de réception (msg.metadata.ts) |
| ts_path | Avec l’heure d’enregistrement : recalcule l’heure de l’enregistrement à partir de cette valeur | aucun | un chemin vers des millisecondes epoch (un nombre ou un texte numérique) |
Sorties : out (une fois les valeurs validées), error avec msg.error.code :
| Code | Signification |
|---|---|
not_a_device | L’origine n’est pas un appareil |
invalid_value | La charge utile n’est pas un objet |
bad_ts | L’heure à ts_path n’est pas en millisecondes epoch |
too_old | Plus ancien que la durée de conservation des données brutes de votre organisation |
no_values | Rien dans la charge utile ne peut être stocké |
key_limit | Pas de place pour une nouvelle clé sous le plafond de clés du forfait |
save_failed | La base de données a refusé la ligne (msg.error.ts est son heure) |
- Les messages sont écrits par vagues d’au plus 500, et le message suivant de l’appareil attend la validation, afin de lire ce qui a été stocké.
- Les mêmes valeurs à la même heure sont stockées une seule fois ; deux messages différents à la même heure sont tous deux conservés ; la dernière valeur n’est remplacée que par une heure strictement plus récente.
- Si la base de données est injoignable, rien n’est perdu : l’exécution attend et est rejouée à son retour.
- Une exécution de test ne stocke rien.
Voir Comment les mesures sont stockées et Clés de télémétrie.
Enregistrer les attributs
Stocke les paires clé-valeur du message comme attributs client de l’appareil (ce que l’appareil déclare de lui-même, comme sa version de firmware).
| Réglage | Signification | Défaut | Valeurs |
|---|---|---|---|
| scope | Quels attributs | client | client |
| clés | Seulement ces clés | toute clé | noms de clés |
Erreurs : not_a_device, invalid_value, save_failed. Un message livré à nouveau ne change rien ; un message plus ancien n’écrase jamais une valeur plus récente ; une valeur inchangée n’est pas réécrite. Voir Attributs.
Définir un attribut partagé
Définit des attributs partagés de l’appareil du message. Un appareil connecté reçoit le changement immédiatement ; un appareil hors ligne à sa prochaine connexion. Les flux reçoivent le changement sous forme de message attributes_updated.
| Réglage | Signification | Valeurs |
|---|---|---|
| éléments | Paires clé et valeur | obligatoire ; au plus 32. Clé : lettres, chiffres, _, ., -, au plus 57 caractères. Valeur : un littéral (true, 22.5, {"mode":"eco"}) ou un chemin comme msg.payload.setpoint. |
Erreurs : not_a_device, device_not_found, invalid_value, bad_attribute, too_large, managed_by_settings (une clé cfg.* d’un appareil dont les réglages sont gérés dans son onglet Settings), limit (l’appareil a reçu trop de commandes et de réglages depuis les flux dans la dernière minute ; défaut 30).
- Niveau de contrôle : le déploiement exige Deploy flows with control-level nodes et le nom du flux saisi.
- Les clés commençant par
_,fw_oucurrent_fw_, ainsi quesession_limitsetdeleted, appartiennent à la plateforme et ne peuvent pas être définies. - Un message tardif ne change rien. Une exécution de test indique ce qu’elle définirait.
Règles d’alarme
Évalue les règles d’alarme du profil de l’appareil et ouvre, met à jour ou efface les alarmes de l’appareil. Les règles se modifient sur le profil de l’appareil ; ce bloc décide où elles s’exécutent dans le flux. La racine par défaut l’a placé juste après l’entrée.
| Réglage | Signification | Défaut | Valeurs |
|---|---|---|---|
| profile_rules | Évaluer les règles du profil | on | on, off |
| rules | Seulement ces types d’alarme | toutes les règles | types de règles du profil |
Sorties :
out: le message, toujours, après l’évaluation (un problème est journalisé et n’arrête jamais le message, donc les blocs d’enregistrement qui suivent s’exécutent quand même).created,updated,cleared: une copie du message avecmsg.msgTypealarm, l’alarme dansmsg.payloadetmsg.metadata.alarm(transition,isNew,isSeverityUpdated,isCleared,repeats,durationMs,ruleId).
La télémétrie est évaluée par rapport aux règles qui lisent l’une de ses clés ; connect, disconnect, activity et inactivity pilotent la règle hors ligne. Les mesures tardives ou désordonnées sont évaluées comme rétro-remplissage (historique marqué Backfilled, personne notifiée). Supprimer le bloc arrête les règles d’alarme pour les appareils de cette racine ; le remettre les relance. Voir Règles d’alarme sur les profils d’appareil.
Détails de l’appareil
Ajoute au message les informations et attributs de l’appareil du message.
| Réglage | Signification | Défaut | Valeurs |
|---|---|---|---|
| champs | Champs de l’appareil | name, profile | name, label, type, serial, model, fw_version, status, online, last_activity (epoch ms), profile, profile_id, is_gateway, gateway |
| attributs | Attributs : scope, key, nom dans le message | aucun | au plus 50 ; scope client, shared ou server |
| cible | Où l’objet est écrit | msg.metadata.device | un chemin sous msg.metadata ou msg.payload |
| with_ts | Écrit les attributs sous la forme { ts, value } | off | |
| on_missing | Un champ ou attribut sans valeur | error | error, skip, null |
Exemple de résultat : { "name": "Boiler 1", "profile": "Boilers", "online": true, "setpoint": 21 }. gateway vaut { id, name, online } pour un appareil derrière une passerelle. Les détails sont mis en cache 30 secondes ; les attributs sont lus à neuf. Erreurs : missing (avec msg.error.keys), not_a_device, not_found, invalid_value, read_failed.
Dernières valeurs
Ajoute les dernières valeurs stockées de clés choisies de l’appareil.
| Réglage | Signification | Défaut | Valeurs |
|---|---|---|---|
| clés | Clés de télémétrie | obligatoire | au plus 50 |
| cible | Où | msg.metadata.latest | sous msg.metadata ou msg.payload |
| with_ts | { ts, value } à la place de la valeur | off | |
| on_missing | Une clé sans valeur stockée | error | error, skip, null |
Une valeur du message en cours de traitement n’est incluse qu’après l’exécution de son bloc Save telemetry.
Détails du profil
Ajoute des informations du profil de l’appareil.
| Réglage | Signification | Défaut | Valeurs |
|---|---|---|---|
| champs | Champs du profil | name | name, id, transport, inactivity_timeout_s, rpc_timeout_s, downlink_max_bytes, online_rule, expected_interval_s |
| cible | Où | msg.metadata.profile | sous msg.metadata ou msg.payload |
| on_missing | Un champ sans valeur | error | error, skip, null |
Données liées
Ajoute les données des actifs et appareils liés à l’appareil ou à l’actif du message : le site où un appareil est placé, les appareils qu’un actif gère, un ancêtre trois niveaux plus haut.
| Réglage | Signification | Défaut | Valeurs |
|---|---|---|---|
| direction | Suivre les relations depuis l’origine, ou vers elle | from | from, to |
| relation_types | Types de relations suivis | CONTAINS | p. ex. CONTAINS, MANAGES, FEEDS, MONITORS ou les vôtres ; none = tous |
| exclude_types | Types jamais suivis | aucun | |
| depth | Niveaux | 1 | 1 à 8 |
| last_level_only | Ne garder que le dernier niveau | off | |
| entity_kind | Quelles entités | any | any, asset, device |
| profiles, kinds | Seulement les appareils de ces profils, les actifs de ces types | any | |
| max | Nombre d’entités | 1 | 1 à 100 (1 écrit un objet, plus une liste) |
| data | Ce qui est lu | attributes | attributs, dernières valeurs (appareils), champs |
| portée | Portée des attributs d’appareil | serveur | serveur, partagé, client |
| mappage | Clés lues et leurs noms dans le message | obligatoire | au maximum 50 |
| cible | Emplacement | msg.metadata.related | sous msg.metadata ou msg.payload |
| with_ts, on_missing | Idem ci-dessus | off, error |
L’arborescence des actifs et les placements d’appareils comptent comme des relations CONTAINS : direction to, CONTAINS, profondeur 3, dernier niveau uniquement, assets trouve le site d’un appareil trois niveaux plus haut. L’ordre est fixe, donc max 1 retourne toujours la même entité. Voir Hiérarchie des actifs.
Enregistrer une lecture (hôte General)
Stocke des paires clé-valeur comme une lecture d’un type d’enregistrement qui accepte les écritures depuis les flux (par exemple les compteurs d’actifs, si votre offre les inclut). Les données des appareils ne sont jamais enregistrées ici.
| Paramètre | Signification | Par défaut | Valeurs |
|---|---|---|---|
| kind | Le type d’enregistrement | obligatoire | un type qui accepte les écritures depuis les flux |
| entity_path | Emplacement de l’identifiant de l’enregistrement | msg.originator.id | un chemin vers un UUID |
| ts, ts_path | Comme pour Enregistrer la télémétrie | horodatage de la lecture | |
| keys | Uniquement ces clés | chaque clé |
Erreurs : invalid_value, invalid_entity, unknown_kind, kind_not_writable, entity_not_writable, bad_ts, save_failed.
Fin des métadonnées
Les valeurs écrites sous msg.metadata ne sont jamais enregistrées ; les valeurs sous msg.payload sont enregistrées par un bloc Enregistrer la télémétrie ultérieur. Placez l’enrichissement sous msg.metadata sauf si vous souhaitez le stocker.

