v26.01: Utilisation des nœuds de lecture

Les nœuds de lecture récupèrent des données provenant de divers systèmes sources et les rendent disponibles pour les nœuds en aval dans le workflow. La catégorie Lecture propose différents types de nœuds, chacun étant conçu pour des sources de données spécifiques.

Types de nœuds de lecture disponibles

Mise en forme de la configuration

La section Mise en forme de la configuration permet de déterminer les dimensions et les métriques à inclure, ainsi que leur organisation dans le résultat.

La mise en forme se compose de trois sections qui fonctionnent conjointement pour définir la structure des données.

Chaque dimension affiche des commandes : icône de filtrage (sélecteur de membres), menu à points de suspension (options Déplacer/Supprimer), Préférences (Lignes uniquement) et Développer/Réduire.

v26.03: Mettre à jour la liste

Lorsque des dimensions sont supprimées d'une section de mise en forme, elles sont automatiquement déplacées vers la liste pour mettre à jour celle-ci. La liste pour mettre à jour conserve toutes les dimensions de la source qui ne sont actuellement pas visibles dans les sections de mise en forme.

Pour restaurer des dimensions, sélectionnez Mettre à jour la liste > cochez les dimensions > sélectionnez OK.

Note: Chaque dimension de la source doit apparaître à tout moment soit dans les sections de mise en forme, soit dans la liste pour mettre à jour la liste. Cela garantit une définition complète de la structure des données.

v26.05: Configuration du nœud Charger le fichier

Le nœud Charger le fichier fournit une source de données basée sur des fichiers pour les workflows. Les concepteurs de workflows configurent le nœud lors de la conception en spécifiant un type de fichier autorisé et un fichier d'exemple pour l'aperçu ; les utilisateurs fournissent le fichier réel lors de l'exécution via la boîte de dialogue Exécuter. Le nœud transmet une référence de fichier à un nœud Lecteur de fichiers en aval — il ne produit pas de sortie tabulaire de son propre chef.

v26.07:  Le nœud Charger le fichier accepte désormais les fichiers CSV et Excel, ce qui élimine les workflows de conversion de format de fichier. Les utilisateurs n'ont plus besoin de convertir les fichiers Excel au format CSV avant de les charger.

Pour configurer un nœud Charger le fichier :

1. Cliquez sur + Ajouter un nœud dans l'en-tête de niveau 2. La boîte de dialogue Ajouter un nœud s'ouvre.

2. Sélectionnez Lire dans le panneau de gauche.

3. Sélectionnez Charger le fichier dans le panneau de droite. Le nœud apparaît sur le canevas et le panneau de configuration s'ouvre.

