Workflows avancés (concepteur visuel de workflow)

Description

Un workflow avancé s’exécute sur un canevas visuel — le Concepteur visuel de workflow — où les étapes sont les nœuds d’un graphe orienté (un DAG). Les lignes entre les nœuds montrent la circulation des données, et le moteur d’exécution les traite dans l’ordre des dépendances plutôt que de haut en bas. Les branches qui ne dépendent pas les unes des autres s’exécutent automatiquement en parallèle.

Avancé est l’un des types de workflow de PlaidCloud ; l’autre est Standard. Les fonctionnalités de ce guide — le canevas visuel, les points d’arrêt, les conteneurs, Exécuter à partir d’ici, Simuler et l’inspecteur ancré — sont toutes réservées aux workflows avancés. Le canevas prend également en charge la collaboration en temps réel : plusieurs personnes peuvent ouvrir le même workflow avancé et le modifier ensemble, en voyant en direct la présence et les modifications des autres.

Standard et avancé

Chaque workflow a un type, choisi lors de sa création :

Type	Les étapes sont organisées dans…	…et s’exécutent
Standard série	la liste des étapes	de haut en bas, une à la fois
Standard parallèle	la liste des étapes	à partir de la liste, en parallèle lorsque les dépendances le permettent
Avancé (canevas DAG)	un graphe visuel de nœuds et de connexions	dans l’ordre des dépendances — les branches indépendantes s’exécutent automatiquement en parallèle

Standard et avancé s’exécutent sur des moteurs différents : un workflow standard s’exécute à partir de sa liste d’étapes, tandis qu’un workflow avancé s’exécute à partir du graphe que vous dessinez, en suivant les connexions explicites producteur/consommateur entre les étapes. C’est pourquoi le Concepteur visuel de workflow ne s’ouvre que pour les workflows avancés — des flèches dessinées sur un workflow standard ne changeraient pas la manière dont il s’exécute.

Choisir le type de workflow

Vous pouvez définir le type lors de la création d’un workflow, ou convertir un workflow standard existant :

À la création — le sélecteur de type de workflow propose Standard série, Standard parallèle, Avancé (canevas DAG) et Macro (bientôt disponible). Les nouveaux workflows sont par défaut de type Standard série.
Convertir un workflow existant — sélectionnez un workflow standard dans la liste Workflows et choisissez Convertir en avancé…, puis confirmez. Vos étapes, leur configuration et leurs dépendances sont conservées — seuls l’affichage et l’exécution du workflow changent.

Le passage d’un workflow de Standard à Avancé via l’API REST ou un assistant IA conserve l’ordre des étapes de la même manière que Convertir en avancé…. Le retour d’un workflow avancé à Standard est refusé.

Le canevas

Chaque étape est un nœud, et les connexions entre les nœuds définissent l’ordre d’exécution des étapes. Le concepteur dispose automatiquement les étapes, et vous pouvez les réorganiser librement.

Qui est présent

Lorsque plusieurs personnes ont ouvert le même workflow avancé, une rangée d’avatars apparaît dans la barre d’outils du canevas pour indiquer qui d’autre le consulte ou le modifie — le même principe de présence en direct qu’un document partagé. Chaque personne est représentée par son gravatar (ou ses initiales si elle n’en a pas), et le survol d’un avatar affiche son nom. Une personne apparaît une seule fois, quel que soit le nombre d’onglets de navigateur dans lesquels elle a ouvert le workflow, et lorsqu’il y a plus de spectateurs que la place disponible, les autres sont regroupés dans un marqueur +N.

Tuiles d’étape

Chaque tuile résume son étape d’un coup d’œil, de haut en bas :

En-tête — l’icône et le nom du type d’étape, ainsi qu’une icône d’état indiquant le résultat de la dernière exécution de l’étape.
Entrées — une icône pour chaque table, dimension ou fichier que l’étape lit. Cliquez sur une icône de table pour la prévisualiser dans le tiroir Aperçu des données, sur une icône de dimension pour ouvrir la dimension, ou sur une icône de fichier pour le télécharger. Lorsqu’une étape a de nombreuses entrées ou sorties, les icônes supplémentaires sont regroupées dans un marqueur +N.
Nom de l’étape — centré dans le corps de la tuile.
Sorties — les icônes des sorties de l’étape, avec le même comportement au clic. Une fois la table de sortie créée, cette ligne affiche aussi son nombre de lignes et de colonnes (par exemple, 12,345 rows · 8 cols) — les mêmes Rows et Cols que ceux affichés dans les tables Entrées/Sorties de l’étape — afin que vous puissiez suivre les volumes de données au fil du workflow sans ouvrir chaque table. Jusque-là (ou lorsque l’étape produit un fichier ou une dimension à la place), la ligne affiche simplement le libellé Sorties. Survolez n’importe quelle icône de table pour voir son nom et ses nombres.
Pied — les durées d’exécution de la dernière exécution et moyenne de l’étape, teintées lorsque la dernière exécution a été anormalement lente par rapport à son historique.

Naviguer

Zoom avant / Zoom arrière, Réinitialiser le zoom à 100 % et Ajuster tous les nœuds à la vue cadrent le workflow quelle que soit sa taille.
Outil Main — lorsqu’il est actif, le glissement déplace le canevas au lieu de sélectionner. Le glissement avec le clic central et Espace+glissement déplacent le canevas quel que soit l’état de la bascule.
Aimantation à la grille arrondit la position des nœuds à une grille fixe lorsque vous les déposez, pour un alignement soigné.

