Transformer

Appliquez plusieurs opérations à une liste dans un seul nœud: la filtrer, reformuler chaque élément, regrouper les éléments ou exécuter votre propre JavaScript.

La transformation applique une chaîne d'opérations à une liste dans un nœud. Chaque opération reçoit le résultat de celle qui la précède, ce qui vous permet, par exemple, de ne conserver que les commandes ouvertes, de reformuler chacune, puis de les regrouper par client. Il se trouve dans la catégorie Données du panneau Ajouter un nœud .

Lorsque vous n'avez besoin que d'une seule opération, utilisez son propre nœud à la place: Filtrer, Mapper ou Regrouper par.

Configurer le nœud

1. Sélectionnez + sur le handle du nœud qu’il suit, puis sélectionnez Données > Transformer.

2. Dans le panneau Propriétés, sélectionnez Modifier la transformation.

3. Dans Collection, saisissez la liste à transformer, par exemple $vars.scriptTask1.output. Le champ attend un tableau.

4. Ajoutez les opérations, dans l'ordre dans lequel elles doivent s'exécuter:

   Opération (Operation)	Ce qu’il fait
   Ajouter un filtre	Renvoie uniquement les éléments qui correspondent aux conditions que vous avez définies.
   Ajouter une carte	Transforme chaque élément en une nouvelle forme, avec les mappages de champs que vous définissez.
   Ajouter un groupe par	Regroupe les éléments par un champ et calcule un nombre, une somme ou une moyenne pour chaque groupe.
   Ajouter un script personnalisé	Exécute votre propre logique de transformation en JavaScript.

5. Sélectionnez Exécuter pour tester le nœud et vérifiez le résultat dans la colonne Sortie .

Sortie

Le nœud renvoie le résultat de la dernière opération en tant que output. Les nœuds ultérieurs le lisent comme $vars.<nodeId>.output, par exemple $vars.transform1.output.

Transformer ou Script

Utilisez la fonction Transformer lorsque le travail filtre, reforme ou regroupe une liste. Utilisez Script lorsque la logique ne correspond pas à ces opérations. Dans la transformation, l'activité Ajouter un script personnalisé couvre une seule étape qui a besoin de code.

Problèmes couramment rencontrés

Problème	Résolution
La collection affiche une erreur	Ce champ est obligatoire et attend un tableau. Vérifiez la valeur dans la trace d'exécution du nœud qui la produit.
La sortie est vide après un filtre	Les conditions ne correspondent à aucun élément. Vérifiez les noms des champs et les valeurs de l'entrée dans la Trace d'exécution.
La sortie contient des champs undefined après une carte	Le champ Source n’existe pas dans les éléments d’entrée. Vérifiez la structure d’entrée dans le traçage de l’exécution.

Prochaines étapes

• Filtrer, Mapper et Regrouper par: une opération par nœud.
• Variables et flux de données: comment $vars fait référence au travail.
• Community (Communauté): posez des questions et partagez des workflows avec d'autres développeurs sur le forum UiPath.