L'evento Assert è uno strumento di debug, simile all'evento Conditional, che testa la logica della tua catena e ne convalida il funzionamento. Al livello più elementare, un ramo di catena continua senza interruzioni quando un'asserzione passa e si interrompe quando un'asserzione fallisce, ma ci sono diverse condizioni che influenzano questa regola. Puoi trovare un elenco di casi d'uso comuni in fondo a questo articolo.
Passo 1: Aggiungere l'evento alla catena
- In Chain Builder, dalla scheda Chains , clicca su Edit per la catena.
- Clicca su Eventi a catena, e sposta Assert nel punto in cui l'evento deve essere inserito nella catena.
- Trascina un collegamento all'evento dal nodo precedente della catena.
Nota: Per cambiare la posizione di un nodo nella catena, scollegalo dagli altri nodi e poi spostalo nel punto in cui dovrebbe trovarsi. Per spostare più nodi contemporaneamente, tieni premuto SHIFT mentre li selezioni.
- Seleziona il nodo dell'evento e clicca su Modifica .
- In Informazioni di base, inserisci un nome e una descrizione unici per identificare l'evento.
Nota: Abilita Stop Chain on Fail se l'intera catena deve arrestarsi quando questa asserzione fallisce. Se la casella non è selezionata, gli altri rami della catena verranno portati a termine anche se questo particolare ramo fallisce.
Passo 2: Impostare la logica condizionale
In Condizioni, costruisci la logica condizionale come regole o gruppi di regole per testare uscite e variabili di vari tipi di dati:
- Stringa, per uno o più caratteri
- Integer, per qualsiasi valore numerico intero non decimale
- Date, per una stringa o una variabile di data
- Float, per qualsiasi valore numerico
- JSON, per Javascript Object Notation
Nota: Per JSON, usa una trasformazione variabile per analizzare i valori.
- Seleziona se aggiungere una Regola o Gruppo di regole.
- Se includi più regole o gruppi, uniscili con un booleano AND o OR:
- Se tutte le regole o i gruppi di devono essere veri affinché la condizione passi, seleziona E.
- Se qualsiasi regola o gruppo di deve essere vera perché la condizione passi, seleziona O.
- Per ogni regola, seleziona il tipo di dati e l'output o la variabile da testare e imposta i criteri per superare la condizione:
- Per verificare se il valore è vuoto, seleziona Is blank o Is not blank.
- Per verificare se il valore include caratteri specifici o un altro valore di output o variabile, seleziona Contains, e inserisci o seleziona il valore da abbinare.
- Per verificare se il valore corrisponde a un'espressione regolare, seleziona Matches RegExp, e inserisci l'espressione a cui corrispondere.
- Per verificare se il valore inizia o finisce con caratteri specifici o con un altro valore di uscita o variabile, seleziona Inizia con o Finisce con, e inserisci o seleziona il valore da abbinare.
- Per verificare se un valore numerico è uguale a un importo, seleziona = o !=, e inserisci o seleziona l'importo.
- Per verificare se un valore numerico è maggiore o minore di un importo, seleziona < o > e inserisci o seleziona l'importo.
- Per verificare se un valore numerico è maggiore o minore di un importo, seleziona <= o >= e inserisci o seleziona l'importo.
- Dopo aver impostato la logica condizionale, clicca su Salva.
Nota: Per rimuovere una regola dalla logica condizionale, clicca su Elimina .
Condizioni e casi d'uso comuni
L'evento Assert può essere aggiunto a più percorsi o "rami" di una catena. Ogni asserzione opera in modo indipendente, il che significa che un'asserzione fallita arresterà solo il ramo in cui è inserita - tutti gli altri rami continueranno a funzionare fino al completamento. Tuttavia, se una singola asserzione fallisce, l'intera catena verrà contrassegnata come "Fallita".
Cose da sapere:
- Abilita l'opzione Stop chain on fail per interrompere immediatamente l'intera catena quando un'asserzione fallisce.
- Puoi annullare un fallimento della catena aggiungendo un evento Set Chain Result. Quando un nodo Set Chain Result è impostato su "Succeed", la catena passa sempre, indipendentemente dalle asserzioni fallite.
Condizioni |
Risultato |
Spiegazione |
|---|---|---|
| L'asserzione viene superata | L'esecuzione continua; la catena ha successo | L'esecuzione della catena continua senza interruzioni. |
|
L'asserzione fallisce (singola asserzione) |
L'esecuzione fallisce; la catena fallisce |
Quando una singola asserzione viene inserita in un percorso a catena, l'esecuzione della catena si interrompe quando l'asserzione fallisce. Esempio: (Clicca per ingrandire) Nota: Un evento assert può essere utilizzato come "guardia" che arresta una catena prima dei punti critici se una condizione non è soddisfatta. Quando un evento Assert è una dipendenza dei nodi successivi, l'intera catena si arresta. |
|
L'asserzione fallisce (con "Stop Chain on Fail" abilitato) |
L'esecuzione fallisce; la catena fallisce; la catena si arresta immediatamente |
Quando l'opzione "Stop Chain on Fail" è attivata e l'asserzione fallisce, tutti gli altri rami vengono immediatamente interrotti. Esempio: (Clicca per ingrandire) |
|
L'asserzione fallisce (più rami/asserzioni) |
L'esecuzione della catena si arresta sul ramo fallito, ma continua per tutti gli altri rami fino a quando non viene soddisfatta una condizione di Guard/Stop; la catena fallisce |
L'evento Assert può essere inserito in più percorsi o "rami" all'interno della stessa catena. Un'asserzione fallita interromperà quel particolare ramo, ma tutti gli altri rami continueranno ad essere eseguiti. Questo ti permette di testare più condizioni all'interno della stessa catena. Esempio: (Clicca per ingrandire) |
Evento assert vs. evento condizionale Evento condizionale
L'evento Conditional, se combinato con l'evento Set Chain Result, può essere utilizzato per ottenere risultati simili, ma sono necessari più nodi e percorsi di ramificazione rispetto all'evento Assert. L'evento Assert ha lo scopo di semplificare e sostituire questo processo più complesso.
Per dimostrarlo, ecco un esempio della logica tipica richiesta per ricreare un ramo "Pass" e "Fail" con un evento condizionale:
Ed ecco la stessa logica utilizzando un singolo evento Assert:
Nota: Quando viene utilizzato sulla stessa catena, l'evento Set Chain Result sovrascrive sempre i risultati di un evento Assert. Ad esempio, una catena con un nodo Set Chain Result impostato su "Succeed" passerà sempre, indipendentemente dall'evento Assert.