跳到主要内容

自定义执行数据

可以通过 Code 节点或 Execution Data 节点为工作流设置自定义数据,n8n 会随每次执行记录这些数据。之后,可以在筛选执行列表时使用这些数据,也可以在工作流中通过 Code 节点获取。

信息

功能可用范围

以下套餐支持自定义执行数据:

  • n8n Cloud: Pro、Enterprise
  • 自托管: 已注册的 Community、Enterprise

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

本节介绍如何通过 Code 节点设置和访问数据。通过 Execution Data 节点设置数据的方法,请参阅 Execution Data 节点。Execution Data 节点不能用于读取自定义数据。

设置自定义执行数据 ​

设置单条附加数据:

JavaScript
$execution.customData.set("key", "value");
Python
_execution.customData.set("key", "value");

设置全部附加数据。这会覆盖本次执行的整个自定义数据对象:

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

存在以下限制:

  • 必须是字符串
  • key 最长为 50 个字符
  • value 最长为 255 个字符
  • n8n 最多支持 10 条自定义数据

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

执行过程中,可以读取自定义数据对象,或其中某个特定值:

JavaScript
// Access the current state of the object during the execution
const customData = $execution.customData.getAll();

// Access a specific value set during this execution
const customData = $execution.customData.get("key");
Python
# Access the current state of the object during the execution
customData = _execution.customData.getAll();

# Access a specific value set during this execution
customData = _execution.customData.get("key");

相关资源 ​

本文为社区中文翻译。查看对应英文原文