v26.01:  Utilisation des nœuds de lecture

Les nœuds de lecture extraient des données de divers systèmes sources et les mettent à la disposition des nœuds en aval dans le flux de travail. 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

Schéma de configuration

La section « Configuration de la présentation » permet de déterminer les dimensions et les indicateurs à inclure, ainsi que la manière de les organiser dans le résultat final.

La structure se compose de trois sections qui, ensemble, définissent la structure des données.

Chaque dimension affiche des commandes : Icône de filtrage (sélecteur d'éléments), 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 cotes sont supprimées d'une section de mise en page, elles sont automatiquement déplacées vers la liste de mise à jour. La liste de mise à jour répertorie toutes les dimensions de la source qui ne sont pas actuellement visibles dans les sections de mise en page.

Pour rétablir les cotes, sélectionnez « Mettre à jour la liste » > cochez les cotes > cliquez sur « OK ».

Note: {b}Remarque : {/b}Toutes les dimensions issues de la source doivent figurer à tout moment soit dans les sections « Mise en page », soit dans la « Liste de mise à jour ». Cela garantit une définition complète de la structure des données.

v26.05:  Configuration du nœud de téléchargement de fichiers

Le nœud « Téléchargement de fichier » fournit une source de données sous forme de fichiers pour les workflows. Les concepteurs de flux de travail 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 au moment de l'exécution via la boîte de dialogue « Exécuter ». Ce nœud transmet une référence de fichier à un nœud « File Reader » situé en aval ; il ne génère pas lui-même de sortie sous forme de tableau.

v26.07:  La fonctionnalité de téléchargement de fichiers prend désormais en charge les fichiers CSV et Excel, ce qui élimine les processus de conversion de format. Les utilisateurs n'ont plus besoin de convertir leurs fichiers Excel au format CSV avant de les importer.

Pour configurer un nœud « Téléchargement de 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 « Téléchargement de fichier » dans le panneau de droite. Le nœud apparaît sur le canevas et le panneau latéral de configuration s'ouvre.

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

   Paramètres	Description
   Nom	Identifiant unique. Par défaut : File Upload_[n].
   v26.07:  Types de fichiers autorisés	Menu déroulant avec les options « CSV » et « Excel » présélectionnées. Prend en charge les fichiers Excel comportant une seule feuille ou plusieurs feuilles.
   Fichier d'exemple	Sélectionnez « Choisir un fichier » pour ouvrir la fenêtre de sélection de fichiers du système d'exploitation et sélectionnez un fichier représentatif. Le nom du fichier apparaît à côté du bouton (tronqué et suivi de 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é après la publication ou la réouverture, est partagé avec tous les utilisateurs du workflow (et non au niveau de l'utilisateur) et n'est jamais ajouté à l'historique des fichiers précédemment téléchargés.
   v26.05: 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. Pour plus d'informations, consultez la section « Utilisation des paramètres de nœud ».

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

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

   • Actualiser Permet de relire les données sources et de prévisualiser les modifications de mise en page non publiées sans avoir à effectuer une publication complète.

   • Mode Affichage/Modification: Permet d'activer ou de désactiver l'affichage du 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 « Téléchargement de fichiers » accepte aussi bien les fichiers CSV que les fichiers Excel.

• Les fichiers CSV comprennent les fichiers standard dont les valeurs sont séparées par des virgules, les fichiers délimités par des tabulations et les fichiers avec des délimiteurs personnalisés (qui peuvent être configurés lors de l'exécution à l'aide des commandes « Encoding » et « Delimiter »).

• Les fichiers Excel comprennent des classeurs Excel à une seule feuille et à plusieurs feuilles (.xlsx).

• Lors de l'importation d'un fichier Excel comportant plusieurs feuilles, le nœud « File Reader » 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 « File Reader » en aval en fonction d'une structure de fichier représentative. Au moment de l'exécution, les utilisateurs fournissent le fichier concerné via la boîte de dialogue « Exécuter » (voir Exécution de workflows avec des nœuds de téléchargement de fichiers). Le contenu du fichier d'exécution peut différer 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 au format CSV et le fichier d'exécution au format Excel), à condition que leur structure soit compatible avec la configuration du lecteur de fichiers.

Fichiers déjà téléchargés

Une fois qu'un workflow comportant un nœud « Téléchargement de fichier » a été exécuté, le fichier d'exécution apparaît dans la section « Fichiers précédemment téléchargés » de ce nœud, accessible uniquement à l'utilisateur connecté. Les fichiers sont classé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 téléchargement de plusieurs fichiers

Un workflow peut contenir plusieurs nœuds « Téléchargement de fichiers ». Chacun d'entre eux est indépendant : son nom, les types de fichiers autorisés, le fichier d'exemple et l'historique des télé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 « Téléchargement de fichier » contiennent un fichier valide.

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

Lors de l'exécution, la boîte de dialogue « Exécuter » affiche une section dédiée aux « Téléchargements de fichiers » pour chaque nœud « Téléchargement de fichiers », avec des commandes permettant de « Choisir un fichier », de définir l'« Encodage » et de sélectionner le « Délimiteur ». Le bouton « Exécuter » reste désactivé tant que tous les nœuds « Téléchargement de fichier » ne contiennent pas un fichier valide. La section « Fichiers précédemment téléchargés », réservée à l'utilisateur connecté, répertorie les téléchargements effectués lors de l'exécution dans l'ordre chronologique inverse à des fins d'audit.

v26.07:  Lors du téléchargement de fichiers Excel, un menu déroulant « Sélection de la feuille » s'affiche si le fichier contient plusieurs feuilles, permettant ainsi aux utilisateurs de choisir la feuille à lire.

v26.05:  Configuration du nœud « File Reader »

Le nœud « File Reader » analyse un fichier reçu d'un nœud « File Upload » pour le convertir en un ensemble de données sous forme de tableau, destiné à être utilisé en aval.

v26.07:  Avec la version 26.07, File Reader prend désormais en charge une configuration distincte pour la position des en-têtes et celle des données, ce qui permet de contrôler avec précision l'emplacement de début des en-têtes et des données dans les fichiers Excel et CSV.

Prérequis :

Un nœud « Téléchargement de fichier » doit déjà exister dans le flux de travail. Le lecteur de fichiers ne peut pas être configuré sans un module de téléchargement de fichiers en amont servant de source.

Pour configurer un nœud « File Reader » :

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 « File Reader » dans le panneau de droite. Le nœud apparaît sur le canevas et le panneau latéral de configuration s'ouvre.

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

   Paramètres	Description
   Nom	Identifiant unique. Le nom par défaut est « File Reader_[n] ».
   Source	Sélectionnez un nœud « Téléchargement de fichier » existant dans la liste déroulante. La liste déroulante répertorie tous les nœuds « Téléchargement de fichier » du flux de travail et s'actualise 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 correspondant à la cellule de début d'en-tête est considérée comme l'en-tête ; la détection des colonnes commence à partir de la colonne indiqué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.
   Cellule de début des données v26.07:	Référence de cellule indiquant le début de 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 mises en page flexibles avec des métadonnées ou plusieurs lignes d'en-tête.
   Sélection des colonnes	Sélectionnez « Toutes les colonnes » (par défaut) pour inclure toutes les colonnes à partir de la colonne « Cellule de départ », ou « Colonnes spécifiques » pour afficher une liste des noms d'en-têtes ainsi que leurs références de position (colonne A, B, C…) et sélectionnez les colonnes à inclure.
   v26.05: 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. Pour plus d'informations, consultez la section « Utilisation des paramètres de nœud ».

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

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

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

   • Actualiser Permet de relire les données sources et de prévisualiser les modifications de mise en page non publiées sans avoir à effectuer une publication complète.

   • Mode Affichage/Modification: Permet d'activer ou de désactiver l'affichage du panneau de configuration tout en conservant la grille de données en lecture seule. [MG3.1]

v26.07:  Contrôle indépendant de l'en-tête et de la position 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 l'un de l'autre, ce qui vous permet de gérer des fichiers présentant des mises en page non standard :

• Scénario 1 Fichier contenant 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épart 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épart des données : A3 (les données commencent après la deuxième ligne d'en-tête, à partir de la ligne 3)

• Scénario 3 Fichier comportant des colonnes de tête à ignorer

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

  • Cellule de départ 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 la position de l'en-tête ou de la cellule de début des données, ce qui garantit que les mappages en aval restent synchronisés avec la nouvelle mise en page.

Position de la colonne par rapport au nom de l'en-tête

Tout le mappage en aval repose sur la position des colonnes (colonnes A, B, C…), et non sur le nom des en-têtes. Si le texte d'en-tête du fichier d'exécution diffère de celui du fichier d'exemple (par exemple, si « Account » a été renommé « ACC »), le mappage reste inchangé car il suit la position des colonnes. Les fichiers dont l'en-tête est vide ou manquant restent lisibles via la même référence positionnelle.

Sortie

La sortie du « File Reader » 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, Write) gèrent toutes les conversions de types.

Conditions de défaillance

Le nœud génère une erreur lors de l'exécution si :

• Le fichier téléchargé ne correspond pas à la configuration du téléchargement de fichiers (par exemple, délimiteur incorrect).

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

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

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

• Le nœud « File Upload » associé a été supprimé.

Plusieurs nœuds « File Reader »

Un nœud « File Upload » peut alimenter plusieurs nœuds « File Reader » indépendants, chacun disposant de ses propres paramètres de configuration : « Header Start Cell », « Data Start Cell » et « Column Selection ». Si le nœud « File Upload » est supprimé, tous les nœuds « File Reader » qui y sont connectés deviennent invalides jusqu’à ce qu’une nouvelle source « File Upload » soit sélectionnée.

v26.02:  Configuration d'un nœud de table distant

Les nœuds « Table à distance » intègrent des données externes provenant de connexions à des tables distantes dans les pipelines de workflow.

Pour configurer un nœud « Remote Table » :

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 « Table à distance » dans le panneau de droite. Le nœud apparaît sur le canevas et le panneau latéral de configuration s'ouvre.

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

   Paramètres	Description
   Nom	Identifiant unique. La valeur par défaut est « Remote Table_[n] ».
   Source	Sélectionnez une table distante à l'aide du sélecteur en ligne. Toutes les dimensions de la table distante sélectionnée sont automatiquement ajoutées à la section « Lignes ».
   Mise en page	Configurer les sections « Lignes » et « Filtres » (il n'y a pas de section « Colonnes »).
   v26.05: 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. Pour plus d'informations, consultez la section « Utilisation des paramètres de nœud ».

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

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

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

   • Actualiser Permet de relire les données sources et de prévisualiser les modifications de mise en page non publiées sans avoir à effectuer une publication complète.

   • Mode Affichage/Modification: Permet d'activer ou de désactiver l'affichage du 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 à la colonne « Lignes » lors de la sélection de la source. Les dimensions des tables distantes ne présentent pas de relations hiérarchiques. Les nœuds de lecture de table à distance 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 de feuille récupèrent des données provenant des feuilles de l'espace de travail.

Pour configurer un nœud « Sheet » :

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 latéral de configuration s'ouvre.

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

   Paramètres	Description
   Nom	Identifiant unique. Le nom par défaut est Sheet_[n].
   Subtype	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 page	Configurer 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. Pour plus d'informations, consultez la section « Utilisation des paramètres de nœud ».

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

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

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

   • Actualiser Permet de relire les données sources et de prévisualiser les modifications de mise en page non publiées sans avoir à effectuer une publication complète.

   • Mode Affichage/Modification: Permet d'activer ou de désactiver l'affichage du panneau de configuration tout en conservant la grille de données en lecture seule.

Note: {b}Remarque : {/b}Les nœuds « Feuille » sont les seuls types de données « Lecture » à comporter une section « Colonnes » dans la mise en page. La section « Colonnes » prend en charge les dimensions et les indicateurs.

v26.02:  Configuration du nœud de 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 « Transaction Table » :

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 des transactions » dans le panneau de droite. Le nœud apparaît sur le canevas et le panneau latéral de configuration s'ouvre.

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

   Paramètres	Description
   Nom	Identifiant unique. La valeur par défaut est la table de transaction Table_[n].
   Source	Sélectionnez une table de transactions à l'aide du sélecteur intégré.
   Mise en page	Configurer 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. Pour plus d'informations, consultez la section « Utilisation des paramètres de nœud ».

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

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

   Une fois la publication effectuée, deux commandes supplémentaires apparaissent dans l'en-tête de niveau 2 :

   • Actualiser Permet de relire les données sources et de prévisualiser les modifications de mise en page non publiées sans avoir à effectuer une publication complète.

   • Mode Affichage/Modification: Permet d'activer ou de désactiver l'affichage du panneau de configuration tout en conservant la grille de données en lecture seule.