Minicarte

Pour les grands workflows qui ne tiennent pas à l’écran, activez la minicarte pour ancrer un panneau de vue d’ensemble dans le coin inférieur droit. Elle montre en miniature les étapes et les connexions de l’ensemble du workflow, avec un rectangle marquant la partie du canevas que vous consultez actuellement.

Le rectangle de la zone visible se déplace en direct lorsque vous faites un panoramique ou un zoom, afin que vous sachiez toujours où vous vous trouvez dans le diagramme complet.
Cliquez ou faites glisser n’importe où dans le panneau pour amener le canevas sur cette partie du workflow.
Pendant l’exécution d’un workflow, chaque étape de la minicarte est codée par couleur selon son état d’exécution (en cours d’exécution, terminé, erreur, etc.), de sorte que le panneau sert aussi de vue d’ensemble de l’état de santé en un coup d’œil.

Disposition

Disposition ouvre un menu d’actions de mise en page. Chaque action est une seule étape dans Défaire (Cmd/Ctrl+Z) et s’applique sans confirmation ; un message indique Disposition mise à jour — appuyez sur Défaire pour annuler. Une action qui ne changerait rien ne fait rien. Voir Organiser le canevas.
Défaire et Rétablir reculent et avancent dans les modifications de disposition (Cmd/Ctrl+Z et Cmd/Ctrl+Maj+Z), et Historique ouvre le panneau des modifications.

Organiser le canevas

Action	Ce qu’elle fait	Nécessite
Tout réorganiser	Dispose toutes les étapes de gauche à droite.	Toujours disponible
Réorganiser la sélection	Dispose uniquement les éléments sélectionnés, en laissant leur coin supérieur gauche où il se trouve. Les autres étapes ne descendent que si elles se chevauchent désormais.	2 éléments ou plus
Supprimer les chevauchements	Repousse vers le bas les éléments qui se chevauchent jusqu’à ce qu’il n’y en ait plus. Elle ne les réordonne jamais.	2 éléments ou plus sur le canevas
Aligner à gauche / au centre / à droite / en haut / au milieu / en bas	Aligne les éléments sélectionnés sur le bord ou le centre que vous choisissez.	2 éléments ou plus
Répartir horizontalement / verticalement	Laisse le premier et le dernier élément où ils sont et espace régulièrement les autres entre eux.	3 éléments ou plus
Aimanter tout sur la grille	Place chaque élément du canevas sur la grille et sépare ceux qui entrent alors en collision.	Toujours disponible

Tout réorganiser conserve votre disposition. Les étapes circulent toujours de gauche à droite, mais, dans chaque colonne, elles restent dans l’ordre de haut en bas que vous aviez déjà, et la disposition reste là où elle se trouvait sur le canevas au lieu de revenir à l’origine.
Les groupes restent ensemble. Un conteneur est disposé comme un seul bloc. Un conteneur réduit se déplace comme une seule tuile, et les étapes qu’il masque l’accompagnent.
Les notes et les surlignages suivent leurs étapes. Tout ce qui se trouve sur une étape se déplace avec elle.
Les groupes comptent pour un seul élément. Pour Aligner, Répartir et Réorganiser la sélection, un conteneur ou un conteneur réduit compte pour un élément, et les étapes qu’il contient se déplacent avec lui.
Aimanter tout sur la grille est distinct de la bascule Aimantation à la grille décrite sous Naviguer, qui n’affecte que l’endroit où une étape atterrit lorsque vous la déposez.
Les actions indisponibles sont grisées. Les éléments de menu qui ne s’appliquent pas à la sélection actuelle sont grisés.
Les workflows verrouillés bloquent toutes les actions de disposition. Déverrouillez d’abord le workflow.

Annoter

Les annotations sont purement visuelles — elles documentent le diagramme et n’affectent jamais l’exécution.

Ajouter une note — déposez une note adhésive n’importe où sur le canevas, puis Modifier le texte… pour y écrire (ou Supprimer la note pour la retirer).
Ajouter un surlignage — dessinez un cadre translucide autour d’un groupe d’étapes liées et donnez-lui un libellé avec Modifier le libellé… (ou Supprimer le surlignage pour le retirer).
Couleur — attribuez une couleur à une étape (ou rétablissez la couleur Par défaut) pour regrouper visuellement le travail.

Verrouiller

Un workflow peut être verrouillé pour éviter les modifications accidentelles. Cliquez sur la bascule de verrouillage pour passer de Modification du workflow — cliquer pour verrouiller à Le workflow est verrouillé — cliquer pour le déverrouiller et le modifier. Tant qu’il est verrouillé, le canevas est en lecture seule jusqu’à ce que vous le déverrouilliez.

Réduire et redimensionner les volets Palette et Inspecteur

La palette d’étapes à gauche et l’inspecteur à droite peuvent chacun être réduits lorsque vous voulez disposer de toute la fenêtre pour le diagramme.

