Pré-requis : pour gérer les métriques calculées, il faut avoir le rôle d'Administrateur Fonctionnel dans io-base.
Accéder au module Formules (menu disponible depuis la page d'accueil du portail).
La modification d'une formule est accessible à partir du bouton de modification dans la colonne Actions.
Depuis l'écran de modification, vous pouvez désactiver ou activer une formule.
Vous pouvez aussi modifier les paramètres de la formule.
Remarque : il est impossible de modifier le nom de la métrique calculée, ainsi que la base de données cible. Pour cela, il faut supprimer la formule et la recréer.
L'écran de modification d'une formule se décompose en trois partes :
définition de la métrique qui sera ajoutée à la base de données
mise en place de la périodicité de calcul des valeurs de la métrique
écriture de la formule de calcul des valeurs
Une fois les informations modifiées, il faut cliquer sur le bouton Mettre à jour la formule. Pour que le bouton soit disponible, il faut que l'expression de la formule soit testée et valide.
Définition de la métrique
La zone Définition vous permet de modifier les informations générales sur la métrique calculée :
Nom de la métrique : non modifiable
Base de donnée : la base de donnée dans laquelle est la métrique, non modifiable
Description : permet de donner des indications sur la métrique
Unité : unité des valeurs de la métrique
Périodicité de calcul
La zone Périodicité vous permet de donner définir la fréquence à laquelle les valeurs de la métrique vont être calculées. Il y a trois options possibles :
En continu : les valeurs se calculeront en permanence, si une valeur d'une métrique utilisée dans la formule change.
Simplifiée : permet de définir un nombre de secondes/minutes/heures entre le calcul de deux valeurs
Avancé : permet de définir une fréquence plus complexe, en utilisant les "Expressions CRON". Un lien d'aide est disponible dans l'écran, pour vous aider à écrire cette fréquence.
Pour résumer, la fréquence va se définir par 5 caractères.
minute
heure
jour du mois
mois
jour de la semaine
Il est possible de saisir des caractères spéciaux :
* : n'importe quelle valeurs
, : séparateur de valeur pour une liste
- : séparateur pour une plage de valeur
/ : valeur pas à pas
Exemple : 50*8* veut dire "A 00:05 en août"
Renseignez également le fuseau horaire sur lequel vous souhaitez paramétrer votre formule.
Une aide à la saisie est proposée, il vous suffit de taper le début de votre saisie, et les fuseaux horaires disponibles s'affichent :
Lors de votre saisie, commencez par indiquer le continent puis la capitale (ou la capitale économique) du pays, séparés par un "/".
exemples :
Définition de la formule
Cette dernière zone consiste à définir la formule qui sera appliquée pour calculer les valeurs de la nouvelle métrique. Elle contient les champs suivants :
validité des données en seconde : cette valeur permet de s'assurer que les valeurs calculées sont basées sur des données valides.
Par exemple, si l'expression est main@tag>5, et que la durée de validité est à 60 secondes. Au moment où la formule doit se recalculer, cela va regarder quelle est la date de la dernière valeur en base pour main@tag. Si cette date est plus ancienne que 60 secondes, alors on estime que la valeur n'est pas fiable. On ne va donc pas recalculer la formule, et aucune nouvelle valeur ne sera insérée pour l'instant.
Si vous souhaitez recalculer une valeur quoi qu'il arrive à chaque fois, et ignorer cette fonctionnalité, il suffit de mettre 0 dans ce champ.
type de résultat : indique sous quel format les valeurs calculées vont être stockées dans la base de donnée :
BOOL : booléen
INT : entier
REAL : décimal
expression: c'est le champ qui va contenir la formule.
Vous pouvez taper directement dans la zone de texte, ou vous servir des différents boutons pour vous aider.
Avec le bouton Recherche de métrique, vous pouvez aller chercher une métrique existante dans la base pour éviter de la saisir.
Les boutons en dessous présentent la liste des opérateurs qu'il est possible d'utiliser dans l'expression.
Le bouton ? disponible sur le champ Expression vous donne des explications complémentaires sur la saisie d'une formule
Une fois que vous avez saisi votre expression de formule, vous devez la tester en cliquant sur le bouton Tester l'expression. Si la formule est juste, le champ expression s'encadre en vert. Sinon, il sera rouge.
Exemple d'expression valide :
Exemple d'expression invalide :
Le bouton Effacer permet d'effacer le contenu du champ Expression pour recommencer la saisie.