子流程

概述

子流程是其他任务和子流程的集合，有助于将复杂流程分解为更易于管理和导航的多个部分。

备注：

• 当您需要在同一项目或一个单独项目中使用其他流程时，请选择“调用”活动。此类具有独立值的智能体流程既可以作为独立流程调用，也可以由其他流程调用，从而自动触发新实例的创建。
• 在需要封装特定逻辑时使用子流程，从而简化父流程。作为同一实例的固有部分，子流程有助于简化整个编排过程。

有关 BPMN 支持的其他详细信息，请参阅“流程建模”。

在子流程之间传递和访问变量

子流程封装可重用逻辑，但通常需要与父流程或其他子流程交换数据。Maestro 为变量的作用域设置和传递方式提供了明确的规则，以便您的数据在各个级别保持一致。

访问子流程中的输入

要访问同一子流程中先前活动的输出，无需额外配置。

示例：如果活动foo设置了一个名为foo_op输出变量，并且同一子流程中存在后续活动bar ，则bar可以直接引用foo_op 。

关键规则: 活动中定义的变量（包括嵌套元素）可供同一子流程中的任何下游活动访问。您无需将它们作为子流程输入显式传递。

公开子流程的输出

当父流程需要访问嵌套子流程中一个活动的输出数据时，您可以使用两种方法的其中之一公开该数据。

方法 1：使用输出变量

1. 在内部子流程中，定义一个输出变量（例如 inner_sp_op），并为其分配内部活动输出值 (bar_op)。
2. 在外部子流程（或父流程）中，定义另一个输出变量（例如 outer_sp_op），并为其分配内部子流程输出值 (inner_sp_op)。
3. 现在，父流程中的下游活动（例如 qux）可以引用 outer_sp_op。

方法 2：使用结束事件变量

1. 在内部子流程中，配置结束事件以声明输出变量，例如ee_inner_op ，并将其分配为bar_op值。

2. 在外部子流程中，配置相应的结束事件，以声明输出变量（例如 ee_outer_op），并为其分配 ee_inner_op 的值。

3. 现在，父流程中的活动 qux 可以引用 ee_outer_op。

   提示：

   结束事件变量会自动传播到父作用域，而无需单独配置输出变量。

   检查子流程变量

您可以在设计期间（通过调试 API）或运行期间（通过实例 API）检查变量值，以验证作用域和数据传输。

调试 API - 查看变量

GET /v1/debug-instances/{instanceId}/variables?parentElementId=outer_subprocess

可用变量：

• foo_op
• inner_subprocess_op
• ee_outer_op

GET /v1/debug-instances/{instanceId}/variables?parentElementId=inner_subprocess

可用变量：

• bar_op
• ee_inner_op

运行时 API – 查看变量

GET /v1/instances/{instanceId}/variables?parentElementId=outer_subprocess

可用变量：

• foo_op
• inner_subprocess_op
• ee_outer_op

GET /v1/instances/{instanceId}/variables?parentElementId=inner_subprocess

可用变量：

• bar_op
• ee_inner_op

多实例标记

子流程支持多实例标记，其中每个元素都会执行多次。除了子流程以外，可以标记为多实例的元素都是任务类型。

嵌套标记

支持将以下字符串变量字符串作为嵌套迭代器：

类别	属性	如何使用/访问
OuterSP - 获取每个用户的联系人信息	InputCollection	var.GetUsers
OuterSP - 获取每个用户的联系人信息	迭代器项目	iterator.item.gid
InnerSP - 获取每个联系人的所有电子邮件	InputCollection	iterator[0].item.contactArray
InnerSP - 获取每个联系人的所有电子邮件	迭代器项目	iterator[1].item.ContactId
发送电子邮件	InputCollection	iterator[1].item.EmailArray
发送电子邮件	迭代器项目	iterator[2]item.emailAddress