Terminez d'abord "Leçon 1 : Comment n8n Structure les données — éléments, JSON et le modèle d’exécution" pour débloquer cette leçon.Aller à la leçon précédente

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.

javascript
// Example: Transforming API response items
// Input item from HTTP Request node:
{
"user_id": 42,
"full_name": "Alice Smith",
"created_at": "2024-01-15T10:30:00Z"
}
// Set node configuration (Add/Overwrite mode):
// Field 1: id (Number) = {{$json.user_id}}
// Field 2: name (String) = {{$json.full_name}}
// Field 3: isActive (Boolean) = true
// Output item:
{
"user_id": 42,
"full_name": "Alice Smith",
"created_at": "2024-01-15T10:30:00Z",
"id": 42,
"name": "Alice Smith",
"isActive": true
}

Remarquez que les champs d’origine restent. Si vous passez en mode Keep Only Set, la sortie contiendrait uniquement id, name et isActive.

flowchart montrant le mode Add/Overwrite fusionnant de nouveaux champs dans l’élément existant versus le mode Keep Only Set remplaçant l’élément entier

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.

javascript
// Input item:
{
"email": "alice@example.com",
"score": 85
}
// Set node fields using expressions:
// Field 1: username (String) = {{$json.email.split('@')[0]}}
// Field 2: domain (String) = {{$json.email.split('@')[1]}}
// Field 3: passed (Boolean) = {{$json.score >= 70}}
// Field 4: grade (String) = {{$json.score >= 90 ? 'A' : $json.score >= 70 ? 'B' : 'C'}}
// Output item:
{
"email": "alice@example.com",
"score": 85,
"username": "alice",
"domain": "example.com",
"passed": true,
"grade": "B"
}

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.

javascript
// Example: Combining data from two nodes
// Webhook node output: {"orderId": "ORD-123"}
// HTTP Request node output: {"status": "shipped", "trackingCode": "TRK-456"}
// Set node fields:
// Field 1: order (String) = {{$node.Webhook.json.orderId}}
// Field 2: status (String) = {{$json.status}}
// Field 3: tracking (String) = {{$json.trackingCode}}
// Output:
{
"order": "ORD-123",
"status": "shipped",
"tracking": "TRK-456"
}

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.

javascript
// Input item with sensitive data:
{
"userId": 42,
"email": "alice@example.com",
"password_hash": "$2b$10$abcd...",
"internal_notes": "VIP customer",
"created_at": "2024-01-15T10:30:00Z"
}
// Set node in Keep Only Set mode:
// Field 1: userId (Number) = {{$json.userId}}
// Field 2: email (String) = {{$json.email}}
// Output (password and notes removed):
{
"userId": 42,
"email": "alice@example.com"
}

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.

javascript
// Type conversion examples:
// Field 1: age (Number) = {{Number($json.age_string)}}
// Field 2: id (String) = {{String($json.numeric_id)}}
// Field 3: price (Number) = {{parseFloat($json.price_with_currency.replace('$', ''))}}

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.

Entraînement

Point de contrôle de la leçon

Révisez la leçon et recevez des conseils sur votre travail.

0/1
Répondu · 0/1