Langue: Français
Une étape de filtre décide si le flux continue. Sa condition — une formule qui doit être évaluée comme vraie ou fausse — est évaluée par rapport aux données de l'étape du déclencheur à chaque exécution de l'automatisation. Lorsque la condition est vraie, l'automatisation passe à l'étape suivante ; lorsqu'elle est fausse, l'exécution s'arrête et aucune autre étape n'est exécutée.
Une automatisation peut contenir plus d'un filtre. Chaque filtre ne protège que les étapes qui le suivent.
La formule de condition
La condition fait référence aux données de l'étape du déclencheur : les champs de l'enregistrement déclencheur, plus les colonnes réservées _previous (modifications uniquement), _user et _trigger. Les champs peuvent être référencés par code, par étiquette entre [crochets], ou par ID de champ ; nous recommandons fortement d'attribuer des codes à vos champs et de les utiliser — les codes survivent au changement d'étiquette et gardent les formules lisibles.
Conditions typiques :
| Objectif | Condition ||------|-----------|| Uniquement les enregistrements avec une sélection donnée | STATUS == "Recovered" | | Uniquement lorsqu'une sélection multiple contient une option | CONTAINS(SYMPTOMS, "Fever") | | Uniquement lorsqu'un champ a réellement changé (déclencheur de modification) | _previous.STATUS != STATUS | | Uniquement lorsqu'un champ est entré dans un état donné (déclencheur de modification) | STATUS == "Recovered" && _previous.STATUS != "Recovered" | | Uniquement au-dessus d'un seuil | AGE >= 18 | | Uniquement les enregistrements référençant un enregistrement parent donné | CLINIC.NAME == "Mangina Health Post" | | Uniquement les modifications apportées par un utilisateur spécifique | _user.email == "amara.diallo@example.org" | | Combinaison de conditions | AGE >= 18 && STATUS == "Under treatment" |
Le langage de formule est le même que celui utilisé dans ActivityInfo pour les mesures calculées ; les opérateurs de comparaison (==, !=, <, <=, >, >=), les opérateurs booléens (&&, ||, !), et les fonctions telles que ISBLANK, CONTAINS, IF, YEAR, et TODAY sont tous disponibles.
CONTAINS(SYMPTOMS, "Fever") teste si une sélection multiple contient une option, en comparant exactement l'étiquette de chaque option sélectionnée — "Fever" ne correspondra jamais à une option étiquetée "Fever (high)".
La liste des champs
L'éditeur liste les colonnes des données de l'étape du déclencheur à côté de la formule. Cliquer sur un champ insère une référence à celui-ci. Les champs de sélection se développent pour afficher leurs options : cliquer sur une option insère une condition complète, prête à l'emploi — une égalité telle que STATUS == "Recovered" pour une sélection unique, ou une recherche telle que CONTAINS(SYMPTOMS, "Fever") pour une sélection multiple. Les champs de référence se développent pour afficher les champs du formulaire référencé, et, pour le déclencheur de modification, l'instantané _previous se développe pour afficher les valeurs de l'enregistrement avant la modification.
Validation
L'éditeur valide la condition au fur et à mesure que vous la saisissez, en la comparant exactement aux données de l'étape que le déclencheur produira : un champ mal orthographié, une référence à _previous sous un déclencheur qui n'a pas d'état précédent, ou une condition qui ne produit pas de valeur vrai/faux est signalée avant que vous ne puissiez enregistrer.
Les conditions sont stockées en utilisant les ID de champ, de sorte qu'elles continuent de fonctionner lorsque les champs sont ré-étiquetés ; l'éditeur les affiche en utilisant des codes et des étiquettes.