L'événement Assert est un outil de débogage, similaire à l'événement conditionnel, qui teste la logique de votre chaîne et vérifie qu'elle fonctionne comme prévu. Au niveau le plus élémentaire, un branchement en chaîne se poursuit sans interruption lorsqu'une assertion réussit et s'arrête lorsqu'une assertion échoue - mais il existe un certain nombre de conditions qui affectent cette règle. Vous trouverez une liste de cas d'utilisation courants au bas de cet article.
Étape 1 : Ajouter l'événement à la chaîne
- Dans Chain Builder, dans l'onglet Chains , cliquez sur Edit pour la chaîne.
- Cliquez sur Chain Events, et déplacez Assert à l'endroit où l'événement doit se produire dans la chaîne.
- Faites glisser un lien vers l'événement à partir du nœud précédent de la chaîne.
Remarque : Pour modifier la position d'un nœud dans la chaîne, il faut le dissocier des autres nœuds, puis le déplacer à l'endroit où il devrait se trouver. Pour déplacer plusieurs nœuds à la fois, maintenez SHIFT pendant que vous les sélectionnez.
- Sélectionnez le nœud de l'événement et cliquez sur Edit .
- Sous Basic Info, saisissez un nom et une description uniques permettant d'identifier l'événement.
Note: Activer Stop Chain on Fail si l'ensemble de la chaîne doit s'arrêter en cas d'échec de cette assertion. Si cette option n'est pas cochée, les autres branches de la chaîne seront exécutées jusqu'au bout même si cette branche particulière échoue.
Étape 2 : Mise en place de la logique conditionnelle
Sous Conditions, construisez la logique conditionnelle sous forme de règles ou de groupes de règles pour tester les sorties et les variables de différents types de données :
- Chaîne, pour un ou plusieurs caractères
- Entier, pour toute valeur numérique entière non décimale
- Date, pour une chaîne ou une variable de date
- Flottant, pour toute valeur numérique
- JSON, pour Javascript Object Notation
Note : Pour JSON, utilisez une transformation variable pour analyser les valeurs.
- Choisissez d'ajouter une règle ou un groupe de règles.
- Si vous incluez plusieurs règles ou groupes, joignez-les à l'aide d'un booléen AND ou OR:
- Si toutes les règles ou tous les groupes de doivent être vrais pour que la condition soit remplie, sélectionnez ET.
- Si une règle ou un groupe doit être vrai pour que la condition soit remplie, sélectionnez OU.
- Pour chaque règle, sélectionnez le type de données et la sortie ou la variable à tester, et définissez ses critères de réussite de la condition :
- Pour vérifier si la valeur est vide, sélectionnez Est vide ou N'est pas vide.
- Pour vérifier si la valeur comprend des caractères spécifiques ou une autre valeur de sortie ou de variable, sélectionnez Contient, puis entrez ou sélectionnez la valeur à faire correspondre.
- Pour vérifier si la valeur correspond à une expression régulière, sélectionnez Matches RegExp et saisissez l'expression à faire correspondre.
- Pour vérifier si la valeur commence ou se termine par des caractères spécifiques ou par une autre valeur de sortie ou variable, sélectionnez Start with ou Ends with, et entrez ou sélectionnez la valeur à faire correspondre.
- Pour vérifier si une valeur numérique est égale à un montant, sélectionnez = ou !=, puis saisissez ou sélectionnez le montant.
- Pour vérifier si une valeur numérique est supérieure ou inférieure à un montant, sélectionnez < ou >, puis saisissez ou sélectionnez le montant.
- Pour vérifier si une valeur numérique est supérieure, inférieure ou égale à un montant, sélectionnez <= ou >=, puis saisissez ou sélectionnez le montant.
- Après avoir défini la logique conditionnelle, cliquez sur enregistrer.
Remarque : Pour supprimer une règle de la logique conditionnelle, cliquez sur Delete .
Conditions et cas d'utilisation courants
L'événement Assert peut être ajouté à plusieurs chemins ou "branches" d'une chaîne. Chaque assertion fonctionne de manière indépendante, ce qui signifie qu'une assertion qui échoue n'arrêtera que la branche particulière où elle est placée - toutes les autres branches continueront à fonctionner jusqu'à leur terme. Toutefois, si l'une des assertions échoue, l'ensemble de la chaîne sera marqué comme "Échec".
Ce qu'il faut savoir :
- Activez l'option Stop chain on fail pour arrêter immédiatement la chaîne entière lorsqu'une assertion échoue.
- Vous pouvez remplacer un échec de chaîne en ajoutant un événement Set Chain Result. Lorsqu'un nœud Set Chain Result a pour valeur "Succeed", la chaîne est toujours acceptée, quelles que soient les assertions qui ont échoué.
Condition |
Résultat |
Explication |
|---|---|---|
| Passes d'affirmation | L'exécution se poursuit, la chaîne réussit | Le déroulement de la chaîne se poursuit sans interruption. |
|
L'affirmation échoue (affirmation unique) |
Échec de l'exécution, échec de la chaîne |
Lorsqu'une seule assertion est placée sur un chemin de chaîne, l'exécution de la chaîne s'arrête lorsque l'assertion échoue. Exemple : (Cliquez pour agrandir) Note: Un événement assert peut être utilisé comme un "gardien" qui arrête une chaîne avant les points critiques si une condition n'est pas remplie. Lorsqu'un événement Assert est une dépendance des nœuds suivants, la chaîne entière s'arrête. |
|
L'affirmation échoue (avec l'option "Stop Chain on Fail" activée) |
Échec de l'exécution ; échec de la chaîne, la chaîne s'arrête immédiatement |
Lorsque l'option "Arrêter la chaîne en cas d'échec" est activée et que cette assertion échoue, toutes les autres branches sont immédiatement arrêtées. Exemple : (Cliquez pour agrandir) |
|
L'affirmation échoue (branches multiples/ assertions) |
L'exécution de la chaîne s'arrête sur la branche défaillante, mais se poursuit pour toutes les autres branches jusqu'à ce qu'une condition Guard/Stop soit remplie |
L'événement Assert peut être placé sur plusieurs chemins ou "branches" au sein de la même chaîne. L'échec d'une assertion entraîne l'arrêt de la branche concernée, mais toutes les autres branches continuent à fonctionner. Cela vous permet de tester plusieurs conditions au sein d'une même chaîne. Exemple : (Cliquez pour agrandir) |
Événement d'affirmation vs. Événement conditionnel
L'événement conditionnel, combiné à l'événement Résultat de la chaîne défini, peut être utilisé pour obtenir des résultats similaires - mais plusieurs nœuds et chemins de dérivation sont nécessaires par rapport à l'événement d'affirmation. L'événement Assert est destiné à simplifier et à remplacer ce processus plus complexe.
En guise de démonstration, voici un exemple de la logique typique requise pour recréer une branche "Pass" et "Fail" avec un événement conditionnel :
Et voici la même logique en utilisant un seul événement Assert :
Note: Lorsqu'il est utilisé sur la même chaîne, l'événement Set Chain Result est toujours prioritaire sur les résultats d'un événement Assert. Par exemple, une chaîne dont le nœud Set Chain Result est défini sur "Succeed" sera toujours réussie, quel que soit l'événement Assert.