Skip to content

自定义执行数据#

您可以使用 Code 节点或 Execution Data 节点在工作流中设置自定义数据。n8n 会将这些数据与每次执行一起记录。之后您可以在筛选执行列表时使用这些数据，或者通过 Code 节点在工作流中获取它们。

/// 信息 | 功能可用性 自定义执行数据适用于：

  • 云版本：Pro、Enterprise
  • 自托管版本：Enterprise、已注册的 Community 版本

0.222.0 及以上版本可用。 ///

使用 Code 节点设置和访问自定义数据#

本节介绍如何使用 Code 节点设置和访问数据。如需了解如何使用 Execution Data 节点设置数据，请参阅 Execution Data 节点。注意：无法通过 Execution Data 节点检索自定义数据。

设置自定义执行数据#

设置单个额外数据项：

1
$execution.customData.set("key", "value");

1
_execution.customData.set("key", "value");

设置所有额外数据（这将覆盖本次执行的整个自定义数据对象）：

1
$execution.customData.setAll({"key1": "value1", "key2": "value2"})

1
_execution.customData.setAll({"key1": "value1", "key2": "value2"})

存在以下限制：

  • 数据必须是字符串类型
  • key 的最大长度为 50 个字符
  • value 的最大长度为 255 个字符
  • n8n 最多支持 10 个自定义数据项

在执行过程中访问自定义数据对象#

您可以在执行过程中检索自定义数据对象或其特定值：

1
2
3
4
5
// 在执行过程中访问对象的当前状态
const customData = $execution.customData.getAll();

// 访问本次执行设置的特定值
const customData = $execution.customData.get("key");

1
2
3
4
5
# 在执行过程中访问对象的当前状态
customData = _execution.customData.getAll();

# 访问本次执行设置的特定值
customData = _execution.customData.get("key");