触发器

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

先决条件

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

• 已为租户启用并配置 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. 从下拉列表中选择 运行时许可证（用于执行触发器启动的作业的运行时）。 可用选项：“非生产”、“无人值守”、“无头”、“TestAutomation”、“AutomationCloud”、“Serverless”、“开发”。

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

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

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

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

备注：

事件监控当前设置为每 5 分钟轮询一次。 因此，最多可能需要 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. 选择“编辑”按钮，您可以为触发器选择新名称。

触发器详细信息视图

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

激活或停用触发器

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

限制

本节列出了 Integration Service 触发器的已知限制。

最大记录限制

描述

Integration Service 触发器目前的上限为每次触发器执行 1,000 个记录。 如果触发器尝试在配置的时间间隔（例如，一分钟或五分钟）内检索 1,000 多个记录，并且供应商系统发出的记录数量超过此限制，则不会捕获任何超过阈值的记录，并且可能会丢失。

影响

此限制可能会影响需要处理大型数据集的工作流或自动化，因为触发器可能无法检索所有记录。

解决方法

我们正在积极努力解决此限制。 在此之前，为了将影响降到最低，您可以将触发间隔配置为尽可能短的持续时间，如轮询间隔中所述。 提高触发器执行的频率可确保在多次触发器运行中捕获所有记录。

自动禁用触发器

在轮询新事件或更新的事件期间，如果触发器连续遇到 100 个由第三方应用程序问题导致的错误，系统将自动禁用该触发器。 此机制有助于保持系统稳定性。

禁用其中一个触发器后，您将收到一封电子邮件通知。 在修复导致错误的基本问题后，您必须手动重新启用触发器。

编辑触发器

当前不支持编辑现有触发器。 触发器管理的唯一选项是创建或删除触发器。 对于任何所需的更改，您必须删除现有触发器并添加新触发器。