Construir un escenario

El editor

El lienzo en el centro, la paleta para añadir y el inspector alrededor. Las cajas se mueven con el ratón, y la vista se desplaza y se amplía.

Añadir una caja

Desde la paleta, organizada por categorías: control, composición (peticiones y conexiones), listas, bucles, tiempo, matemáticas, algorítmica, formatos de datos, codificación, interfaz, utilidades.

Una acción vinculada a una petición (Petición HTTP, Petición SOAP, todas las acciones de conexión) pide designar la petición del proyecto que maneja.

El vínculo escenario ↔ petición

Designar una petición en una acción crea un vínculo fuerte: la acción referencia la petición por su identificador, no por una copia. De ello se deriva que:

• la petición sigue estando compartida: modificarla (URL, cabeceras, cuerpo) cambia lo que ejecutan todos los escenarios que la usan, en su próxima ejecución;
• el vínculo sobrevive al cambio de nombre o al desplazamiento de la petición dentro del árbol: no se basa ni en el nombre ni en la ruta;
• desde la petición, la smartbar contiene un botón «Usada en escenarios» que enumera los escenarios que la llaman y permite saltar hasta ellos. Es el reflejo que conviene tener antes de modificar una petición compartida;
• una petición que falta (eliminada, o ausente al abrir el proyecto) hace fallar la validación del escenario: el botón de reproducción permanece bloqueado y la caja culpable se señala. Nunca hay un escenario roto en silencio.

Para volver a ejecutar la misma petición sin tocar su versión guardada, no la modifique: use las sobrescrituras (ajuste rápido, sobrescrituras de acción, enlace) que se describen en Sobrescribir una petición.

Configurar una caja

Cada caja tiene sus campos, que se introducen directamente en la caja o en el inspector. Los campos aceptan valores tipados —cadena, número, booleano, fecha, expresión Handlebars, variable, lista personalizada, secreto…—: consulte Variables y entornos.

Ctrl+Space activa el autocompletado de las variables y los helpers en los campos que lo aceptan.

Cablear

Tire desde un puerto de salida hacia un puerto de entrada.

Dos reglas que hay que conocer:

1. Un puerto de entrada solo acepta un enlace, salvo el puerto in, que acepta tantos como se quiera y actúa entonces como barrera.
2. Una salida de señal pura no puede alimentar una entrada de valor puro. Todo lo demás está permitido: una salida que lleva un valor sirve también como disparador.

Más detalles: Puertos y enlaces.

El selector de enlace

Un enlace puede llevar un selector: una ruta aplicada al valor en tránsito.

data.items[0].id
body['user-id']
status

Es lo que evita intercalar una caja de transformación entre cada llamada y su consumidor. El selector se ajusta al crear el enlace o más tarde; vaciarlo lo elimina.

Sobrescribir una petición

Una acción vinculada a una petición puede modificarla sin tocar la propia petición. Cuatro capas, en este orden:

1. la petición tal como está guardada;
2. un ajuste rápido (quick config) designado en la acción: así se reutiliza una variante guardada de una petición directamente en un escenario, sin volver a escribirla;
3. las sobrescrituras introducidas en la acción;
4. el valor que llega por un enlace al puerto de sobrescritura.

Es la forma limpia de repetir la misma llamada con tres juegos de datos.

Repetir en cada evento

El menú contextual de una caja ofrece «Repetir en cada evento recibido». Al activarla, la opción convierte todas las entradas cableadas en puertas «o» no bloqueantes: la caja se vuelve a disparar con cada valor recibido en cualquier puerto, en lugar de esperar a que estén todos.

Es imprescindible para tratar un flujo (cada mensaje MQTT, cada evento SSE), y es también lo que desbloquea un ciclo de finalización.

Parámetros y salidas

• Una caja Input / Param declara los parámetros del escenario. Se proporcionan al lanzarlo, en línea de comandos (--param nombre=valor), o se piden durante la ejecución en modo interactivo.
• Una caja Output / Return expone un resultado a quien la llama, útil cuando el escenario lo invoca otro mediante la acción Ejecutar el escenario.

Organizar

Restorm sabe ordenar automáticamente un grafo (disposición); las cajas siguen pudiéndose mover a mano después. Ctrl+Z deshace, Ctrl+Shift+Z rehace.

Validar

El botón de reproducción está bloqueado mientras queden errores de validación: enlace no válido, petición que falta, campo obligatorio vacío. Las cajas culpables se señalan.