Assert-händelsen är ett felsökningsverktyg, i likhet med Conditional-händelsen, som testar logiken i din kedja och validerar att den fungerar som avsett. På den mest grundläggande nivån kommer en kedjegren att fortsätta oavbrutet när ett påstående godkänns och stoppas när ett påstående inte går - men det finns ett antal villkor som påverkar denna regel. Du hittar en lista över vanliga användningsfall längst ner i den här artikeln.
Steg 1: Lägg till händelsen i kedjan
- I Chain Builder, på fliken Chains , klickar du på Edit för kedjan.
- Klicka på Chain Events, och flytta Assert till den plats i kedjan där händelsen ska inträffa.
- Dra en länk till händelsen från föregående nod i kedjan.
Obs: För att ändra en nods position i kedjan måste du koppla bort den från andra noder och sedan flytta den till den plats där den ska vara. Om du vill flytta flera noder samtidigt håller du ned SHIFT medan du markerar dem.
- Markera evenemangets nod och klicka på Redigera .
- Under Basic Info anger du ett unikt namn och en beskrivning som hjälper dig att identifiera evenemanget.
Obs: Aktivera Stoppa kedjan vid Det gick inte om hela kedjan ska stoppas när detta påstående misslyckas. Om den inte markeras kommer andra grenar i kedjan att slutföras även om det gick inte att slutföra den här.
Steg 2: Ställ in den villkorliga logiken
Under Villkor, bygg upp den villkorliga logiken som regler eller grupper av regler för att testa utdata och variabler av olika datatyper:
- Sträng, för ett eller flera tecken
- Integer, för alla hela, icke-decimala numeriska värden
- Datum, för en datumsträng eller variabel
- Float, för valfritt numeriskt värde
- JSON, för Javascript Object Notation
Obs: För JSON, använd en variabelomvandling för att analysera värden.
- Välj om du vill lägga till en Regel eller Grupp av regler.
- Om du inkluderar flera regler eller grupper sammanfogar du dem med ett boolean AND eller OR:
- Om alla regler eller grupper måste vara sanna för att villkoret ska godkännas väljer du AND.
- Om någon regel eller grupp måste vara sann för att villkoret ska godkännas väljer du OR.
- För varje regel väljer du vilken typ av data och utdata eller variabel som ska testas och ställer in dess kriterier för att klara villkoret:
- Om du vill testa om värdet är tomt väljer du Är tomt eller Är inte tomt.
- Om du vill testa om värdet innehåller specifika tecken eller ett annat utdata- eller variabelvärde väljer du Innehåller och anger eller väljer det värde som ska matchas.
- Om du vill testa om värdet uppfyller ett reguljärt uttryck väljer du Matches RegExp och anger det uttryck som ska matchas.
- För att testa om värdet börjar eller slutar med specifika tecken eller ett annat utdata- eller variabelvärde, välj Börjar med eller Slutar med, och ange eller välj det värde som ska matchas.
- För att testa om ett numeriskt värde är lika med ett belopp, välj = eller !=, och ange eller välj beloppet.
- Om du vill testa om ett numeriskt värde är större eller mindre än ett belopp väljer du < eller > och anger eller väljer beloppet.
- Om du vill testa om ett numeriskt värde är större eller mindre än eller lika med ett belopp väljer du <= eller >= och anger eller väljer beloppet.
- När du har ställt in den villkorliga logiken klickar du på Spara.
Obs: Om du vill ta bort en regel från den villkorliga logiken klickar du på Radera .
Villkor och vanliga användningsfall
Assert-händelsen kan läggas till på flera vägar eller "grenar" i en kedja. Varje assertion fungerar självständigt, vilket innebär att en assertion som gick inte stoppar endast den gren där den är placerad - alla andra grenar fortsätter att köras till slut. Om något enstaka påstående misslyckas kommer dock hela kedjan att markeras som "Det gick inte".
Saker att veta:
- Aktivera alternativet Stop chain on fail för att omedelbart stoppa hela kedjan när ett påstående misslyckas.
- Du kan åsidosätta ett kedjebrott genom att lägga till en Set Chain Result-händelse. När en Set Chain Result-nod är inställd på "Succeed" kommer kedjan alltid att godkännas oavsett om det gick inte.
Skick |
Resultat |
Förklaring |
|---|---|---|
| Påståendet passerar | Körningen fortsätter | Kedjekörningen fortsätter utan avbrott. |
|
Påståendet går inte igenom (enstaka påstående) |
Körningen går inte |
När ett enda påstående placeras på en kedjebana stoppas kedjekörningen när påståendet går fel. Exempel: (Klicka för att förstora) Obs: En assert-händelse kan användas som en "vakt" som stoppar en kedja före kritiska punkter om ett villkor inte uppfylls. När en Assert-händelse är ett beroende av de efterföljande noderna stoppas hela kedjan. |
|
Påståendet går inte igenom (med "Stoppa kedjan om det gick inte" aktiverat) |
Körningen går inte |
När alternativet "Stop Chain on Fail" är aktiverat och det påståendet går inte igenom, stoppas alla andra grenar omedelbart. Exempel: (Klicka för att förstora) |
|
Påståendet går inte igenom (flera grenar/påståenden) |
Kedjekörningen stoppas i den gren där det gick inte, men fortsätter i alla andra grenar tills ett Guard/Stop-villkor uppfylls |
Assert-händelsen kan placeras på flera vägar eller "grenar" inom samma kedja. Ett assertion som gick inte kommer att stoppa den specifika grenen, men alla andra grenar kommer att fortsätta att köras. Detta gör att du kan testa flera villkor inom samma kedja. Exempel: (Klicka för att förstora) |
Bekräfta händelse vs. Villkorlig händelse
Händelsen Conditional kan, i kombination med händelsen Set Chain Result, användas för att uppnå liknande resultat - men det krävs flera noder och förgreningsvägar i förhållande till händelsen Assert. Assert-händelsen är avsedd att förenkla och ersätta denna mer komplexa process.
Här följer ett exempel på den typiska logik som krävs för att återskapa en "Pass"- och "Det gick inte"-gren med en villkorlig händelse:
Och här är samma logik med hjälp av en enda Assert-händelse:
Anm.: När händelsen Set Chain Result används i samma kedja kommer den alltid att åsidosätta resultatet av en Assert-händelse. Till exempel kommer en kedja med en Set Chain Result-nod som är inställd på "Succeed" alltid att godkännas oavsett Assert-händelsen.