触发器

触发器提供了一种统一机制，用于从连接器平台订阅事件。 它使您可以灵活地在 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 中管理触发器 和运行时 （机器人许可证） 文档。
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 窗口中的“ 触发器 ”选项卡。单击与触发器对应的“更多操作” 按钮，然后选择“删除”。

触发器详细信息视图

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

激活/停用触发器

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

失败时自动禁用触发器

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

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

重命名触发器

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

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

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

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

限制

我们目前不通过 Swagger 公开 Integration Service API。