触发器

触发器提供了一种用于从连接器平台订阅事件的统一机制。让您可以灵活地在 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 实例中设置了一个 Unattended 或非生产机器人。
• 您正在使用新式文件夹（定义触发器时，传统文件夹中的流程不可见）。
• 使用触发器的用户在 Orchestrator 中拥有必要的权限。要创建触发器，用户必须在目标文件夹中具有“触发器-创建” 权限。有关权限的更多信息，请参阅 Orchestrator 用户指南中的配置帐户访问权限。

触发器的工作原理

基于轮询的触发器（例如“已创建记录”或“已创建事件”）可用于多个 UiPath 连接器。此类触发器通过对目标应用程序的公共 API 使用轮询机制来检测新记录。

触发器的运行方式如下：

1. 轮询间隔- Integration Service 以设置的间隔（默认情况下每五分钟）轮询目标系统。轮询间隔是在连接级别设置的，因此更改轮询间隔会影响与该连接关联的所有触发器。

2. 基于 API 的检测- 在每个轮询周期内，Integration Service 会使用供应商的标准 REST API 查询相关对象/表格。

3. 渐进式记录识别- 使用 API 查询参数（通常基于以下参数）识别新记录：

   • 记录创建时间戳（例如sys_created_on ）
   • 在某些情况下，修改时间戳

   Integration Service 存储上一个成功轮询周期的最新创建时间戳（或等效标记）。下次轮询时，将从该存储的值继续执行查询，从而确保连续性并防止重复处理。

   例如，用于轮询 ServiceNow 中新事件的查询可能如下所示： GET https://{instance}.service-now.com/api/now/v1/table/incident?sysparm_query=sys_created_on>={last_max_created_date}

   备注：

   可能包括其他参数（例如分页、限制、偏移量或字段扩展），以支持筛选和数据调整。这些不会改变核心轮询逻辑。

创建触发器

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

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

更新轮询间隔

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

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

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

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

要更新轮询间隔：

1. 从产品启动器中选择“Orchestrator”。
2. 选择一个文件夹，然后导航到“连接”选项卡。
3. 在连接右侧，选择“更多操作” > “查看/编辑”以打开编辑连接页面。
4. 在“检查事件间隔：”下，选择时间间隔（以分钟或小时为单位）。轮询间隔必须大于 1 分钟，且不超过 24 小时或 1440 分钟。
5. 选择“更新”。

查看触发器运行历史记录

重要提示：

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

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

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

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

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

备注：

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

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

管理触发器

以下操作适用于在 Integration Service 中创建的触发器。

直接在 Orchestrator 中创建的触发器可以在 Orchestrator 中进行管理。

重命名触发器

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

1. Access the Triggers tab.
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 中的“表达式编辑器”查看任何触发器输出对象的所有可用属性。

限制

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

常见问题

如果连接中断，与该连接关联的触发器会发生什么情况?

如果连接断开，关联的触发器将暂时停止运行。成功重新连接后，触发器将自动恢复执行。作为附加步骤，请确保触发器未处于 “禁用”状态。

对于断开连接的触发器，如何将触发器输出与我的流程相关联？

有关如何检索有关连接器和触发流程的事件的数据的详细信息，请参阅事件参数部分。

您可以使用UiPath 事件对象ID 参数在流程中添加获取记录或HTTP 活动调用，以获取相应的记录数据。

备注：

这仅适用于断开连接的触发器。对于已连接的触发器，您在设计流程时应该已经准备好整个对象。

如何更改触发器的轮询间隔？

您可以直接在触发器配置中修改轮询间隔。有关详细步骤，请参阅本指南：更新轮询间隔。

我可以筛选触发自动化的记录吗？

是的。您可以（适用于支持数据筛选器的连接器）添加数据筛选器，以控制最终启动流程的记录。

备注：

Integration Service 提取记录后，将应用筛选器。

例如：

• 在 Studio Web 中创建筛选条件：

  

• 在 Orchestrator 中创建筛选器：

  

为什么触发器没有立即触发?

触发器执行时间可能会因触发器类型、数据量和机器人可用性而异。

对于基于轮询的触发器：

• 触发器根据在 Integration Service 中配置的轮询间隔获取新记录或更新的记录。

• 根据检索到的数据量，Integration Service 会应用任何已定义的筛选器或触发器条件，然后将符合条件的事件传递给Orchestrator 。

• 此处理可能会带来较小的延迟，尤其是在处理大型数据集或复杂的筛选器时。

• 将事件移交给 Orchestrator 后，仅当此时 Unattended Robot 可用时，才会启动自动化。

• 如果轮询间隔设置太长，则系统可能会一次检索大量数据，从而可能降低流程速度。在这种情况下，请考虑缩短间隔以提高性能。

  备注：

  如果触发器延迟显示，请检查轮询间隔，审核筛选器以提高效率，并确保有 Unattended Robot 可用来执行作业。

对于基于 Webhook 的触发器（例如，HTTP Webhook）：

• Webhook 触发器的设计目的是几乎立即触发 ，因为事件由外部应用程序直接发送到 Integration Service。
• 由于 Webhook 通常每个事务处理一个记录（一个事务） ，因此延迟很短。
• 但是，如果在将事件移交给 Orchestrator 之前应用了触发器筛选器或处理逻辑，您可能仍会观察到一小段延迟。

如何对未触发的触发器进行故障排除？

• 请验证关联的连接是否处于活动状态。
• 检查触发器是否已启用。
• 验证您的连接是否需要特定的作用域或角色才能访问轮询的目标 API 端点。
• 确认筛选器与预期数据匹配。
• 对于 Webhook 触发器，请确认 Webhook 注册在外部应用程序上有效。

触发器第一次选取记录的时间？

触发器的首次运行从创建触发器的时间开始。

根据触发器的筛选器，不会选取在创建触发器之前创建的记录，并且在触发器创建时间戳之后创建/更新的所有记录都符合处理条件。

在调试模式下，触发器何时首次选取记录？

在调试模式下，“开始事件触发器”（启动流程的触发器）会考虑过去 1 小时相对于配置时间的事件。