Skip to content

数据结构#

在 n8n 中,所有在节点之间传递的数据都是一个对象数组。它具有以下结构:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
[
	{
		// 对于大多数数据:
		// 将每个条目包装在另一个对象中,键名为 'json'
		"json": {
			// 示例数据
			"apple": "beets",
			"carrot": {
				"dill": 1
			}
		},
		// 对于二进制数据:
		// 将每个条目包装在另一个对象中,键名为 'binary'
		"binary": {
			// 示例数据
			"apple-picture": {
				"data": "....", // Base64 编码的二进制数据(必需)
				"mimeType": "image/png", // 尽可能设置(可选)
				"fileExtension": "png", // 尽可能设置(可选)
				"fileName": "example.png", // 尽可能设置(可选)
			}
		}
	},
]

跳过 json 键和数组语法

从 0.166.0 版本开始,当使用 Function 节点或 Code 节点时,如果缺少 json 键,n8n 会自动添加。如果需要,它还会自动将您的条目包装在数组 ([]) 中。这仅适用于使用 Function 或 Code 节点的情况。在构建自己的节点时,您仍然必须确保节点返回的数据包含 json 键。

数据项处理#

节点可以处理多个数据项。

例如,如果您将 Trello 节点设置为 Create-Card(创建卡片),并创建一个表达式,使用来自输入数据的 name-input-value 属性来设置 Name 字段,那么该节点会为每个数据项创建一张卡片,总是选择当前数据项的 name-input-value 值。

例如,以下输入将会创建两张卡片:一张名为 test1,另一张名为 test2

1
2
3
4
5
6
7
8
[
	{
		name-input-value: "test1"
	},
	{
		name-input-value: "test2"
	}
]