Introduction aux scénarios
Un scénario est un graphe. Des boîtes (les actions) sont reliées par des liaisons qui transportent des valeurs et des signaux. Le moteur exécute une boîte dès que toutes ses entrées câblées ont reçu quelque chose.
C’est ce qui, dans Restorm, remplace les scripts pré-requête et post-requête des autres clients d’API — avec un avantage décisif : on voit le flux.
Clic droit dans l’arbre ▸ Ajouter ▸ Scénario.
À quoi ça sert
Section titled “À quoi ça sert”- Enchaîner des appels et passer une valeur de l’un à l’autre : créer une ressource, récupérer son identifiant, l’utiliser dans l’appel suivant.
- Vérifier : assertions, validation de schéma JSON, comparaison.
- Brancher et boucler :
if,switch,for,forEach,while,retry. - Orchestrer plusieurs transports : ouvrir un abonnement MQTT, déclencher une action par HTTP, vérifier que le message arrive.
- Automatiser : le même scénario tourne dans l’interface et sans fenêtre en intégration continue.
Les briques
Section titled “Les briques”| Notion | Ce que c’est |
|---|---|
| Boîte (nœud) | Une action. Quatre-vingt-dix types sont disponibles — voir le catalogue |
| Port | Un point de branchement sur une boîte, typé et orienté |
| Liaison (arête) | Un fil entre un port de sortie et un port d’entrée |
| Sélecteur | Un chemin appliqué à la valeur en transit sur une liaison (data.items[0].id) |
| Variable de run | Une valeur nommée, posée et relue pendant l’exécution |
| Paramètre | Une entrée du scénario, fournie au lancement ou en ligne de commande |
| Sortie | Un résultat exposé à l’appelant du scénario |
Les trois ports que toute boîte possède
Section titled “Les trois ports que toute boîte possède”Ils ne sont pas listés dans la configuration : ils font partie du cadre de la boîte.
| Port | Sens | Rôle |
|---|---|---|
in | Entrée | Le déclencheur. Il accepte plusieurs liaisons entrantes et attend alors que toutes soient arrivées — c’est la barrière « attendre que plusieurs branches soient terminées » |
error | Sortie | La route d’échec. Tout ce qui rate part par là |
done | Sortie | Émis quand la boîte et tout son sous-graphe aval ont fini |
La distinction done / sortie de valeur est importante : une valeur sort dès
qu’elle est produite, done attend que tout ce qui en dépend soit terminé.
Un premier scénario
Section titled “Un premier scénario”- Ajoutez une action Requête HTTP et liez-la à une requête existante.
- Ajoutez une action Assert, opérateur
eq. - Tirez une liaison depuis le port
responsede la requête vers l’entréeade l’assertion, et posez le sélecteurstatussur cette liaison. - Dans l’assertion, réglez
bà200. - Cliquez sur Lecture.
L’assertion a deux sorties, then et else : branchez un Log ou une
Toast sur chacune pour voir passer le résultat.
Et après
Section titled “Et après”- Construire un scénario — les gestes de l’éditeur.
- Ports et liaisons — le modèle d’exécution en détail.
- Variables et données — comment les valeurs circulent.
- Catalogue des actions — les 90 boîtes.
- Actions de code — quand le graphe ne suffit pas.