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

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 seulement	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ù elles 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 mappage :

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.

v26.04: Configuration du code des données de base

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

Pour configurer un nœud de données de base :

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.
Sélectionnez Write dans le panneau de gauche.
Sélectionnez Master Data dans le panneau de droite. Le nœud apparaît dans le canevas et le panneau latéral de configuration s'ouvre.

Remplissez les champs requis à partir du panneau de configuration :

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 mappage	Mapper les colonnes de la source aux colonnes de la table cible.
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.

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

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

Configuration du nœud de feuille

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

Pour configurer un nœud de feuille :

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.
Sélectionnez Write dans le panneau de gauche.
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.