触发器

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

先决条件

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

• 已为租户启用并配置 Integration Service。
• “集成”窗口中将显示“触发器”选项卡。
• 您已在 Orchestrator 实例中设置了一个无人值守或非生产机器人。

• 您正在使用新式文件夹（定义触发器时，传统文件夹中的流程不可见）。

  备注：

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

创建流程

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

要接收记录的详细信息，您还可以按照以下指示操作：

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

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

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

以下示例说明了 Integration Service 如何传递 输入参数值 。

发布流程

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

配置触发器

要添加触发器，您必须：

1. 访问 Automation Cloud。
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. 预定义，表示对特定对象的特定操作。 例如，日历事件已创建。

   
   

   

   
   

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

数据筛选器

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

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

轮询间隔

当您创建新连接并在该连接上设置事件触发器时，轮询间隔默认设置为 5 分钟。

您可以使用“可调轮询间隔”功能自定义此间隔，该功能允许您选择事件触发器检查新对象事件的间隔。

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

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

更改轮询间隔

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

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

4. 单击连接名称下的间隔，如下所示。 仅对添加了触发器的连接显示轮询间隔。

   
   

   

   
   

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

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

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

   
   

   

   
   

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

7. 单击 “更新间隔” 。

触发器运行历史记录

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

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

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

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

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

删除触发器

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

触发器详细信息视图

只需单击触发器即可查看其详细信息。

激活/停用触发器

要激活或停用触发器，您首先必须单击它以查看其详细信息。 然后单击窗口左上角的开关。

失败时自动禁用触发器

如果在对单个事件进行 11 次尝试（约 34 小时）后无法启动作业，或者在最近 100 个事件中作业无法启动，则触发器将被禁用并设置为错误状态。

使用指数回退策略完成每个事件的 10 次重试。 每次后续重试时，延迟时间是上次尝试的两倍。

重命名触发器

请按照以下步骤重命名触发器：

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

2. 将鼠标光标悬停在要修改的触发器的名称上，您现在应该会看到“编辑” 按钮显示。

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