4. Remplissez les champs requis dans le panneau de configuration :

   Paramètres	Description
   Nom	Identifiant unique. La valeur par défaut est Charger le fichier_[n].
   v26.07:  Types de fichiers autorisés	Liste déroulante avec CSV et Excel sélectionnés. Prend en charge les fichiers Excel à une ou plusieurs feuilles.
   Fichier d'exemple	Sélectionnez Choisir un fichier pour ouvrir la boîte de dialogue de sélection de fichiers du système d'exploitation et choisir un fichier représentatif. Le nom du fichier apparaît à côté du bouton (tronqué par des points de suspension s'il est trop long) ; tant qu'aucun fichier n'a été sélectionné, le champ affiche Aucun fichier sélectionné. Le fichier d'exemple est conservé lors de la publication ou de la réouverture, est partagé avec tous les utilisateurs du workflow (et non limité à un utilisateur) et n'est jamais ajouté à l'historique Fichiers précédemment chargés.
   v26.05: Paramètres (Facultatif)	Configurez les nœuds Précédent et Suivant pour contrôler l'ordre d'exécution des nœuds. Voir Utilisation des paramètres de nœud pour plus de détails.

5. Sélectionnez Publier dans l'en-tête de niveau 2 pour enregistrer la configuration.

   Deux commandes supplémentaires sont disponibles dans l'en-tête de niveau 2 :

   • Actualiser : Relit les données source et permet de prévisualiser les modifications de mise en forme non publiées sans requérir une publication complète.

   • Mode Affichage/Éditer : Permet d'afficher ou de masquer le panneau de configuration tout en conservant la grille de données en lecture seule.

v26.07: Formats de fichiers pris en charge

Le nœud Charger le fichier accepte à la fois les fichiers CSV et Excel.

• Les fichiers CSV comprennent les fichiers standard à valeurs séparées par des virgules, les fichiers délimités par des tabulations et les fichiers à délimiteurs personnalisés (configurables à l'exécution via les contrôles Encodage et Délimiteur).

• Les fichiers Excel comprennent les classeurs Excel à une ou plusieurs feuilles (.xlsx).

• Lorsque vous chargez un fichier Excel à plusieurs feuilles, le nœud Lecteur de fichiers vous permet de sélectionner la feuille à lire.

Fichier d'exemple vs. fichier d'exécution

Le fichier d'exemple sert uniquement à l'aperçu en phase de conception — il permet de configurer le nœud Lecteur de fichiers en aval en fonction d'une structure de fichier représentative. Au moment de l'exécution, les utilisateurs fournissent le fichier réel via la boîte de dialogue Exécuter (voir Exécution de workflows avec des nœuds Charger le fichier). Le fichier d'exécution peut avoir un contenu différent de celui du fichier d'exemple.

v26.07: Le fichier d'exemple et le fichier d'exécution peuvent être dans des formats différents (par exemple, le fichier d'exemple est au format CSV, celui d'exécution au format Excel), à condition que la structure soit compatible avec la configuration du Lecteur de fichiers.

Fichiers précédemment chargés

Une fois qu'un workflow a été exécuté avec un nœud Charger le fichier, le fichier d'exécution apparaît dans la section Fichiers précédemment chargés du nœud, réservée à l'utilisateur connecté. Les fichiers sont répertoriés par ordre chronologique inverse, avec l'horodatage et l'icône de déclenchement. Le fichier d'exemple n'est jamais ajouté à cette liste.

Nœuds de chargement de fichiers multiples

Un workflow peut contenir plusieurs nœuds Charger le fichier. Chacun est indépendant : son nom, le type de fichier autorisé, le fichier d'exemple et l'historique des chargements sont tous propres à chaque nœud. Au moment de l'exécution, chaque nœud dispose de son propre bloc dans la boîte de dialogue Exécuter, et le bouton Exécuter n'est activé que lorsque tous les nœuds Charger le fichier contiennent un fichier valide.

Gestion des chargements à l'exécution et de l'historique des fichiers

Au moment de l'exécution, la boîte de dialogue Exécuter affiche une section dédiée Charger le fichier pour chaque nœud Charger le fichier, avec des commandes pour Choisir un fichier, Encodage et Délimiteur. Le bouton Exécuter reste désactivé tant que chaque nœud Charger le fichier ne contient pas de fichier valide. Une section Fichiers précédemment chargés, propre à l'utilisateur connecté, répertorie les chargements effectués lors des exécutions précédentes par ordre chronologique inverse à des fins d'audit.

v26.07:  Lorsque le fichier Excel est chargé, un menu déroulant Sélection de la feuille s'affiche si le fichier contient plusieurs feuilles, permettant aux utilisateurs de spécifier la feuille à lire.

Configuration du nœud Lecteur de fichiers

Le nœud Lecteur de fichiers analyse un fichier reçu d'un nœud Charger le fichier pour le convertir en un ensemble de données tabulaire destiné à être utilisé en aval.

v26.07: À partir de la version 26.07, le Lecteur de fichiers prend désormais en charge une configuration distincte de la position des en-têtes et des données, ce qui permet un contrôle précis de l'emplacement où commencent les en-têtes et les données dans les fichiers Excel et CSV.

v26.05: 

Prérequis

Un nœud Charger le fichier doit déjà exister dans le workflow. Le nœud Lecteur de fichiers ne peut pas être configuré sans un nœud Charger le fichier en amont servant de source.

Pour configurer un nœud Lecteur de fichiers :

1. Cliquez sur + Ajouter un nœud dans l'en-tête de niveau 2. La boîte de dialogue Ajouter un nœud s'ouvre.

2. Sélectionnez Lire dans le panneau de gauche.

3. Sélectionnez Lecteur de fichiers dans le panneau de droite. Le nœud apparaît sur le canevas et le panneau de configuration s'ouvre.

4. Remplissez les champs requis dans le panneau de configuration :

   Paramètres	Description
   Nom	Identifiant unique. La valeur par défaut est Lecteur de fichiers_[n].
   Source	Sélectionnez un nœud Charger le fichier existant dans la liste déroulante. Le menu déroulant répertorie tous les nœuds Charger le fichier du workflow et se met à jour dynamiquement à mesure que des nœuds sont ajoutés, supprimés ou renommés.
   Cellule de début d'en-tête v26.07:	Référence de cellule définissant la ligne d'en-tête et la colonne la plus à gauche (par exemple, A1 ou B3). La ligne de la cellule de début d'en-tête est considérée comme l'en-tête ; la détection des colonnes commence à la colonne spécifiée. Ce paramètre est indépendant de la Cellule de début des données, ce qui permet aux en-têtes et aux données de commencer à des lignes différentes. Note: v26.08: Pour les fichiers Excel, vous pouvez spécifier n'importe quelle référence de cellule valide. Pour les fichiers CSV, l'en-tête est toujours fixé à la première ligne et à la première colonne.
   Cellule de début des données v26.07:	Référence de cellule définissant l'emplacement où commence la zone de données (par exemple, A2 ou B4). Les lignes situées au-dessus de cette cellule sont ignorées ; la ligne correspondant à la Cellule de début des données est la première ligne de données. Ce paramètre est indépendant de la Cellule de début d'en-tête, ce qui permet des structures de fichier flexibles avec des métadonnées ou plusieurs lignes d'en-tête. Note: v26.08: Lors du changement de type de fichier (Excel vers CSV), les cellules de début d'en-tête et de début des données sont automatiquement réinitialisées à leur position de départ par défaut, avec un avertissement pour éviter toute incompatibilité.
   Sélection des colonnes	Choisissez Toutes les colonnes (par défaut) pour inclure chaque colonne à partir de la colonne Cellule de début d'en-tête, ou Colonnes spécifiques pour ouvrir une liste des noms d'en-têtes accompagnés de leurs références de position (colonne A, B, C…) et sélectionner les colonnes à inclure.
   v26.05: Paramètres (Facultatif)	Configurez les nœuds Précédent et Suivant pour contrôler l'ordre d'exécution des nœuds. Voir Utilisation des paramètres de nœud pour plus de détails.

   Note: v26.08: Après avoir modifié l'en-tête ou la cellule de début des données, ou après avoir changé de type de fichier, le bouton Actualiser s'affiche. Tant qu'on n'a pas cliqué dessus, la liste des colonnes reste inchangée, ce qui préserve les mappages en aval. Un indicateur périmé s'affiche quand les colonnes sont obsolètes, invitant les utilisateurs à actualiser.

5. Sélectionnez Publier dans l'en-tête de niveau 2 pour enregistrer la configuration.

   Le système valide la configuration et affiche les données récupérées dans la grille de visualisation située sous la zone de travail. Les données s'affichent en lecture seule, structurées selon la mise en forme configurée.

   Deux commandes supplémentaires sont disponibles dans l'en-tête de niveau 2 :

   • Actualiser : Relit les données source et permet de prévisualiser les modifications de mise en forme non publiées sans requérir une publication complète.

   • Mode Affichage/Éditer : Permet d'afficher ou de masquer le panneau de configuration tout en conservant la grille de données en lecture seule.

v26.07: Contrôle indépendant de la position de l'en-tête et des données

Les paramètres Cellule de début d'en-tête et Cellule de début des données sont désormais indépendants, ce qui vous permet de gérer des fichiers présentant des mises en forme non standard :

• Scénario 1 : Fichier comportant des lignes de métadonnées avant les en-têtes

  • Cellule de début d'en-tête : B5 (les en-têtes commencent à la ligne 5)

  • Cellule de début des données : B6 (les données commencent à la ligne 6)

• Scénario 2 : Fichier comportant plusieurs lignes d'en-tête

  • Cellule de début d'en-tête : A1 (première ligne d'en-tête)

  • Cellule de début des données : A3 (les données commencent après la deuxième ligne d'en-tête, à la ligne 3)

• Scénario 3 : Fichier comportant des colonnes initiales à ignorer

  • Cellule de début d'en-tête : C1 (les en-têtes commencent à la colonne C)

  • Cellule de début des données : C2 (les données commencent à la colonne C, ligne 2)

La détection des colonnes se met automatiquement à jour chaque fois que vous modifiez les positions de l'en-tête ou de la cellule de début des données, garantissant ainsi que les mappages en aval restent synchronisés avec la nouvelle mise en forme.

Position des colonnes vs. nom des en-têtes

Tout le mapping en aval est basé sur la position des colonnes (colonnes A, B, C…), et non sur le nom des en-têtes. Si le fichier d'exécution comporte un texte d'en-tête différent de celui du fichier d'exemple (par exemple, "Compte" renommé "ACC"), le mapping reste intact car il suit la position des colonnes. Les fichiers dont les en-têtes sont vides ou manquants restent lisibles grâce à cette même référence positionnelle.

Sortie

La sortie du Lecteur de fichiers est un ensemble de données tabulaire plat (lignes × colonnes sélectionnées). Toutes les valeurs sont lues sous forme de texte. Les nœuds en aval (Mapping, SQL, Écriture) gèrent toute conversion de type.

Conditions d'échec

Le nœud échoue lors de l'exécution si :

• Le fichier chargé ne correspond pas à la configuration de Charger le fichier (par exemple, délimiteur incorrect).

• Le fichier chargé est vide (0 octet ou aucun contenu).

• v26.07: La ligne Cellule de début d'en-tête dépasse le nombre de lignes du fichier.

• v26.07: La ligne Cellule de début des données dépasse le nombre de lignes du fichier.

• Le nœud Charger le fichier connecté a été supprimé.

Plusieurs nœuds Lecteur de fichiers

Un nœud Charger le fichier peut alimenter plusieurs nœuds Lecteur de fichiers indépendants, chacun disposant de sa propre configuration Cellule de début d'en-tête, Cellule de début des données et Sélection des colonnes. Si le nœud Charger le fichier est supprimé, tous les nœuds Lecteur de fichiers connectés deviennent invalides jusqu'à ce qu'une nouvelle source Charger le fichier soit sélectionnée.

v26.02: Configuration du nœud Tableau distant

Les nœuds Tableau distant intègrent des données externes provenant de connexions à des tables distantes dans les pipelines de workflow.

Pour configurer un nœud Tableau distant :

1. Cliquez sur + Ajouter un nœud dans l'en-tête de niveau 2. La boîte de dialogue Ajouter un nœud s'ouvre.

2. Sélectionnez Lire dans le panneau de gauche.

3. Sélectionnez Tableau distant dans le panneau de droite. Le nœud apparaît sur le canevas et le panneau de configuration s'ouvre.

4. Remplissez les champs requis dans le panneau de configuration :

   Paramètres	Description
   Nom	Identifiant unique. La valeur par défaut est Tableau distant_[n].
   Source	Sélectionnez une table distante à l'aide du sélecteur intégré. Toutes les dimensions de la table distante sélectionnée sont automatiquement ajoutées à Lignes.
   Mise en forme	Configurez les sections Lignes et Filtres (il n'y a pas de section Colonnes).
   v26.05: Paramètres (Facultatif)	Configurez les nœuds Précédent et Suivant pour contrôler l'ordre d'exécution des nœuds. Voir Utilisation des paramètres de nœud pour plus de détails.

5. Sélectionnez Publier dans l'en-tête de niveau 2 pour enregistrer la configuration.

   Le système valide la configuration et affiche les données récupérées dans la grille de visualisation située sous la zone de travail. Les données s'affichent en lecture seule, structurées selon la mise en forme configurée.

   Deux commandes supplémentaires sont disponibles dans l'en-tête de niveau 2 :

   • Actualiser : Relit les données source et permet de prévisualiser les modifications de mise en forme non publiées sans requérir une publication complète.

   • Mode Affichage/Éditer : Permet d'afficher ou de masquer le panneau de configuration tout en conservant la grille de données en lecture seule.

v26.04: Toutes les dimensions de la table distante sélectionnée sont automatiquement ajoutées à Lignes lors de la sélection de la source. Les dimensions des tables distantes n'ont pas de relations hiérarchiques. Les nœuds Lecture de table distante prennent en charge les références aux paramètres de workflow pour le filtrage dynamique des données.

Configuration du nœud Feuille

Les nœuds Feuille récupèrent les données des feuilles de l'espace de travail.

Pour configurer un nœud Feuille :

1. Cliquez sur + Ajouter un nœud. La boîte de dialogue Ajouter un nœud s'ouvre.

2. Sélectionnez Lire dans le panneau de gauche.

3. Sélectionnez Feuille dans le panneau de droite. Le nœud apparaît sur le canevas et le panneau de configuration s'ouvre.

4. Remplissez les champs requis dans le panneau de configuration :

   Paramètres	Description
   Nom	Identifiant unique. La valeur par défaut est Feuille_[n].
   Sous-type	Champ en lecture seule indiquant le type de données sélectionné.
   Source	Sélectionnez une feuille à l'aide du sélecteur intégré.
   Mise en forme	Configurez les sections Lignes, Colonnes et Filtres.
   v26.05:  Paramètres (Facultatif)	Configurez les nœuds Précédent et Suivant pour contrôler l'ordre d'exécution des nœuds. Voir Utilisation des paramètres de nœud pour plus de détails.

5. Sélectionnez Publier dans l'en-tête de niveau 2 pour enregistrer la configuration.

   Le système valide la configuration et affiche les données récupérées dans la grille de visualisation. Les données s'affichent en lecture seule, structurées selon la mise en forme configurée.

   Deux commandes supplémentaires sont disponibles dans l'en-tête de niveau 2 :

   • Actualiser : Relit les données source et permet de prévisualiser les modifications de mise en forme non publiées sans requérir une publication complète.

   • Mode Affichage/Éditer : Permet d'afficher ou de masquer le panneau de configuration tout en conservant la grille de données en lecture seule.

Note: Les nœuds Feuille sont le seul type de données en lecture à comporter une section Colonnes dans la mise en forme. La section Colonnes prend en charge les dimensions et les métriques.

v26.02:  Configuration d'un nœud Table de transactions

Les nœuds Table de transactions récupèrent des données à partir des tables de transactions du système.

Pour configurer un nœud Table de transactions :

1. Cliquez sur + Ajouter un nœud. La boîte de dialogue Ajouter un nœud s'ouvre.

2. Sélectionnez Lire dans le panneau de gauche.

3. Sélectionnez Table de transactions dans le panneau de droite. Le nœud apparaît sur le canevas et le panneau de configuration s'ouvre.

4. Remplissez les champs requis dans le panneau de configuration :

   Paramètres	Description
   Nom	Identifiant unique. La valeur par défaut est Table de transactions_[n].
   Source	Sélectionnez une table de transactions à l'aide du sélecteur intégré.
   Mise en forme	Configurez les sections Lignes et Filtres (il n'y a pas de section Colonnes).
   v26.05:  Paramètres (Facultatif)	Configurez les nœuds Précédent et Suivant pour contrôler l'ordre d'exécution des nœuds. Voir Utilisation des paramètres de nœud pour plus de détails.

5. Sélectionnez Publier dans l'en-tête de niveau 2 pour enregistrer la configuration.

   Le système valide la configuration et affiche les données récupérées dans la grille de visualisation. Les données s'affichent en lecture seule, structurées selon la mise en forme configurée.

   Après la publication, deux commandes supplémentaires sont disponibles dans l'en-tête de niveau 2 :

   • Actualiser : Relit les données source et permet de prévisualiser les modifications de mise en forme non publiées sans requérir une publication complète.

   • Mode Affichage/Éditer : Permet d'afficher ou de masquer le panneau de configuration tout en conservant la grille de données en lecture seule.