触发器

触发器提供了一种统一机制，用于从连接器平台订阅事件。 它使您可以灵活地在 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。
• “集成”窗口中将显示“触发器”选项卡。
• 您已在 Orchestrator 实例中设置了一个无人值守或非生产机器人。
• 您正在使用新式文件夹（定义触发器时，传统文件夹中的流程不可见）。

注意：仅新式文件夹支持触发器。 传统文件夹不支持新式用户身份范例，因此不能支持一般连接或触发器。

创建流程

像往常一样在UiPath™ Studio 中创建流程。 使用 Integration Service，可以为任何流程触发任何自动化。

要接收记录的详细信息，请执行以下步骤：

• 如果您想知道在工作流中触发流程的实际连接器、事件、记录类型或记录，可以在流程中定义以下类型为 String 的输入参数。

  Integration Service 将在启动作业时自动填充这些字段。

  • UiPath 事件连接器
  • UiPath 事件
  • UiPath 事件对象类型
  • UiPath 事件对象 ID
    注意：请 在此处 详细了解 参数 的工作原理和管理方法。
• 要检索和处理在作业运行中具有触发器的记录，请使用 UiPath 事件对象 ID 输入参数从源系统检索记录。

以下是 Integration Service 如何传递输入参数值的示例。

发布流程

像往常一样，将流程发布到 Orchestrator。 您可以将其发布到共享文件夹或个人工作区。 确保在包中创建流程。

配置触发器

要添加触发器，请执行以下步骤：

1. 访问Automation Cloud ^TM 。
2. 在左侧菜单中，选择“Integration Service” 。 “Integration Service”窗口包含三个单独的选项卡：“连接器”、“连接” 和“触发器”。
3. 访问“触发器”选项卡，然后选择“添加触发器”按钮。
4. 从各自的下拉菜单中选择所需的“连接器”和“连接” 。如果为该特定连接器仅为一个配置，则系统会自动选择该连接器。

5. 从相应的下拉菜单中选择所需的 事件 和 记录 。

   注意： 事件类型可能因连接器而异。
6. 接下来，选择要执行的流程。

7. 从下拉列表中选择运行时许可证（用于执行触发器启动的作业的运行时）。

   显示的运行时列表基于从 Orchestrator 收到的响应，即已向该文件夹“分配”的运行时许可证。对于选定的运行时，将显示一条消息，指示分配的运行时数量。有关更多信息，请参阅在 Orchestrator 中管理触发器和Runtime（机器人许可证）文档。
8. 选择“添加触发器”按钮以创建触发器并激活它。

或者，您可以从“连接”选项卡中创建新的触发器。为完成此操作，请执行以下操作：

1. 选择连接的“更多操作”按钮。
2. 选择“添加触发器” 选项。
3. 从相应的下拉菜单中选择所需的 事件 和 记录类型 。 在这种情况下，“连接器”和“连接”已被选中，无法更改。
4. 在右侧，选择 要执行的流程 和相应的 运行时许可证。

5. 选择“添加触发器”按钮以创建触发器并激活它。

备注：

事件监控当前设置为每五分钟轮询一次。因此，关联的流程最多可能需要五分钟才能启动。

您可以在 Orchestrator 文件夹的“作业”选项卡下查看作业的详细信息。 从 Integration Service 启动的作业将其来源显示为 集成触发器。

Events

连接器通过轮询机制支持事件。 大多数连接器目录都支持此操作。

Integration Service 支持以下两种类型的事件：

1. 通用，表示典型的“创建”、“更新”和“删除”操作。 选择一般事件时，还必须定义要监控的事件记录。 例如，为 日历 记录 创建记录 。

2. 预定义，表示对特定对象的特定操作。 例如，已创建 日历活动。

有关事件的更多信息，请参阅每个连接器的页面。

数据筛选器

为触发器定义事件时，可以添加更具体的筛选。

使用 数据筛选器，您可以配置与特定数据模式匹配的触发器。 这意味着更少的机器人启动次数，并且不必在自动化中应用额外的筛选。

轮询间隔

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

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

“可调整轮询间隔”字段用于自定义事件触发器检查新对象事件的间隔。

重要提示： 即使每个连接可以设置多个触发器，每个连接也只能有一个轮询间隔。 更改轮询间隔会影响连接上的所有关联触发器。

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

更改轮询间隔

您可以从特定连接器的页面或“连接”选项卡更改轮询间隔。

1. 在Automation Cloud ^TM中，访问Integration Service 。
2. 转到“连接器” 页面并选择一个连接器。
3. 在连接器的页面中，选择一个连接以打开连接详细信息页面。

4. 选择在连接名称下找到的间隔，如下所示。 仅对于已添加触发器的连接显示轮询间隔。

   
   

   

   
   

或者，您可以从“连接”选项卡配置轮询间隔：

1. 在Integration Service中，转到“连接”选项卡。
2. 选择特定连接以打开连接详细信息页面。
3. 选择在连接名称下找到的间隔。
4. 系统将显示“更新轮询间隔” 窗口。

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

   
   

   

   
   

   如果输入了不正确的值，以下错误消息会警告您：“轮询间隔必须是 1 到 1440 分钟或 24 小时之间的自然数。”

6. 选择“更新间隔” 。

触发器运行历史记录

您只需在“触发器”选项卡中选择触发器，即可查看触发器的运行历史记录。 在新页面中，尝试历史记录显示在界面的下部。

此历史记录显示 Integration Service 收到的事件以及流程是否已成功启动，在这种情况下，它会在“状态 ”列中显示“成功 ”一词。

注意： “成功”状态仅表示作业已成功启动。 它并不反映作业是否已成功执行到底。

重要提示： 如果作业无法启动，则其 状态 将显示为 Failed 。 将鼠标光标悬停在“失败” 状态上以查看错误消息。

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

删除触发器

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

重命名触发器

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

1. 访问“触发器”选项卡。

2. 将鼠标光标悬停在要修改的触发器的名称上。 系统将显示编辑按钮。

   注意： 或者，您可以从列表中选择触发器以访问详细视图。 “编辑”按钮位于触发器名称的右侧。
3. 选择“编辑”按钮，您可以为触发器选择新名称。

触发器详细信息视图

选择触发器以查看其详细信息。

激活或停用触发器

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

限制

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