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 inmsg.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.