Workflows und REST-Quellen
Workflows
Workflows sind Logik auf dem Server – mit derselben Flow-Engine und demselben Editor wie in IllusionCMS und IllusionForms: Nodes, verbunden mit Drähten, eine Nachricht msg läuft vom Start durch. Ein Workflow gehört zur App (Reiter Workflows) und läuft, wenn eine Abfrage vom Typ Workflow ausführen aufgerufen wird:
- Die Parameter der Abfrage kommen als
msg.payloadan, das Konto alsmsg.user(id,email,role). - Der Node HTTP-Antwort ist die Antwort an die App (
msg.payload); ohne ihn antwortet die Abfrage mit{"ok": true}. - Ein Lauf darf höchstens 20 Sekunden dauern.
Nodes: Start, Function (JavaScript mit msg), Weiche, HTTP-Anfrage, Verzögern, Zusammenführen, HTTP-Antwort, Debug und die IllusionDB-Nodes:
| Node | Wirkung |
|---|---|
| Datensätze auflisten | Tabelle, Filter (JSON mit {{ msg.… }}), Sortierung, höchstens → msg.payload ist die Liste |
| Datensatz lesen | Tabelle, Datensatz (Primärschlüssel) → msg.payload |
| Datensatz anlegen | Tabelle, Werte (JSON) – leer = msg.payload ist der Datensatz |
| Datensatz ändern | Tabelle, Datensatz, Werte |
Die IllusionDB-Nodes erreichen genau die Tabellen, die sie nennen, mit den Rechten wie bei Abfragen. HTTP-Anfragen haben denselben Zielschutz wie Webhooks (Cloud-Metadaten-Adressen immer gesperrt, lokale Adressen nach Einstellungen → Sicherheit). Zeitpläne, HTTP-Eingänge und E-Mails gibt es in App-Workflows nicht.
Im Entwurf darf ein Node noch unvollständig sein (das Autospeichern läuft weiter); Veröffentlichen prüft alle Nodes.
REST-Quellen
Für externe APIs legst du unter Apps → REST-Quellen eine Quelle an: Name, Basisadresse (z. B. https://api.example.com/v1) und Header wie Authorization: Bearer … oder X-Api-Key. Die Header werden verschlüsselt gespeichert (mit ENCRYPTION_KEY, wie die Passwörter der Datenquellen), danach nie wieder angezeigt und kommen nie im Browser an.
Eine Abfrage vom Typ REST-Quelle nennt Quelle, Methode, Pfad (z. B. /items?q={{params.q}}, Platzhalter werden kodiert) und bei POST/PUT/PATCH einen Body (JSON mit Platzhaltern). Eine JSON-Liste als Antwort wird zu records wie bei Datensätze auflisten – Tabellen und Listen zeigen sie direkt an. Antworten ab Status 400 werden zum Fehler der Abfrage.