v26.01: Travailler avec Write Node

Les nœuds d'écriture enregistrent les données traitées par les nœuds en amont vers les destinations cibles, complétant ainsi le pipeline de traitement des données. Les nœuds d'écriture fonctionnent comme des nœuds terminaux dans les flux de travail, 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

Type de données	Description
Feuille	Écriture de données sur des feuilles, y compris des feuilles standard et des feuilles à sections multiples
v26.04: Master Data	Écriture dans les entités de données de base telles que les hiérarchies et les données de référence
Table	Écriture de données dans des tables au sein du système
Table à distance	Écriture de données dans des tables distantes de systèmes externes
Journal	Enregistrer des écritures de journal pour les données transactionnelles

Configuration du nœud d'écriture

Pour ajouter et configurer un nœud d'écriture :

Sélectionner + Ajouter un nœud. La boîte de dialogue Ajouter un nœud s'ouvre.
Sélectionnez Write > sélectionnez le type de données requis. Le nœud apparaît dans le canevas et le volet latéral s'ouvre.
Saisissez le nom unique.
Sélectionnez la cible à l'aide du sélecteur en ligne.
Configurer la définition de la mise en page et le mappage des champs.
Sélectionnez le mode d'écriture (Écraser, Fusionner ou Ajouter).
(Facultatif) Sélectionnez Test pour valider la configuration sans valider les modifications, ou Aperçu pour visualiser la trame de données qui sera écrite.
Sélectionnez Publier pour enregistrer la configuration.

Le système valide l'unicité de la métrique dans tous les nœuds d'écriture du flux de travail. Prévisualisez les données d'écriture dans la section Sortie d'exécution.

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

Schéma de 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 mappage de la source et le comportement d'écriture.

Définition de la mise en page

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

Section	Éléments autorisés	Sélection des membres	Objectif
Lignes	Dimensions ou métriques	Dynamique ou fixe	Éléments apparaissant sous forme de lignes dans la structure de sortie.
Colonnes	Dimensions ou métriques	Membres fixes de la feuille uniquement (multi-sélection activée)	Éléments apparaissant sous forme de colonnes dans la structure de sortie. La relation doit être "Membre actuel".
Filtres	Dimensions uniquement	Membres à feuilles fixes uniquement	Définit l'intersection fixe pour l'enregistrement des données sans affichage en sortie.

Note: La sélection des métriques est obligatoire, quel que soit l'endroit où les métriques apparaissent dans la structure de la mise en page (lignes, colonnes ou filtres). Chaque mesure ne peut être utilisée que dans un seul nœud d'écriture dans l'ensemble du flux de travail. Le système valide l'unicité de la métrique et affiche une erreur si des doublons sont détectés.

Mapping des champs :

La section Correspondance des champs é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 cible de la présentation de sortie.

Exigences en matière de cartographie :

Tous les champs cibles doivent être mis en correspondance avec les champs sources.
Les types de données source et cible doivent être compatibles.
Le système empêche les correspondances incompatibles (chaîne de caractères vers nombre, date vers chaîne de caractères, etc.)
Lorsque la source a plus de colonnes que la cible : Le système agrège automatiquement les données.
Lorsque la cible a plus de colonnes que la source : L'utilisateur doit modifier la mise en page pour déplacer les dimensions supplémentaires vers les filtres.
Pour les cibles en feuilles : Les colonnes sources doivent être uniques (pas d'enregistrements en double 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.

Mode écriture	Comportement	Cas d'usage
Overwrite	Efface les données existantes en fonction des critères spécifiés avant d'écrire de nouvelles données. Nécessite la configuration de l'en-tête d'effacement pour spécifier les données à effacer.	Actualisation complète des données lorsque les valeurs précédentes doivent être remplacées.
Fusionner	Met à jour les enregistrements existants lorsque les combinaisons de dimensions correspondent exactement. Insère de nouveaux enregistrements lorsqu'il n'existe pas de correspondance. Fonctionne de manière identique au comportement de fusion du téléchargement de fichiers.	Mises à jour incrémentales : certains enregistrements sont mis à jour et de nouveaux enregistrements sont ajoutés.
Ajouter	Ajoute des enregistrements sans effacer les données existantes. Principalement applicable aux cibles de table (opérations basées sur la file d'attente). Non pertinent pour les cibles de feuilles.	Ajout de nouveaux enregistrements à des données existantes sans modification.

Configuration du mode d'écrasement

Lorsque le mode écrasement est sélectionné, configurez l'en-tête d'effacement pour spécifier les données à effacer :

Option	Description
Membre fixe :	Efface les données d'un membre spécifique uniquement.
Source des données	Utilise les valeurs des données d'entrée pour déterminer ce qu'il faut effacer.
Variable de contexte	Utilise les valeurs du contexte du flux de travail pour déterminer ce qu'il faut effacer.

Feuille Nœud d'écriture

Les nœuds d'écriture de feuilles enregistrent les données traitées dans les feuilles de l'espace de travail.

Paramètre :	Description
Nom	Identifiant unique. La valeur par défaut est l'écriture sur feuille.
Cible	Sélectionnez une feuille à l'aide du sélecteur en ligne ("Cliquez pour sélectionner").
Mise en page	Configurer les sections Lignes, Colonnes et Filtres.
Entrée	Sélectionnez un nœud en amont (lecture ou transformation) à l'aide du sélecteur en ligne.
Liste de cartographie	Mettez en correspondance les champs cibles et les champs sources.
Option d'écriture	Sélectionnez Écraser, Fusionner ou Ajouter. Détermine la manière dont le système traite les données existantes dans la cible.
Définir l'écrasement en fonction de	Pour le mode d'écrasement, configurez : Membre fixe, données source ou variable contextuelle.
Paramètres > Nœuds précédents	Sélectionner les nœuds qui doivent être exécutés avant ce nœud.
Paramètres > Nœuds suivants	Affiche les nœuds qui s'exécutent après ce nœud (en lecture seule).

L'écriture sur feuille est actuellement le seul type de données d'écriture activé pour la production. La sélection de la métrique est obligatoire dans la structure de présentation. Chaque mesure ne peut être utilisée que dans un seul nœud d'écriture dans l'ensemble du flux de travail.

v26.04: Nœud d'écriture des données de base

Le nœud d'écriture des données de base écrit les données directement dans les tables de données de base de l'espace de travail.

Paramètre :	Description
Nom	Identifiant unique. La valeur par défaut est Master Data_[n].
Cible	Sélectionnez une table de données de base à l'aide du sélecteur en ligne ("Cliquez pour sélectionner").
Entrée	Sélectionnez un nœud en amont (lecture ou transformation) à l'aide du sélecteur en ligne.
Liste de cartographie	Mapper les colonnes de la source aux colonnes de la table cible.
Paramètres > Nœuds précédents	Sélectionner les nœuds qui doivent être exécutés avant ce nœud.
Paramètres > Nœuds suivants	Affiche les nœuds qui s'exécutent après ce nœud (en lecture seule).

Le nœud d'écriture des données de base prend en charge les opérations d'insertion et de mise à jour. Ce nœud prend en charge la synchronisation automatisée des données et la gestion des membres de la dimension.