Manual · 8

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 en msg.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.