Skip to content

自定义执行数据#

您可以使用代码节点或执行数据节点在工作流上设置自定义数据。n8n 在每次执行时记录此数据。然后您可以在过滤执行列表时使用此数据，或使用代码节点在工作流中获取它。

功能可用性

自定义执行数据可用于：

  • 云版：专业版、企业版
  • 自托管：企业版、已注册社区版

版本 0.222.0 及以上可用。

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

本节描述如何使用代码节点设置和访问数据。有关使用执行数据节点设置数据的信息，请参阅执行数据节点。您无法使用执行数据节点检索自定义数据。

设置自定义执行数据#

设置单个额外数据：

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");