Wprowadzenie do scenariuszy

Scenariusz jest grafem. Bloki (akcje) są połączone krawędziami, które przenoszą wartości i sygnały. Silnik wykonuje blok, gdy tylko wszystkie jego podłączone wejścia coś otrzymają.

To właśnie zastępuje w aplikacji Restorm skrypty pre-request i post-request znane z innych klientów API — z jedną decydującą zaletą: przepływ jest widoczny.

Kliknięcie prawym przyciskiem w drzewie ▸ Dodaj ▸ Scenariusz.

Do czego to służy

• Łączenie wywołań w łańcuch i przekazywanie wartości z jednego do drugiego: utworzenie zasobu, pobranie jego identyfikatora, użycie go w kolejnym wywołaniu.
• Weryfikowanie: asercje, walidacja schematu JSON, porównania.
• Rozgałęzianie i pętle: if, switch, for, forEach, while, retry.
• Orkiestracja wielu transportów: otwarcie subskrypcji MQTT, wywołanie akcji przez HTTP, sprawdzenie, że komunikat dociera.
• Automatyzacja: ten sam scenariusz działa w interfejsie oraz bez okna w ciągłej integracji.

Elementy składowe

Pojęcie	Czym jest
Blok (węzeł)	Akcja. Dostępnych jest dziewięćdziesiąt typów — zob. katalog
Port	Punkt podłączenia na bloku, typowany i skierowany
Połączenie (krawędź)	Przewód między portem wyjściowym a portem wejściowym
Selektor	Ścieżka stosowana do wartości przesyłanej przez połączenie (data.items[0].id)
Zmienna uruchomienia	Nazwana wartość, ustawiana i odczytywana w trakcie wykonania
Parametr	Wejście scenariusza, dostarczane przy uruchomieniu albo w wierszu poleceń
Wyjście	Wynik udostępniany wywołującemu scenariusz

Trzy porty, które ma każdy blok

Nie są wymienione w konfiguracji: stanowią część ramy bloku.

Port	Kierunek	Rola
in	Wejście	Wyzwalacz. Przyjmuje wiele połączeń wchodzących i czeka wówczas, aż dotrą wszystkie — to bariera „poczekaj na zakończenie kilku gałęzi”
error	Wyjście	Trasa błędu. Wszystko, co się nie udaje, wychodzi tą drogą
done	Wyjście	Emitowany, gdy blok oraz cały jego podgraf w dół zakończą pracę

Rozróżnienie między done a wyjściem wartości jest istotne: wartość wychodzi, gdy tylko zostanie wytworzona, natomiast done czeka na zakończenie wszystkiego, co od niej zależy.

Pierwszy scenariusz

1. Dodać akcję Żądanie HTTP i powiązać ją z istniejącym żądaniem.
2. Dodać akcję Assert z operatorem eq.
3. Przeciągnąć połączenie z portu response żądania do wejścia a asercji i ustawić na tym połączeniu selektor status.
4. W asercji ustawić b na 200.
5. Kliknąć Uruchom.

Asercja ma dwa wyjścia, then i else: podłączenie do każdego z nich bloku Log lub Toast pozwala obserwować przechodzący wynik.

Co dalej

• Budowanie scenariusza — obsługa edytora.
• Porty i połączenia — model wykonania w szczegółach.
• Zmienne i dane — jak krążą wartości.
• Katalog akcji — 90 bloków.
• Akcje kodu — gdy graf nie wystarcza.

Edycja

Projektowanie i uruchamianie scenariuszy w interfejsie należy do edycji Community. Uruchamianie headless w CI oraz debugowanie krok po kroku wymagają edycji Pro — zob. Plany i możliwości.