Manuel · 8

Workflows et sources REST

Workflows

Les workflows sont de la logique sur le serveur – avec le même moteur et le même éditeur que dans IllusionCMS et IllusionForms : des nœuds reliés par des fils, un message msg circule depuis le départ. Un workflow appartient à l’app (onglet Workflows) et s’exécute quand une requête de type Exécuter un workflow est appelée :

  • Les paramètres de la requête arrivent dans msg.payload, le compte dans msg.user (id, email, role).
  • Le nœud Réponse HTTP est la réponse à l’app (msg.payload) ; sans lui, la requête répond {"ok": true}.
  • Une exécution dure au maximum 20 secondes.

Nœuds : Départ, Fonction (JavaScript avec msg), Aiguillage, Requête HTTP, Délai, Fusion, Réponse HTTP, Debug et les nœuds IllusionDB :

Nœud Effet
Lister des enregistrements table, filtre (JSON avec {{ msg.… }}), tri, maximum → msg.payload est la liste
Lire un enregistrement table, enregistrement (clé primaire) → msg.payload
Créer un enregistrement table, valeurs (JSON) – vide = msg.payload est l’enregistrement
Modifier un enregistrement table, enregistrement, valeurs

Les nœuds IllusionDB atteignent exactement les tables qu’ils nomment, avec les droits comme pour les requêtes. Les requêtes HTTP ont la même protection des cibles que les webhooks (adresses de métadonnées cloud toujours bloquées, adresses locales selon Paramètres → Sécurité). Les planifications, entrées HTTP et e-mails n’existent pas dans les workflows d’app.

Dans le brouillon, un nœud peut encore être incomplet (l’enregistrement automatique continue) ; Publier vérifie tous les nœuds.

Sources REST

Pour les API externes, créez une source sous Apps → Sources REST : nom, adresse de base (p. ex. https://api.example.com/v1) et en-têtes comme Authorization: Bearer … ou X-Api-Key. Les en-têtes sont chiffrés (avec ENCRYPTION_KEY, comme les mots de passe des sources de données), jamais réaffichés et n’arrivent jamais dans le navigateur.

Une requête de type Source REST indique la source, la méthode, le chemin (p. ex. /items?q={{params.q}}, les variables sont encodées) et pour POST/PUT/PATCH un corps (JSON avec variables). Une liste JSON en réponse devient records comme pour Lister des enregistrements – les tableaux et listes l’affichent directement. Les réponses à partir du statut 400 deviennent une erreur de la requête.