自定义执行数据#

你可以使用代码节点（Code node）或执行数据节点为工作流设置自定义数据。n8n 会在每次执行时记录这些数据。之后，你可以在过滤执行列表时使用这些数据，或在工作流中通过代码节点获取它们。

功能可用性 自定义执行数据支持以下版本：

• Cloud：Pro、Enterprise
• 自托管（Self-Hosted）：Enterprise、已注册的 Community

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

本节介绍如何使用代码节点来设置和访问数据。有关使用执行数据节点设置数据的信息，请参考 Execution Data 节点文档。注意：无法使用执行数据节点检索自定义数据。

设置自定义执行数据#

设置单个额外数据项： JavaScriptPython

1

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

---|---

1

| ```
_execution.customData.set("key", "value");

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

1

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

---|---

1

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

---|--- 限制说明：

• 所有值必须是字符串（strings）
• key 最长支持 50 个字符
• value 最长支持 255 个字符
• n8n 最多支持 10 个自定义数据项

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

你可以在执行期间检索整个自定义数据对象，或其中某个特定值： JavaScriptPython

1
2
3
4
5

| ``` // 访问执行过程中当前的数据对象状态 const customData = $execution.customData.getAll();

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

---|---

1
2
3
4
5

| ```

在执行期间访问对象的当前状态

customData = _execution.customData.getAll();

访问本次执行期间设置的特定值

customData = _execution.customData.get("key");

---|---