Introduksjon til scenarioer

Et scenario er en graf. Bokser (handlingene) knyttes sammen av forbindelser som frakter verdier og signaler. Motoren kjører en boks så snart alle de tilkoblede inngangene har mottatt noe.

I Restorm er det dette som erstatter pre- og post-forespørselsskriptene i andre API-klienter — med én avgjørende fordel: du ser flyten.

Høyreklikk i treet ▸ Legg til ▸ Scenario.

Hva det brukes til

• Lenke sammen kall og sende en verdi fra det ene til det andre: opprette en ressurs, hente IDen dens og bruke den i neste kall.
• Verifisere: assertions, validering av JSON-skjema, sammenligning.
• Forgrene og gå i løkke: if, switch, for, forEach, while, retry.
• Orkestrere flere transportlag: åpne et MQTT-abonnement, utløse en handling over HTTP og sjekke at meldingen kommer fram.
• Automatisere: det samme scenarioet kjører i grensesnittet og uten vindu i kontinuerlig integrasjon.

Byggeklossene

Begrep	Hva det er
Boks (node)	En handling. Nitti typer er tilgjengelige — se katalogen
Port	Et tilkoblingspunkt på en boks, med type og retning
Forbindelse (kant)	En tråd mellom en utgangsport og en inngangsport
Selektor	En sti som anvendes på verdien som er underveis på en forbindelse (data.items[0].id)
Run-variabel	En navngitt verdi som settes og leses igjen under kjøringen
Parameter	Inndata til scenarioet, oppgitt ved start eller på kommandolinjen
Utdata	Et resultat som eksponeres for den som kaller scenarioet

De tre portene enhver boks har

De står ikke oppført i konfigurasjonen: de er en del av selve boksrammen.

Port	Retning	Rolle
in	Inngang	Utløseren. Den godtar flere innkommende forbindelser, og venter da til alle har kommet — dette er barrieren «vent til flere grener er ferdige»
error	Utgang	Feilruten. Alt som går galt, går ut her
done	Utgang	Sendes ut når boksen og hele delgrafen nedstrøms er ferdig

Skillet mellom done og en verdiutgang er viktig: en verdi går ut så snart den er produsert, mens done venter til alt som avhenger av den, er ferdig.

Ditt første scenario

1. Legg til en HTTP-forespørsel-handling og knytt den til en forespørsel som finnes fra før.
2. Legg til en Assert-handling med operatoren eq.
3. Trekk en forbindelse fra response-porten på forespørselen til inngangen a på assertionen, og sett selektoren status på forbindelsen.
4. Sett b til 200 i assertionen.
5. Klikk på Kjør.

Assertionen har to utganger, then og else: koble en Log eller en Toast på hver av dem for å se resultatet gå gjennom.

Veien videre

• Bygge et scenario — håndgrepene i editoren.
• Porter og forbindelser — kjøremodellen i detalj.
• Variabler og data — hvordan verdiene beveger seg.
• Handlingskatalog — de 90 boksene.
• Kodehandlinger — når grafen ikke er nok.

Utgave

Å utforme og kjøre scenarioer i grensesnittet er en del av Community-utgaven. Headless kjøring i CI og feilsøking steg for steg krever Pro-utgaven — se Planer og muligheter.