首先完成“第5课:数据流并行与合并”即可解锁本课程。转到上一课

介绍

这是课程的收官课。你已经学习了如何使用 Code 节点、Set 节点、IF 节点、Merge 节点,以及如何用表达式对数据进行整形。现在你将把这些组件串联起来,形成一个真正可执行的单一工作流:从两个来源获取数据,清洗并筛选,转换为目标结构,合并流并输出一个可用于下游的最终结果。

本节所用的情景是实用且代表性强的生产环境:你从一个 HTTP 端点获取订单列表,从另一个端点获取客户名单。目标是生成一个丰富的订单报告,仅包含已付款的订单,附上客户姓名和邮箱,并对日期进行显示格式化。

展示六个顺序节点的端到端工作流图:HTTP Request(Orders)和 HTTP Request(Customers)并行输入,进入各自的筛选/转换节点,然后是 Merge 节点,再是用于最终整形的 Code 节点,最后输出节点输出最终结果。

并行从两个来源获取数据

从两个 HTTP Request 节点并行运行开始。两者都由相同的 Manual Trigger 或 Schedule Trigger 节点触发。第一个抓取订单,第二个抓取客户。在 n8n 中,通过将一个触发器连接到两个 HTTP Request 节点来实现并行执行。

对于订单端点,设置 URL 并确保响应格式为 JSON。原始响应通常如下所示:

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"}
]

对于客户端点:

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

两个节点输出项数组。n8n 会自动将数组分割为独立项目,因此每个订单和每个客户都会成为在工作流其余部分中流动的单独项。

对每个流进行筛选和转换

在合并之前,单独清洗每个流。这使逻辑保持隔离,便于调试。

对于订单,在订单 HTTP 请求之后连接一个 IF 节点。将条件设置为检查字段 status 是否等于字符串 paid。只有真分支继续。这会在订单到达合并之前就排除待处理、已取消或已退款的订单。

接下来,在 IF 真输出后连接一个 Code 节点以重新塑形订单项并格式化日期:

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
}
};
});

对于客户,在客户 HTTP 请求之后连接一个 Set 节点。用它显式仅保留需要的字段并重命名以提高清晰度。将 customer_key 设置为对 id 字段的表达式引用,保留 name 和 email。这能去除噪音,使合并键明确无误。

对比这两个并行转换分支的示意图:订单分支(IF 过滤 → Code 重塑)与客户分支(Set 节点清理),两者都输入到 Merge 节点

合并这两条流

将两个变换后的流都连接到 Merge 节点。使用 Merge by Key 模式。为输入 1(orders)设置键为 customer_id,为输入 2(customers)设置键为 customer_key。n8n 将把每个订单与其客户记录匹配,并输出包含两者字段的组合项。

合并后的项此时在顶层 item.json 包含 order_id、customer_id、amount、order_date、customer_key、name 和 email。可能还会有类似 customer_key 的冗余字段,只是为了连接而添加。请在下一步清理。

最终整理与输出

在 Merge 节点之后再添加一个 Code 节点。这是最终转换步骤,你需要向下游消费方承诺的输出契约:

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
}
};
});

该节点剥离内部连接键,将 amount 重命名为 amount_usd,以提高明确性,并生成一组整齐的增强订单记录。将其连接到你需要的最终节点:一个 HTTP 请求将结果 POST 到 webhook、一个 Google Sheets 节点追加行,或在开发阶段仅作为终端节点并在 n8n 编辑器中检查输出。

Summary

你已经构建了覆盖完整转换生命周期的工作流:来自两个 HTTP 来源的并行摄取、独立的 IF 过滤、通过 Code 与 Set 节点对每个流进行重塑、基于键的合并以及最终清理阶段。每个节点只有一个明确的职责,这使工作流可读且易于调试。当生产环境中出现问题时,你可以在任意节点处固定数据并从该点重新运行,而不需要修改上游节点。这种可组合的结构,而非单个节点,才是本课程一直在培养的核心技能。

课后练习

课程检查点

巩固所学知识,获取作业反馈。

0/1
已回答 · 0/1