Conception d'un Maestro Flow

Concevez un Maestro Flow dans Studio Web à l'aide du canevas Flux, y compris comment ajouter et connecter des déclencheurs et des nœuds, configurer des propriétés, gérer des variables, gérer des erreurs et déboguer votre processus.

Remarque :

Maestro Flow est en aperçu.

Le canevas Maestro Flow est un concepteur visuel dans lequel vous créez des automatisations en plaçant des nœuds et en les connectant en séquence.

Le canevas Maestro Flow

Le canevas affiche votre flux sous la forme d'un graphique de nœuds connectés par des bords. L'exécution commence au nœud du déclencheur et parcourt chaque nœud connecté dans l'ordre.

To add a node, select the + handle on the outgoing edge of any existing node to open the Add node panel. To connect two nodes manually, drag from the output handle of one node to the input handle of another. You can rename any node by opening its label on the Maestro Flow canvas.

La barre d'outils supérieure fournit:

• Déboguer sur le cloud — exécute le flux de bout en bout dans le cloud.
• Déboguer étape par étape — avance dans le flux un nœud à la fois.
• Publier : empaquète et publie le flux dans Orchestrator.

Ajout d'un déclencheur

Le flux commence par un nœud Déclencheur manuel par défaut qui démarre le flux à la demande. Sélectionnez le déclencheur sur le canevas pour le configurer dans le panneau Propriétés .

Propriétés du déclencheur

• ID — l'identifiant du déclencheur, utilisé pour référencer ses sorties dans les expressions (par exemple, $vars.manualTrigger1.output.userId).
• Libellé : le nom complet du déclencheur sur le canevas.
• Variables — Variables d'entrée appartenant au déclencheur. Lorsque le déclencheur se déclenche, ses entrées sont disponibles en aval sous la forme $vars.<triggerId>.output.<inputName>.

Ajout de nœuds

Pour ajouter un nœud, sélectionnez la poignée + sur le bord sortant de n'importe quel nœud pour ouvrir le panneau Ajouter un nœud , puis sélectionnez une catégorie et choisissez le type de nœud. Pour obtenir la liste complète des types de nœuds disponibles, consultez À propos de Maestro Flow.

Propriétés du nœud

La sélection d'un nœud ouvre sa configuration dans le panneau Propriétés à droite, organisé en sections:

• Général : l' ID du nœud (utilisé dans les expressions $vars ), le Libellé (nom d'affichage sur le canevas), la Description et la Couleur de l'icône.
• Gestion des erreurs — activez Activer la gestion des erreurs pour ajouter une gestion des erreurs au nœud. Lorsque cette option est activée et que le nœud échoue, l’exécution est redirigée vers le chemin d’erreur au lieu d’arrêter le flux.
• Mettre à jour la variable — attribuez une valeur à une variable de processus lorsque le nœud se termine. Sélectionnez + Ajouter une mise à jour de variable, choisissez la variable cible et saisissez l'expression à affecter.

L'onglet Variables (à côté de Propriétés) est l'endroit où vous définissez les variables au niveau du processus. Chaque variable a un nom, un type (Chaîne de caractères, Nombre, Booléen, Objet ou Tableau) et une direction (entrée, sortie ou bidirectionnelle).

Opening the context menu for a node on the canvas opens a context menu with: Add breakpoint, Add probe, Copy, Cut, Paste, and Delete.

Variables et flux de données

Les nœuds ne partagent pas automatiquement les données. Les nœuds en aval accèdent à la sortie d'un nœud via des expressions en utilisant le préfixe $vars .

Chaque nœud qui produit des données rend sa sortie disponible en tant que $vars.<nodeId>.output. L'ID de nœud est attribué automatiquement en fonction du type de nœud. Par exemple, le premier nœud du workflow d'API est apiWorkflow1. Vous pouvez voir et modifier l'ID d'un nœud dans la section Général du panneau Propriétés.

// Access the output of a node named apiWorkflow1
$vars.apiWorkflow1.output

// Access the response body of an HTTP request node
$vars.httpRequest1.output.body

Utilisez l'onglet Variables pour définir des variables qui doivent être accessibles sur l'ensemble du processus ou qui définissent les entrées et les sorties du processus. Les variables sont référencées sous la forme $vars.<variableName>.

Pour connaître les règles complètes de grammaire et de portée, reportez-vous à la section Variables et flux de données dans la documentation Maestro.

Gestion des erreurs

Par défaut, un nœud échoué arrête l'ensemble du flux. Pour gérer les défaillances sur un nœud spécifique, activez l'option Activer la gestion des erreurs dans le panneau Propriétés du nœud. Cela ajoute une gestion de sortie d'erreur en bas à droite du nœud sur la zone de dessin. Connectez la gestion des erreurs à un nœud en aval pour acheminer les échecs vers un chemin distinct.

Lorsqu'un nœud échoue et que sa gestion des erreurs est connectée, les détails de l'erreur sont disponibles sous la forme $vars.<nodeId>.error sur le chemin de l'erreur, avec des champs incluant message, code, status et detail.

Pour des modèles tels que journaliser et continuer, réessayer et alerte et terminer, reportez-vous à la gestion des erreurs dans la documentation de Maestro.

Débogage d'un Maestro Flow

Sélectionnez Déboguer sur le cloud dans la barre d'outils supérieure pour exécuter le flux de bout en bout. Lorsque l’exécution se termine, sélectionnez n’importe quel nœud sur le canevas pour inspecter sa sortie. Les nœuds qui ont réussi affichent un indicateur vert; les nœuds ayant échoué affichent les détails de l’erreur lorsqu’ils sont sélectionnés.

Sélectionnez Déboguer étape par étape pour progresser dans le flux un nœud à la fois.

Open the context menu for any node and select Add breakpoint to pause execution at that node during a debug run. Select Add probe to capture the node’s output without pausing.

Liens connexes

• Variables et flux de données
• Gestion des erreurs
• Sous-flux
• Flux de contrôle
• Publier et déployer un flux