De Assert event is een debug-gereedschap, vergelijkbaar met de Conditional event, dat de logica van je keten test en valideert dat het werkt zoals bedoeld. Op het meest basale niveau zal een kettingtak ononderbroken doorgaan als een assertie slaagt en stoppen als een assertie faalt - maar er zijn een aantal voorwaarden die deze regel beïnvloeden. Onderaan dit artikel vind je een lijst met veelvoorkomende use cases .
Stap 1: Voeg de gebeurtenis toe aan de keten
- Klik in Chain Builderop het tabblad Chains op Bewerk voor de keten.
- Klik op Ketengebeurtenissen, en verplaats Assert naar de plaats in de keten waar de gebeurtenis moet plaatsvinden.
- Sleep een link naar de gebeurtenis vanaf het vorige knooppunt in de keten.
Opmerking: Om de positie van een knooppunt in de keten te wijzigen, ontkoppel je het van andere knooppunten en verplaats je het naar de plaats waar het moet komen. Om meerdere nodes tegelijk te verplaatsen, houd je SHIFT ingedrukt terwijl je ze selecteert.
- Selecteer het knooppunt van de gebeurtenis en klik op Bewerken .
- Voer onder Basisinfoeen unieke naam en beschrijving in om de gebeurtenis te helpen identificeren.
Opmerking: Schakel Stop Chain on Fail in als de hele keten moet stoppen als deze bewering faalt. Als deze optie niet is aangevinkt, zullen andere kettingtakken worden voltooid, zelfs als deze takken falen.
Stap 2: De voorwaardelijke logica instellen
Onder Conditions, bouw de voorwaardelijke logica als regels of groepen regels om uitgangen en variabelen van verschillende gegevenstypen te testen:
- String, voor een of meer tekens
- Geheel getal, voor elke gehele, niet-decimale numerieke waarde
- Datum, voor een datumstring of -variabele
- Float, voor elke numerieke waarde
- JSON, voor Javascript Object Notation
Opmerking: Gebruik voor JSON een variabele transformatie om waarden te parsen.
- Selecteer of u een Regel of Groep van regels wilt toevoegen.
- Als je meerdere regels of groepen opneemt, voeg ze dan samen met een AND of OR boolean:
- Als alle regels of groepen waar moeten zijn om aan de voorwaarde te voldoen, selecteer dan AND.
- Als een regel of groep van waar moet zijn om de voorwaarde te laten slagen, selecteer dan OF.
- Selecteer voor elke regel het gegevenstype en de uitvoer of variabele om te testen en stel de criteria in om aan de voorwaarde te voldoen:
- Om te testen of de waarde leeg is, selecteer je Is leeg of Is niet leeg.
- Om te testen of de waarde specifieke tekens of een andere uitvoer- of variabele waarde bevat, selecteer je Bevaten voer je de waarde in of selecteer je de waarde die moet overeenkomen.
- Om te testen of de waarde voldoet aan een reguliere uitdrukking, selecteer je Matches RegExp, en voer je de uitdrukking in die je wilt matchen.
- Om te testen of de waarde begint of eindigt met specifieke tekens of een andere uitvoer- of variabele waarde, selecteer je Beginnen met of Eindigen met, en voer je de waarde in of selecteer je deze.
- Om te testen of een numerieke waarde gelijk is aan een bedrag, selecteer je = of !=, en voer je het bedrag in of selecteer je het.
- Om te testen of een numerieke waarde groter of kleiner is dan een bedrag, selecteer je < of >, en voer je het bedrag in of selecteer je het.
- Om te testen of een numerieke waarde groter of kleiner is dan of gelijk is aan een bedrag, selecteer je <= of >=, en voer je het bedrag in of selecteer je het.
- Nadat je de voorwaardelijke logica hebt ingesteld, klik je op Opslaan.
Opmerking: Als u een regel uit de voorwaardelijke logica wilt verwijderen, klikt u op .
Voorwaarden en algemene gebruikssituaties
De gebeurtenis Assert kan worden toegevoegd aan meerdere paden of "takken" van een keten. Elke assertie werkt onafhankelijk, wat betekent dat een mislukte assertie alleen de specifieke tak stopt waar deze is geplaatst - alle andere takken zullen doorgaan tot ze voltooid zijn. Als echter een enkele assertie faalt, dan wordt de hele keten gemarkeerd als "Mislukt".
Wetenswaardigheden:
- Schakel de optie Stop chain on fail in om de hele keten onmiddellijk te stoppen als een assertie faalt.
- Je kunt een kettingfout opheffen door een Set Chain Result eventtoe te voegen. Als een Set Chain Result-knooppunt is ingesteld op "Succeed", zal de keten altijd slagen, ongeacht eventuele mislukte asserties.
Voorwaarde |
Resultaat |
Uitleg |
|---|---|---|
| Bewering passeert | Run gaat door; Chain is geslaagd | De ketting loopt zonder onderbreking door. |
|
Bewering mislukt (enkele bewering) |
Uitvoeren mislukt; Chain mislukt |
Als een enkele assertie op een kettingpad wordt geplaatst, stopt de kettingloop als de assertie faalt. Voorbeeld: (Klik om te vergroten) Opmerking: Een assert event kan worden gebruikt als een "bewaker" die een keten stopt voor kritieke punten als niet aan een voorwaarde wordt voldaan. Als een Assert-gebeurtenis een afhankelijkheid is van de volgende knooppunten, stopt de hele keten. |
|
Bewering mislukt (met "Stop Chain on Fail" ingeschakeld) |
Uitvoeren mislukt; Ketting mislukt; Ketting stopt onmiddellijk |
Als de optie "Stop Chain on Fail" is ingeschakeld en die assertie faalt, dan worden alle andere takken onmiddellijk gestopt. Voorbeeld: (Klik om te vergroten) |
|
Bewering mislukt (meerdere takken/bevestigingen) |
De kettingloop stopt bij de mislukte vertakking, maar gaat door voor alle andere vertakkingen totdat aan een Guard/Stop voorwaarde wordt voldaan; Keten mislukt |
De gebeurtenis Assert kan op meerdere paden of "takken" binnen dezelfde keten worden geplaatst. Een mislukte assertie zal die specifieke tak stoppen, maar alle andere takken zullen blijven draaien. Hierdoor kun je meerdere voorwaarden binnen dezelfde keten testen. Voorbeeld: (Klik om te vergroten) |
Gebeurtenis bevestigen vs. Voorwaardelijke gebeurtenis
De gebeurtenis Conditionalkan in combinatie met de gebeurtenis Set Chain Resultworden gebruikt om vergelijkbare resultaten te bereiken, maar er zijn meerdere knooppunten en vertakkingspaden nodig ten opzichte van de gebeurtenis Assert. De gebeurtenis Assert is bedoeld om dit complexere proces te vereenvoudigen en te vervangen.
Om dit te demonstreren is hier een voorbeeld van de typische logica die nodig is om een "Pass" en "Fail" vertakking te maken met een Conditional event:
En hier is dezelfde logica met een enkele Assert-gebeurtenis:
Opmerking: Bij gebruik op dezelfde keten zal de Set Chain Result event altijd de resultaten van een Assert event overschrijven. Bijvoorbeeld, een keten met een Set Chain Result knooppunt dat is ingesteld op "Succeed" zal altijd slagen, ongeacht de Assert gebeurtenis.