v26.01: Gestion des workflows

La création d'un workflow implique un processus structuré, de sa conception à son exécution. Cette section vous guide à travers chaque étape du cycle de vie du développement d'un workflow :

Création d'un nouveau workflow : Définissez le conteneur du workflow en lui attribuant un nom et une description.
Ajouter aux Favoris : Marquez les workflows fréquemment utilisés pour y accéder rapidement.
Modifier les propriétés d'un workflow : Mettez à jour les métadonnées du workflow si nécessaire.
Ajout de nœuds : Construisez le pipeline de données en ajoutant et en configurant des nœuds.
Publier les workflows : Enregistrez toutes les configurations de workflow.
Exécution des workflows : Exécutez le workflow et surveillez les résultats.

Chaque étape s'appuie sur la précédente, créant ainsi un workflow complet et exécutable qui automatise les opérations sur les données.

Création d'un nouveau workflow

Pour créer un workflow :

Accédez au domaine fonctionnel cible dans le volet Explorateur.
Cliquez sur l'icône + et sélectionnez Workflow parmi les types d'objets disponibles.
Le panneau Détails du workflow s'ouvre à droite.
Saisissez le nom du workflow dans le champ Nom (il doit être unique).
Saisissez une description dans le champ Description.
Validez ou modifiez le Domaine fonctionnel à l'aide du menu déroulant.
Sélectionnez Créer.

Le workflow s’ouvre dans le canevas, prêt à être conçu.

Ajouter aux Favoris

Pour ajouter un workflow aux Favoris :

Ouvrez le workflow dans le canevas.
Cliquez sur l'icône en forme d'étoile située à côté du nom du workflow dans l'en-tête de niveau 2.
Une fenêtre contextuelle intitulée Ajouter aux Favoris s'affiche, dans laquelle vous pouvez :
- Saisir un nom pour le favori.
- Sélectionner un dossier dans lequel l'enregistrer.
Sélectionnez AJOUTER pour confirmer ou ANNULER pour quitter.

Une fois ajouté, le workflow apparaît dans la section Favoris du panneau Explorateur pour un accès rapide.

Note: Les favoris sont spécifiques à chaque utilisateur et sont conservés d'une session à l'autre.

Modifier les propriétés d’un workflow

Pour modifier les propriétés d’un workflow :

Repérez le panneau « Détails du workflow » situé à droite du canevas.
Modifiez l’un des champs suivants :
- Nom : Modifiez l'identifiant du workflow (qui doit rester unique).
- Description : Mettez à jour les informations contextuelles.
- Domaine fonctionnel : Sélectionnez un autre domaine fonctionnel dans la liste déroulante.
- v26.10: Autoriser l'accès aux tables de l'espace de travail : Sélectionnez cette option pour permettre aux nœuds « Script SQL » de ce workflow de lire les tables qui ne sont pas ajoutées en tant qu’entrées de nœud. Cette option est désactivée par défaut et requiert un accès de gestion au workflow.
Les modifications prennent effet immédiatement dans le panneau.
Cliquez sur Publier pour enregistrer définitivement les modifications.

Ajout de nœuds

Les nœuds constituent les éléments de base des workflows, chaque nœud effectuant une opération spécifique dans le pipeline de données. Les nœuds sont ajoutés selon un processus standard, et des connecteurs sont automatiquement créés entre les nœuds pour illustrer le flux de données.

Pour ajouter un nœud :

Sélectionnez + Ajouter un nœud dans l'en-tête de niveau 2.

La boîte de dialogue Ajouter un nœud s'ouvre. La boîte de dialogue indique les catégories de nœuds disponibles à gauche et les types de nœuds à droite.
Sélectionnez la catégorie appropriée dans le volet de gauche.

Catégories disponibles : Transformation, Lecture, Écriture, Ensemble de règles (catégories actives) et Logique, Collaboration (espaces réservés pour les versions futures).
Sélectionnez le type de données requis dans le volet de droite.

Le nœud apparaît sur 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 à droite.
Configurez les champs spécifiques au type de données dans le volet latéral.

Note: Les détails des champs varient selon le type de données — consultez Comprendre les types et catégories de nœuds pour obtenir la référence des paramètres par type de données et la section relative au type de données concerné pour connaître la procédure de configuration.
(Facultatif) Configurez la section Paramètres pour contrôler l’ordre d’exécution des nœuds. Consultez Utilisation des paramètres des nœuds pour plus de détails.
Sélectionnez Publier pour enregistrer la configuration.

v26.02: Renommer des nœuds

