De Assert event is een debug-gereedschap, vergelijkbaar met de Conditional event, dat de logica van uw keten test en valideert dat deze 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. U vindt een lijst met veelvoorkomende use cases onderaan dit artikel.
Stap 1: Voeg de gebeurtenis toe aan de ketting
- In Chain Builder, op het tabblad Chains klikt u 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, koppelt u het los van andere knooppunten en verplaatst u het vervolgens naar de plaats waar het moet komen. Om meerdere nodes tegelijk te verplaatsen, houdt u SHIFT ingedrukt terwijl u ze selecteert.
- Selecteer het knooppunt van de gebeurtenis en klik op Bewerken.
- Voer onder Basisinfo een unieke naam en beschrijving in om de gebeurtenis te helpen identificeren.
Opmerking: Schakel Stop Chain on Fail in als de hele keten moet stoppen wanneer deze bewering faalt. Als deze optie niet is aangevinkt, zullen andere kettingtakken doorlopen tot ze voltooid zijn, zelfs als deze takken falen.
Stap 2: De voorwaardelijke logica instellen
Onder Conditions, bouwt u de voorwaardelijke logica op 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 u meerdere regels of groepen opneemt, voeg ze dan samen met een AND of OR boolean:
- Als alle regels of groepen waar moeten zijn om de voorwaarde te laten slagen, selecteert u EN.
- Als een regel of groep van waar moet zijn om de voorwaarde te laten slagen, selecteert u OF.
- Selecteer voor elke regel het gegevenstype en de uitvoer of variabele die u wilt testen, en stel de criteria in om aan de voorwaarde te voldoen:
- Om te testen of de waarde leeg is, selecteert u Is leeg of Is niet leeg.
- Om te testen of de waarde specifieke tekens of een andere uitvoer- of variabele waarde bevat, selecteert u Bevat en voert u de waarde in of selecteert u de waarde die overeen moet komen.
- Om te testen of de waarde voldoet aan een reguliere uitdrukking, selecteert u Matches RegExp, en voert u de uitdrukking in waarmee u wilt overeenkomen.
- Om te testen of de waarde begint of eindigt met specifieke tekens of een andere uitvoer- of variabele waarde, selecteert u Beginnen met of Eindigen met, en voert u de waarde in of selecteert u de waarde die overeen moet komen.
- Om te testen of een numerieke waarde gelijk is aan een bedrag, selecteert u = of !=, en voert u het bedrag in of selecteert u het.
- Om te testen of een numerieke waarde groter of kleiner is dan een bedrag, selecteert u < of >, en voert u het bedrag in of selecteert u het.
- Om te testen of een numerieke waarde groter of kleiner is dan of gelijk is aan een bedrag, selecteert u <= of >=, en voert u het bedrag in of selecteert u het.
- Nadat u de voorwaardelijke logica hebt ingesteld, klikt u op Opslaan.
Opmerking: Om een regel uit de voorwaardelijke logica te verwijderen, klikt u op .
Voorwaarden en algemene gebruikssituaties
De gebeurtenis Assert kan aan meerdere paden of "takken" van een keten worden toegevoegd. Elke assertie werkt onafhankelijk, wat betekent dat een mislukte assertie alleen de specifieke tak stopt waar deze is geplaatst - alle andere takken zullen doorlopen tot ze voltooid zijn. Als echter een enkele assertie faalt, wordt de hele keten gemarkeerd als "Mislukt".
Wetenswaardigheden:
- Schakel de optie Stop chain on fail in om de hele keten onmiddellijk te stoppen wanneer een assertie faalt.
- U kunt een kettingfout opheffen door een Set Chain Result event toe 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 kettingloop gaat zonder onderbreking door. |
|
Bewering mislukt (enkele bewering) |
Uitvoeren mislukt; Ketting 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 vóór kritieke punten stopt als niet aan een voorwaarde wordt voldaan. Wanneer een Assert-gebeurtenis een afhankelijkheid is van de volgende knooppunten, zal de hele keten stoppen. |
|
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 bewering faalt, dan worden alle andere takken onmiddellijk gestopt. Voorbeeld: (Klik om te vergroten) |
|
Bewering mislukt (meerdere takken/bevestigingen) |
De kettingrun stopt bij de mislukte vertakking, maar gaat door voor alle andere vertakkingen totdat aan een Guard/Stop voorwaarde wordt voldaan; Keten mislukt |
De Assert-gebeurtenis kan op meerdere paden of "takken" binnen dezelfde keten geplaatst worden. Een mislukte assertie zal die specifieke tak stoppen, maar alle andere takken zullen blijven draaien. Hierdoor kunt u meerdere voorwaarden binnen dezelfde keten testen. Voorbeeld: (Klik om te vergroten) |
Gebeurtenis bevestigen vs. Voorwaardelijke gebeurtenis
De gebeurtenis Conditional (Voorwaardelijk) kan in combinatie met de gebeurtenis Set Chain Result (Ketenresultaat instellen) worden gebruikt om vergelijkbare resultaten te bereiken - maar in vergelijking met de gebeurtenis Assert zijn er meerdere knooppunten en vertakkingspaden nodig. 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 opnieuw te maken met een Voorwaardelijke gebeurtenis:
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.