n8n 中文文档

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 字段以粗体显示,表示它包含嵌套数据:

示例数据的表格视图,其中 nested 字段以粗体显示

相关资源

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