Lorsqu’un nœud est renommé sur 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é comme source ou entrée, dans toutes les requêtes SQL des nœuds « Script SQL », dans l’affichage du canevas et sur la page d’accueil du workflow. 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épendantes, supprime toutes les connexions associées du canevas et affiche des icônes d’avertissement de validation sur les nœuds qui deviennent incomplets. Le nom du nœud supprimé devient disponible pour être réutilisé.

Publication des workflows

Publier enregistre définitivement toutes les configurations de workflow. Les workflows peuvent être publiés à n'importe quelle étape de leur développement, même si certaines configurations de nœuds sont incomplètes.

Pour publier un workflow :

Cliquez sur Publier dans l'en-tête de niveau 2.
Le système enregistre toutes les modifications, notamment :
- La disposition du canevas et la position des nœuds.
- Toutes les configurations des nœuds.
- Toutes les connexions entre les nœuds.
- Tous les suppressions ou modifications.
Un message de confirmation s'affiche.

Note: Aucune validation ne bloque l'opération de publication. Les workflows peuvent être enregistrés même si certains nœuds sont incomplets ou déconnectés, mais des icônes d’avertissement sont indiquées pour signaler aux utilisateurs les problèmes de configuration.

Exécuter les workflows

Exécutez le workflow pour traiter les données et afficher les résultats.

Pour exécuter un workflow :

Assurez-vous que tous les nœuds requis sont configurés et publiés.
Cliquez sur le bouton Exécuter dans l'en-tête de niveau 2.
L'exécution commence au nœud « Démarrer ».
Des indicateurs visuels indiquent sur les nœuds :
- Traitement : Icône de chargement.
- Réussite : Coche.
- 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 « Démarrer ». Les nœuds non connectés sont ignorés lors de l'exécution.

v26.02: Exécution de workflows avec sélection de membres

Le bouton « Exécuter » ouvre une fenêtre contextuelle intégrée intitulée « Sélections » indiquant toutes les dimensions uniques utilisées dans le workflow (union des dimensions FAContext), préremplie avec les sélections actuelles du contexte d’en-tête L2.

Pour exécuter un workflow 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 intégré proposant une liste hiérarchique des membres autorisés.
Contrôlez un ou plusieurs membres par dimension, puis sélectionnez « OK ». Les membres sélectionnés sont indiqués avec un indicateur de relation « LM » en lecture seule.
Pour supprimer des membres, cochez la case à côté de ceux-ci et sélectionnez l’icône « Corbeille ».
Assurez-vous que toutes les dimensions comportent au moins une sélection (le bouton EXECUTER est désactivé tant que toutes les dimensions ne sont pas renseignées), puis sélectionnez EXECUTER pour lancer l’exécution.

Les sélections de membres sont transmises à tous les nœuds de workflow configurés via FAContext lors de l’exécution. Pour les scripts SQL utilisant des valeurs de contexte, la sélection multiple est prise en charge. Le système génère des entrées de journal des événements pour chaque exécution, et les sélections de contexte sont conservées lorsque la fenêtre contextuelle « Exécuter » est rouverte.

Note: Lorsque vous utilisez « Exécuter SQL » dans l’éditeur de script ou que vous consultez la sortie de l’exécution en dehors d’une exécution, le système utilise les sélections de contexte de l’en-tête L2 au lieu des sélections de la fenêtre contextuelle « Exécuter ».

v26.02: Exécution de workflows à partir de tâches d’activité

Les workflows peuvent être ajoutés aux tâches « Calcul et flux de données » dans les flux de processus, ce qui permet leur exécution directement à partir des tâches d’activité sans accéder au canevas complet du workflow.

Lorsqu’un utilisateur ouvre une tâche contenant des workflows à partir d’une activité, un volet latéral s’ouvre pour indiquer les sélections de dimensions dérivées des nœuds du workflow. Les dimensions correspondant à l’instance d’activité sont automatiquement renseignées avec les valeurs de contexte. Les utilisateurs cliquent sur le bouton « Calculer » pour exécuter le workflow de bout en bout et peuvent modifier les sélections et relancer l’exécution si nécessaire.

Chaque entrée de workflow dans la configuration de la tâche comprend une case à cocher « Actif » (qui contrôle la visibilité dans l’activité) et une case à cocher « Exécuter les formules par défaut » (qui contrôle l’ordre d’exécution des formules). Plusieurs workflows 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, enregistrant l’état d’exécution, les détails de l’utilisateur, les sélections de dimensions et les états nœud par nœud.

v26.05: Exécution de workflows comportant des nœuds pour charger des fichiers