Réduire un volet — cliquez sur le chevron dans l’en-tête de la palette ou de l’inspecteur. Le volet se réduit à un rail étroit dont le titre court le long du côté. Le rail réduit de l’inspecteur affiche le nom de l’étape sélectionnée, afin qu’un canevas pleine largeur ne vous fasse pas perdre de vue ce que vous inspectiez ; survolez-le pour voir le nom complet s’il est tronqué.
Le rétablir — cliquez n’importe où sur le rail, pas seulement sur le chevron.
Clavier — appuyez sur [ pour réduire ou développer la palette et sur ] pour réduire ou développer l’inspecteur. Ces deux raccourcis sont ignorés pendant que vous saisissez dans un champ, de sorte qu’ils n’interrompent jamais la zone de filtre ni un renommage en ligne.
Double-clic sur un séparateur — un double-clic sur le séparateur à côté d’un volet le réduit ou le développe, comme le chevron.
Redimensionner — faites glisser l’un ou l’autre séparateur. Les deux volets ont une largeur minimale ; en dessous, les cartes Entrées et Sorties de l’inspecteur défilent latéralement au lieu de tronquer leurs noms et leurs nombres de lignes.

Exporter le diagramme

Le bouton d’exportation de la barre d’outils enregistre une image du canevas pour la documentation, la revue ou le partage. Un clic exporte un PDF ; sa liste déroulante propose Exporter en PDF et Exporter en PNG.

Thème sombre

Le canevas suit le thème PlaidCloud que vous avez choisi. Dans le thème Sombre, l’arrière-plan du canevas, les tuiles d’étape, les connecteurs, les notes, les surlignages, les conteneurs, la minicarte, ainsi que la palette d’étapes, l’inspecteur et le tiroir Aperçu des données qui l’accompagnent sont tous dessinés pour un fond sombre, avec des couleurs d’état d’exécution et un texte de libellé choisis pour rester lisibles sur ce fond. Le changement de thème recharge l’interface, et le canevas reprend les nouvelles couleurs à sa réouverture.

Ajouter, connecter et modifier des étapes

Cliquez sur un type d’étape dans la palette pour le déposer sur le canevas, ou faites-le glisser où vous le souhaitez. Pour connecter des étapes, faites glisser d’une étape vers une autre afin de tracer un connecteur — c’est ce qui indique au moteur d’exécution que la sortie d’une étape alimente la suivante.

Une étape qui lit une table doit s’exécuter après l’étape qui l’écrit. Synchroniser les dépendances dans la barre d’outils repère les étapes qui peuvent s’exécuter trop tôt et suggère les connecteurs à ajouter. Voir Synchroniser les dépendances.

Faites un clic droit sur n’importe quelle étape pour accéder à :

Modifier la configuration de l’étape… — le formulaire des paramètres de l’étape.
Modifier les détails de l’étape… — nom, mémo, gestion des erreurs, nouvelle tentative et conditions.
Convertir le type d’étape… — change l’étape en un autre type d’opération.
Dupliquer l’étape… — copie cette étape. Le formulaire de l’étape s’ouvre sur son onglet Général, rempli à partir de cette étape, afin que vous puissiez renommer la copie et choisir où la placer ; la copie conserve la configuration de cette étape.
Activer l’étape / Désactiver l’étape — une étape désactivée est ignorée à l’exécution.
Afficher les entrées de l’étape / Afficher les sorties de l’étape — ouvre les données de l’étape dans l’inspecteur.
Prévisualiser les données de sortie — ouvre la sortie de l’étape dans le tiroir Aperçu des données ancré. Le survol d’une étape fait aussi apparaître en fondu un glyphe de navigation qui fait la même chose.
Couleur — applique ou efface une couleur d’étape.
Supprimer l’étape… — la retire de la structure du workflow. Les étapes en aval qui dépendaient de sa sortie devront être reconfigurées.

Concurrence des sous-workflows

Lorsqu’une étape invoque un autre workflow — une étape Exécuter le workflow, Exécuter le workflow sous condition ou Exécuter le workflow en boucle pointant vers un workflow qui n’est pas une macro — une seule invocation de ce sous-workflow peut s’exécuter à la fois. Un sous-workflow qui n’est pas une macro partage un état d’exécution unique ; deux invocations simultanées entreraient donc en collision.

Cela compte sur le canevas avancé, car les étapes qui ne sont pas ordonnées les unes par rapport aux autres s’exécutent en parallèle. Si deux de ces étapes invoquent le même sous-workflow qui n’est pas une macro, elles se font concurrence.

Le concepteur vérifie ce cas à l’enregistrement du canevas et affiche un message d’avis intitulé Avis sur le workflow qui nomme les étapes concernées et le sous-workflow partagé — par exemple :

Les étapes « Build » et « Refresh » invoquent toutes le sous-workflow non macro « Load Dims » mais ne sont pas ordonnées les unes par rapport aux autres ; elles peuvent s’exécuter simultanément et entrer en collision (un sous-workflow non macro ne peut pas s’exécuter deux fois en même temps). Ordonnez les étapes pour qu’elles ne se chevauchent pas, ou faites de « Load Dims » une macro (les macros s’exécutent avec une isolation par invocation).

Pour le faire disparaître :

Ordonnez les étapes pour qu’elles ne se chevauchent pas — tracez un connecteur afin que l’une s’exécute après l’autre.
Faites du sous-workflow une macro — chaque invocation d’une macro s’exécute dans son propre schéma temporaire isolé ; la même macro peut donc être appelée en toute sécurité de manière simultanée. Voir Créer une macro et la référence Macro Run.

