Transformation des données

Opérations de transformation de données pour le filtrage, la mise en correspondance et le regroupement de collections.

Transforme les données à l'aide d'une variété d'opérations. Le nœud Transformation des données et ses nœuds d'opération individuels (Filtrer, Mettre en correspondance, Regrouper par) sont disponibles en tant que nœuds sélectionnables distincts dans la palette de nœuds.

Quand utiliser la transformation de données vs Script

Utilisez les opérations de transformation des données lorsque la transformation est une opération au niveau du champ sur une collection. Les opérations disponibles couvrent :

• Filtrage
• Mappage
• Regroupement

Utilisez Script lorsque la transformation nécessite une manipulation logique conditionnelle, arithmétique ou de chaîne, ou lorsqu'aucune opération dédiée ne couvre le cas. Les deux peuvent être combinés : une opération de transformation des données peut filtrer ou remodeler une collection, puis transmettre le résultat à un nœud Script.

Sortie

Tous les nœuds d'opération Transformation des données fournissent leur sortie en tant que output, accessible en aval comme $vars.<nodeName>.output.

Filtrer (Filter)

Conserve uniquement les entrées d'une collection qui correspondent à vos conditions.

Configuration

Champ	Requis	Description
Entrée	Oui (Yes)	La collection (tableau) à filtrer. Référencé en tant que $vars.<nodeName>.output.
Conditions	Oui (Yes)	Une ou plusieurs conditions. Une entrée est conservée uniquement si toutes les conditions sont remplies.

Exemple

Conservez uniquement les commandes avec un status de "completed" :

• Entrée : $vars.fetchOrders1.output.body
• Condition : status égale à completed

Sortie disponible sous forme de $vars.filter1.output.

Carte

Transforme chaque entrée dans une collection en modifiant ou en remodelant ses champs.

Configuration

Champ	Requis	Description
Entrée	Oui (Yes)	La collection (tableau) à transformer.
Mappage des champs	Oui (Yes)	Pour chaque champ cible, définissez le nom et le champ ou l'expression source.

Exemple

Renommez les champs firstName et lastName en first et last :

Champ cible	Mise en correspondance de la source
first	firstName
last	lastName

Sortie disponible sous forme de $vars.map1.output.

Regrouper par

Regroupe une collection par un champ partagé et agrège des valeurs telles que les totaux, les moyennes ou les comptes.

Configuration

Champ	Requis	Description
Entrée	Oui (Yes)	La collection (tableau) à regrouper.
Regrouper par champ	Oui (Yes)	Le champ dont la valeur détermine le groupe.
Agrégations	Non (No)	Champs calculés supplémentaires par groupe (nombre, somme, moyenne, min, max, premier, dernier, collecter).

Exemple

Regroupez une liste de commandes par region et comptez le nombre de commandes par région :

• Entrée : $vars.fetchOrders1.output.body
• Regrouper par : region
• Agrégation : orderCount = nombre

Sortie disponible sous forme de $vars.groupBy1.output.

Problèmes couramment rencontrés

Problème	Résolution
La sortie est vide après Filtrer	Les conditions ne correspondent à aucune entrée. Inspectez la collection d'entrée dans la trace d'exécution pour vérifier les noms de champs et les valeurs.
La sortie Mettre en correspondance possède des champs undefined	Le chemin du champ source n'existe pas dans les entrées. Utilisez la trace d'exécution pour confirmer la structure d'entrée.