运行作业

UiPath.Activities.System.Jobs.RunJob

描述

使用运行作业活动轻松启动其他自动化，例如 RPA 工作流或智能体流程。此单个活动会合并从工作流中启动自动化的现有活动。您可以选择要启动的项目类型，活动会根据您的选择调整其行为。

重要提示：

• 在配置此活动之前，所选自动化必须存在于 Orchestrator 文件夹中。这不适用于使用解决方案资源的用户。
• 更新自动化后，请确保重新发布该自动化，并将相应的流程重新部署到 Orchestrator 文件夹。

项目兼容性

Windows | 跨平台

Windows、跨平台配置

• 活动主体属性：

  • “Orchestrator 文件夹路径” — 将要启动的自动化部署到的 Orchestrator 文件夹。只有您可以访问的文件夹才会显示在下拉菜单中。此属性是否可用取决于上下文：
    • 在解决方案之外— 该属性始终可用。如果未选择文件夹，则使用您的个人工作区。
    • 在解决方案中，将流程名称设置为解决方案资源— 该属性可见，但为只读状态，因此不会被考虑在内。
    • 在解决方案中，将流程名称设置为变量— 您可以使用此属性来选择目标 Orchestrator 文件夹。
  • 流程名称— 选择与要运行的自动化相关联的流程。系统将显示所有类型的流程：RPA、智能体、智能体编排。如果系统未列出您需要的流程，请选择“管理流程”以重定向到您在 Orchestrator 中的文件夹，您可以在其中添加缺少的流程。
  • 输入参数— 配置要传递到所选流程的参数。可通过属性旁边的图标使用三种输入模式：

    • “使用架构” （默认）—自动导入流程参数架构，并生成可使用数据映射器编辑的自定义数据类型。“输出参数”属性将单独显示。要检索最新的流程参数列表，请选择属性右侧的“刷新” 。

      重要提示：

      为获得最佳体验，请确保您使用最新的 Studio 版本。2025.0.161 之前的 Studio 版本使用“表达式编辑器”窗口。以下代码片段显示了如何使用 VB.NET 和 C# 为智能体输入参数提供值：

      'VB.NET
      New Email_Rewriter_Input() With {
      .feedback = "sample feedback",
      .originalEmail = "sample email content"
      }
      

      //C#
      new Email_Rewriter_Input {
      feedback = "sample feedback",
      originalEmail = "sample email content"
      }
      

    • 使用参数— 参数微件，其中每个条目都有“名称”、“值”和“方向（输入/输出）”。输入和输出参数均在此处配置。“输出参数”属性在此模式下隐藏，通过将“方向” 设置为“输出” 的条目接收输出值。

    • “使用对象” — 接受任何变量或对象表达式作为输入，这些输入将在运行时进行 JSON 序列化并传递给流程。JSON 字符串按原样传递。“输出参数”属性仍单独显示。

• 属性面板：

  • 执行模式— 选择活动等待作业完成的方式。可选择以下选项：
    • 不等待— 该活动将启动作业，并允许工作流无需等待作业完成即可继续运行。
    • 等待作业完成— 默认选项。该活动会暂停工作流，直到已启动的作业完成或达到超时。如果作业成功完成，则活动将返回输出，并且工作流将继续。
      备注：

      此执行模式利用 Orchestrator SignalR 功能实时完成确认作业。可以在“Orchestrator 设置”中在“租户级别”启用此功能。如果禁用 SignalR，则此执行模式将默认为 30 秒轮询。

    • “暂停执行直至作业完成” — 该活动暂停工作流，并持久等待输出。
  • “超时（毫秒）” — 设置等待作业完成的最长时间（以分钟为单位）。默认值为 600,000 毫秒（10 分钟）。
  • 出错时继续— 指定在活动抛出错误时是否应继续自动化操作。该字段仅支持“布尔值”（true 和 false）。默认值为 False。因此，如果未配置该字段且活动引发错误，系统将停止执行项目。如果该值设为“True”，则无论出现何种错误，系统都将继续执行项目。
  • 作业失败时失败— 仅当执行模式为“等待作业完成”或“暂停执行直至作业完成”时，此属性才可用。指定在执行的 Orchestrator 作业完成并处于“发生故障”状态时，活动是否应引发异常。默认值为“关闭” 。设置为“开启”可在 Orchestrator 作业失败时引发异常并停止执行工作流。
  • “作业数据” — 显示已启动作业的对象。自动生成。
  • 输出参数— 显示流程在完成时返回的输出参数。此属性仅在使用“使用架构”或“使用对象”输入模式时显示。使用“使用参数”模式时，将通过“参数”微件中将“方向” 设置为“输出” 的条目捕获输出参数。如果从流程列表中选择流程，则输出对象包含所选流程的所有输出属性。如果您使用表达式提供流程，并且流程返回值，则必须使用“使用参数”选项配置输入和输出参数。

已知限制

当智能体流程抛出异常时，Maestro 会将 Orchestrator 作业保持在“正在运行”状态，期待 Maestro 能够在 Maestro 中处理异常。

结果：

• 运行作业活动未检测到故障。
• 当配置为“等待作业完成”时，它会：
  • 超时，或
  • 在暂留模式下无限期挂起，因为作业永远不会达到成功 的状态。

为避免此行为，请根据“运行作业”活动的执行模式，使用以下建议：

• 对于“等待作业完成” ，请应用与智能体流程的预期持续时间匹配的“超时” 。如果没有它，工作流将保持卡住状态，等待作业状态永远不会发生的更改。
• 使用“暂停执行直到作业完成” ，因为当您的工作流需要接收输出时，此模式效果最佳。智能体流程完成后，流程将自动继续。