La palette d’étapes

La Palette d’étapes, à gauche du canevas, contient tous les types d’étapes que vous pouvez ajouter, classés dans dix dossiers : Importer ; Export et archivage ; Tables ; Dimensions ; Allocations ; IA, ML et texte ; Spatial ; Documents et rapports ; Workflow et variables ; et Systèmes externes. Les dossiers sont fermés au départ. Cliquez sur l’un d’eux pour l’ouvrir ; quelques-uns contiennent des sous-dossiers, comme Sage sous Importer et Notifications sous Workflow et variables. La palette mémorise les dossiers que vous avez laissés ouverts.

Ombrage des dossiers et repères d’indentation

La palette montre où vous vous situez dans la hiérarchie sans que vous ayez à vous en souvenir :

Les dossiers sont ombrés selon la profondeur, de sorte qu’un dossier de premier niveau, un sous-dossier et les étapes qu’ils contiennent se distinguent d’un coup d’œil. L’ombrage n’est qu’un indice secondaire — l’icône de dossier et la légende en gras signalent déjà un dossier.
Chaque dossier ouvert trace un repère d’indentation vertical le long de la gauche de tout ce qu’il contient, et cliquer sur un repère ferme le dossier auquel il appartient. C’est le moyen rapide de sortir d’un long dossier ouvert dont l’en-tête est déjà sorti de l’écran. Le survol d’un repère affiche Réduire ce dossier.
Les dossiers s’ouvrent et se ferment avec la même case +/− que sur les écrans de dimensions, de sorte que le geste se lit de la même manière dans tout le produit.
L’en-tête du dossier que vous lisez reste épinglé en haut de la liste pendant le défilement, de sorte que les étapes sous votre pointeur ne sont jamais anonymes. Dans un sous-dossier, son en-tête et celui de son parent sont tous deux épinglés.
L’ouverture ou la fermeture d’un dossier conserve votre position de défilement au lieu de vous renvoyer en haut de la liste.
Développer tous les dossiers et Réduire tous les dossiers sont les deux petits boutons de l’en-tête de la palette, à côté du chevron qui réduit la palette elle-même.

Il existe deux façons d’ajouter une étape :

Cliquer dessus. La ligne clignote pour confirmer l’ajout, et l’étape apparaît près du coin supérieur gauche du canevas visible, déjà sélectionnée, de sorte que l’inspecteur affiche ses détails. Faites-la glisser où vous le souhaitez. Vous avez cliqué sur la mauvaise ? Appuyez sur Suppr et confirmez — elle est toujours sélectionnée, il n’y a donc rien à rechercher.
La faire glisser de la palette vers le canevas ; elle atterrit là où vous la déposez.

Deux autres choses à savoir :

Filtrer… recherche dans tout le catalogue par nom d’étape, que les dossiers soient ouverts ou fermés. Chaque correspondance est listée sous l’en-tête du dossier dont elle provient, de sorte que vous voyez où se trouve une étape sans rien ouvrir. Lorsqu’aucune étape ne correspond, la palette indique Aucune étape correspondante.
L’étoile à côté d’une étape l’épingle dans Favoris, une section située au-dessus des dossiers et jamais classée dans l’un d’eux. Faites un clic droit sur une étape pour accéder aux mêmes commandes Ajouter aux favoris / Retirer des favoris, ainsi que Ajouter au canevas.

La palette peut être pilotée entièrement au clavier, et elle est navigable avec un lecteur d’écran : elle est exposée sous forme d’arbre, et chaque ligne indique s’il s’agit d’un dossier, si ce dossier est ouvert et à quelle profondeur il se situe. Lorsqu’un filtre est saisi, les résultats sont exposés sous la forme de la liste plate de correspondances qu’ils constituent.

La touche Tab passe du champ Filtrer… à la liste — un seul arrêt pour toute la liste, et non un par étape — et une nouvelle pression sur Tab quitte la liste pour le canevas. Dans la liste :

Touche	Ce qu’elle fait
Bas / Haut	Passer à la ligne suivante ou précédente
Droite	Ouvrir le dossier sur lequel vous êtes — ou, sur une étape, descendre
Gauche	Fermer le dossier sur lequel vous êtes — ou, sur une étape, remonter au dossier qui la contient
Entrée ou Espace	Ajouter l’étape sur laquelle vous êtes au canevas, ou ouvrir et fermer le dossier
Échap	Revenir au champ Filtrer…

Commandes d’exécution

Le canevas exécute l’ensemble du workflow ou n’importe quelle partie de celui-ci. Comme l’exécution suit le graphe, « à partir d’ici » et « sélection » respectent les dépendances plutôt que la position dans la liste.

Action	Ce qu’elle exécute
Exécuter le workflow	Le workflow entier à partir de ses étapes de départ.
Exécuter cette étape	Uniquement l’étape sélectionnée.
Exécuter à partir d’ici	L’étape sélectionnée et chaque étape en aval qui s’exécuterait normalement après elle.
Exécuter la sélection	Uniquement les étapes sélectionnées — elles se déclenchent en parallèle et le moteur d’exécution les séquence selon leurs dépendances.
Exécuter la section	Les étapes sélectionnées plus toutes les étapes que le graphe place entre la plus précoce et la plus tardive de votre sélection selon l’ordre topologique.

