N8N中文教程
使用 n8n/Key_concepts/Data/Data_mapping

在用户界面中进行数据映射#

数据映射(Data mapping)指的是引用前序节点中的数据。它不包含对数据的修改(转换),仅涉及数据的引用。

你可以通过以下方式映射数据:

  • 使用表达式编辑器(expressions editor)。
  • 通过将 INPUT 中的数据拖拽到参数字段中。系统会自动为你生成相应的表达式。

有关映射和项目链接错误的信息,请参考 项目链接错误(Item linking errors)。

如何拖拽映射数据#

  1. 运行你的工作流以加载数据。
  2. 打开需要进行数据映射的节点。
  3. 你可以在表格视图、JSON 视图和模式(schema)视图中进行映射:
    • 在表格视图中:点击并按住表头可映射顶层数据,点击并按住表中的某个字段可映射嵌套数据。
    • 在 JSON 视图中:点击并按住某个键(key)。
    • 在 schema 视图中:点击并按住某个键(key)。
  4. 将选中的项目拖动到你希望使用该数据的字段中。

理解拖拽映射的内容#

数据映射实际上是映射键的路径(key path),并将该键对应的值加载到目标字段中。例如,假设有如下数据:

1
2
3
4
5
6

| ``` [ { "fruit":"apples", "color":"green" } ]


---|---
你可以通过将 **INPUT** 中的 **fruit** 拖拽到目标字段中来映射 `fruit` 字段。这将自动生成一个表达式:`{{ $json.fruit }}`。当节点遍历输入项时,该字段的值将变为每个输入项中 `fruit` 的实际值。

### 理解嵌套数据#

假设有如下数据:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

| ```
[
{
"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 会以如下表格形式显示: "INPUT 面板中表格的截图。其中包含一个名为 'nested' 的顶层字段,该字段包含嵌套数据,以粗体表示。"