Assert-hendelsen er et feilsøkingsverktøy, på samme måte som Conditional-hendelsen, som tester logikken i kjeden din og validerer at den fungerer som tiltenkt. På det mest grunnleggende nivået vil en kjedegren fortsette uavbrutt når en assertion blir godkjent, og stoppe når en assertion mislykkes - men det finnes en rekke forhold som påvirker denne regelen. Du finner en liste over vanlige bruksområder på nederst i denne artikkelen.
Trinn 1: Legg til hendelsen i kjeden
- I Chain Builder, fra Chains -fanen, klikker du på Edit for kjeden.
- Klikk på Chain Events, og flytt Assert til der hendelsen skal inntreffe i kjeden.
- Dra en kobling til hendelsen fra den foregående noden i kjeden.
Merk: Hvis du vil endre en nodes posisjon i kjeden, må du koble den fra andre noder og deretter flytte den dit den skal ligge. Hvis du vil flytte flere noder samtidig, holder du SHIFT nede mens du velger dem.
- Velg hendelsens node, og klikk på Edit.
- Under Basic Info angir du et unikt navn og en beskrivelse for å identifisere hendelsen.
Merk: Aktiver Stop Chain on Fail hvis hele kjeden skal stoppe når denne assertionen feiler. Hvis du ikke merker av for dette, vil andre kjedegrener fullføres selv om denne grenen mislykkes.
Trinn 2: Sett opp den betingede logikken
Under Conditions kan du bygge betingelseslogikken som regler eller grupper av regler for å teste utganger og variabler av ulike datatyper:
- String, for ett eller flere tegn
- Heltall, for en hvilken som helst hel, ikke-desimal numerisk verdi
- Date, for en datostreng eller variabel
- Float, for en hvilken som helst numerisk verdi
- JSON, for Javascript Object Notation
Merk: For JSON må du bruke en variabeltransformasjon for å analysere verdier.
- Velg om du vil legge til en Regel eller Gruppe av regler.
- Hvis du inkluderer flere regler eller grupper, kobler du dem sammen med en AND eller OR boolean:
- Hvis alle regler eller grupper må være sanne for at betingelsen skal passere, velger du AND.
- Hvis en regel eller gruppe må være sann for at betingelsen skal passere, velger du ELLER.
- For hver regel velger du datatypen og utdataene eller variabelen som skal testes, og angir kriteriene for å oppfylle betingelsen:
- For å teste om verdien er blank, velger du Er blank eller Er ikke blank.
- Hvis du vil teste om verdien inneholder bestemte tegn eller en annen utdata- eller variabelverdi, velger du Contains, og skriver inn eller velger verdien som skal matches.
- Hvis du vil teste om verdien oppfyller et regulært uttrykk, velger du Matches RegExp, og skriver inn uttrykket som skal matches.
- Hvis du vil teste om verdien begynner eller slutter med bestemte tegn eller en annen utdata- eller variabelverdi, velger du Starter med eller Slutter med, og skriver inn eller velger verdien som skal matches.
- Hvis du vil teste om en numerisk verdi er lik et beløp, velger du = eller !=, og skriver inn eller velger beløpet.
- Hvis du vil teste om en numerisk verdi er større eller mindre enn et beløp, velger du < eller >, og skriver inn eller velger beløpet.
- Hvis du vil teste om en numerisk verdi er større eller mindre enn eller lik et beløp, velger du <= eller >=, og skriver inn eller velger beløpet.
- Når du har konfigurert den betingede logikken, klikker du på Lagre.
Merk: Hvis du vil fjerne en regel fra den betingede logikken, klikker du på Delete .
Betingelser og vanlige brukstilfeller
Assert-hendelsen kan legges til i flere baner eller "grener" av en kjede. Hver assertion fungerer uavhengig av hverandre, noe som betyr at en mislykket assertion bare stopper den grenen der den er plassert - alle andre grener vil fortsette å kjøre til de er fullført. Hvis en enkelt assertion mislykkes, vil imidlertid hele kjeden bli merket som "Mislykket".
Ting du bør vite:
- Aktiver alternativet Stop chain on fail for å stoppe hele kjeden umiddelbart når en assertion feiler.
- Du kan overstyre en kjedefeil ved å legge til en Set Chain Result-hendelse. Når en Set Chain Result-node er satt til "Succeed", vil kjeden alltid bli godkjent uavhengig av eventuelle mislykkede assertions.
Betingelse |
Resultat |
Forklaring |
|---|---|---|
| Påstanden er bestått | Kjøringen fortsetter; kjeden lykkes | Kjedekjøringen fortsetter uten avbrudd. |
|
Påstanden mislykkes (enkeltstående påstand) |
Kjøringen mislykkes; kjeden mislykkes |
Når en enkelt assertion er plassert på en kjedesti, stopper kjedekjøringen når assertionen feiler. Eksempel: (Klikk for å forstørre) Merk: En assert-hendelse kan brukes som en "vakt" som stopper en kjede før kritiske punkter hvis en betingelse ikke er oppfylt. Når en Assert-hendelse er en avhengighet av de påfølgende nodene, vil hele kjeden stoppe. |
|
Påstanden mislykkes (med "Stopp kjede ved feil" aktivert) |
Kjøringen mislykkes; kjeden mislykkes; kjeden stopper umiddelbart |
Når alternativet "Stopp kjeden ved feil" er aktivert og den aktuelle assertionen mislykkes, stoppes alle andre grener umiddelbart. Eksempel: (Klikk for å forstørre) |
|
Påstanden mislykkes (flere grener/påstander) |
Kjedekjøringen stopper på den mislykkede grenen, men fortsetter for alle andre grener til en Guard/Stop-betingelse er oppfylt; Kjeden mislykkes |
Assert-hendelsen kan plasseres på flere baner eller "grener" i samme kjede. En mislykket assertion vil stoppe den aktuelle grenen, men alle andre grener vil fortsette å kjøre. Dette gjør at du kan teste flere betingelser i samme kjede. Eksempel: (Klikk for å forstørre) |
Bekreft hendelse vs. Betinget hendelse
Conditional-hendelsen, kombinert med Set Chain Result-hendelsen, kan brukes til å oppnå lignende resultater - men det kreves flere noder og forgreningsveier i forhold til Assert-hendelsen. Assert-hendelsen er ment å forenkle og erstatte denne mer komplekse prosessen.
Her er et eksempel på den typiske logikken som kreves for å gjenskape en "Pass"- og "Fail"-gren med en Conditional-hendelse:
Og her er den samme logikken ved hjelp av en enkelt Assert-hendelse:
Merk: Når Set Chain Result-hendelsen brukes i samme kjede, vil den alltid overstyre resultatene av en Assert-hendelse. For eksempel vil en kjede med en Set Chain Result-node som er satt til "Succeed", alltid bli godkjent uavhengig av Assert-hendelsen.