触发器

触发器提供了一种统一机制，用于从连接器平台订阅事件。 它使您可以灵活地在 Orchestrator 中自动启动自动化或流程。

Orchestrator 中的触发器

重要提示：

从 2025 年 4 月下旬开始，您只能在 Orchestrator 中创建新的 Integration Service 触发器。

在 Orchestrator 中创建的触发器不会在 Integration Service触发器选项卡上列出。在 2025 年 7 月 31 日之前，现有 Integration Service 触发器将继续运行并在“Integration Service触发器”选项卡上保持可见状态（该日期可能会延长）。在此日期之后，现有的 Integration Service 触发器将迁移到 Orchestrator，并删除 Integration Service 中的“触发器”选项卡。

按计划，此更改将首先应用于社区版用户，然后根据组织和租户区域逐步应用于企业版用户。请关注Integration Service 发行说明指南，了解首次宣布变更的时间。

Orchestrator 中触发器的主要优势

将 Integration Service 触发器移至 Orchestrator 是一个很大的变化，但它带来了许多好处。以下是此次更新的主要原因：

1. 帐户-计算机映射：Orchestrator 支持对 Integration Service 触发的流程进行计算机级别控制。
2. 特定于机器人的流程执行控制：Orchestrator 允许您指定哪个机器人应在分配了多个机器人的文件夹中执行流程。这可以精确控制哪个机器人执行已触发的流程，消除了对单机器人文件夹等变通方法的需要，并通过在不失去执行控制的情况下允许多个机器人来增强可扩展性。
3. “输入参数和动态流程分配” ：Orchestrator 支持动态输入参数，并允许您定义活动流程实例的最大数量。这通过允许动态参数来减少流程重复，通过限制活动流程来优化资源使用，并提高按顺序管理请求的流程的效率。
4. 改进了对长时间运行的流程的管理: 在 Orchestrator 中创建的触发器支持“在此时间后停止”和“在此时间后终止”选项，允许在指定的持续时间或条件后自动终止流程。这可通过终止长时间运行的流程来防止资源过度使用，并通过停止无响应的工作流确保及时执行。
5. 编辑功能：Orchestrator 让您能够编辑现有触发器。
6. 统一的触发器体验：从一个位置创建和管理所有类型的触发器。
7. 单个触发器视图:将触发器创建移至 Orchestrator，可确保所有基于 Integration Service 的触发器保留单个视图。现在，您可以通过两种方式创建基于 Integration Service 的触发器：从 Integration Service，即为特定连接器创建触发器；从 Studio，即使用触发器活动启动自动化。即使两个触发器捕获相同的事件，为两个触发器显示的配置信息也可能略有不同。

概述

根据 Integration Service 连接，有两种类型的事件触发器：

• “已连接” – 在 Studio 中使用触发器活动创建，在流程内部使用。
• 已断开连接– 在 Orchestrator 或 Integration Service 中创建，用于启动任何自动化。

注意：触发器取决于连接。删除连接同时也会删除所有相关的触发器。

先决条件

在配置触发器之前，请确保满足以下条件：

• 已为租户启用并配置 Integration Service。
• 您已在 Orchestrator 实例中设置了一个无人值守或非生产机器人。
• 您正在使用新式文件夹（定义触发器时，传统文件夹中的流程不可见）。

创建触发器

您可以直接从 Orchestrator 创建断开连接的事件触发器。有关详细信息，请参阅 Orchestrator 用户指南中的事件触发器部分。

Orchestrator 提供对这些触发器的直接管理。在 Integration Service 中，唯一可用于修改触发器的选项是调整轮询间隔，该间隔在连接级别设置。

更新轮询间隔

连接器通过轮询机制支持事件。

在连接上设置事件触发器时，默认情况下轮询间隔设置为五分钟。

轮询间隔在连接级别设置。这意味着即使您为每个连接创建了多个触发器，每个连接也只能有一个轮询间隔。更改轮询间隔会影响连接上的所有关联触发器。

