Maestro 用户指南

上次更新日期 2025年9月26日

网关

Gateways control the flow of your process. You can configure condition logic to determine which path to take. Once the paths are drawn, you can set the condition logic either via the path line or directly on the gateway. Read more about gateways.

排他网关

排他网关只允许根据条件评估结果选择一条传出路径。它按顺序检查每个条件，然后选择评估结果为 true 的第一个路径。

如果所有条件的评估结果都不是 true，但定义了默认路径，流程将使用默认路径。
如果所有条件都不是 true，而且未定义默认路径，流程执行将会失败。

定义默认路径

在 Maestro 中，您可以将路径标记为默认路径。在 XML 标记中，此操作可以利用 <exclusiveGateway> 元素上的 default 属性来完成。

合并行为

排他网关会等待一次传入执行后再继续流程。它充当决策点，仅允许运行多个可能路径中的一个路径。

包容性网关属性

版块	字段	描述
常规	名称	用于识别图表中网关的标签。虽然是可选操作，但能提高模型的清晰度。
常规	描述	自由文本字段，用于记录网关背后的用途或逻辑。有助于进行设计审核和协作。
条件	（标签组）	“条件”下的每个组代表网关的一条传出路径。每条路径都有自己的逻辑。
条件	标签	条件路径的显示名称。它显示在图表上，以帮助用户理解分支逻辑。
条件	设为默认路径	一个开关，在其他条件的评估结果都不为“真”时，将此路径定义为回退路径。只有一个路径应标记为默认路径。
条件	条件	确定是否采用此路径的表达式。示例：`vars.error_1 != null && vars.retryCount < 3`。按顺序评估条件。

排他网关逻辑的说明

仅遵循一个条件路径：一旦一个条件的评估结果为true，则忽略所有其他条件。
顺序非常重要：按顺序评估条件；第一个匹配项决定了所遵循的路径。
默认路径是可选项，但建议使用：如果所有条件的评估结果都不是true，且未设置默认值，流程实例将在运行时失败。
表达式语法：Maestro 使用类似 JavaScript 的语法。您可以使用 vars. 引用流程变量（例如，
```
vars.status ==
    "error"vars.status ==
    "error"
```
）。

包容网关

包容网关允许并行执行多个传出路径，具体取决于哪些条件的评估结果为 true。

分叉行为

对于条件评估结果为 true 的所有传出路径，流程都会并行进行。
将为每个选定路径创建一个并行执行。

汇聚行为

包容网关等待上游激活的每个传入序列流的执行到达。
所有预期令牌到达后，网关将其合并，流程继续进行。

包容性网关属性

Maestro 中的包容性网关允许流程评估多个传出条件，并根据哪些条件为真，遵循一条路径或同时遵循多条路径。

版块	字段	描述
常规	名称	用于在图表上识别网关的标签。这是可选项，但建议使用，以使复杂模型更加清晰。
常规	描述	用于描述网关用途或逻辑的可选元数据。这在设计和审核过程中非常有用。
条件	（标签组）	“条件”下的每个组代表一个传出序列流。您可以用序列流各自的条件定义多个序列流。
条件	标签	特定条件或路径的用户定义名称。此标签显示在图表上，用于解释分支背后的逻辑。
条件	条件	在运行时评估以确定是否应采用此路径的实际表达式。Maestro 使用 `vars.error_1 == null` 等表达式来检查流程变量。

Maestro 中包容性网关行为的说明

可以采用多个路径：如果两个或多个条件的评估结果为true，包容性网关会并行激活所有匹配路径。
条件为可选项：如果未定义条件，则会采用所有传出流。
至少需要有一个匹配路径：您应确保条件涵盖所有可能情况，或使用无条件流定义默认路径。
语法：条件是使用 Maestro 的表达式语法编写的，该语法支持 ==、!=、比较和逻辑运算符。例如：
```
vars.amount > 1000 && vars.region == "EU"vars.amount > 1000 && vars.region == "EU"
```

并行网关

并行网关用于：

分叉：将流程拆分为多个并行路径。无需任何条件，遵循所有传出路径。
汇聚：将多个并行路径合并为单个流程。网关会等待所有传入执行，然后再继续流程。

并行网关属性

Maestro 中的包容性网关允许流程评估多个传出条件，并根据哪些条件为真，遵循一条路径或同时遵循多条路径。

版块	字段	描述
常规	名称	在图表上显示的名称，用于识别网关。这是可选项，但可以让复杂流更加清晰。
常规	描述	可选的自由文本字段，用于记录网关的用途或行为。仅在“属性”面板中显示。

Maestro 中并行网关行为的说明

并行网关用于将流分为多个同时运行的分支，或同步多个传入路径。
不需要任何条件。所有传出路径都同时触发。
在连接中，网关会等待所有传入流完成，然后再继续。
常见用例包括并行启动多个任务或在完成后同步并行分支。

基于事件的网关

事件网关会等待多个可能事件中的一个事件，然后再继续流程。在触发其中一个事件之前，执行会暂停。每个路径必须以中间捕获事件开头，例如：

计时器事件
消息事件

Maestro 操作类型：等待连接器事件

用例：响应式流程，其结果取决于先发生的事件（例如，外部回调或超时）。

事件驱动网关的属性

Maestro 中的包容性网关允许流程评估多个传出条件，并根据哪些条件为真，遵循一条路径或同时遵循多条路径。

版块	字段	描述
常规	名称	网关的显示名称。它显示在图表上，以帮助用户识别分支逻辑。可选项，但有助于提高清晰度。
常规	描述	可选的文本字段，用于记录事件驱动网关的用途或行为。有助于协作和可维护性。