v26.01: Travailler avec le nœud de lecture

Les nœuds de lecture récupèrent des données à partir de divers systèmes sources et les mettent à la disposition des nœuds situés en aval dans le flux de travail. La catégorie Lecture propose différents types de nœuds, chacun 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 mise en page détermine les dimensions et les mesures à inclure et la manière de les organiser dans le résultat.

Le schéma se compose de trois sections qui définissent ensemble la structure des données.

Chaque dimension affiche des contrôles : Icône de filtre (sélecteur de membres), Menu Ellipse (options de déplacement/suppression), Préférences (rangées uniquement) et Développer/Réduire.

v26.03: Mettre à jour la liste :

Lorsque des dimensions sont supprimées d'une section de la mise en page, elles sont automatiquement transférées dans la liste des mises à jour. La liste des mises à jour contient toutes les dimensions de la source qui ne sont pas visibles dans les sections de mise en page.

Pour restaurer les dimensions, sélectionnez Mettre à jour la liste > vérifier les dimensions > sélectionner OK.

Note: Chaque dimension de la source doit apparaître soit dans les sections de présentation, soit dans la liste de mise à jour à tout moment. 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 de téléchargement de fichiers fournit une source de données basée sur les fichiers pour les flux de travail. Les concepteurs de flux de travail configurent le nœud au moment de la conception avec un type de fichier autorisé et un échantillon de fichier pour la prévisualisation ; les utilisateurs fournissent le fichier réel au moment de l'exécution par le biais de la boîte de dialogue Exécuter. Le nœud transmet une référence de fichier à un nœud de lecteur de fichiers en aval - il ne produit pas lui-même de tableau.

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

4. Remplissez les champs requis à partir du panneau de configuration :

   Paramètre :	Description
   Nom	Identifiant unique. La valeur par défaut est File Upload_[n].
   Types de fichiers autorisés	Liste déroulante avec CSV présélectionné. La prise en charge de plusieurs feuilles Excel est prévue pour une prochaine version.
   Exemple de fichier	Sélectionnez Choisir un fichier pour ouvrir le sélecteur de fichiers du système d'exploitation et sélectionner un fichier représentatif. Le nom du fichier apparaît à côté du bouton (tronqué par une ellipse s'il est trop long) ; avant qu'un fichier ne soit sélectionné, le champ indique Aucun fichier choisi. Le fichier d'exemple persiste lors de la publication ou de la réouverture, il est partagé avec tous les utilisateurs du flux de travail (il n'est pas limité à l'utilisateur) et n'est jamais ajouté à l'historique des fichiers précédemment téléchargés.
   v26.05: Paramètres (facultatif)	Configurer les nœuds précédents et suivants pour contrôler l'ordre d'exécution des nœuds. Pour plus de détails, voir Travailler avec les paramètres des nœuds.

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

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

   • Actualiser Relecture des données sources et prévisualisation des modifications de mise en page non publiées sans qu'il soit nécessaire de procéder à une publication complète.

   • Mode de visualisation/édition : Permet d'afficher ou non le panneau de configuration tout en conservant la grille de données en lecture seule.

Fichier échantillon vs. Fichier d'exécution

Le fichier d'exemple n'est utilisé que pour la prévisualisation au moment de la conception - il permet de configurer le nœud File Reader en aval par rapport à une structure de fichier représentative. Au moment de l'exécution, les utilisateurs fournissent le fichier réel par l'intermédiaire de la boîte de dialogue Exécuter (voir v26.01: Travailler avec le nœud de lecture). Le fichier d'exécution peut avoir un contenu différent de celui du fichier d'exemple.

Fichiers précédemment téléchargés

Après l'exécution d'un flux de travail avec un nœud de téléchargement de fichiers, le fichier d'exécution apparaît dans une section Fichiers précédemment téléchargés sur le nœud, limitée à l'utilisateur connecté. Les fichiers sont classés dans l'ordre chronologique inverse avec l'horodatage et l'icône de déclenchement. Le fichier échantillon n'est jamais ajouté à cette liste.

