v26.01: Utilisation des nœuds d'écriture

Les nœuds d'écriture enregistrent les données traitées provenant des nœuds en amont vers les destinations cibles, achevant ainsi le pipeline de traitement des données. Les nœuds d'écriture font office de nœuds terminaux dans les workflows, ce qui signifie qu'ils n'acceptent que des connexions d'entrée et ne peuvent pas fournir de sortie aux nœuds suivants.

Types de nœuds d'écriture disponibles

A noter : Les nœuds d'écriture n'acceptent que des connexions d'entrée et ne peuvent pas fournir de connexions de sortie vers d'autres nœuds. Ils fonctionnent comme des nœuds terminaux, marquant la fin des chemins de flux de données dans le workflow.

Mise en forme de la configuration

Les nœuds d'écriture nécessitent une configuration complète pour définir la destination de sortie, la structure des données, le mapping de la source et le comportement d'écriture.

Définition de la mise en forme v26.08: 

La mise en forme spécifie la structure des données de sortie avec des exigences spécifiques pour chaque section.

• Les lignes contiennent les dimensions qui s'affichent sous forme de colonnes de sortie.

• La section « Colonnes » est désormais réservée exclusivement aux Métriques ; aucune dimension ne peut y être ajoutée, et aucune Métrique ne peut en être retirée.

• La section « Filtres » contient les dimensions déplacées depuis la section « Lignes », chacune limitant l'écriture à un seul membre feuille ; les dimensions filtrées sont exclues à la fois de la table de Mapping et de la sortie.

A noter : La sélection des métriques est obligatoire, quel que soit leur emplacement dans la structure de la mise en forme (lignes, colonnes ou Filtres). Chaque métrique ne peut être utilisée que dans un seul nœud « Écriture » sur l'ensemble du workflow. Le système vérifie l'unicité des métriques et affiche une erreur si des doublons sont détectés.

Mapping du champ v26.08: 

La section « Mapping du champ » établit la correspondance entre les données d'entrée et la structure de sortie. L'interface affiche une vue à deux colonnes avec, à gauche, les champs source du nœud d'entrée et, à droite, les champs de sortie de la mise en forme de sortie.

Exigences de Mapping :

• Tous les champs de sortie doivent être mappés à des champs source.

• Les types de données source et de sortie doivent être compatibles.

• Le système empêche les mappages incompatibles (chaîne vers nombre, date vers chaîne, etc.).

• Lorsque la source comporte plus de colonnes que la sortie : le système agrège automatiquement les données.

• Lorsque la sortie comporte plus de colonnes que la source : l'utilisateur doit modifier la mise en forme pour déplacer les dimensions supplémentaires vers les filtres.

