配置错误处理

BPMN 流程中的每个节点都可以有一个或多个错误映射，用于定义 Maestro 如何处理运行时抛出的错误。使用属性面板中的“错误映射”属性，指定节点在什么条件下捕获哪些错误，以及如何路由这些错误。

错误和错误映射

Maestro 区分两个相关的概念：

• 错误是在流程级别定义的。它们代表流程中任何节点都可以引用的命名错误类型。
• 错误映射是在元素级别定义的。每个节点都有自己的映射列表，这些映射列表可链接到流程级错误，并定义该特定节点的捕获条件。

当节点在运行时抛出错误时，Maestro 会按优先级顺序评估其错误映射，并应用条件评估为 true 的第一个映射。

添加错误映射

1. 选择画布上的节点。
2. 在属性面板中，转到“错误映射”。
3. 选择“添加映射”。
4. 配置映射字段（请参阅下面的“错误映射属性”）。

错误映射属性

字段	描述
错误	此映射捕获的流程级错误。在下拉菜单中进行选择，或单击“菜单”按钮以打开错误创建对话框，然后在行内定义新错误。选择错误时，会将映射的 errorRef 设置为选定流程级错误的 ID。
条件	定义此映射何时适用。使用变量选取器构建表达式，若为复杂条件，请切换到 JavaScript 或 C# 编辑器。留空即可无条件捕获错误。
详细信息	映射的自由文本描述。用于记录您团队的映射意图。

按优先级对映射进行重新排序

Maestro 按照错误映射的显示顺序对其进行评估。要更改评估顺序，请将映射拖动到列表中的其他位置。首先评估顶部的映射。

错误传播

错误映射匹配后，Maestro 会将错误路由到节点上附加的适当处理程序：

• 边界事件：错误会传播到节点上附加的错误边界事件，流程遵循边界事件的输出路径。
• 事件子流程：在父流程中提出的错误会传播到使用错误开始事件的事件子流程，触发子流程中定义的集中错误处理。

有关使用边界事件和事件子流程的建模模式，请参阅“错误和恢复”。

创建流程级错误

流程级错误在流程中的所有节点之间共享。要新建错误：

1. 在任何映射的“错误”字段中，单击“菜单”按钮。
2. 在打开的对话框中，输入名称，并可选择性地输入错误代码。
3. 选择“创建”。错误将添加到流程中，并在当前映射中处于选中状态。

同一个错误可以由多个节点上的映射引用。