Pendant l’exécution d’un workflow, vous pouvez le Suspendre (les étapes en cours se terminent ; les nouvelles étapes attendent que vous choisissiez Reprendre), Reprendre un workflow suspendu ou arrêté là où il s’était interrompu, ou l’Arrêter (les étapes en cours se terminent ; les étapes en file d’attente sont annulées). Reprendre ré-exécute le nœud qui a échoué et tout ce qui l’attend encore, en laissant intacts les nœuds terminés — voir Suspendre, arrêter et reprendre.

Simuler

Simuler parcourt le graphe du workflow sans exécuter les transformations réelles. Les étapes se colorent comme lors d’une exécution réelle, afin que vous puissiez visualiser l’ordre et les branches avant de vous engager dans le calcul. Rien ne s’exécute et aucune donnée ne change.

Points d’arrêt

Un point d’arrêt suspend une exécution lorsqu’elle atteint une étape, afin que vous puissiez inspecter la sortie en amont avant que le reste du workflow ne continue.

Faites un clic droit sur une étape et choisissez Définir un point d’arrêt (ou Effacer le point d’arrêt pour le supprimer).
Exécutez le workflow. Lorsque l’exécution atteint une étape munie d’un point d’arrêt, elle se suspend à cet endroit ; tout ce qui est en aval attend.
Inspectez les entrées et les sorties de l’étape dans l’inspecteur, puis choisissez Reprendre pour continuer.

Les points d’arrêt sont enregistrés avec le workflow ; un point d’arrêt que vous définissez persiste donc d’une session à l’autre jusqu’à ce que vous l’effaciez.

Conteneurs

Un conteneur regroupe des étapes liées dans un cadre étiqueté que vous pouvez réduire ou désactiver comme un tout — utile pour organiser de grands workflows ou pour activer et désactiver tout un sous-processus.

Grouper dans un conteneur — sélectionnez les étapes, puis regroupez-les et donnez un nom au conteneur.
Réduire le conteneur / Développer le conteneur — replie le conteneur en une seule tuile pour désencombrer le canevas, ou le rouvre.
Désactiver le conteneur / Activer le conteneur — la désactivation d’un conteneur ignore toutes ses étapes membres en une seule action. L’activation les rétablit.
Renommer le conteneur… — modifie son libellé.
Dissocier le conteneur — supprime le conteneur ; ses étapes membres restent sur le canevas.
Ajouter ou retirer des étapes — maintenez Cmd sur Mac ou Ctrl sur Windows et faites glisser une étape sur un conteneur. Le conteneur est mis en surbrillance comme cible de dépôt, et l’étape le rejoint lorsque vous relâchez. Cmd/Ctrl+glissement d’une étape hors de son conteneur vers une zone vide du canevas la retire. Déposer sur un conteneur réduit y ajoute l’étape.

Une étape appartient à un seul conteneur au plus ; la déposer sur un autre conteneur la déplace donc. Faire glisser plusieurs étapes sélectionnées les déplace toutes. Si vous sélectionnez un conteneur entier et faites un Cmd/Ctrl+glissement sur l’une de ses étapes, seule cette étape se déplace. Un conteneur simple qui ne contient plus aucune étape est supprimé. Un glissement simple ne fait que déplacer l’étape sur le canevas, Cmd/Ctrl+clic continue de basculer la sélection, et relâcher en dehors du canevas ne change rien. Vous pouvez défaire et rétablir les changements d’appartenance comme n’importe quelle autre modification de disposition ; les workflows verrouillés ne peuvent pas être modifiés.

Conteneurs d’exécution

Un conteneur simple est un regroupement visuel — il met de l’ordre dans le canevas mais ne change pas la manière dont les étapes s’exécutent. Transformez un conteneur en conteneur d’exécution et il devient aussi une unité d’exécution : tout le groupe s’exécute comme un sous-workflow scellé, se comportant comme un seul nœud dans le graphe parent.

L’activer — faites un clic droit sur le conteneur et activez Exécution. Le conteneur est redessiné avec une bordure distincte, un badge Exécution dans son en-tête, ainsi qu’un port d’entrée et un port de sortie, afin que vous puissiez distinguer d’un coup d’œil un conteneur d’exécution d’un groupe ordinaire. Survolez les ports pour voir leurs info-bulles Port d’entrée et Port de sortie.

Une seule arête vers le port d’entrée alimente le groupe scellé ; le port de sortie ne libère le travail en aval qu’une fois tous les membres terminés.

Comment il s’exécute — un sous-DAG scellé. Dès qu’un conteneur est marqué pour l’exécution, sa frontière est scellée dans les deux sens :

Rien à l’intérieur ne démarre tant que les entrées du conteneur ne sont pas arrivées. Chaque étape membre attend ce qui alimente le groupe, même un membre qui n’a aucun amont propre.
Rien en aval du conteneur ne démarre tant que tous les membres ne sont pas terminés. La sortie du groupe ne se libère que lorsque le dernier membre a terminé ; le workflow parent traite donc tout le conteneur comme un seul nœud.

Les branches indépendantes à l’intérieur du conteneur s’exécutent toujours en parallèle, exactement comme sur le canevas ouvert — le scellement ne régit que la frontière du groupe, et non l’ordre du travail à l’intérieur.