Nœuds de téléchargement de fichiers multiples

Un flux de travail peut contenir plusieurs nœuds File Upload. Chacun est indépendant - son nom, le type de fichier autorisé, le fichier d'exemple et l'historique du téléchargement sont tous à l'échelle du 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 de téléchargement de fichiers contiennent un fichier valide.

Gestion de l'historique des téléchargements et des fichiers en cours d'exécution

Au moment 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 de téléchargement de fichiers, avec des contrôles pour Choisir le fichier, Encodage et Délimiteur. Le bouton Exécuter reste désactivé jusqu'à ce que chaque nœud de téléchargement de fichiers contienne un fichier valide. Une section Fichiers précédemment téléchargés, limitée à l'utilisateur connecté, répertorie les téléchargements antérieurs dans l'ordre chronologique inverse à des fins d'audit.

v26.05: Configuration du nœud de lecture de fichiers

Le nœud File Reader analyse un fichier reçu d'un nœud File Upload en un ensemble de données tabulaires pour une consommation en aval.

Prérequis :

Un nœud File Upload doit déjà exister dans le flux de travail. Le lecteur de fichiers ne peut pas être configuré sans un téléchargement de fichiers en amont.

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

4. Remplissez les champs requis à partir du panneau de configuration :

   Paramètre :	Description
   Nom	Identifiant unique. La valeur par défaut est File Reader_[n].
   Source	Sélectionnez un nœud de téléchargement de fichiers existant dans la liste déroulante. La liste déroulante répertorie tous les nœuds de téléchargement de fichiers dans le flux de travail et se met à jour dynamiquement lorsque des nœuds sont ajoutés, supprimés ou renommés.
   Cellule de départ	Référence de la cellule définissant la ligne d'en-tête et la colonne la plus à gauche (par exemple, A1 ou B3 [MG2.1]). La ligne de la cellule de départ est considérée comme l'en-tête ; les lignes inférieures sont des données. La colonne Cellule de départ est la colonne la plus à gauche incluse dans la lecture.
   Sélection des colonnes	Choisissez Toutes les colonnes (par défaut) pour inclure toutes les colonnes à partir de la colonne Cellule de départ, ou Colonnes spécifiques pour ouvrir une liste de contrôle des noms d'en-tête avec les références de position (Colonne A, B, C...) et sélectionner les colonnes à inclure.
   v26.05: Paramètres (facultatif)	Configurer les nœuds précédents et suivants pour contrôler l'ordre d'exécution des nœuds. Pour plus de détails, voir Travailler avec les paramètres des nœuds.

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 le canevas. Les données apparaissent en lecture seule et sont structurées selon la présentation configurée.

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

   • Actualiser Relecture des données sources et prévisualisation des modifications de mise en page non publiées sans qu'il soit nécessaire de procéder à une publication complète.

   • Mode de visualisation/édition : Permet d'afficher ou non le panneau de configuration tout en conservant la grille de données en lecture seule [MG3.1].

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

Toutes les correspondances en aval sont basées sur la position de la colonne (colonne A, B, C...), et non sur le nom de l'en-tête. Si le fichier d'exécution a un texte d'en-tête différent de celui du fichier d'exemple (par exemple, "Account" renommé en "ACC"), la correspondance reste intacte car elle suit la position des colonnes. Les fichiers dont l'en-tête est vide ou manquant sont toujours lisibles par le biais de la même référence de position.

Sortie

La sortie du lecteur de fichiers est un ensemble de données tabulaires plates (lignes × colonnes sélectionnées). Toutes les valeurs sont lues comme du texte. Les nœuds en aval (Mapping, SQL, Write) gèrent toute conversion de type.

Conditions de défaillance

Le nœud échoue au moment de l'exécution si

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

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

• La ligne de la cellule de départ dépasse le nombre de lignes du fichier.

