触发器

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

概述

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

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

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

先决条件

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

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

更新轮询间隔

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

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

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

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

要更新轮询间隔：

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

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

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

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

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

查看触发器运行历史记录

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

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

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

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

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

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

管理触发器

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

重命名触发器

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

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

限制

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