Relier une étape en amont au port d’entrée. Faites glisser un connecteur d’une étape en amont vers le conteneur et déposez-le sur le port d’entrée. Cette seule arête alimente tout le groupe — chaque membre qui a besoin de l’entrée la récupère une fois que les entrées du conteneur sont arrivées.

Relier le port de sortie à une étape en aval. Faites glisser un connecteur depuis le port de sortie du conteneur, sur son bord droit, vers l’étape en aval qui consomme la sortie du groupe. L’étape en aval démarre une fois tous les membres terminés, et le connecteur est tracé depuis le bord du conteneur.

Vous pouvez aussi tracer un connecteur depuis une étape membre vers l’étape en aval, comme vous connectez deux étapes quelconques. Le moteur d’exécution fait passer cette connexion par le port de sortie du conteneur à votre place ; les deux méthodes donnent donc le même résultat.

Comportement en cas d’échec. Un membre qui échoue suit la même gestion des erreurs que n’importe quelle autre étape :

Avec le comportement par défaut arrêt en cas d’erreur, l’échec d’un membre interrompt l’exécution, et tout ce qui se trouve après le conteneur est retenu.
Avec continuer en cas d’erreur, le membre en échec est considéré comme terminé ; la sortie du conteneur se libère quand même une fois ses branches restantes terminées, et le travail en aval se poursuit.

Désactivation d’un conteneur d’exécution. La désactivation d’un conteneur d’exécution l’ignore comme un tout — ses membres ne s’exécutent pas, et comme un conteneur ignoré ne produit aucune sortie, tout ce qui se trouve en aval du conteneur est également ignoré au lieu de s’exécuter sur une entrée absente. C’est différent de la désactivation d’un conteneur simple (hors exécution), qui n’ignore que les étapes membres ; les étapes en aval qui ne dépendent pas de ces membres s’exécutent toujours. Réactivez le conteneur pour rétablir tout le groupe.

Ajout et retrait d’étapes. Vous modifiez les étapes d’un conteneur d’exécution de la même manière, avec Cmd/Ctrl+glissement. PlaidCloud refuse le déplacement, affiche un message et remet l’étape où elle se trouvait, lorsque :

l’étape est connectée au port d’entrée ou de sortie du conteneur lui-même,
le déplacement créerait un cycle à travers la frontière du conteneur, ou
il retirerait la dernière étape du conteneur. Utilisez plutôt Dissocier le conteneur.

Exécuter et surveiller les conteneurs d’exécution

Un conteneur d’exécution est aussi quelque chose que vous exécutez et surveillez comme un tout. Vous pouvez démarrer uniquement son travail, suivre un état consolidé pendant l’exécution et accéder directement à un échec en son sein — sur le canevas comme dans le moniteur d’exécution.

Exécuter le groupe / Exécuter le groupe + l’aval. Faites un clic droit sur un conteneur d’exécution pour l’exécuter sans toucher au reste du workflow :

Exécuter le groupe exécute les étapes membres du conteneur.
Exécuter le groupe + l’aval exécute les membres et tout ce qui se trouve en aval du conteneur.

Aucune de ces commandes ne ré-exécute les étapes en amont qui alimentent le conteneur — elles exécutent le groupe en l’état, avec l’entrée déjà en place. Les deux utilisent le même mécanisme Exécuter la sélection que les étapes individuelles ; les membres se déclenchent donc en parallèle et le moteur d’exécution les séquence selon leurs dépendances.

État en direct du groupe. Pendant l’exécution d’un workflow, le conteneur affiche un état consolidé de ses membres : un point d’état, un compteur N sur M terminés et une bordure colorée. L’état reflète les membres dans leur ensemble — erreur si un membre a échoué, en cours d’exécution tant qu’un membre s’exécute, terminé une fois tous les membres achevés, ignoré lorsque le groupe a été ignoré, et ainsi de suite. Un conteneur réduit affiche le même agrégat sur sa tuile unique ; replier un groupe ne masque donc pas l’avancement de son travail.

Accéder à l’échec. Lorsqu’un groupe a un membre en échec, cliquez sur son état pour sélectionner et centrer ce membre sur le canevas — inutile de fouiller le groupe pour trouver ce qui a interrompu l’exécution.

Réessayer après l’échec. Faites un clic droit sur un conteneur d’exécution en échec et choisissez Réessayer après l’échec pour ré-exécuter uniquement le ou les membres en échec et tout ce qui se trouve en aval de ceux-ci à l’intérieur du groupe ; les membres déjà réussis sont ignorés. C’est la différence avec Exécuter le groupe, qui ré-exécute tous les membres sans distinction. Réessayer après l’échec est le chemin le plus rapide pour revenir au vert une fois que vous avez corrigé ce qui a fait trébucher un membre.

Durée de la dernière exécution. L’en-tête du conteneur affiche la somme des durées de la dernière exécution de ses membres, afin que vous puissiez lire d’un coup d’œil le coût de l’ensemble du groupe plutôt que d’additionner vous-même les membres.

Info-bulles des ports. Survolez le Port d’entrée ou le Port de sortie d’un conteneur d’exécution pour voir, dans l’info-bulle, les tables qui traversent cette frontière — les entrées que le groupe consomme ou les sorties qu’il transmet en aval.

Itérer sur un conteneur