• Pour les feuilles cibles : les colonnes de la source doivent être uniques (aucun enregistrement en double ne nécessitant l'agrégation de champs non numériques).

Options du mode d'écriture

Le mode d'écriture détermine la manière dont le système traite les données existantes dans la destination cible.

v26.04: Configuration du nœud « Données permanentes »

Le nœud Données permanentes écrit les données directement dans les tables de données permanentes de l'espace de travail.

Pour configurer un nœud « Données permanentes » :

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 Écriture dans le panneau de gauche.

3. Sélectionnez Données permanentes 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 Données de référence_[n].
   Cible	Sélectionnez une table de données permanentes à l'aide du sélecteur intégré (A sélectionner).
   Entrée	Sélectionnez un nœud en amont (Lecture ou Transformation) à l'aide du sélecteur intégré.
   Liste de Mapping	Mettez en correspondance les colonnes source avec les colonnes de la table cible.
   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 des nœuds pour plus de détails.

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

A noter : Le nœud Données permanentes prend en charge les opérations d'insertion et d'actualisation, la synchronisation automatisée des données et la gestion des membres de dimension.

Configuration du nœud « Feuille »

Les nœuds Feuille enregistrent les données traitées dans des feuilles au sein de l'espace de travail.

Pour configurer un nœud Feuille :

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 Écriture 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 Sheet Write_[n].
   Cible	Sélectionnez une feuille à l'aide du sélecteur intégré (A sélectionner).
   Entrée	Sélectionnez un nœud en amont (Lecture ou Transformation) à l'aide du sélecteur intégré.
   Mise en page	Configurez les sections Lignes, Colonnes et Filtres.
   Liste de Mapping	Mettez en correspondance les champs cibles avec les champs sources.
   Option d'écriture	Sélectionnez Remplacer, Fusionner ou Ajouter. Détermine la manière dont le système traite les données existantes dans la cible.
   Définissez l'option « Remplacer » en fonction de	Pour le mode Remplacer uniquement. Configurez Membre fixe, Données source ou Variable de contexte.
   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 des nœuds pour plus de détails.

5. (Facultatif) Sélectionnez Test pour valider la configuration sans valider les modifications, ou Aperçu pour afficher le cadre de données qui sera écrit.

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

A noter : Le nœud Feuille est le seul type de données en écriture autorisé pour une utilisation en production. La sélection d'une métrique est obligatoire dans la structure de mise en forme. Chaque métrique ne peut être utilisée que dans un seul nœud d'écriture sur l'ensemble du workflow.

v26.07: Configuration du nœud « Table »

Les nœuds de table écrivent les données traitées dans les tables de transaction du système. Cela permet de couvrir l'intégralité du chemin d'écriture : les feuilles, les données permanentes et les tables de transaction peuvent toutes servir de destinations d'écriture au sein d'un même workflow.

Pour configurer un nœud « Tableau » :

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 Écriture dans le panneau de gauche.

3. Sélectionnez Table 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. Le nom par défaut est Table_[n].
   Table cible	Sélectionnez une table de transaction à l'aide du sélecteur intégré (A sélectionner). La sélection d'une table cible remplit automatiquement les champs « Mapping » et « Gestion des doublons ».
   Entrée	Sélectionnez un nœud en amont (Lecture, SQL ou Mapping) à l'aide du sélecteur intégré. Accepte une entrée. La modification de l'entrée actualise les colonnes source dans le Mapping.
   Mapping	Mettez en correspondance les colonnes source du nœud d'entrée avec les dimensions et Métriques cibles. Chaque ligne affiche un champ cible ; sélectionnez un champ source, Ignorer (dimensions et Métriques locales uniquement) ou Valeur fixe dans le menu déroulant. Au moins une métrique doit être mappée à un champ source.
   Gestion des enregistrements en double	Sélectionnez la stratégie de gestion des doublons. Les options dépendent de la politique de la table cible en matière de doublons.
   v26.08:  Option d'écriture	Sélectionnez Remplacer, Fusionner ou Ajouter. Détermine la manière dont le système traite les données existantes dans la cible.
   v26.08:  Définissez l'option « Remplacer » en fonction de	Pour le mode Remplacer uniquement. Sélectionnez les dimensions dans la liste d'actualisation ; utilisez l'icône Filtre sur n'importe quelle dimension globale pour limiter le remplacement à des membres spécifiques.
   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 de détails, 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 nœud Table prend en charge les opérations d'écriture dans la table avec gestion automatique des doublons et journalisation complète des audits. La traçabilité des données et les détails des transactions au niveau des lignes sont enregistrés pour chaque opération d'écriture.

A noter : v26.08: La disponibilité de l'option d'écriture dépend de la politique de duplication de la table cible. L'écrasement est toujours disponible et constitue la valeur par défaut. La fusion n'est disponible que lorsque les doublons sont désactivés. L'ajout est disponible lorsque les doublons sont activés.

Gestion intelligente des doublons

Lorsque vous sélectionnez une table cible, le nœud Table détecte automatiquement la politique de gestion des doublons de la cible et limite les options de gestion des doublons disponibles en conséquence. Si la table cible autorise les doublons, seule l'option « Insérer tous les enregistrements » est disponible : tous les enregistrements source sont écrits en tant que nouveaux enregistrements. Si la cible désactive les doublons, le nœud ne propose que les méthodes valides : Conserver la dernière valeur (par défaut), Agréger tous les enregistrements ou Rejeter les enregistrements en double. Cette détection intelligente évite les incohérences de configuration et garantit que la méthode d'écriture est toujours conforme à la politique de la table cible.

Exécution de l'écriture avec une visibilité totale

Pendant l'exécution, le nœud Tableau offre une transparence totale sur l'opération d'écriture. Un aperçu de la sortie affiche les données transformées après application de la méthode de gestion des doublons, ce qui vous permet de vérifier le résultat avant la validation. Le journal d'audit enregistre le nom de la table de transaction, la méthode de traitement des doublons utilisée et le nombre de lignes pour chaque chemin (écrites/ignorées/agrégées/rejetées), ce qui vous permet de vérifier l'intégrité des données et de dépanner les opérations d'écriture. Cette visibilité détaillée sur l'exécution répond aux exigences de conformité et garantit la fiabilité des modifications apportées aux données.

v26.08: Mode de réécriture pour les tables de transaction

Les tables de transaction autorisent par conception les lignes en double. Lorsqu'un workflow est exécuté de manière répétée, le nœud Write Transaction Table sans mode Overwrite accumule des enregistrements en double à chaque exécution. Le mode « Écraser » empêche cela en effaçant la tranche de données correspondant à la clé de dimension spécifiée avant d'écrire les nouvelles données, ce qui rend le workflow idempotent : des exécutions répétées produisent des résultats identiques sans accumulation de lignes.

La clé de remplacement est définie par les dimensions sélectionnées dans la section « Définir le remplacement en fonction de » :

• Une dimension globale cochée limite la tranche effacée à ses membres sélectionnés. Si aucun membre n'est sélectionné, tous les membres sont inclus.

• Une dimension locale cochée est résolue pour tous les membres et ne restreint pas la tranche.

• Les dimensions ne figurant pas dans la clé sont traitées comme des caractères génériques : tous leurs membres présents dans la tranche sont réécrits.

Au moins une dimension globale doit être incluse dans la clé de remplacement. Si la clé est vide ou ne contient que des dimensions locales, la publication est bloquée avec l'avertissement « Dimension globale requise pour le remplacement ».