Introducción a los escenarios
Un escenario es un grafo. Unas cajas (las acciones) se unen mediante enlaces que transportan valores y señales. El motor ejecuta una caja en cuanto todas sus entradas cableadas han recibido algo.
Es lo que, en Restorm, sustituye a los scripts de pre-petición y post-petición de otros clientes de API, con una ventaja decisiva: se ve el flujo.
Clic derecho en el árbol ▸ Añadir ▸ Escenario.
Para qué sirve
Section titled “Para qué sirve”- Encadenar llamadas y pasar un valor de una a otra: crear un recurso, recuperar su identificador y usarlo en la llamada siguiente.
- Comprobar: aserciones, validación de esquemas JSON, comparación.
- Ramificar e iterar:
if,switch,for,forEach,while,retry. - Orquestar varios transportes: abrir una suscripción MQTT, desencadenar una acción por HTTP y comprobar que el mensaje llega.
- Automatizar: el mismo escenario se ejecuta en la interfaz y sin ventana en integración continua.
Los componentes
Section titled “Los componentes”| Noción | Qué es |
|---|---|
| Caja (nodo) | Una acción. Hay noventa tipos disponibles: consulte el catálogo |
| Puerto | Un punto de conexión en una caja, tipado y orientado |
| Enlace (arista) | Un hilo entre un puerto de salida y un puerto de entrada |
| Selector | Una ruta aplicada al valor en tránsito por un enlace (data.items[0].id) |
| Variable de ejecución | Un valor con nombre, establecido y releído durante la ejecución |
| Parámetro | Una entrada del escenario, proporcionada al lanzarlo o en línea de comandos |
| Salida | Un resultado expuesto a quien llama al escenario |
Los tres puertos que tiene toda caja
Section titled “Los tres puertos que tiene toda caja”No se enumeran en la configuración: forman parte del marco de la caja.
| Puerto | Sentido | Función |
|---|---|---|
in | Entrada | El disparador. Acepta varios enlaces entrantes y espera entonces a que todos hayan llegado: es la barrera de «esperar a que varias ramas hayan terminado» |
error | Salida | La ruta de fallo. Todo lo que sale mal pasa por ahí |
done | Salida | Se emite cuando la caja y todo su subgrafo aguas abajo han terminado |
La distinción entre done y una salida de valor es importante: un valor sale en cuanto se
produce, mientras que done espera a que haya terminado todo lo que depende de él.
Un primer escenario
Section titled “Un primer escenario”- Añada una acción Petición HTTP y vincúlela a una petición existente.
- Añada una acción Assert, con el operador
eq. - Tire un enlace desde el puerto
responsede la petición hasta la entradaade la aserción, y coloque el selectorstatusen ese enlace. - En la aserción, ajuste
ba200. - Haga clic en Reproducir.
La aserción tiene dos salidas, then y else: conecte un Log o un Toast a cada
una para ver pasar el resultado.
Y después
Section titled “Y después”- Construir un escenario — los gestos del editor.
- Puertos y enlaces — el modelo de ejecución en detalle.
- Variables y datos — cómo circulan los valores.
- Catálogo de acciones — las 90 cajas.
- Acciones de código — cuando el grafo no basta.