Un conteneur d’exécution peut exécuter son sous-DAG scellé une fois par itération sur un ensemble de valeurs — un groupe qui charge et transforme les données d’une région peut ainsi traiter chaque région à tour de rôle sans que vous ayez à copier les étapes pour chaque région. Faites un clic droit sur un conteneur d’exécution et choisissez Paramètres du conteneur…, puis l’onglet Itérer sur, et cochez Itérer ce conteneur d’exécution pour activer l’itération (les paramètres n’apparaissent que sur les conteneurs d’exécution, puisque l’itération pilote un groupe qui s’exécute comme une unité). L’itération est facultative — laissez la case décochée et le conteneur s’exécute une seule fois ; un conteneur peut donc porter des conditions seules, sans aucun paramètre d’itération.

Chaque passe lie la variable de boucle à la valeur suivante, puis exécute tout le groupe scellé — dans l’ordre, une passe à la fois.

Configurer la boucle. L’onglet Itérer sur de la boîte de dialogue Paramètres du conteneur… utilise le même modèle d’itération que l’étape Exécuter le workflow en boucle, sur des sous-pages à onglets. Choisissez comment l’ensemble d’itération est construit :

Specify Variable Values to Iterate Over — définissez vous-même les valeurs dans l’onglet Itération manuelle des valeurs. Ajoutez une ou plusieurs variables de boucle et, pour chacune, indiquez soit une liste explicite de valeurs, soit une plage :

Type de plage Itère une fois par…

Entier nombre à partir d’un début, d’une fin et d’un pas

Majuscules / Minuscules lettre d’une plage (A–Z ou a–z)

Une plage peut porter une liste de valeurs exclues à ignorer. Lorsque vous définissez plus d’une variable, le conteneur s’exécute une fois par combinaison de leurs valeurs (le produit cartésien).
Use Combination of Unique Values in Table — choisissez une table source dans l’onglet Itérer sur, puis, dans l’onglet Data to Variable Mapping, associez une ou plusieurs de ses colonnes à des noms de variables de boucle. Le conteneur s’exécute une fois par combinaison unique des valeurs de ces colonnes. Utilisez l’onglet Filtres de données de la table pour restreindre les lignes prises en compte.

Type de plage	Itère une fois par…
Entier	nombre à partir d’un début, d’une fin et d’un pas
Majuscules / Minuscules	lettre d’une plage (`A`–`Z` ou `a`–`z`)

Les étapes à l’intérieur du conteneur référencent chaque variable de boucle comme n’importe quelle variable de workflow — {region} — de sorte que le SQL, les expressions, les noms de tables et les chemins de fichiers d’un membre peuvent tous varier selon l’itération. Vous pouvez aussi activer Combine all iterations’ output pour cumuler les résultats de chaque passe au lieu de ne conserver que la dernière — voir la remarque ci-dessous sur l’état de cette fonction.

Comment il s’exécute. Les itérations s’exécutent en série, l’une après l’autre — les membres partagent les variables de boucle, et deux passes simultanées liraient donc les valeurs l’une de l’autre. Chaque itération lie les variables de boucle à la valeur (ou à la combinaison) suivante, puis exécute tout le groupe comme une exécution ordinaire de conteneur d’exécution ; l’itération suivante ne démarre que lorsque la précédente est terminée. Un conteneur est plafonné à 1 000 itérations.

Ce que lit l’aval. Comme chaque passe écrase les tables de sortie du groupe, une étape en aval du conteneur lit la sortie de la dernière itération. Si vous avez besoin des lignes de chaque itération, activez Combine all iterations’ output pour que les passes s’accumulent au lieu de se remplacer.

Par exemple, pour produire un extrait filtré par région, ajoutez une variable de boucle region avec une liste de valeurs East, West, et donnez à une étape membre un filtre qui lit la variable :

SELECT *
  FROM sales
 WHERE region = '{region}'

Le conteneur s’exécute deux fois — region = 'East', puis region = 'West' — en exécutant à chaque fois tout le groupe scellé.

Conditions de conteneur

Un conteneur d’exécution peut aussi porter des conditions qui déterminent si le conteneur entier s’exécute — les mêmes contrôles de variables, de tables, de documents et de temps que ceux des conditions d’une étape, de sorte que les deux fonctionnent de la même manière. Faites un clic droit sur le conteneur, choisissez Paramètres du conteneur… et ouvrez l’onglet Conditions — le premier onglet, là où se trouvent les conditions d’une étape : c’est la même interface de conditions que celle d’une étape, inchangée. Les conditions ne nécessitent aucune itération ; un conteneur peut donc les porter seules, avec Itérer ce conteneur d’exécution désactivé.

Évaluées une seule fois, à l’entrée. Les conditions d’un conteneur sont vérifiées une seule fois, lorsque le conteneur est atteint dans le graphe — pas une fois par membre et, pour un conteneur itératif, pas une fois par itération non plus. Si les conditions sont satisfaites, chaque étape membre s’exécute normalement. Si elles échouent, aucun membre ne s’exécute ; le conteneur ne produit aucune sortie, de sorte que tout ce qui se trouve en aval est également ignoré, comme pour un conteneur désactivé.

Ignorer uniquement — il n’y a pas de « aller à ». La condition en échec d’une étape peut envoyer l’exécution vers une étape nommée au lieu de simplement passer à la suite ; celle d’un conteneur ne le peut pas. Le sélecteur « aller à l’étape » qu’offre une étape est masqué pour un conteneur ; une condition de conteneur en échec signifie donc toujours ignorer le conteneur et tout ce qui se trouve en aval — il n’y a aucun point d’arrivée alternatif à choisir.

