Handbuch · 8

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.payload an, das Konto als msg.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.