L'Éditeur de recette

L'éditeur de recette est le canevas de la fenêtre Recipes : créez ou ouvrez-y une recette et travaillez dans son onglet Canvas. Chaque recette ouverte reçoit son propre onglet, et l'en-tête de l'éditeur regroupe les commandes d'édition du graphe, Console, Historique, Test run, Configurer, Enregistrer et le plein écran. Le canevas propose le zoom, le déplacement, une minicarte, les messages de validation et les connexions entre nœuds.

Les captures montrent l’interface de Budgie Echo en anglais.

Anatomie du canevas

• Les nœuds représentent des actions. Faites-les glisser pour organiser le graphe, sélectionnez-les pour les copier ou les supprimer et double-cliquez pour les modifier.
• Les arêtes relient le port de sortie d'une source au port d'entrée d'une cible. Une exécution terminée met en évidence celles qui ont transporté des données ; cliquez sur une telle arête pour inspecter la valeur enregistrée.
• Configurer modifie les métadonnées, déclencheurs, emplacements vocaux et options de traitement du workflow.
• Enregistrer conserve les actions du graphe, leurs positions et leurs arêtes. La boîte Configurer possède sa propre commande Enregistrer pour les métadonnées.
• Annuler, rétablir, copier et coller s'appliquent à la sélection du canevas. L'éditeur avertit également en cas de nœuds orphelins ou inaccessibles et de cycles interdits.

Nœuds et données

Chaque nœud accepte le port d'entrée de contrôle nommé main. Chaque nœud ordinaire expose une sortie de contrôle main, y compris les actions qui ne produisent aucune valeur de données. Les ports de contrôle décident de ce qui s'exécute ensuite ; les sorties de données décident de ce qui peut être référencé comme variable.

Relier une cible sur son port main enregistre l'arête. Si la valeur principale de la cible est vide, l'éditeur insère aussi une référence au nœud source telle que {{source_node_id}}. À l'exécution, le résultat d'une action est enregistré sous l'identifiant stable de son nœud ; son nom de sortie I/O peut en plus publier un alias plus lisible.

Flux de contrôle

Les nœuds de flux de contrôle acheminent l'exécution par des sorties nommées :

• If / Else : true ou false.
• Loop : loop pour le corps et done pour la suite.
• Switch : le premier port case:<pattern> correspondant, sinon default.
• Try / Catch : try en exécution normale et catch lorsqu'un nœud de la portée protégée échoue.

Seul le port déclenché par un nœud terminé active l'arête qui lui est reliée. Un nœud en échec ne déclenche aucun port de sortie. Les cycles ordinaires sont rejetés ; une arête de retour du corps vers un nœud Loop est l'exception prise en charge.

Points d'entrée

Dans un graphe explicite, un point d'entrée est un nœud sans arête entrante qui ne soit pas un retour de boucle. Les nœuds d'entrée sont planifiés en premier. Plusieurs points d'entrée sont admis et leur ordre de déclaration départage les égalités de façon déterministe.

Dans un graphe de plusieurs nœuds, un nœud isolé est signalé comme orphelin. Un nœud inaccessible depuis tous les points d'entrée est signalé comme inaccessible. Corrigez les avertissements de validation avant de vous fier à une exécution.

Un ancien workflow sans arêtes explicites reste une chaîne linéaire exécutée dans l'ordre d'enregistrement de ses actions.

États terminaux

Un nœud est terminal lorsqu'il n'a aucune arête sortante pour le port qu'il déclenche. L'atteindre termine cette branche. Le workflow s'achève lorsque le planificateur a résolu tout le graphe accessible, y compris les branches ignorées ; un échec peut arrêter le workflow, suivre le comportement d'erreur configuré ou entrer dans une portée catch connectée.

La Sortie du workflow désigne la variable renvoyée comme résultat final. Si elle n'est pas définie, Echo peut utiliser une sortie d'étape, puis la valeur conventionnelle processed_text. Consultez les Sorties.

Ports nommés

Les noms de ports font partie du contrat enregistré du graphe. main est l'entrée et la sortie ordinaire par défaut. Les noms du flux de contrôle sont exacts, et Switch conserve le motif dans case:<pattern>. Renommer un motif Switch change le port que l'arête doit utiliser.

Contrôle et données sont distincts : une Notification peut poursuivre par main sans publier de variable, alors qu'un If / Else peut publier un résultat de données indépendamment du choix entre true et false.

Sélecteur d'actions

Choisissez + (Ajouter une étape) pour ouvrir le sélecteur. Les actions sont groupées par domaine de capacité : Core, File System, Text, System, App Control, Network, Math & Data, Arrays, Persistence, UI et Control Flow.

La Référence des actions générée est la source de vérité sur les champs, ports de contrôle, sorties de données, états d'exécution, limites d'autorisation et confirmations à l'exécution actuels.

Onglets Config et I/O du nœud

Double-cliquez sur un nœud pour ouvrir son éditeur :

• Config contient les champs propres à l'action et un nom personnalisé facultatif. Les nœuds amont connectés peuvent apparaître comme raccourcis d'insertion.
• I/O choisit l'entrée principale des actions qui en acceptent une, nomme la sortie des actions qui en produisent une et liste les variables actuellement accessibles.

La liste I/O ne regarde que vers l'avant : elle contient les entrées du workflow et les sorties des actions antérieures dans l'ordre enregistré, jamais celles des actions suivantes. Pour les graphes complexes, préférez des arêtes explicites et des noms de sortie stables et descriptifs, puis vérifiez le flux réel dans les Exécutions de workflows.