轮询以选定的间隔在连接上运行。 检索到数据后，该连接的所有活动触发器都将应用于数据集。 如果更改间隔时轮询正在运行，则服务将等待现有轮询完成，然后启动另一个轮询。

要更新轮询间隔：

1. 在 Integration Service 中，转到“连接”选项卡。
2. 选择特定连接以打开连接详细信息页面。

   仅对于已添加触发器的连接显示轮询间隔。

3. 选择时间间隔以打开“更新轮询间隔”窗口。

4. 您可以选择其中一个可用选项，或设置自定义时间间隔（以分钟或小时为单位）。轮询间隔必须超过 1 分钟，且不超过 24 小时或 1440 分钟。

5. 选择“更新”，然后选择“检查” 。

查看触发器运行历史记录

重要提示： “尝试次数”的历史记录表仅可用于在“Integration Service”中创建并在“触发器”选项卡中列出的触发器。尝试历史记录不适用于在 Orchestrator 中创建的触发器。

要查看触发器运行历史记录，请执行以下操作：

1. 在 Integration Service 中，选择“触发器”选项卡。
2. 对于任何列出的触发器，使用“更多操作”菜单：

“尝试历史记录”表格显示：

• 事件时间 – 捕获事件的时间
• 尝试次数
• 触发器状态 – 流程是否已成功启动。

注意： “成功”状态仅表示作业已成功启动。它不会反映作业是否已成功执行到底。如果作业无法启动，其“状态”将显示为“失败” 。将鼠标光标悬停在“失败”状态上以查看错误消息。

要检查作业是否已成功执行，请选择“查看作业日志”按钮。此操作会将您重定向到 Orchestrator，您可以在其中看到有关作业执行的所有必要信息。

管理触发器

以下操作适用于在 Integration Service 中创建的触发器。直接在 Orchestrator 中创建的触发器可以在 Orchestrator 中进行管理。

重命名触发器

要重命名触发器，请执行以下步骤：

1. 访问“触发器”选项卡。
2. 将鼠标光标悬停在要修改的触发器的名称上。 系统将显示编辑按钮。
   或者，您可以从列表中选择触发器以访问详细视图。编辑按钮位于触发器名称的右侧。
3. 选择“编辑”按钮，然后您可以为触发器选择新名称

删除触发器

转到“Integration Service” 窗口中的“触发器” 选项卡。选择与您的触发器对应的“更多操作”按钮，然后选择“删除” 。

激活或停用触发器

要激活或停用触发器，您首先必须选择它才能查看其详细信息。 然后选择位于窗口左上角的开关。

事件参数

断开连接的触发器允许您检索触发流程的连接器和事件的相关数据。

如果您想了解触发工作流中流程的实际连接器、事件、记录类型或记录，请在流程中定义以下类型为String的输入参数。Integration Service 会在启动作业时自动填充这些值：

• UiPathEventConnector - 确定启动自动化的连接器。
• UiPathEvent - 确定发生的事件的类型。
• UiPathEventObjectType - 定义事件产生的特定记录类型。
• UiPathEventObjectId - 提供事件所涉及的对象的唯一标识。

您不能为这些参数分配任何值。这些参数会在执行触发器时自动填充，您无法从 Studio 的“参数”面板查看或编辑这些参数。请参阅 Studio 文档，了解有关参数工作原理以及管理参数的更多信息：管理参数。

要检索和使用在作业运行中具有触发器的记录，请使用UiPathEventObjectId输入参数从源系统中检索记录。

以下示例说明了 Integration Service 如何将输入参数值传递到 Orchestrator 日志中：

特定于触发器的输出

已连接的触发器具有特定于对象的输出。例如， Microsoft OneDrive & SharePoint已收到电子邮件”触发器输出一个Office365Message类型的对象，其中包含AttachmentsNamesList 、 FromAddress 、 InternetMessageId和SentDateTime等属性。 有关详细信息，请参阅Microsoft OneDrive & SharePoint事件。

使用 Studio 中的表达式编辑器查看任何触发器输出对象的所有可用属性。

限制

触发器限制记录在本指南的“故障排除”部分中。请参阅触发器限制。