n8n 如何构造数据
了解 n8n 如何在节点之间构建和传递数据是构建工作流程的基础。本指南涵盖了数据结构格式以及数据如何在工作流程中流动。
数据结构
在 n8n 中,节点之间传递的所有数据都是对象数组。它具有以下结构:
[
{
// 对于大多数数据:
// 将每个项目包装在另一个对象中,键为 'json'
"json": {
// 示例数据
"apple": "beets",
"carrot": {
"dill": 1
}
},
// 对于二进制数据:
// 将每个项目包装在另一个对象中,键为 'binary'
"binary": {
// 示例数据
"apple-picture": {
"data": "....", // Base64 编码的二进制数据(必需)
"mimeType": "image/png", // 如果可能的话最好设置(可选)
"fileExtension": "png", // 如果可能的话最好设置(可选)
"fileName": "example.png", // 如果可能的话最好设置(可选)
}
}
},
]
提示
Skipping the json key and array syntax 跳过 json 键和数组语法
从 0.166.0 开始,当使用 Function 节点或 Code 节点时,n8n 会自动添加 json 密钥(如果缺失)。如果需要,它还会自动将您的项目包装在数组 ([]) 中。仅当使用“函数”或“代码”节点时才会出现这种情况。在构建自己的节点时,您仍然必须确保节点使用 json 密钥返回数据。
数据如何在节点 内流动
当您连接工作流中的节点时,数据会自动从一个节点传递到下一个节点。
节点自动处理多个项目。当节点接收到一组数据项时,它会单独处理每个数据项并为每个数据项执行配置的操作。
例如,如果您将 Trello 节点设置为 Create-Card,并使用传入数据中名为 name-input-value 的属性创建一个设置 Name 的表达式,则该节点会为每个项目创建一个卡片,并始终选择当前项目的 name-input-value。
例如,此输入将创建两张卡。一个名为 test1,另一个名为 test2:
[
{
"name-input-value": "test1"
},
{
"name-input-value": "test2"
}
]
了解您通过拖放映射的内容
数据映射映射字段路径,并加载字段的值。例如,给定以下数据:
[
{
"fruit": "apples",
"color": "green"
}
]
您可以通过将 fruit 水果 从 INPUT 拖放到要使用其值的字段来映射 fruit。这将创建一个表达式 {{ $json.fruit }}。当节点迭代输入项时,该字段的值将变为每个项的 fruit 的值。
理解嵌套数据
给出以下数据:
[
{
"name": "First item",
"nested": {
"example-number-field": 1,
"example-string-field": "apples"
}
},
{
"name": "Second item",
"nested": {
"example-number-field": 2,
"example-string-field": "oranges"
}
}
]
n8n 以表格形式显示它,如下所示,其中 nested 字段以粗体显示,表示它包含嵌套数据:

相关资源
不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。