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.
-
Remplissez les champs requis à partir du panneau de configuration :
Paramètre :
Description
Nom
Identifiant unique. Defaults to Sheet Write_[n].
Cible
Sélectionnez une feuille à 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.
Mise en page
Configurer les sections Lignes, Colonnes et Filtres.
Liste de mappage
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
Uniquement pour le mode écrasement. Configurer un membre fixe, une donnée source ou une variable contextuelle.
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.
(Facultatif) Sélectionnez Test pour valider la configuration sans engager de modifications, ou Aperçu pour visualiser la trame de données qui sera écrite.
Sélectionnez Publier dans l'en-tête de niveau 2 pour enregistrer la configuration.
Note: Le nœud de feuille est 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 sur l'ensemble du flux de travail.
v26.07: Configuration du nœud de table
Les nœuds de table enregistrent les données traitées dans les tables de transaction du système. Cela permet de couvrir l'ensemble des chemins d'écriture : les feuilles de calcul, les données de référence et les tables de transaction peuvent toutes servir de destinations d'écriture au sein d'un même workflow.
Pour configurer un nœud Table :
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 Écrire dans le panneau de gauche.
Sélectionnez Table dans le panneau de droite. Le nœud apparaît sur 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 Table_[n].
Cible
Sélectionnez une table de transactions à l'aide du sélecteur intégré (Cliquer pour sélectionner). La sélection d'une cible actualise la liste de mappage et met à jour les options de gestion des doublons.
Entrée
Sélectionnez un nœud en amont (Lecture, SQL ou Mappage) à l'aide du sélecteur intégré. Accepte une entrée. La modification de l'entrée entraîne la mise à jour des colonnes source dans la liste de mappage.
Liste de mappage
Mapper les colonnes source du nœud d'entrée aux dimensions et métriques cibles. Chaque ligne correspond à un champ cible ; sélectionnez le champ source, « Ignorer » (dimensions/indicateurs locaux uniquement) ou « Valeur fixe » dans le menu déroulant. Au moins un indicateur doit être associé à un champ source.
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 de nœud pour plus de détails.
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 une 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.
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 cette table et limite en conséquence les options disponibles pour la gestion des doublons. Si la cible autorise les doublons, seule l'option « Insérer tous les enregistrements » est disponible : tous les enregistrements de la source sont enregistrés 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 respecte toujours la politique de la table cible.
Exécution des écritures avec une visibilité totale
Lors de l'exécution, le nœud Table offre une transparence totale sur l'opération d'écriture. Un aperçu du résultat affiche les données transformées après application de la méthode de traitement des doublons, ce qui vous permet de vérifier le résultat avant de valider. Le journal d'audit enregistre le nom de la table de transactions, la méthode de gestion 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 permet de respecter les exigences de conformité et garantit la fiabilité des modifications apportées aux données.