v26.01: Gestion des flux de travail
L'élaboration d'un flux de travail implique un processus structuré, de la création à l'exécution. Cette section vous guide à travers chaque étape du cycle de développement d'un flux de travail :
- Création d'un nouveau flux de travail: Établir le conteneur de flux de travail avec un nom et une description.
- Ajouter aux favoris: Marquez les flux de travail fréquemment utilisés pour y accéder rapidement.
- Modification des propriétés du flux de travail: Mettre à jour les métadonnées du flux de travail si nécessaire.
- Ajout de nœuds: Construire le pipeline de données en ajoutant et en configurant des nœuds.
- Flux de travail de publication: Sauvegarder toutes les configurations du flux de travail.
- Exécution de flux de travail: Exécuter le flux de travail et contrôler les résultats.
Chaque étape s'appuie sur la précédente, créant ainsi un flux de travail complet et exécutable qui automatise les opérations sur les données.
Création d'un nouveau flux de travail
Pour créer un flux de travail :
- Naviguez jusqu'au domaine fonctionnel cible dans le volet Explorateur.
- Cliquez sur l'icône + et sélectionnez Workflow dans la liste des types d'objets disponibles.
- Le panneau Détails du flux de travail s'ouvre sur le côté droit.
- Saisissez le nom du flux de travail dans le champ Nom (il doit être unique).
- Saisissez une description dans le champ Description.
- Confirmez ou modifiez le domaine fonctionnel à l'aide de la liste déroulante.
- Sélectionnez Créer.
Le flux de travail s'ouvre dans le canevas, prêt à être conçu.
Ajouter aux favoris
Pour ajouter un flux de travail aux favoris :
- Ouvrez le flux de travail dans le canevas.
- Cliquez sur l'icône en forme d'étoile située à côté du nom du flux de travail dans l'en-tête du niveau 2.
- Une fenêtre contextuelle intitulée Ajouter aux favoris s'affiche et vous permet d'effectuer les opérations suivantes :
- Entrez un nom pour le favori.
- Sélectionnez un dossier pour l'enregistrer.
- Sélectionnez ADD pour confirmer ou CANCEL pour quitter.
Une fois ajouté, le flux de travail apparaît dans les Favoris du panneau de l'Explorateur pour un accès rapide.
Remarque : Les favoris sont propres à l'utilisateur et persistent d'une session à l'autre.
Modification des propriétés du flux de travail
Pour modifier les propriétés du flux de travail :
- Localisez le panneau Détails du flux de travail sur le côté droit du canevas.
- Modifiez l'un des champs suivants :
- Nom Modifier l'identifiant du flux de travail (qui doit rester unique).
- Description Mettre à jour les informations contextuelles.
- Domaine fonctionnel Sélectionnez un autre domaine fonctionnel dans la liste déroulante.
- Les modifications prennent effet immédiatement dans le tableau de bord.
- Cliquez sur Publier pour enregistrer les modifications de façon permanente.
Ajout de nœuds
Les nœuds sont les éléments constitutifs des flux de travail, chaque nœud effectuant une opération spécifique dans le pipeline de données. Les nœuds sont ajoutés par le biais d'un processus commun et des connecteurs sont automatiquement créés entre les nœuds pour montrer le flux de données.
Pour ajouter un nœud :
-
Sélectionnez + Ajouter un nœud dans l'en-tête du niveau 2.
La boîte de dialogue Ajouter un nœud s'ouvre. La boîte de dialogue affiche les catégories de nœuds disponibles sur la gauche et les types de nœuds sur la droite.
Sélectionnez la catégorie appropriée en fonction de l'opération nécessaire (transformation, lecture ou écriture) dans le panneau de gauche.
-
Sélectionnez le type de données requis dans le panneau de droite.
Le nœud apparaît dans le canevas et le volet latéral s'ouvre.
Un connecteur se forme automatiquement entre le nœud précédent et le nouveau nœud.
-
Le panneau de configuration s'ouvre sur le côté droit.
Sélectionnez Publier pour enregistrer la configuration.
Pour des informations détaillées sur chaque type de nœud, voir Comprendre les types et catégories de nœuds.
v26.02: Renommer des nœuds
Lorsqu'un nœud est renommé dans le canevas, le système met automatiquement à jour le nom du nœud dans toutes les configurations de nœuds où il est référencé en tant que source ou entrée, dans toutes les requêtes SQL des nœuds SQL Script, dans l'affichage du canevas et dans la page de renvoi du flux de travail. Les règles standard de validation des noms s'appliquent.
v26.02: Suppression de nœuds
Lorsqu'un nœud est supprimé, le système le retire de toutes les configurations de nœuds dépendants, supprime toutes les connexions associées du canevas et affiche des icônes d'avertissement de validation sur tous les nœuds qui deviennent ainsi incomplets. Le nom du nœud supprimé peut être réutilisé.
Flux de publication
La publication enregistre toutes les configurations du flux de travail de manière permanente. Les flux de travail peuvent être publiés à n'importe quel stade du développement, y compris avec des configurations de nœuds incomplètes.
Pour publier un flux de travail :
- Cliquez sur Publier dans l'en-tête Niveau 2.
- Le système enregistre toutes les modifications, y compris :
- Disposition du canevas et positions des nœuds.
- Toutes les configurations de nœuds.
- Toutes les connexions entre les nœuds.
- Toute suppression ou modification.
- Un message de confirmation apparaît.
Remarque : Aucune validation ne bloque l'opération de publication. Les flux de travail peuvent être enregistrés avec des nœuds incomplets ou déconnectés, mais des icônes d'avertissement s'affichent pour signaler aux utilisateurs les problèmes de configuration.
Exécution de flux de travail
Exécuter le flux de travail pour traiter les données et visualiser les résultats.
Pour exécuter un flux de travail :
- S'assurer que tous les nœuds nécessaires sont configurés et publiés.
- Cliquez sur le bouton Exécuter dans l'en-tête du niveau 2.
- L'exécution commence au nœud de départ.
- Des indicateurs visuels s'affichent sur les nœuds :
- Traitement Icône de chargement.
- Réussite: Cochez la case.
- Erreur: Icône d'erreur.
- Le bouton Exécuter est désactivé pendant l'exécution.
Remarque : L'exécution suit tous les chemins connectés à partir du nœud de départ. Les nœuds déconnectés sont ignorés pendant l'exécution.
v26.02: Exécution de flux de travail avec sélection des membres
Le bouton Exécuter ouvre une fenêtre contextuelle en ligne intitulée "Sélections" qui affiche toutes les dimensions uniques utilisées dans le flux de travail (union des dimensions FAContext), pré-remplies avec les sélections actuelles du contexte de l'en-tête L2.
Pour exécuter un flux de travail avec sélection des membres :
Sélectionnez le bouton Exécuter dans le canevas. La fenêtre contextuelle "Sélections" s'ouvre.
Sélectionnez l'icône Filtre à côté d'une dimension pour ouvrir un sélecteur de membres en ligne avec une liste hiérarchique des membres autorisés.
Cochez un ou plusieurs membres par dimension et sélectionnez OKAY. Les membres sélectionnés s'affichent avec un indicateur de relation "LM" en lecture seule.
Pour supprimer des membres, cochez la case à côté d'eux et sélectionnez l'icône de la corbeille.
Assurez-vous que toutes les dimensions comportent au moins une sélection (le bouton RUN est désactivé tant que toutes les dimensions ne sont pas renseignées), puis sélectionnez RUN pour exécuter.
Les sélections de membres sont transmises à tous les nœuds de flux de travail configurés par FAContext pendant l'exécution. Pour les scripts SQL utilisant des valeurs contextuelles, la multi-sélection est prise en charge. Le système génère des entrées dans le journal des événements pour chaque exécution, et les sélections contextuelles sont conservées lorsque la fenêtre contextuelle Exécuter est ouverte à nouveau.
Note: Lorsque vous utilisez Exécuter SQL dans l'éditeur de script ou que vous visualisez la sortie d'exécution en dehors d'une exécution, le système utilise les sélections contextuelles de l'en-tête L2 au lieu des sélections contextuelles d'Exécution.
v26.02: Exécution de flux de travail à partir de tâches d'activité
Les flux de travail peuvent être ajoutés aux tâches de "calcul et de flux de données" dans les flux de processus, ce qui permet de les exécuter directement à partir des tâches d'activité sans accéder à l'ensemble du canevas de flux de travail.
Lorsqu'un utilisateur ouvre une tâche contenant des flux de travail d'une activité, un volet latéral s'ouvre et affiche des sélections de dimensions dérivées des nœuds du flux de travail. Les dimensions correspondant à l'instance d'activité sont automatiquement complétées par des valeurs contextuelles. Les utilisateurs sélectionnent le bouton Calculer pour exécuter le flux de travail de bout en bout et peuvent modifier les sélections et le réexécuter si nécessaire.
Chaque entrée de workflow dans la configuration de la tâche comprend une case à cocher Active (contrôle la visibilité dans l'activité) et une case à cocher Exécuter les formules par défaut (contrôle l'ordre d'exécution des formules). Les flux de travail multiples s'exécutent séquentiellement dans l'ordre où ils apparaissent.
Le système génère des journaux d'exécution pour chaque exécution, capturant l'état de l'exécution, les détails de l'utilisateur, les sélections de dimensions et les états nœud par nœud.
Visualisation des résultats de l'exécution
Pour visualiser les résultats de l'exécution :
- Localisez la section "Execution Output" en bas du canevas.
- Cliquez sur l'icône de développement pour ouvrir la section.
- Passer d'un onglet à l'autre :
- Onglet Données: Visualiser les données traitées (500 lignes par défaut).
- Onglet Message: Affichez les journaux d'exécution horodatés avec le nom du nœud, le type de message (Info, Avertissement, Erreur) et les détails.
Dépannage des erreurs
Lorsque des erreurs se produisent pendant l'exécution du flux de travail :
- Vérifier les nœuds avec les icônes d'erreur sur le canevas.
- Ouvrez la section Sortie d'exécution.
- Cliquez sur l'onglet Message.
- Examinez les détails de l'erreur, notamment le nom du nœud, le type d'erreur et le message d'erreur.
- Corriger la configuration dans le nœud concerné.
- Cliquez sur Publier pour enregistrer les corrections.
- Cliquez à nouveau sur Exécuter pour réexécuter.