Introduktion til scenarier

Et scenarie er en graf. Bokse (handlingerne) forbindes af forbindelser, der transporterer værdier og signaler. Motoren udfører en boks, så snart alle dens tilkoblede indgange har modtaget noget.

Det er dette, der i Restorm erstatter de andre API-klienters scripts før og efter anmodningen — med en afgørende fordel: du ser flowet.

Højreklik i træstrukturen ▸ Tilføj ▸ Scenarie.

Hvad kan du bruge det til

• Kæde kald sammen og sende en værdi fra det ene til det næste: opret en ressource, hent dens id, brug det i det følgende kald.
• Kontrollere: assertioner, validering af JSON-skema, sammenligning.
• Forgrene og gentage: if, switch, for, forEach, while, retry.
• Orkestrere flere transporter: åbn et MQTT-abonnement, udløs en handling via HTTP, kontrollér at beskeden når frem.
• Automatisere: det samme scenarie kører både i brugerfladen og uden vindue i continuous integration.

Byggeklodserne

Begreb	Hvad det er
Boks (knude)	En handling. Halvfems typer står til rådighed — se kataloget
Port	Et forbindelsespunkt på en boks, typet og med en retning
Forbindelse (kant)	En ledning mellem en udgangsport og en indgangsport
Selektor	En sti anvendt på værdien undervejs på en forbindelse (data.items[0].id)
Kørselsvariabel	En navngiven værdi, som sættes og læses under kørslen
Parameter	En indgang til scenariet, som leveres ved starten eller på kommandolinjen
Output	Et resultat, der stilles til rådighed for den, der kalder scenariet

De tre porte, enhver boks har

De står ikke i konfigurationen: de er en del af selve boksens ramme.

Port	Retning	Rolle
in	Indgang	Udløseren. Den accepterer flere indgående forbindelser og venter da på, at alle er nået frem — det er barrieren »vent til flere grene er færdige«
error	Udgang	Fejlruten. Alt, hvad der går galt, går ud ad den vej
done	Udgang	Udsendes, når boksen og hele dens efterfølgende delgraf er færdig

Forskellen mellem done og en værdiudgang er vigtig: en værdi kommer ud, så snart den er produceret, mens done venter på, at alt det, der afhænger af den, er færdigt.

Et første scenarie

1. Tilføj en HTTP-anmodning-handling og knyt den til en eksisterende anmodning.
2. Tilføj en Assert-handling med operatoren eq.
3. Træk en forbindelse fra anmodningens response-port til assertionens a-indgang, og sæt selektoren status på den forbindelse.
4. Sæt b til 200 i assertionen.
5. Klik på Afspil.

Assertionen har to udgange, then og else: kobl en Log eller en Toast på hver af dem for at se resultatet komme igennem.

Og hvad så

• Byg et scenarie — editorens håndgreb.
• Porte og forbindelser — udførelsesmodellen i detaljer.
• Variabler og data — hvordan værdierne bevæger sig.
• Handlingskatalog — de 90 bokse.
• Kodeknuder — når grafen ikke slår til.

Udgave

At designe og køre scenarier i brugerfladen hører til Community-udgaven. Headless-kørsel i CI og trinvis fejlfinding kræver Pro-udgaven — se Planer og kapaciteter.