Comment cela se combine :

La désactivation l’emporte. Un conteneur que vous avez désactivé est ignoré quelles que soient ses conditions — la désactivation est un saut plus fort et inconditionnel qui ne les évalue pas du tout.
L’itération est conditionnée, pas bouclée. Un conteneur qui itère et a aussi des conditions vérifie les conditions une seule fois, avant la première itération, pour décider si la boucle s’exécute. Une condition en échec ignore toutes les itérations, pas seulement la première ; une condition satisfaite n’est pas revérifiée d’une passe à l’autre.
La reprise conserve la décision. La reprise d’une exécution qui a ignoré un conteneur de cette manière ne réévalue pas la condition — le conteneur reste ignoré, comme toute autre décision achevée avant la suspension.
Une condition défectueuse fait échouer l’exécution. Une erreur lors de l’évaluation d’une condition — un contrôle mal configuré, par exemple — fait échouer l’exécution avec cette erreur. Elle n’est pas traitée comme une condition en échec ; elle n’ignore donc pas silencieusement le conteneur.

L’inspecteur

L’inspecteur d’étape ancré affiche tout ce qui concerne l’étape que vous sélectionnez :

Entrées et Sorties — les données qui entrent dans l’étape et en sortent. L’icône en forme d’œil d’une carte d’entrée ou de sortie ouvre le tiroir Aperçu des données pour un aperçu rapide des premières lignes de cette table.
Statistiques d’exécution — le résultat de la dernière exécution de l’étape, la dernière durée, le nombre d’exécutions et des résumés de durée, dont les durées Moyenne et p95, ainsi que la dernière erreur d’exécution ou le dernier avertissement d’exécution le cas échéant.
Modifier la configuration de l’étape… et Modifier les détails de l’étape… — accèdent directement aux formulaires de l’étape, et renommez l’étape en ligne en cliquant sur son nom.
Restaurer la configuration de l’étape (Flashback) — rétablit la configuration de l’étape à une version enregistrée antérieure.
Afficher l’historique d’exécution — ouvre l’historique complet des exécutions de cette étape.

Sélectionnez une seule étape pour l’inspecter ; sélectionnez-en plusieurs et l’inspecteur vous oriente vers les actions groupées de la barre d’outils du canevas.

L’inspecteur est redimensionnable — faites glisser le séparateur entre lui et le canevas — et réductible : le chevron à côté du nom de l’étape (ou la touche ]) le replie en un rail étroit qui continue d’afficher le nom de l’étape sélectionnée sur son côté, afin que vous puissiez rendre la largeur au canevas sans perdre de vue ce que vous aviez sélectionné. Cliquez n’importe où sur le rail pour le rouvrir. Voir Réduire et redimensionner les volets Palette et Inspecteur.

Historique des exécutions

Choisissez Afficher l’historique d’exécution de ce workflow pour voir les exécutions passées avec des statistiques récapitulatives. Le canevas dessine aussi une carte thermique à partir des enregistrements d’exécution récents, de sorte que les étapes qui échouent ou ralentissent fréquemment ressortent d’un coup d’œil.

Afficher les journaux

Cliquez sur Afficher les journaux dans la barre d’outils pour accéder directement à la vue Journal du projet, déjà filtrée sur ce workflow — le journal d’exécution complet auquel vous accéderiez autrement depuis la zone Projet. Voir Consulter le journal du workflow.

Quand le canevas ne peut pas ouvrir un workflow

Le canevas ouvre un workflow même lorsqu’une partie de sa disposition enregistrée est illisible.

Un conteneur sans position ni taille enregistrée — par exemple un conteneur créé via l’API ou MCP — s’ouvre, dessiné autour de ses étapes membres.
Un autre élément de disposition illisible — le workflow s’ouvre quand même, et une notification Disposition partiellement illisible liste ce qui a été réinitialisé ou masqué : jusqu’à trois éléments, puis …et N de plus. Une annotation masquée est supprimée à la prochaine sauvegarde de la disposition.
Un workflow qui ne peut pas être chargé — un message Impossible de charger le workflow en donne la raison, au lieu d’un canevas vide. Fermez le canevas et rouvrez le workflow.
Un workflow standard — le canevas affiche Canevas visuel indisponible — Ce workflow n’est pas avancé. Utilisez « Convertir en avancé… » pour activer le canevas visuel. Choisissez Convertir en avancé… sur le workflow pour l’activer. Voir Standard et avancé.

Étapes suivantes

Synchroniser les dépendances — ajoutez les connecteurs qui font exécuter chaque étape après l’étape qui écrit une table qu’elle lit
Optimiser un workflow — fusionnez les étapes d’extraction et reconstruisez les dépendances pour que le workflow s’exécute plus vite
Prévisualiser les données d’une étape — parcourez la sortie de n’importe quelle étape dans le tiroir Aperçu des données ancré
Consulter le journal du workflow — lisez le journal d’exécution complet d’un workflow
Exécuter un workflow — exécuter un workflow de bout en bout
Gérer les erreurs d’étape — déboguer les échecs
Calendrier des prochaines exécutions — voyez quand les workflows planifiés s’exécuteront