Les flux

Les flux de données

L’écran des flux de données permet de gérér les données disponibles sur le réseau, qui doivent être enregistrées et conservées.
On arrive d’abord sur un écran qui liste les flux actuels connus. Il est possible d’en ajouter grâce au bouton “Nouveau”, ou de modifier un flux existant en le sélectionnant.
Les champs suivants sont utilisés :

Nom :

Nom du flux. C’est ce nom qui est affiché.

Code :

Code de ce flux de données.
Il est obligatoire et doit être unique car c’est ce code qui permet à la base de données d’enregistrer et de récupérer les données de ce flux.

Description :

Description et complèments d’information sur ce flux de données. C’est juste à titre informatif pour l’utilisateur.

Topic MQTT :

il s’agit du “topic” MQTT, un identifiant, auquel souscrire pour récupérer les données de ce flux. (Ne doit pas commencer par “/”).

Règles supplémentaires :

Il est possible de renseigner des règles supplémentaires qui vont régir l’enregistrement des données.
Pour le moment, et pour des questions de commodité et de souplesse, ces règles sont enregistrées au format json.
Il est possible de spécifier plusieurs régles. Pour que l’enregistrement se fasse, il suffit qu’une des règles soit vérifiée.
A noter que si le flux est marqué comme ‘retained’, la règle ne peut pas s’appliquer.

• Valeur minimale du changement :
  Il est possible de spécifier une différence de valeur nécessaire pour déclencher l’enregistrement des données. En effet, il peut sembler inutile d’enregistrer plusieurs fois de suite la même données, ou des données très proches.
  Le mot clè utilisé sera delta, auquel il faut ajouter le nom de la colonne à prendre en compte. Dans le cas de documents json imbriqués, l’élément de détail est indiqué à la suite de l’élément principal et séparé par -).
  Le champ “Dernières données” décrit ci-dessous est justement là pour montrer comment sont formatées les données du flux afin de choisir la colonne intéressante à utiliser.
  Un exemple pourrait être {"col": "temp", "delta": 0.5}, ce qui signifierait de n’enregistrer les données que si la valeur associée à l’élément nommé “temp” dépasse de “delta”, ici 0.5, la dernière valeur enregistrée.
  Noter que dans le cas d’un capteur Tasmota, l’exemple pourrait être {"col": "ENERGY-)Power", "delta": 10}. Consulter le paragraphe Elément à tracer pour plus de détails sur le nommage des colonnes.
• Temps écoulé :
  Si un delta est spécifié, il peut arriver que la règle soit très peu souvent vérifiée. En spécifiant une durée, exprimé en secondes, l’enregistrement va être forcé si le dernier enregistrement remonte plus loin que cette durée.
  Le mot clè utilisé sera elapsed, auquel il faut ajouter le nombre de secondes à prendre en compte Un exemple pourrait être {"elapsed": 3600}, ce qui signifierait que si plus d’une heure s’est écoulé depuis le précédent enregistrement, la valeur doit être enregistrée.
  Couplé avec une règle de valeur minimale, l’exemple serait {"col": "temp", "delta": 0.5}, {"elapsed": 3600}.

Dernières données :

Cette donnée est présentée à titre indicatif et n’est pas modifiable via cet écran.