v26.03: Utilisation des nœuds de transformation

Les nœuds de transformation (anciennement appelés « nœuds de calcul ») transforment les données provenant des nœuds en amont à l'aide de diverses méthodes.

Types de données disponibles

v26.03: Mapping Node

Le nœud de Mapping transforme les données en appliquant des tables de correspondance prédéfinies aux jeux de données d'entrée.

Pour configurer un nœud de Mapping :

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

3. Sélectionnez Mapping dans le panneau de droite. Le nœud apparaît sur le canevas et le panneau latéral 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 Mapping_[n].
   Entrée	Sélectionnez un nœud en amont Read ou SQL Script.
   Étapes	Sélectionnez + Ajouter une étape pour créer des mappages. Chaque étape requiert les éléments suivants : Nom de l'étape (identifiant) Table de correspondance (la table de correspondance prédéfinie à appliquer) Mapping du champ source (les champs source à mapper)
   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 de nœud pour plus de détails.

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

   Après avoir publié, les commandes suivantes deviennent disponibles dans l'en-tête de niveau 2 :

   • Actualiser : Recharge la grille pour prendre en compte les modifications.

   • Exécuter : Exécute la requête lorsqu'elle est valide.

Accédez à l'onglet Résultats d'exécution pour prévisualiser les données de la Table de correspondance. L'onglet Résultats d'exécution affiche également un aperçu de la simulation des données en temps réel : les lignes mappées affichent la valeur mappée, les lignes ayant échoué affichent N/A, et les lignes non mappées sont vides lorsque l'option Échec en cas de source non mappée n'est pas activée.

v26.04: Les utilisateurs peuvent réorganiser, modifier et supprimer des étapes via le menu des points de suspension. La gestion des éléments non mappés hérite du paramètre Fail on Unmapped Source de la Table de correspondance sélectionnée.

v26.03: SQL Script Node

Le nœud SQL Script offre des capacités de transformation des données basées sur le langage SQL.

Pour configurer un nœud SQL Script :

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

3. Sélectionnez SQL Script dans le panneau de droite. Le nœud apparaît sur le canevas et le panneau latéral 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 SQL Script_[n].
   Entrée	Sélectionnez + Ajouter pour choisir les nœuds en amont. Plusieurs saisies sont prises en charge.
   Requête	Saisissez la logique SQL. Sélectionnez Développer pour ouvrir la Vue avancée et la modifier.
   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 de nœud pour plus de détails.

5. (Facultatif) Sélectionnez Valider pour vérifier la syntaxe avant de publier.

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

   Note: Les nœuds peuvent être publiés avec des requêtes non valides — une icône d'avertissement s'affiche dans ce cas.

   Après avoir publié, des commandes supplémentaires deviennent disponibles dans l'en-tête de niveau 2 :

   • Actualiser : Recharge la grille pour prendre en compte les modifications.

   • Exécuter : Exécute la requête lorsqu'elle est valide.

La cellule Requête prend en charge les éléments suivants :

• Syntaxe de requête — {{node_name}} et ${dimension_description} avec des exemples.

• Opérations SQL prises en charge — SELECT, JOIN, WHERE, GROUP BY, ORDER BY, fonctions.

• Informations de validation — Sélectionnez Valider pour vérifier la syntaxe avant de publier.

Note: Les nœuds peuvent être publiés avec des requêtes non valides (une icône d'avertissement s'affiche).

v26.02: La requête est validée lors de la publication ou de l'actualisation. Le système affiche une icône d'avertissement lorsque des requêtes SQL accèdent à des composants non autorisés.

v26.04: Syntaxe de la requête : Utilisez {{node_name}} pour les nœuds de saisie, {{node_name}}.DIM_NAME pour les dimensions.

v26.08: Validation des saisies et sécurité

Les requêtes SQL ne peuvent désormais faire référence qu'aux tables explicitement ajoutées en tant que nœuds de saisie (via des nœuds Read, des données de référence ou les Preferences).

Les identifiants ou noms directs des tables du backend sont bloqués tant au moment d'enregistrer qu'au moment de l'exécution.

Cela comble une faille permettant aux workflows de contourner les contrôles d'accès aux données au niveau de l'espace de travail, garantissant ainsi que tous les nœuds SQL Script respectent les politiques de sécurité au niveau de l'espace de travail.

v26.09: Normalisation de la syntaxe SQL

Le nœud SQL Script utilise désormais une syntaxe normalisée pour référencer les nœuds, les colonnes et les Paramètres. Cela remplace les anciennes formes {{node_name}} et ${Node Name}.

Références aux nœuds et aux colonnes

Les colonnes sont référencées au format 'node_id'.'column_id', l'ID du nœud et l'ID de la colonne étant tous deux placés entre guillemets simples.

• Une référence doit toujours inclure à la fois l'ID du nœud et l'ID de la colonne, séparés par un point. Une requête utilisant un nom de colonne nu, sans référence à un nœud, est rejetée avec un message d’erreur clair.

• Un ID de nœud ou de colonne entre guillemets simples qui ne correspond à aucun nœud de saisie déclaré ni à l'une de ses colonnes est rejeté avec une erreur claire identifiant l'identifiant inconnu.

• Les guillemets simples et doubles ne sont pas mélangés.

La syntaxe normalisée s’applique de manière cohérente à la rédaction des requêtes, à l’affichage de la structure de saisie/sortie et à l’aperçu des données. L’affichage de la structure indique le format ID (description), tandis que la requête utilise 'node_id'.'column_id'.

Références aux paramètres

Tous les paramètres sont référencés au format $'parameter_name'. L’ancienne forme ${Node Name} n’est plus utilisée ni indiquée nulle part.

Cela s’applique à tous les paramètres du panneau Available Parameters, y compris les paramètres système (Date d’exécution, Période d’exécution, Utilisateur d’exécution) et les paramètres définis par l’utilisateur.

Comportement de l’éditeur

• Cliquer sur un paramètre dans le panneau Available Parameters l'insère à la position du curseur sous la forme $'parameter_name', plutôt que de le copier dans le presse-papiers.

• Lorsque vous tapez entre des guillemets simples, l’éditeur suggère des ID de nœuds de saisie correspondants. Après 'node_id'., il suggère les ID de colonnes de ce nœud, issus uniquement des nœuds de saisie déclarés du nœud SQL. La sélection d’une suggestion insère la référence complète 'node_id'.'column_id'.

Impact sur les workflows existants

Les workflows existants ne sont pas mis à jour automatiquement. Les requêtes SQL existantes écrites selon l’ancienne syntaxe — utilisant {{node_name}}.column_name ou ${Node Name} — ne s’exécuteront pas tant qu’elles n’auront pas subi une actualisation selon la nouvelle syntaxe. Tous les nœuds dont la requête ne peut plus être résolue sont signalés comme invalides.

A noter : Les nœuds existants conservent leurs noms et ID actuels. Aucune table n’est recréée et aucun ID n’est modifié par cette actualisation.