• Le nœud File Upload connecté a été supprimé.

Nœuds de lecture de fichiers multiples

Un nœud de téléchargement de fichiers peut alimenter plusieurs nœuds de lecture de fichiers indépendants, chacun ayant sa propre configuration de cellule de départ et de sélection de colonne. Si le nœud File Upload est supprimé, tous les nœuds File Reader connectés deviennent invalides jusqu'à ce qu'une nouvelle source File Upload soit sélectionnée.

v26.02: Configuration du nœud de tableau distant

Les nœuds de table distante intègrent des données externes provenant de connexions de table distante dans les flux de travail.

Pour configurer un nœud de table distante :

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

4. Remplissez les champs requis à partir du panneau de configuration :

   Paramètre :	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 du tableau distant sélectionné sont automatiquement ajoutées aux lignes.
   Mise en page	Configurer les sections Lignes et Filtres (pas de section Colonnes ).
   v26.05: Paramètres (facultatif)	Configurer les nœuds précédents et suivants pour contrôler l'ordre d'exécution des nœuds. Pour plus de détails, voir Travailler avec les paramètres des nœuds.

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 le canevas. Les données apparaissent en lecture seule et sont structurées selon la présentation configurée.

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

   • Actualiser Relecture des données sources et prévisualisation des modifications de mise en page non publiées sans qu'il soit nécessaire de procéder à une publication complète.

   • Mode de visualisation/édition : Permet d'afficher ou non 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 aux lignes lors de la sélection de la source. Les dimensions des tables distantes n'ont pas de relations hiérarchiques. Les nœuds de lecture de tableau à distance prennent en charge les références de paramètres de flux de travail pour le filtrage dynamique des données.

Configuration du nœud de feuille

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

Pour configurer un nœud de feuille :

1. Cliquez sur + Add Node (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 dans le canevas et le panneau latéral de configuration s'ouvre.

4. Remplissez les champs requis à partir du panneau de configuration :

   Paramètre :	Description
   Nom	Identifiant unique. La valeur 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 en ligne.
   Mise en page	Configurer les sections Lignes, Colonnes et Filtres.
   v26.05:  Paramètres (facultatif)	Configurer les nœuds précédents et suivants pour contrôler l'ordre d'exécution des nœuds. Pour plus de détails, voir Travailler avec les paramètres des nœuds.

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 le canevas. Les données apparaissent en lecture seule et sont structurées selon la présentation configurée.

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

   • Actualiser Relecture des données sources et prévisualisation des modifications de mise en page non publiées sans qu'il soit nécessaire de procéder à une publication complète.

   • Mode de visualisation/édition : Permet d'afficher ou non le panneau de configuration tout en conservant la grille de données en lecture seule.

Note: Les nœuds de feuille sont le seul type de données Read avec une section Columns dans la mise en page. La section Colonnes prend en charge les dimensions et les métriques.

v26.02:  Configuration du nœud du tableau des transactions

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

Pour configurer un nœud de table de transactions :

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

4. Remplissez les champs requis à partir du panneau de configuration :

   Paramètre :	Description
   Nom	Identifiant unique. La valeur par défaut est Transaction Table_[n].
   Source	Sélectionnez un tableau de transactions à l'aide du sélecteur en ligne.
   Mise en page	Configurer les sections Lignes et Filtres (pas de section Colonnes ).
   v26.05:  Paramètres (facultatif)	Configurer les nœuds précédents et suivants pour contrôler l'ordre d'exécution des nœuds. Pour plus de détails, voir Travailler avec les paramètres des nœuds.

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 le canevas. Les données apparaissent en lecture seule et sont structurées selon la présentation configurée.

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

   • Actualiser Relecture des données sources et prévisualisation des modifications de mise en page non publiées sans qu'il soit nécessaire de procéder à une publication complète.

   • Mode de visualisation/édition : Permet d'afficher ou non le panneau de configuration tout en conservant la grille de données en lecture seule.