Terminez d'abord "Leçon 5 : Fusionner et combiner des flux de données" pour débloquer cette leçon.Aller à la leçon précédente

Introduction

Ceci est la leçon capstone du cours. Vous avez appris à utiliser le nœud Code, le nœud Set, le nœud IF, le nœud Merge et la manière de façonner les données avec des expressions. Maintenant, vous allez assembler toutes ces pièces en un seul flux de travail qui fait quelque chose de réel : extraire des données de deux sources, les nettoyer et les filtrer, les transformer en une forme cible, fusionner les flux et produire une sortie finale prête pour une utilisation ultérieure.

Le scénario utilisé tout au long de cette leçon est pratique et représentatif de ce que vous rencontrerez en production : vous disposez d’une liste de commandes provenant d’un endpoint HTTP et d’une liste de clients provenant d’un autre. L’objectif est de produire un rapport de commandes enrichi qui ne contient que les commandes payées, joindre le nom et l’e-mail du client, et formater les dates pour l’affichage.

diagramme de flux de travail de bout en bout montrant 6 nœuds en séquence : requête HTTP (Commandes) et requête HTTP (Clients) en parallèle, alimentant des nœuds de filtrage/transformations séparés, puis un nœud Merge, puis un nœud Code pour le façonnage final, puis un nœud de sortie final

Récupération des données à partir de deux sources en parallèle

Commencez avec deux nœuds HTTP Request fonctionnant en parallèle. Les deux sont déclenchés par le même déclencheur manuel (Manual Trigger) ou par un déclencheur programmé (Schedule Trigger). Le premier récupère les commandes, le second récupère les clients. Dans n8n, vous divisez l’exécution en connectant un déclencheur à ces deux nœuds HTTP Request.

Pour l’endpoint des commandes, définissez l’URL et assurez-vous que le format de la réponse est JSON. La réponse brute se présente généralement ainsi :

json
[
{"id": 101, "customer_id": 5, "status": "paid", "amount": 149.99, "created_at": "2024-03-15T10:22:00Z"},
{"id": 102, "customer_id": 8, "status": "pending", "amount": 89.00, "created_at": "2024-03-16T08:05:00Z"}
]

Pour l’endpoint des clients :

json
[
{"id": 5, "name": "Alice Martin", "email": "alice@example.com"},
{"id": 8, "name": "Bob Chen", "email": "bob@example.com"}
]

Les deux nœuds produisent des tableaux d’éléments. n8n répartit automatiquement les tableaux en éléments individuels, de sorte que chaque commande et chaque client devient son propre élément qui circule dans le reste du flux de travail.

Filtrage et transformation de chaque flux

Avant la fusion, nettoyez chaque flux indépendamment. Cela garde la logique isolée et plus facile à déboguer.

Pour les commandes, connectez un nœud IF après la requête HTTP des commandes. Définissez la condition pour vérifier que le champ status est égal à la chaîne paid. Seule la branche vraie continue. Cela élimine les commandes en attente, annulées ou remboursées avant même d'atteindre la fusion.

Ensuite, connectez un nœud Code après la sortie true de l'IF pour remodeler l’élément de commande et formater la date :

javascript
const items = $input.all();
return items.map(item => {
const d = new Date(item.json.created_at);
const formatted = d.toLocaleDateString('en-GB', { day: '2-digit', month: 'short', year: 'numeric' });
return {
json: {
order_id: item.json.id,
customer_id: item.json.customer_id,
amount: item.json.amount,
order_date: formatted
}
};
});

Pour les clients, connectez un nœud Set après la requête HTTP des clients. Utilisez-le pour ne conserver explicitement que les champs dont vous avez besoin et les renommer pour plus de clarté. Définissez customer_key sur l’expression faisant référence au champ id, conservez name et email. Cela réduit le bruit et rend la clé de fusion non ambiguë.

diagramme comparant les deux branches de transformation parallèles : Branche commandes (filtrage IF → remodelage Code) et Branche clients (nettoyage par nœud Set), les deux alimentant un nœud Merge

Fusion des deux flux

Connectez les deux flux transformés dans un nœud Merge. Utilisez le mode Merge by Key. Définissez la clé pour l’entrée 1 (commandes) sur customer_id et la clé pour l’entrée 2 (clients) sur customer_key. n8n associera chaque commande à son enregistrement client et produira un élément combiner contenant les champs des deux.

L’élément fusionné à ce stade contient order_id, customer_id, amount, order_date, customer_key, name, et email tous au même niveau de item.json. Il peut y avoir des champs redondants comme customer_key que vous avez ajoutés uniquement pour la jointure. Supprimez-les à l’étape suivante.

Final Shaping and Output

Ajoutez un nœud Code de plus après le nœud Merge. C’est l’étape de transformation finale où vous produisez le contrat de sortie exact que vous aviez promis aux consommateurs en aval :

javascript
const items = $input.all();
return items.map(item => {
return {
json: {
order_id: item.json.order_id,
order_date: item.json.order_date,
amount_usd: item.json.amount,
customer_name: item.json.name,
customer_email: item.json.email
}
};
});

Ce nœud supprime les clés internes de jointure, renomme amount en amount_usd pour plus de clarté, et produit un tableau propre d’enregistrements de commandes enrichies. Reliez-le à ce que vous besoin comme nœud final : une requête HTTP pour POST les résultats vers un webhook, un nœud Google Sheets pour ajouter des lignes, ou laissez-le simplement comme nœud terminal pendant le développement et inspectez la sortie dans l’éditeur n8n.

Résumé

Vous avez construit un workflow qui couvre l'intégralité du cycle de transformation : ingestion parallèle depuis deux sources HTTP, filtrage indépendant avec IF, remodelage par flux avec des nœuds Code et Set, une fusion par clé, et une passe de nettoyage finale. Chaque nœud a une responsabilité unique et claire, ce qui rend le workflow lisible et débogable. Lorsqu quelque chose se casse en production, vous pouvez épingler les données à n'importe quel nœud et relancer à partir de ce point sans toucher les nœuds en amont. Cette structure modulaire, et non pas un nœud individuel, est la compétence clé sur laquelle ce cours vise à vous faire progresser.

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