Maestro 用户指南

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

Events

事件能够捕获流程执行过程中的事件发生时间。流程图绘制事件主要有三种类型：开始事件、中间事件和结束事件。这些事件也被称为“捕获”事件（对触发器做出反应）或“抛出”事件。

UiPath 平台支持以下事件类型和实现：

开始事件的行为与捕获事件相同。它们由以下因素触发：
- 无（手动触发时启动流程或通过 Orchestrator 启动）
- 消息事件（等待来自 Integration Service 的事件触发器）
- 计时器事件（按触发器配置中定义的计划或延迟开始流程）
  计时器开始事件根据定义的计划而非用户或系统输入开始流程。您可以使用“计时器”部分对其进行配置，它支持三种类型：“日期”、“持续时间”和“周期”。对于重复执行，请使用“周期”类型，并指定“重复”频率（例如，每小时、每天）和间隔。“时间”和“重复次数”字段用于对时间和上限进行额外控制。在“实施”部分中，如果不需要入站事件，可以将“操作”设置为“无”，如果流程在继续之前需要侦听外部触发器，可以将其设置为“等待连接器事件”。计时器开始事件非常适用于计划的自动化，例如每小时同步或每日报告。阅读有关 Integration Services 连接器的更多信息。
中间捕获事件的行为与开始事件类似。它们在流程执行期间等待消息、计时器或 API 触发器。执行暂停，直到收到消息。
边界事件是附加到任务的特殊类型中间捕获事件。它们可以配置为：
- 中断性边界事件：当附加任务开始时，边界事件会等待其触发器。如果任务仍在执行时被触发，它会中断任务并沿边界事件输出路径继续运行。中断性边界事件可以通过“计时器”或“消息”事件触发。
  计时器边界事件用于在任务耗时过长时中断该任务。您可以使用“持续时间”、特定“日期”或“周期”（适用于周期性计时器）来配置超时。在“属性面板”中，“类型”字段确定计时器模式，“值”字段接受 ISO 8601 时间表达式（例如，一小时为 PT1H）。如果任务仍在运行时计时器到期，会继续沿着边界事件的传出路径进行流程。“实施”部分可用于选择性地定义触发超时时要采取的操作，但如果在下游对后续逻辑进行了建模，通常会设置为“无”。
  
  消息边界事件会在其所属的活动仍在运行时侦听特定消息。如果消息到达，它会中断正在进行的任务，并将流转移到单独的路径。您可以通过选择可用操作（例如等待连接器事件或外部输入），在“实施”部分中定义消息处理逻辑。使用“输入”和“输出”部分从传入消息中传递或提取数据。您还可以使用“更新变量”来修改流程数据，以响应消息。如果未收到消息，原始任务将不间断继续执行。
- 非中断性边界事件：触发时，这些事件会创建新的执行令牌并沿并行路径继续运行，而不会中断原始任务的执行。非中断性边界事件可以通过“计时器”和“消息”事件触发。
- 错误边界事件：错误边界事件用于捕获和处理其所属的活动中发生的错误。如果引发错误，控件将退出活动，并沿边界事件路径执行后续步骤。默认情况下，“异常”被设置为“全部捕获”，这意味着它会捕获任何未处理的错误。在大多数情况下，此路径被作为回退路径或“最终”错误处理路由。“实施”部分用于选择性地定义操作（例如日志记录或通知），但如果边界事件中不需要特定执行，可以将其设置为“无”。
中间抛出事件主动发送触发器。例如：
- 消息中间抛出事件的作用类似于“发送任务”，会调用 Integration Service API 执行。
结束事件标志着流程的完成，行为与抛出事件相同。此类事件可能是：
- 错误结束事件，完成流程实例并导致 orchestration runtime (OR) 作业出现故障。
- 消息结束事件，在流程结束时发送消息。可以配置消息结束事件，使其在流程结束时执行连接器活动。选择“执行连接器活动”作为实施操作，您可以使用 Integration Service 中可用的任何连接器（例如 Slack、Salesforce、ServiceNow 等）触发出站操作。这通常用于在流程成功完成或失败后通知外部系统、更新记录、发送消息或上传文件。您必须选择目标连接器，定义连接，然后选择要运行的特定活动。输入用于将数据传递给连接器，而输出用于捕获并存储连接器的响应或结果，以在流程中的其他位置使用。阅读有关 Integration Services 连接器的更多信息。
- 终止结束事件，取消所有其他执行路径/令牌，尤其在多个分支并行运行时。结束事件表示流程路径的结束。在 Maestro 中，您可以选择性地定义“实施操作”，以执行最终活动，例如执行连接器操作，返回数据或触发后续系统。如果不需要操作，可以将实施设置为“无”，这样就会结束流程。“参数”部分用于定义可以传递给父流程或用于下游报告的输出值。结束事件非常灵活，可用于关闭标准路径和特殊路径，具体取决于流程的建模方式。