Transformation des données

Opérations de transformation de données pour le filtrage, le mappage et le regroupement des collections.

Transforme les données à l'aide de diverses opérations. Le nœud Transformation de données et ses nœuds d'opération individuels (Filtre, Carte, Regrouper par) sont disponibles sous forme de nœuds sélectionnables distincts dans la palette des nœuds.

Quand utiliser la transformation de données vs Script

Utilisez les opérations de transformation de 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 logique conditionnelle, une arithmétique ou une manipulation de string, ou lorsqu'aucune opération dédiée ne couvre le cas. Les deux peuvent être combinés: une opération de transformation de données peut filtrer ou façonner une collection, puis transmettre le résultat à un nœud de script.

Sortie

Tous les nœuds d’opération de transformation de données génèrent leur résultat sous la forme output, accessible en aval sous la forme $vars.<nodeName>.output.

Filtrer (Filter)

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

Configuration

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

Exemple

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

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

Sortie disponible en tant que $vars.filter1.output.

Carte

Transforme chaque entrée dans une collection en modifiant ou en reformant 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	Mappage source
first	firstName
last	lastName

Sortie disponible en tant que $vars.map1.output.

Regrouper par

Regroupe une collection par un champ partagé et agrège les 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, collecte).

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 en tant que $vars.groupBy1.output.

Problèmes couramment rencontrés

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