执行子工作流程
使用 Execute Sub-workflow 节点在运行 n8n 的主机上运行不同的工作流。
节点参数
来源
选择节点应从何处获取子工作流的信息:
- Database 数据库:选择此选项从数据库按 ID 加载工作流。您还必须输入以下之一:
- From list 从列表:从您帐户可用的工作流列表中选择工作流。
- Workflow ID 工作流 ID:输入工作流的 ID。工作流的 URL 在
/workflow/后包含 ID。例如,如果工作流的 URL 是https://my-n8n-acct.app.n8n.cloud/workflow/abCDE1f6gHiJKL7,Workflow ID 工作流 ID 是abCDE1f6gHiJKL7。
- Local File 本地文件:选择此选项从本地保存的 JSON 文件加载工作流。您还必须输入:
- Workflow Path 工作流路径:输入您希望节点执行的本地 JSON 工作流文件的路径。
- Parameter 参数:选择此选项从参数加载工作流。您还必须输入:
- Workflow JSON 工作流 JSON:输入您希望节点执行的 JSON 代码。
- URL:选择此选项从 URL 加载工作流。您还必须输入:
- Workflow URL 工作流 URL:输入您要从中加载工作流的 URL。
工作流程输入
如果您使用database 数据库和From list 从列表选项选择子工作流,子工作流的输入项目将自动显示,准备供您填写或映射值。
您可以选择删除请求的输入项目,在这种情况下子工作流将接收 null 作为该项目的值。您还可以启用Attempt to convert types 尝试转换类型以尝试自动将数据转换为子工作流项目请求的类型。
如果子工作流的 Workflow Input Trigger 节点使用"接受所有数据"输入数据模式,则不会显示输入项目。
模式
使用此参数控制节点的执行模式。从这些选项中选择:
- Run once with all items 使用所有项目运行一次:将所有输入项目传递到节点的单次执行中。
- Run once for each item 为每个项目运行一次:依次为每个输入项目执行节点一次。
节点选项
此节点包括一个选项:Wait for Sub-Workflow Completion 等待子工作流完成。这让您控制主工作流是否应该等待子工作流完成后再继续下一步(打开),或者主工作流是否应该不等待继续(关闭)。
模板和示例
设置并使用子工作流程
本节介绍如何设置父工作流和子工作流。
创建子工作流程
-
新建工作流程.
从现有工作流创建子工作流
您可以选择使用 执行子工作流 节点直接从现有父工作流创建子工作流。在节点中,选择数据库和从列表选项,然后选择在列表中创建子工作流。
也可以直接使用提取选定的节点上下文菜单中的子工作流程转换。
-
Optional 可选:配置哪些工作流程可以调用子工作流程:
- 选择 Options 选项
菜单 > Settings 设置。 n8n 打开 Workflow settings 工作流程设置 模态。 - 更改 This workflow can be called by 该工作流程可以通过以下方式调用 设置。 有关配置工作流程的更多信息,请参阅工作流程设置。
- 选择 Options 选项
- 添加 Execute Sub-workflow 执行子工作流程 触发节点(如果您在触发节点下搜索,则标题也为 When Executed by Another Workflow 当由另一个工作流程执行时)。
- 设置 Input data mode 输入数据模式 以选择如何定义子工作流程的输入数据:
- Define using fields below 使用下面的字段定义:选择此模式可定义调用工作流需要提供的各个输入名称和数据类型。调用工作流中的执行子工作流节点或调用n8n工作流工具节点将自动拉入此处定义的字段。
- Define using JSON example 使用 JSON 示例定义:选择此模式可提供示例 JSON 对象,该对象演示预期的输入项及其类型。
- Accept all data 接受所有数据:选择此模式无条件接受所有数据。子工作流程不会定义任何所需的输入项。该子工作流程必须处理任何输入不一致或缺失值。
- 根据需要添加其他节点以构建子工作流功能。
- 保存子工作流程。
提示
Sub-workflow mustn't contain errors 子工作流程不得包含错误
如果子工作流程出现错误,父工作流程无法触发。
提示
Load data into sub-workflow before building 在构建之前将数据加载到子工作流程中
这需要能够从之前的执行中加载数据,该功能可在 n8n Cloud 和注册的社区计划中使用。
如果您想将数据加载到子工作流程中以在构建时使用:
- 创建子工作流并添加Execute Sub-workflow Trigger 执行子工作流程触发器。
- 将节点的 Input data mode 输入数据模式 设置为 Accept all data 接受所有数据,或者使用字段或 JSON 定义输入项(如果已知)。
- 在子工作流程设置中,将Save successful production executions 保存成功的生产执行设置为Save 保存。
- 跳到设置父工作流并运行它。
- 按照步骤从先前执行中加载数据。
- 如有必要,调整 Input data mode 输入数据模式 以匹配父工作流程发送的输入。
您现在可以将示例数据固定在触发器节点中,从而使您能够在配置工作流程的其余部分时使用真实数据。
调用子工作流程
- 打开要调用子工作流程的工作流程。 1.添加Execute Sub-workflow 执行子工作流程节点。
-
在Execute Sub-workflow 执行子工作流程节点中,设置要调用的子工作流程。您可以选择按 ID 调用工作流、从本地文件加载工作流、将工作流 JSON 添加为节点中的参数或通过 URL 定位工作流。
查找您的工作流程 ID
您的子工作流程的 ID 是其 URL 末尾的字母数字字符串。
-
填写子工作流程定义的必填输入项。
- 保存您的工作流程。
当您的工作流程执行时,它将向子工作流程发送数据并运行它。
您可以通过打开执行子工作流程节点并选择 View sub-execution 查看子执行 链接来跟踪从父工作流程到子工作流程的执行流程。同样,子工作流程的执行包含返回父工作流程的执行的链接,以沿另一个方向导航。
数据如何在工作流程之间传递
例如,假设您在 Workflow A 工作流程A 中有一个执行子工作流节点。执行子工作流节点调用另一个名为 Workflow B 工作流程B 的工作流:
- 执行子工作流节点将数据传递给工作流 B 的执行子工作流触发器节点(在画布中标题为"当被另一个节点执行时")。
- 工作流 B 的最后一个节点将数据发送回工作流 A 中的执行子工作流节点。