Inleiding tot scenario's
Een scenario is een graaf. Vakjes (de acties) zijn verbonden door verbindingen die waarden en signalen vervoeren. De engine voert een vakje uit zodra al zijn aangesloten invoeren iets hebben ontvangen.
Dat is wat in Restorm de pre- en post-requestscripts van andere API-clients vervangt — met één beslissend voordeel: u ziet de stroom.
Rechtsklik in de boom ▸ Toevoegen ▸ Scenario.
Waar het voor dient
Section titled “Waar het voor dient”- Aanroepen aan elkaar knopen en een waarde van de een aan de ander doorgeven: een resource aanmaken, haar identificator ophalen, en die in de volgende aanroep gebruiken.
- Controleren: asserties, validatie van een JSON-schema, vergelijking.
- Vertakken en herhalen:
if,switch,for,forEach,while,retry. - Meerdere transporten orkestreren: een MQTT-abonnement openen, een actie via HTTP uitlokken, controleren dat het bericht aankomt.
- Automatiseren: hetzelfde scenario draait in de interface en zonder venster in continue integratie.
De bouwstenen
Section titled “De bouwstenen”| Begrip | Wat het is |
|---|---|
| Vakje (node) | Een actie. Er zijn negentig soorten beschikbaar — zie de catalogus |
| Poort | Een aansluitpunt op een vakje, getypeerd en met een richting |
| Verbinding (edge) | Een draad tussen een uitvoerpoort en een invoerpoort |
| Selector | Een pad dat op de waarde onderweg over een verbinding wordt toegepast (data.items[0].id) |
| Runvariabele | Een benoemde waarde, die tijdens de uitvoering wordt gezet en teruggelezen |
| Parameter | Een invoer van het scenario, meegegeven bij de start of op de opdrachtregel |
| Uitvoer | Een resultaat dat aan de aanroeper van het scenario wordt aangeboden |
De drie poorten die elk vakje heeft
Section titled “De drie poorten die elk vakje heeft”Ze staan niet in de configuratie: ze horen bij het kader van het vakje.
| Poort | Richting | Rol |
|---|---|---|
in | Invoer | De trigger. Die accepteert meerdere inkomende verbindingen en wacht dan tot alle zijn aangekomen — het is de barrière “wachten tot meerdere takken klaar zijn” |
error | Uitvoer | De foutroute. Alles wat mislukt, gaat daarlangs |
done | Uitvoer | Wordt uitgestuurd wanneer het vakje en zijn hele stroomafwaartse subgraaf klaar zijn |
Het onderscheid tussen done en een waarde-uitvoer is belangrijk: een waarde
komt eruit zodra zij is geproduceerd, terwijl done wacht tot alles wat ervan
afhangt klaar is.
Een eerste scenario
Section titled “Een eerste scenario”- Voeg een actie HTTP-verzoek toe en koppel die aan een bestaand verzoek.
- Voeg een actie Assert toe, met operator
eq. - Trek een verbinding van de poort
responsevan het verzoek naar de invoeravan de assertie, en zet op die verbinding de selectorstatus. - Zet in de assertie
bop200. - Klik op Uitvoeren.
De assertie heeft twee uitvoeren, then en else: sluit op elk een Log of
een Toast aan om het resultaat langs te zien komen.
En daarna
Section titled “En daarna”- Een scenario bouwen — de handelingen in de editor.
- Poorten en verbindingen — het uitvoeringsmodel in detail.
- Variabelen en gegevens — hoe de waarden zich verplaatsen.
- Actiecatalogus — de 90 vakjes.
- Code-acties — wanneer de graaf niet volstaat.