Pré-requis : il est nécessaire d'avoir le rôle d'Administrateur fonctionnel pour accéder à cette fonctionnalité.

Se connecter au portail, et accéder au menu Référentiels / Règles de stockage.

La liste des règles de stockage existantes apparaît.

Cliquer sur le bouton de modification dans la colonne Actions.

La fenêtre de saisie des propriétés de la règle s'affiche. Elle contient les champs suivants :

Pour pouvoir valider l'ajout, il faut au minimum avoir renseigné un nom et une durée de validité. Une fois que c'est fait, cliquez sur Ajouter.

Pour appliquer une règle de stockage à une métrique, passer par le menu Référentiels / Gestion des métriques.

Par défaut, les données envoyées à l'API Indaba sont écrites directement en base. Afin d'alléger la base de données et d'améliorer les performances, il est conseillé de définir une bande morte.

Quand une nouvelle valeur est envoyée en base, elle est sauvegardée même si elle est égale à la valeur précédente. La définition d'une bande morte permet de donner un delta, en dessous duquel la nouvelle valeur ne sera pas enregistrée si elle ne diffère pas assez de la précédente.

Par exemple:

Bande morte = 0,5

Dernière valeur en base = 3,5

Nouvelle valeur = 3,8

Le delta entre 3,8 et 3,5 < à la bande morte, donc la nouvelle valeur n'est pas enregistrée.

Remarque : Pour désactiver le filtre par bande morte, saisissez "0".

Valeur inscrite en base :

Valeur non inscrite en base :

La durée de validité correspond au nombre de secondes pendant lesquelles on ne réinscrit pas une valeur en base, si elle n’a pas changé. Dans le cas où une bande morte est saisie, on considère que la valeur n’a pas changé si le delta avec l’ancienne valeur est inférieur à la valeur de la bande morte.

Remarque : Pour désactiver la durée de validité de la bande morte, saisissez "0".

Si la nouvelle valeur est comprise dans le rectangle dessiné ci-dessus, elle n’est pas sauvegardée en base.

Si au contraire elle est en dehors du rectangle, alors elle est inscrite en base et elle devient la nouvelle valeur courante de la métrique correspondante.

Pour vous guider dans la création ou modification d'une règle de stockage, un message vous indique le filtrage qui sera appliqué sur vos données.

Si "bande morte" > 0 et "durée de validité" > 0
​Les données seront enregistrées si l’écart entre deux valeurs consécutives est supérieur ou égal à X (valeur de la bande morte) ou si plus de Y secondes (durée de validité) se sont écoulées depuis la dernière écriture.

Exemple :

Si "bande morte" = 0 et "durée de validité" > 0
La donnée sera enregistrée si plus de Y secondes (durée de validité) se sont écoulées depuis la dernière écriture.

Exemple :

​
​Si "bande morte" > 0 et "durée de validité" = 0 :
​La donnée sera enregistrée si l’écart entre deux valeurs consécutives est supérieur ou égal à X (valeur de la bande morte).
​

Exemple : ​

​Si "bande morte" = 0 et "durée de validité" = 0 :
Filtrage de données désactivé.

Le nombre de chiffres après la virgule des données stockées sera déduit de la valeur saisie pour la bande morte. Par exemple si cette valeur vaut 0,02 alors les valeurs des métriques concernées seront stockées avec une précision de 3 chiffres après la virgule.

Lorsque la bande morte est désactivée ("bande morte"=0), le champ "chiffres après la virgule" devient actif :

Indiquer alors le nombre de chiffres après la virgule que vous souhaitez :

Remarque : Si vous saisissez "0", des nombres entiers seront enregistrés.

Remarque : Il est possible d'indiquer jusqu'à 6 chiffres après la virgule.

Dans le cas où aucune règle de stockage n'est définie, les valeurs par défaut sont les suivantes :

Si vous souhaitez modifier cette règle de stockage par défaut, contacter le support Io-base.

Vous pouvez visualiser votre règle de stockage par défaut en cliquant sur le bouton

dans la colonne Actions :