Manuale · 8

Workflow e sorgenti REST

Workflow

I workflow sono logica sul server – con lo stesso motore e lo stesso editor di IllusionCMS e IllusionForms: nodi collegati da fili, un messaggio msg scorre dall’avvio. Un workflow appartiene all’app (scheda Workflow) e viene eseguito quando si chiama una query di tipo Esegui workflow:

  • I parametri della query arrivano in msg.payload, l’account in msg.user (id, email, role).
  • Il nodo Risposta HTTP è la risposta all’app (msg.payload); senza di esso la query risponde {"ok": true}.
  • Un’esecuzione dura al massimo 20 secondi.

Nodi: Avvio, Funzione (JavaScript con msg), Deviatore, Richiesta HTTP, Ritardo, Unione, Risposta HTTP, Debug e i nodi IllusionDB:

Nodo Effetto
Elenca record tabella, filtro (JSON con {{ msg.… }}), ordinamento, massimo → msg.payload è l’elenco
Leggi record tabella, record (chiave primaria) → msg.payload
Crea record tabella, valori (JSON) – vuoto = msg.payload è il record
Modifica record tabella, record, valori

I nodi IllusionDB raggiungono esattamente le tabelle che nominano, con i diritti come per le query. Le richieste HTTP hanno la stessa protezione dei target dei webhook (indirizzi dei metadati cloud sempre bloccati, indirizzi locali secondo Impostazioni → Sicurezza). Pianificazioni, input HTTP ed e-mail non esistono nei workflow delle app.

Nella bozza un nodo può essere ancora incompleto (il salvataggio automatico continua); Pubblica controlla tutti i nodi.

Sorgenti REST

Per le API esterne crea una sorgente in App → Sorgenti REST: nome, indirizzo di base (es. https://api.example.com/v1) e header come Authorization: Bearer … o X-Api-Key. Gli header vengono salvati cifrati (con ENCRYPTION_KEY, come le password delle sorgenti dati), non vengono più mostrati e non arrivano mai nel browser.

Una query di tipo Sorgente REST indica sorgente, metodo, percorso (es. /items?q={{params.q}}, i segnaposto vengono codificati) e per POST/PUT/PATCH un corpo (JSON con segnaposto). Una lista JSON come risposta diventa records come per Elenca record – tabelle ed elenchi la mostrano direttamente. Le risposte con stato da 400 in su diventano un errore della query.