简介
Set 节点是你在 n8n 工作流中重新塑形数据的主要工具。与从外部获取数据的节点不同,Set 完全专注于转换你已经拥有的数据:添加新字段、覆盖现有字段,或删除不需要的字段。这使它在将有效载荷发送给 API、数据库或其他服务之前的准备阶段变得至关重要。
n8n 中的每个项都是一个 JSON 对象。Set 节点让你精确定义每个项应包含的字段以及它们应拥有的值。你可以将值设为硬编码、从其他字段复制数据,或使用表达式基于上游数据计算新值。
基础字段操作
Set 节点有两种工作模式:Keep Only Set(仅用你定义的字段替换整個项)或 Add/Overwrite(将新字段合并到现有项中)。对于大多数转换任务,Add/Overwrite 提供更大的灵活性。
要添加字段,点击 Add Field 并选择合适的类型:String、Number、Boolean,或其他类型。每个字段需要一个名称和一个值。名称成为 JSON 键,值可以是静态文本、数字,或表达式。
请注意,原始字段仍然存在。如果你切换到 Keep Only Set 模式,输出将仅包含 id、name 和 isActive。
使用表达式引用上游数据
表达式是你从前一个节点访问数据的方式。最常见的模式是{{$json.fieldName}},它从当前项中读取一个字段。你也可以在表达式中使用JavaScript来即时转换数值。
你可以使用{{$node.NodeName.json.fieldName}}引用来自其他节点的字段。当你需要从多个来源组合数据或在工作流步骤之间比较值时,这很有用。
移除不需要的字段
有时在下游发送数据前,你需要剥离敏感或不必要的字段。在“仅保留设定”模式下,你只需定义要保留的字段,其它字段一并消失。在“添加/覆盖”模式下,移除字段需要使用“移除其他字段”切换或手动将字段设为null。
这种方法比逐个删除字段更安全,尤其是在处理动态数据结构时,你可能事先并不知道所有字段名。
常见模式与注意事项
在构建复杂转换时,逐步进行。先添加一两个字段,执行节点并验证输出,然后再添加更多。这比一次性配置十个字段并排查错误要容易得多。
表达式错误很常见。如果表达式无法求值,n8n通常会将字段留为空值或显示错误徽标。再次检查你的语法:表达式必须用双大括号包裹,里面的JavaScript代码必须有效。使用表达式编辑器面板在提交前测试表达式。
类型不匹配可能导致下游问题。如果一个字段期望数字但接收到字符串,请在表达式中使用Number或parseInt进行显式转换。需要时也使用String将数字转换为文本。
Set节点对每个项独立处理。如果你有50个项进入节点,每个项都会按你的字段定义进行变换。这意味着类似{{$json.fieldName}}的表达式始终引用当前正在被处理的项,而不是整个数组。
小结
Set节点是你在n8n中进行数据转换的解剖刀。当你想要增强现有数据时使用“添加/覆盖”模式;需要用一个干净的起点只保留特定字段时使用“仅保留设定”。表达式让你在工作流中引用任意位置的数据并内联应用JavaScript转换。掌握Set节点,你将减少在数据格式上的斗争,更多时间用来构建可用的工作流。
课程检查点
巩固所学知识,获取作业反馈。