Terminez d'abord "Leçon 4 : Transformations personnalisées avec le nœud Code" pour débloquer cette leçon.Aller à la leçon précédente

Introduction

Dans les workflows d’automatisation réels, les données ne circulent que rarement sur une seule ligne droite. Vous pourriez récupérer des dossiers clients depuis un CRM dans une branche, extraire leurs commandes récentes via une API dans une autre branche, puis devoir réunir ces deux flux en objets unifiés avant de les transmettre en aval. C’est exactement le rôle du nœud Merge.

Le nœud Merge accepte deux branches d’entrée distinctes — appelées Entrée 1 et Entrée 2 — et combine leurs éléments selon une stratégie que vous choisissez. Choisir à tort le mode de fusion est l’une des sources les plus courantes de bugs de données silencieux dans n8n, où les éléments semblent se combiner mais le résultat ne correspond pas à ce que vous attendiez. Comprendre la différence entre les modes dès le départ évite beaucoup de débogage par la suite.

Diagramme de flux montrant deux branches parallèles (Entrée 1 et Entrée 2) convergeant vers un seul nœud Merge, puis se dirigeant vers un flux de sortie unique

Les quatre modes de fusion

Le nœud Merge de N8n propose quatre modes : Append, Combine by Position, Combine by Key et Multiplex. Chacun répond à une question différente sur la façon dont les éléments des deux branches doivent être reliés entre eux.

Append concatène simplement les deux listes. Chaque élément de l’Entrée 1 vient en premier, puis chaque élément de l’Entrée 2. Aucune mise en correspondance n’a lieu. Utilisez ceci lorsque vous voulez une liste unique et plate et que les deux branches sont indépendantes — par exemple, fusionner deux listes distinctes d’adresses e-mail pour envoyer une campagne.

Combine by Position (anciennement appelé Merge by Index) associe les éléments selon leur ordre dans la liste. L’élément 0 de l’Entrée 1 se fusionne avec l’élément 0 de l’Entrée 2, l’élément 1 avec l’élément 1, et ainsi de suite. Les champs des deux éléments sont fusionnés en un seul objet. Si les listes n’ont pas la même longueur, la liste la plus courte détermine automatiquement le nombre de sorties.

Combine by Key fait correspondre les éléments des deux branches en utilisant une valeur de champ commune — similaire à un JOIN SQL sur une colonne. Vous spécifiez un champ clé dans chaque entrée (ils peuvent avoir des noms de champ différents), et n8n trouve les paires dont les valeurs correspondent.

Multiplex produit toutes les combinaisons possibles d’articles à partir de l’Entrée 1 et de l’Entrée 2 — un produit cartésien. Si l’Entrée 1 contient 3 articles et l’Entrée 2 en contient 4, Multiplex produit 12 articles. C’est rarement ce que vous souhaitez, mais utile pour générer des combinaisons telles que l’appariement de chaque produit avec chaque niveau de remise.

Diagramme de comparaison montrant 4 modes de fusion côte à côte : Append (deux listes empilées), Combine by Position (articles appariés par index), Combine by Key (articles appariés par champ commun), Multiplex (grille de toutes les combinaisons)

Exemple pratique : Combine by Key

Supposons que votre nœud HTTP Request renvoie des profils clients dans une branche :

json
[
{ "customerId": "C001", "name": "Alice" },
{ "customerId": "C002", "name": "Bob" }
]

Et qu’un deuxième HTTP Request renvoie les totaux des commandes dans une autre branche :

json
[
{ "id": "C002", "totalSpent": 340 },
{ "id": "C001", "totalSpent": 120 }
]

Les éléments sont dans des ordres différents et utilisent des noms de champs différents pour le même identifiant client. Dans le nœud Merge paramétré sur Combine by Key, vous configurez le champ clé Input 1 comme customerId et le champ clé Input 2 comme id. N8n fera correspondre C001 à C001 et C002 à C002 quel que soit l’ordre, produisant :

json
[
{ "customerId": "C001", "name": "Alice", "id": "C001", "totalSpent": 120 },
{ "customerId": "C002", "name": "Bob", "id": "C002", "totalSpent": 340 }
]

Les éléments d’Input 1 qui n’ont pas de correspondance dans Input 2 sont supprimés par défaut. Vous pouvez modifier ce comportement dans l’option Output Type, en choisissant de conserver les éléments non appariés d’Input 1, d’Input 2, ou des deux — équivalent à les jointures LEFT, RIGHT ou FULL OUTER en SQL.

Exemple Combine by Position

Combine by Position est le choix à privilégier lorsque vous savez que les deux branches produiront toujours le même nombre d’éléments et dans le même ordre. Un cas typique est de découper une liste, d’enrichir chaque élément via deux API différentes en parallèle, puis de réassembler les résultats enrichis.

json
[
{ "userId": 1, "email": "alice@example.com" }
]

Si Input 1 contient l’enregistrement utilisateur de base et Input 2 contient un score provenant d’un service de scoring :

json
[
{ "score": 87 }
]

Combine by Position les fusionne par index en :

json
[
{ "userId": 1, "email": "alice@example.com", "score": 87 }
]

Si vous exécutez cela sur une liste de 50 utilisateurs répartis sur les deux branches, les 50 éléments se fusionnent sans problème tant que l’ordre est préservé — ce qui est généralement le cas lorsque les deux branches démarrent à partir du même Split in Batches ou SplitOut node.

Erreurs courantes

La faute la plus fréquente est d’utiliser Combine by Position lorsque les deux branches traitent les éléments à des vitesses différentes ou appliquent un filtrage, ce qui fait que les listes se désynchronisent. La fusion associera silencieusement les mauvais éléments. S’il existe une quelconque chance que l’ordre puisse différer, utilisez Combine by Key à la place.

Un autre problème est d’actionner le nœud Merge avant que les deux branches aient terminé leur exécution. Dans n8n, le nœud Merge attend automatiquement l’arrivée des deux entrées avant de traiter, mais cela ne fonctionne correctement que lorsque les deux branches proviennent du même nœud en amont. Si vous connectez des chemins de déclenchement sans relation dans un nœud Merge en attendant une synchronisation, le comportement est indéfini et produit souvent des exécutions en double.

Enfin, méfiez-vous des collisions de noms de champs. Lorsqu’input 1 et input 2 partagent le même nom de champ et que vous les combinez, la valeur provenant de l’Input 2 écrase par défaut celle de l’Input 1. Renommez les champs conflictuels en amont avec un nœud Set avant la fusion si vous devez conserver les deux valeurs.

Résumé

Le nœud Merge est l’épine dorsale des flux de travail multi-branche dans n8n. Append empile les listes, Combine by Position associe des éléments par ordre, Combine by Key joint les éléments par une valeur de champ commune, et Multiplex génère toutes les combinaisons. La décision clé est toujours de savoir si vos deux flux de données entretiennent une relation structurelle — s’ils en ont une, utilisez Combine by Key pour la fiabilité ; s’ils sont garantis d’être ordonnés et de longueur égale, Combine by Position est plus simple. Bien choisir ce mode évite toute une catégorie de bugs d’intégrité des données subtils.

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