Workflows y fuentes REST
Workflows
Los workflows son lógica en el servidor – con el mismo motor y el mismo editor que IllusionCMS e IllusionForms: nodos unidos por cables, un mensaje msg recorre el flujo desde el inicio. Un workflow pertenece a la app (pestaña Workflows) y se ejecuta cuando se llama a una consulta de tipo Ejecutar workflow:
- Los parámetros de la consulta llegan en
msg.payload, la cuenta enmsg.user(id,email,role). - El nodo Respuesta HTTP es la respuesta a la app (
msg.payload); sin él, la consulta responde{"ok": true}. - Una ejecución dura como máximo 20 segundos.
Nodos: Inicio, Función (JavaScript con msg), Desvío, Petición HTTP, Retardo, Unión, Respuesta HTTP, Debug y los nodos de IllusionDB:
| Nodo | Efecto |
|---|---|
| Listar registros | tabla, filtro (JSON con {{ msg.… }}), orden, máximo → msg.payload es la lista |
| Leer registro | tabla, registro (clave primaria) → msg.payload |
| Crear registro | tabla, valores (JSON) – vacío = msg.payload es el registro |
| Cambiar registro | tabla, registro, valores |
Los nodos de IllusionDB llegan exactamente a las tablas que nombran, con los permisos como en las consultas. Las peticiones HTTP tienen la misma protección de destinos que los webhooks (direcciones de metadatos de la nube siempre bloqueadas, direcciones locales según Configuración → Seguridad). Planificaciones, entradas HTTP y correos no existen en los workflows de apps.
En el borrador un nodo puede estar aún incompleto (el guardado automático sigue funcionando); Publicar comprueba todos los nodos.
Fuentes REST
Para API externas crea una fuente en Apps → Fuentes REST: nombre, dirección base (p. ej. https://api.example.com/v1) y encabezados como Authorization: Bearer … o X-Api-Key. Los encabezados se guardan cifrados (con ENCRYPTION_KEY, como las contraseñas de las fuentes de datos), no se vuelven a mostrar y nunca llegan al navegador.
Una consulta de tipo Fuente REST indica la fuente, el método, la ruta (p. ej. /items?q={{params.q}}, los marcadores se codifican) y para POST/PUT/PATCH un cuerpo (JSON con marcadores). Una lista JSON como respuesta se convierte en records como en Listar registros – tablas y listas la muestran directamente. Las respuestas con estado 400 o superior se convierten en un error de la consulta.