Introduction
Le nœud Set est votre outil principal pour remodeler les données qui circulent dans les flux de travail n8n. Contrairement aux nœuds qui récupèrent des données externes, Set se concentre entièrement sur la transformation de ce que vous avez déjà : ajouter de nouveaux champs, écraser les champs existants ou supprimer les champs dont vous n’avez pas besoin. Cela le rend essentiel pour préparer les charges utiles avant de les envoyer à des API, bases de données ou autres services.
Chaque élément dans n8n est un objet JSON. Le nœud Set vous permet de définir exactement quels champs chaque élément doit contenir et quelles valeurs ils doivent prendre. Vous pouvez coder des valeurs en dur, copier des données d’autres champs, ou utiliser des expressions pour calculer de nouvelles valeurs à partir des données en amont.
Opérations de champ de base
Le nœud Set fonctionne selon l’un des deux modes suivants : Keep Only Set (remplace l’élément entier par les seuls champs que vous définissez) ou Add/Overwrite (fusionne vos nouveaux champs avec l’élément existant). Pour la plupart des tâches de transformation, Add/Overwrite offre plus de flexibilité.
Pour ajouter un champ, cliquez sur Add Field et choisissez le type approprié : String, Number, Boolean, ou autres. Chaque champ nécessite un nom et une valeur. Le nom devient la clé JSON, et la valeur peut être du texte statique, un nombre ou une expression.
Remarquez que les champs d’origine restent. Si vous passez en mode Keep Only Set, la sortie contiendrait uniquement id, name et isActive.
Référence des données en amont avec des expressions
Les expressions permettent d accéder aux données des nœuds précédents. Le schéma le plus courant est {{$json.fieldName}}, qui lit un champ de l élément courant. Vous pouvez également utiliser JavaScript dans les expressions pour transformer les valeurs à la volée.
Vous pouvez référencer des champs issus d’autres nœuds en utilisant {{$node.NodeName.json.fieldName}}. Cela est utile lorsque vous devez combiner des données provenant de plusieurs sources ou comparer des valeurs à travers les étapes du workflow.
Suppression des champs indésirables
Parfois, il est nécessaire d’éliminer des champs sensibles ou inutiles avant d’envoyer les données en aval. En mode Keep Only Set, vous définissez simplement les champs que vous souhaitez conserver et tout le reste disparaît. En mode Add/Overwrite, la suppression de champs nécessite d’utiliser l’interrupteur Remove Other Fields ou de définir manuellement les champs sur null.
Cette approche est plus sûre que de tenter de supprimer les champs individuellement, surtout lorsque vous traitez des structures de données dynamiques où vous pourriez ne pas connaître tous les noms de champs à l’avance.
Schémas courants et pièges
Lors de la construction de transformations complexes, travaillez étape par étape. Ajoutez un ou deux champs, exécutez le nœud et vérifiez la sortie avant d’en ajouter davantage. Cela facilite le débogage bien plus que de configurer dix champs à la fois et de dépanner les erreurs.
Les erreurs d’expression sont courantes. Si une expression échoue à s’évaluer, n8n laisse généralement le champ vide ou affiche une pastille d’erreur. Vérifiez votre syntaxe: les expressions doivent être enveloppées dans des doubles accolades, et le code JavaScript à l’intérieur doit être valide. Utilisez le panneau Expression Editor pour tester les expressions avant de les valider.
Les incompatibilités de type peuvent causer des problèmes en aval. Si un champ attend un nombre mais reçoit une chaîne, convertissez-le explicitement à l’aide de Number ou parseInt dans votre expression. De même, utilisez String pour convertir les nombres en texte lorsque nécessaire.
Le nœud Set traite chaque élément indépendamment. Si vous avez 50 éléments qui entrent dans le nœud, chacun est transformé selon vos définitions de champ. Cela signifie que des expressions comme {{$json.fieldName}} se réfèrent toujours à l’élément courant traité, et non à l’ensemble du tableau.
Résumé
Le nœud Set est votre scalpel pour la transformation des données dans n8n. Utilisez le mode Add/Overwrite lorsque vous souhaitez enrichir les données existantes, et Keep Only Set lorsque vous avez besoin d’un tableau vierge avec uniquement des champs spécifiques. Les expressions vous permettent de référencer des données depuis n’importe où dans votre workflow et d’appliquer des transformations JavaScript en ligne. Maîtrisez le nœud Set et vous passerez moins de temps à lutter avec les formats de données et plus de temps à construire des flux de travail fonctionnels.
Point de contrôle de la leçon
Révisez la leçon et recevez des conseils sur votre travail.