Lorsque le workflow contient un ou plusieurs nœuds « Charger le fichier », la boîte de dialogue « Exécuter » indique une section dédiée « Téléchargements de fichiers » pour chaque nœud « Charger le fichier », à côté de la fenêtre contextuelle « Sélections » existante. Chaque bloc « Charger le fichier » contient un bouton « Choisir un fichier », une liste déroulante « Encodage » (UTF-8 par défaut) et une liste déroulante « Délimiteur » (virgule par défaut). Le bouton EXECUTER reste désactivé tant qu’un fichier valide n’a pas été chargé pour chaque nœud de chargement de fichiers.

Une section « Fichiers précédemment téléchargés », propre à l’utilisateur connecté, répertorie les téléchargements effectués lors d’exécutions précédentes par ordre chronologique inverse, avec l’horodatage et l’icône de déclenchement. Seul le fichier effectivement utilisé lors de l’exécution est ajouté à l’historique — les fichiers d’exemple configurés lors de la conception et les sélections rejetées sont exclus.

Pour plus de détails sur la configuration des nœuds « Charger le fichier », voir Nœud de lecture « Charger le fichier ».

Affichage de la sortie d’exécution

Pour afficher la sortie de l’exécution :

Recherchez la section « Sortie d’exécution » au bas du canevas.
Cliquez sur l’icône d’expansion pour ouvrir la section.
Passez d'un onglet à l'autre :
- Onglet « Données » : Afficher les données traitées (500 lignes par défaut).
- Onglet « Message » : Afficher les journaux d'exécution horodatés avec le nom du nœud, le type de message (Info, Avertissement, Erreur) et les détails.
v26.10: L'onglet « Message » affiche le message du nœud sélectionné ; il reste vide tant que vous n'avez pas exécuté ou prévisualisé le nœud. Lorsque l'aperçu de l'onglet « Données » est tronqué, l'onglet « Message » indique le nombre de lignes affichées et le total, par exemple : Affichage de 1 000 enregistrements sur 100 000. Veuillez appliquer des filtres pour affiner les résultats.

Dépannage des erreurs

Lorsque des erreurs se produisent pendant l’exécution du workflow :

Contrôlez les nœuds comportant des icônes d'erreur sur le canevas.
Ouvrez la section « Sortie d'exécution ».
Cliquez sur l'onglet Message.
Consultez les détails de l'erreur, notamment le nom du nœud, le type d'erreur et le message d'erreur.
Corrigez la configuration du nœud concerné.
Cliquez sur Publier pour enregistrer les corrections.
Cliquez à nouveau sur Exécuter pour relancer l'exécution.

v26.10: Chaque nœud génère un message qui indique la nature du problème, par exemple une source ou une cible supprimée, une saisie manquante, une table vide ou des lignes ignorées en raison de l’inexistence d’un membre. Le message se termine par le nom du nœud et la mention « Réussi » ou « Échec ». Après avoir exécuté une tâche, le Journal des événements répertorie les messages de tous les nœuds dans l’ordre d’exécution. Exécuter à partir du canevas et exécuter à partir d’une tâche génèrent les mêmes messages.

v26.10: Actualisation d’un nœud après une modification de la source

Lorsqu’une feuille, une table de transactions, une table distante, une dimension ou une table de correspondance est modifiée après la publication d’un nœud de lecture, d’écriture ou de mapping, le workflow signale le nœud à l’ouverture du workflow. Le nœud affiche un point d’exclamation sur le canevas, et son en-tête L2 affiche la message Actualisation de la table de saisie. Ce signal n’a qu’une valeur indicative, et le nœud conserve sa structure jusqu’à l’actualisation. Un changement de nom ne déclenche pas de signalement du nœud. Si vous exécutez le workflow sans effectuer d'actualisation sur le nœud, le même message apparaît pour ce nœud dans le Journal des événements.

Pour réaliser l'actualisation d'un nœud signalé :

Ouvrez le nœud.
Ajoutez à nouveau le composant Source.
Vérifiez les modifications, et sélectionnez Publier.

Le fait d'ajouter à nouveau la source permet de conserver les sélections, la mise en page, les filtres et les mappages qui sont toujours valides. Les éléments supprimés à la Source sont supprimés du nœud, et un type de données modifié est appliqué. Les éléments ajoutés à la source sont disponibles mais ne sont pas sélectionnés : une nouvelle métrique apparaît dans le sélecteur de métriques, et une nouvelle dimension ou propriété apparaît dans la section Mettre à jour la liste.

Note: Un nœud de Mapping n'a pas de source à ajouter à nouveau. Ouvrez l’étape concernée, corrigez la colonne Source ou cible, et publiez.

Note: Une table distante dont le type passe à « Virtual » ne peut plus servir de source à un nœud de lecture.