n8n 中文文档

n8n 元数据

使用 n8n 元数据的方法。

这包括:

  • 访问自托管 n8n 的 n8n 环境变量。
  • 有关工作流程、执行和节点的元数据。
  • 有关实例变量 和外部机密 的信息。

提示

Python support Python支持

您可以在代码节点中使用Python。它在表达式中不可用。

JavaScript

方法 描述 在代码节点中可用吗?
$env 包含n8n实例配置环境变量。 ✅
$execution.customData 设置和获取自定义执行数据。有关更多信息,请参阅自定义执行数据。 ✅
$execution.id 当前工作流程执行的唯一 ID。 ✅
$execution.mode 执行是自动触发的,还是手动运行工作流。可能的值为 test 和 production。 ✅
$execution.resumeUrl 用于恢复在 等待节点 处等待的工作流的 Webhook URL。 ✅
$getWorkflowStaticData(type) 访问静态工作流数据。测试工作流时静态数据不会保留:请发布工作流,并通过触发器或 Webhook 运行它以保存静态数据。如需在执行之间持久保存数据,请考虑改用数据表。查看示例。 ✅
$("<node-name>").isExecuted 检查节点是否已经执行。 ✅
$itemIndex 项目列表中项目的索引。 ❌
$nodeVersion 获取当前节点的版本。 ✅
$prevNode.name 当前输入来自的节点的名称。使用合并节点时,请注意 $prevNode 始终使用第一个输入连接器。 ✅
$prevNode.outputIndex 当前输入来自的输出连接器的索引。当前一个节点有多个输出(例如 If 或 Switch 节点)时使用此选项。 使用合并节点时,请注意 $prevNode 始终使用第一个输入连接器。 ✅
$prevNode.runIndex 生成当前输入的前一个节点的运行。使用合并节点时,请注意 $prevNode 始终使用第一个输入连接器。 ✅
$runIndex n8n 已执行当前节点多少次。从零开始(第一次运行为 0,第二次运行为 1,依此类推)。 ✅
$secrets 包含有关您的外部机密 设置的信息。 ❌
$vars 包含活动环境中可用的变量。 ✅
$version 节点版本。 ❌
$workflow.active 工作流程是否处于活动状态(true)或不活动(false)。 ✅
$workflow.id 工作流程 ID。 ✅
$workflow.name 工作流程名称。 ✅

Python (native)

方法 描述
_items 包含“对所有项目运行一次”模式下的传入项目。
_item 包含在“为每个项目运行一次”模式下迭代的项目。
_query 在 Code Tool 中,包含 AI Agent 调用该工具时传入的输入字符串。适用于“对所有数据项运行一次”模式。

Python (Pyodide, deprecated)

Python (Pyodide) 支持从 n8n 1.113.2 起弃用。请改用 Python (native)。

方法 描述
_env 包含n8n实例配置环境变量。
_execution.customData 设置和获取自定义执行数据。有关更多信息,请参阅自定义执行数据。
_execution.id 当前工作流程执行的唯一 ID。
_execution.mode 执行是自动触发的,还是手动运行工作流。可能的值为 test 和 production。
_execution.resumeUrl 用于恢复在 等待节点 处等待的工作流的 Webhook URL。
_getWorkflowStaticData(type) 访问静态工作流数据。测试工作流时静态数据不会保留:请发布工作流,并通过触发器或 Webhook 运行它以保存静态数据。如需在执行之间持久保存数据,请考虑改用数据表。查看示例。
_("<node-name>").isExecuted 检查节点是否已经执行。
_nodeVersion 获取当前节点的版本。
_prevNode.name 当前输入来自的节点的名称。使用合并节点时,请注意 _prevNode 始终使用第一个输入连接器。
_prevNode.outputIndex 当前输入来自的输出连接器的索引。当前一个节点有多个输出(例如 If 或 Switch 节点)时使用此选项。 使用合并节点时,请注意 _prevNode 始终使用第一个输入连接器。
_prevNode.runIndex 生成当前输入的前一个节点的运行。使用合并节点时,请注意 _prevNode 始终使用第一个输入连接器。
_runIndex n8n 已执行当前节点多少次。从零开始(第一次运行为 0,第二次运行为 1,依此类推)。
_secrets 包含有关您的外部机密 设置的信息。
_vars 包含活动环境中可用的变量。
_workflow.active 工作流程是否处于活动状态(true)或不活动(false)。
_workflow.id 工作流程 ID。
_workflow.name 工作流程名称。

相关资源

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。