- 入门指南
- 最佳实践
- 租户
- Cloud Robots
- 文件夹上下文
- 自动化
- 流程
- 作业
- Apps
- 触发器
- 日志
- 监控
- 队列
- 资产
- 业务规则
- 存储桶
- 索引
- Orchestrator 测试
- 资源目录服务
- 集成
- 故障排除

Orchestrator 用户指南
管理作业
在完成以下步骤之前,您需要 创建一个流程。
设置作业优先级
选择执行运行时
从“Runtime 类型”下拉列表中,选择用于执行作业的运行时类型。
下拉列表下方会显示可用和已连接的运行时数量。
- “_ 可用” - 可用的运行时数量,以运行时总数减去正在运行的作业数计算得出。
-
“_ 已连接”- 运行时总数,以连接到与活动文件夹关联的 Orchestrator 的所有计算机上的运行时总和计算得出。
Runtime 类型
描述
Production (Unattended)
使用无人值守运行时以无人值守模式执行作业。
测试
使用测试运行时以无人值守模式执行作业。
应用程序测试
使用应用测试 runtime 以 Unattended 模式执行作业。
重要提示:应用测试 runtime 只能执行以下操作:- 来自测试自动化项目的应用程序测试用例。
- 使用应用测试开发者许可证创建的用于应用测试的 non-production 流程。
非生产
使用非生产运行时以无人值守模式执行作业。
Cloud - Serverless 测试
该作业在配置为在测试环境中运行的 Serverless Robot 计算机上以 Unattended 模式执行。所需的 Robot Units 数量特定于测试环境,并取决于 Serverless Robot 计算机的规格以及执行作业所需的分钟数。
有关更多详细信息,请参阅 Robot Units - 消耗。
Cloud - Serverless
该作业在配置为在生产环境中运行的 Serverless Robot 计算机上以 Unattended 模式执行。所需的 Robot Units 数量特定于生产环境,并取决于无服务器机器人计算机的大小以及执行作业所需的分钟数。
有关更多详细信息,请参阅 Robot Units - 消耗。
Cloud - VM 测试
该作业在配置为在“测试”或“Non-production”环境中运行的 Cloud VM 上以 Unattended 模式执行。运行虚拟机会使用测试环境中的 Robot Units。
有关更多详细信息,请参阅 Robot Units - 消耗。
Cloud - VM
该作业在配置为在生产环境中运行的云虚拟机上以 Unattended 模式执行。运行虚拟机会使用生产环境中的 Robot Units。
有关更多详细信息,请参阅 Robot Units - 消耗。
示例:假设计算机模板 A 有 2 个非生产运行时和 1 个无人值守运行时,计算机模板 B 有 3 个非生产运行时和 2 个无人值守运行时。两个模板都与一个文件夹相关联。在每个模板上,您连接一台主机。产生的运行时状态如下:
- 无人值守:
3 Available, 3 Connected
- 非生产:
5 Available, 5 Connected
占用一个运行时的正在运行的作业会从该类型的可用运行时数中减去 1。
在发布时,Orchestrator 从可用的个人工作区运行时中选择来执行作业。 运行时优先级如下:
- Production (Unattended)
- 非生产
例如,如果不存在 Production Runtime,则 Orchestrator 将使用可用的 NonProduction Runtime。如果不存在,则作业将失败。
如果所选运行时在作业执行之间变得不可用,则即将执行的作业将失败,因为 Orchestrator 不会查找下一个可用的作业。
配置执行目标
根据需要在“开始作业”窗口的“执行目标”部分设置选项,以配置执行目标。
动态分配
选择不对帐户和计算机进行明确选择的动态分配,可以在首先可用的帐户和计算机下多次执行前台流程。只要有足够的 runtime,无论帐户是否繁忙,后台流程都可以在任何帐户上执行。
使用此选项,最多可以在一个作业中执行一个流程 10000 次。
帐户
您可以选择以下方法之一:
- 指定帐户意味着系统将在该特定用户或机器人帐户下执行流程。
- 同时指定帐户和计算机意味着在该特定帐户-计算机对上启动作业。仅可选择有效的帐户-计算机对。
- 如果未指定帐户,则 Orchestrator 会动态分配帐户。
计算机
您可以选择以下方法之一:
- 指定计算机对象意味着将在所选计算机模型附加的一台主机上执行该流程。从下拉列表中的已连接主机池中选择特定主机。
- 同时指定帐户和计算机意味着在该特定帐户-计算机对上启动作业。仅可选择有效的帐户-计算机对。
- 如果未指定计算机,则 Orchestrator 会动态分配主机。
确保将与作业类型匹配的运行时分配给关联的计算机模型。仅显示与活动文件夹关联的已连接主机。
选择有效帐户 - 计算机映射
选择将运行作业的特定帐户-计算机对。如果希望在多个此类对上运行作业,您可以单击“添加帐户-计算机映射”。如果执行此操作,将为每个帐户-计算机对创建一个“待处理”作业。
启用 Healing Agent
要接收建议和调试信息,了解如何修复在执行作业期间可能出现的问题,请打开“启用 Healing Agent”切换开关。此外,还可以选择“启用 Healing Agent 自我修复”选项,以便 Healing Agent 独立修复作业执行问题。有关 Healing Agent 及其功能的详细信息,请参阅 Healing Agent 文档。
在作业恢复时保持帐户/计算机分配
此设置可用于配置是否在同一帐户-计算机对上执行长时间运行作业的不同片段。
默认情况下,暂停的作业将在任何可用计算机上的任何可用机器人上恢复。
根据您的许可证或资源要求,您可以选择在启动作业的同一台计算机上和相同的帐户上下文中恢复作业。
假设您需要 SAP 许可证才能执行作业。您可以在单台计算机上安装 SAP 许可证,并使用该计算机来启动和继续作业,而不必在每台可用的计算机上安装 SAP 许可证(这样会增加成本)。相同的策略可能适用于用户许可证。您只能分配一个用户许可证,并使用它来执行作业。
计划结束作业执行
流程执行有时可能会出错,从而导致作业保持挂起状态。 打开切换开关后,您可以(单击以展开):
- 从下拉菜单中选择“停止”- 这会在作业一直处于“待处理”状态以来经过已定义的时间间隔后尝试正常结束执行(可设置的最短时间为 1 分钟,最长时间为 10 天 23 小时 59 分钟)。
- 从下拉菜单中选择“终止”- 这会在作业一直处于“待处理”状态以来经过已定义的时间间隔后尝试强制结束执行(可设置的最短时间为 1 分钟,最长时间为 10 天 23 小时 59 分钟)。
- 从下拉菜单中选择“停止”,并启用“如果作业未停止,则计划自动‘终止’”选项 - 这会在作业一直处于“待处理”状态以来经过已定义的时间间隔后尝试正常结束执行,然后在作业一直处于“正在停止”状态以来经过已定义的时间间隔后尝试强制结束作业(可设置的最短时间为 1 分钟,最长时间为 10 天 23 小时 59 分钟)。
在作业停留在待处理状态或已恢复状态时生成警示
通过打开切换开关,您可以激活有关保持挂起或恢复状态超过指定持续时间的作业的警示。
可配置的持续时间最短为一分钟,最长为十一天。
如果作业时长超过配置的持续时间,则会弹出“错误”严重性警报,并使用以下文本通知您:
"#process {process_number} 的 N 个作业已挂起或恢复超过 X 小时 Y 分钟。", 其中:
- N - 触发警示的作业编号
- {process_number} - 流程标识符
-
X - 作业处于挂起或已恢复状态时超出的配置小时数;天将转换为小时。
- Y - 作业处于挂起或已恢复状态时超过的配置分钟数。
如果作业已开始但尚未完成,则生成警示
通过打开开关,您可以激活有关未在指定持续时间内完成的作业的警示。
可配置的持续时间最短为一分钟,最长为十一天。
如果作业时长超过配置的持续时间,则会弹出“错误”严重性警报,并使用以下文本通知您:
“#process {process_number} 的作业已运行超过 X 小时 Y 分钟”,其中:
- {process_number} - 流程标识符
-
X - 作业尝试完成时超出的配置小时数。天将转换为小时。
- Y - 作业尝试完成时超出的配置分钟数。
Orchestrator 会阻止使用无效配置启动作业。尝试在无效的设置中启动作业会导致显示描述性错误消息,为您提供有关如何修复配置的详细信息。
使用动态分配(即不指定计算机或帐户)和不兼容的文件夹设置开始作业会导致错误。请务必更正设置,否则作业将无限期保持待处理状态。例如,当文件夹中只有跨平台模板时,尝试运行 .NET Framework 4.6.1 后台作业将会失败,因为在修复配置之前,作业将保持待处理状态。
添加参数
在“开始作业”窗口的“runtime 参数”部分,配置以下设置:
-
选择入口点。如果流程不支持多个入口点,Orchestrator 将在“入口点”下拉列表中显示“默认”,您无法进行选择。
有关详细信息,请参阅“入口点”。
-
为选定流程提供输入参数。该表格将自动填充选定流程接受的所有输入参数以及继承自包的对应值。
在执行以下步骤之前,您需要创建一个流程。
- 在流程所在的文件夹中导航到“自动化”,然后选择“作业”。
- 单击“开始”。系统将显示“开始作业”窗口。
- 从“流程名称”下拉列表中,选择一个先前已部署到当前文件夹的流程。要仅在显示下拉列表中显示智能体,请使用筛选类型筛选器,然后选择智能体。
- 配置必填字段,如下面的部分所述。
- 单击开始。“开始作业”窗口将关闭,系统将根据您进行的设置开始作业。作业状态将实时显示在“作业”页面上。
配置执行目标
在“开始作业”窗口的“执行目标”选项卡中根据需要设置选项,配置您的执行目标。
计划结束作业执行
流程执行有时可能出现错误,导致作业保持待处理状态。打开切换按钮,则可以:
- 从下拉菜单中选择“停止”- 这会在作业一直处于“待处理”状态以来经过已定义的时间间隔后尝试正常结束执行(可设置的最短时间为 1 分钟,最长时间为 10 天 23 小时 59 分钟)。
- 从下拉菜单中选择“终止”- 这会在作业一直处于“待处理”状态以来经过已定义的时间间隔后尝试强制结束执行(可设置的最短时间为 1 分钟,最长时间为 10 天 23 小时 59 分钟)。
- 从下拉菜单中选择“停止”,并启用“如果作业未停止,则计划自动‘终止’”选项 - 这会在作业一直处于“待处理”状态以来经过已定义的时间间隔后尝试正常结束执行,然后在作业一直处于“正在停止”状态以来经过已定义的时间间隔后尝试强制结束作业(可设置的最短时间为 1 分钟,最长时间为 10 天 23 小时 59 分钟)。
如果作业已开始但尚未完成,则生成警示
通过打开开关,您可以激活有关未在指定持续时间内完成的作业的警示。
可配置的持续时间最短为一分钟,最长为十一天。
如果作业时长超过配置的持续时间,则会弹出“错误”严重性警报,并使用以下文本通知您:
“#process {process_number} 的作业已运行超过 X 小时 Y 分钟”,其中:
- {process_number} - 流程标识符
- X - 作业尝试完成时超出的配置小时数。天将转换为小时。
- Y - 作业尝试完成时超出的配置分钟数。
Orchestrator 会阻止使用无效配置启动作业。尝试在无效的设置中启动作业会导致显示描述性错误消息,为您提供有关如何修复配置的详细信息。
帐户
您可以选择以下方法之一:
- 指定帐户意味着系统将在该特定用户或机器人帐户下执行流程。
- 如果未指定帐户,则 Orchestrator 会动态分配帐户。
Defining the environment configuration for coded agent jobs
To specify environment variables for a coded agent job, use the Environment Configuration text field. Coded agents are indicated as (Agent - <programming language>) in the user interface.
You can use the Environment Configuration field to reference secrets, such as API keys, using one of the following methods:
- Enter the secret value directly
in the Environment Configuration field, as shown in the following
example:You can enhance the security of secrets by having asterisks displayed instead of the secret value in the following scenarios:
SECRET=Abc@123
SECRET=Abc@123- Starting a job with the environment configuration inherited from the underlying process.
- Restarting a job.
ACCESS_KEY
API_KEY
AUTH
CREDENTIALS
PASSWORD
PRIVATE_KEY
SECRET
SESSION
TOKEN
- Reference a secret-type asset
located in the same folder as the agent, as shown in the following
example:
MySecret=%ASSETS/SECRET%
MySecret=%ASSETS/SECRET%备注:- Typing
=%
after the secret key displays anASSETS/
autocompletion suggestion. Accepting the suggestion displays a drop-down list of assets from which you can select the desired item. - You cannot retrieve secrets from external credential stores when using a disconnected credential proxy.
- Typing
添加参数
如果包具有输入和/或输出参数,这些参数将显示在“输入”和“输出”选项卡下的“runtime 参数”部分。参数值继承自包,但您可以根据需要对其进行编辑。
在执行以下步骤之前,您需要创建一个流程。
- 在流程所在的文件夹中导航到“自动化”,然后选择“作业”。
- 单击“开始”。系统将显示“开始作业”窗口。
- 从“流程名称”下拉列表中,选择一个先前已部署到当前文件夹的流程。要仅在下拉列表中显示智能体流程,请使用“筛选类型”筛选器,然后选择“智能体流程”。
- 配置必填字段,如下面的部分所述。
- 单击开始。“开始作业”窗口将关闭,系统将根据您进行的设置开始作业。作业状态将实时显示在“作业”页面上。
配置执行目标
在“开始作业”窗口的“执行目标”选项卡中根据需要设置选项,配置您的执行目标。
计划结束作业执行
流程执行有时可能会出错,从而导致作业保持挂起状态。 打开切换开关后,您可以(单击以展开):
- 从下拉菜单中选择“停止”- 这会在作业一直处于“待处理”状态以来经过已定义的时间间隔后尝试正常结束执行(可设置的最短时间为 1 分钟,最长时间为 10 天 23 小时 59 分钟)。
- 从下拉菜单中选择“终止”- 这会在作业一直处于“待处理”状态以来经过已定义的时间间隔后尝试强制结束执行(可设置的最短时间为 1 分钟,最长时间为 10 天 23 小时 59 分钟)。
- 从下拉菜单中选择“停止”,并启用“如果作业未停止,则计划自动‘终止’”选项 - 这会在作业一直处于“待处理”状态以来经过已定义的时间间隔后尝试正常结束执行,然后在作业一直处于“正在停止”状态以来经过已定义的时间间隔后尝试强制结束作业(可设置的最短时间为 1 分钟,最长时间为 10 天 23 小时 59 分钟)。
如果作业已开始但尚未完成,则生成警示
通过打开开关,您可以激活有关未在指定持续时间内完成的作业的警示。
可配置的持续时间最短为一分钟,最长为十一天。
如果作业时长超过配置的持续时间,则会弹出“错误”严重性警报,并使用以下文本通知您:
“#process {process_number} 的作业已运行超过 X 小时 Y 分钟”,其中:
- {process_number} - 流程标识符
- X - 作业尝试完成时超出的配置小时数。天将转换为小时。
- Y - 作业尝试完成时超出的配置分钟数。
Orchestrator 会阻止使用无效配置启动作业。尝试在无效的设置中启动作业会导致显示描述性错误消息,为您提供有关如何修复配置的详细信息。
帐户
您可以选择以下方法之一:
- 指定帐户意味着系统将在该特定用户或机器人帐户下执行流程。
- 如果未指定帐户,则 Orchestrator 会动态分配帐户。
添加参数
如果包具有输入和/或输出参数,这些参数将显示在“输入”和“输出”选项卡下的“runtime 参数”部分。参数值继承自包,但您可以根据需要对其进行编辑。
从作业的“更多操作”菜单中,选择“停止”。Orchestrator 将作业的状态标记为“正在停止”,并向机器人发送通知,但自动化项目将继续执行。
true
结果。您可以将此结果作为标记,以确定何时调用“停止作业”活动,从而启动正常关闭流程。
如果未找到“停止作业”活动,作业执行在项目结束时才会停止。最终作业状态为“成功”。
- 从 Orchestrator 启动的作业只能从 Orchestrator 停止。
- 从 Assistant 启动的作业既可以从 Orchestrator 的“作业”页面停止,也可以使用 UiPath™ Assistant 停止。
- 作业已停止后,作业结束计划将丢失,您需要在重新启动作业时重新配置“计划结束作业执行”选项。
单击相应的更多操作按钮,然后单击终止。自动化项目被强制停止,该作业被标记为已停止,并且作业详细信息窗口中显示作业“已取消”。
- 从 Orchestrator 启动的作业既可以从 Orchestrator 的“作业”页面终止,也可以使用 UiPath Assistant 终止。
- 从 Assistant 启动的作业既可以从 Orchestrator 的“作业”页面终止,也可以使用 UiPath Assistant 终止。
- 作业被终止后,作业结束计划将丢失,您需要在重新启动作业时重新配置“计划结束作业执行”选项。
此功能使您可以快速从作业列表运行作业,而无需完成作业配置流程。您可以重新开始任何处于最终状态(已停止、发生故障或成功)的作业。
- 您无法重新启动由代理程序(例如 Assistant)或通过 Studio 远程调试会话触发的作业。
- 当您重新启动已启用“计划结束作业执行”选项的作业时,您需要重新配置这些选项。
此过程首先假设您先前启动了已达到最终状态的作业。
- 单击相应的更多操作按钮,然后单击重新启动。系统将显示开始作业窗口,其中包含作业的初始设置。
- 进行所需的更改。
- 单击“开始”。“开始作业”窗口将关闭,作业会开始执行。作业状态实时显示在“作业”页面上。
-
当侧面板打开时,您可以单击列表中的任何作业以显示其面板中包含的所有选项卡的特定详细信息。作业列表网格可以水平滚动,同时根据您的特定屏幕尺寸和分辨率,让“流程”列保持固定。请注意,您可以增加某些列的大小,从而显示滚动条以便于访问。
-
您可以单击任何选项卡右上角的展开图标,以将其作为完整大小的窗口打开,并在面包屑导航中标明基础流程的名称。同一角落的“折叠”按钮可将窗口恢复到侧面板状态。
-
作业详细信息不包括失败的作业的许可注意事项。请使用监控功能获取有关许可证的详细信息。
要查看有关特定作业的详细信息,请单击相应的“详细信息”按钮。这将显示一个包含“作业详细信息”部分的侧面板,为您提供各种信息,例如:
- 基础包的名称
- 用于执行作业的入口点
- 执行机器人和计算机
- 作业开始时间和结束时间
- 作业失败的原因
- 作业无法开始的原因
- 用于修复任何问题并触发作业开始的操作
对于智能体和智能体流程作业,作业详细信息面板包含“追踪”选项卡。“追踪”提供了作业运行、输入和输出以及与运行相关的任何其他已调用资源或已执行作业的全面分层视图。
追踪视图还允许您对任何追踪项目提供正面或负面反馈以及评论。
在 SAP 租户的上下文中,您可以使用“返回到 SAP 按钮”返回到 SAP Build 流程自动化中的流程。
要查看特定作业的日志,请单击相应的“详细信息”按钮。这将显示一个侧面板,其中包括“日志”部分,以及有关所选作业的数据。
要手动刷新作业日志,请在作业侧面板的“日志”部分选择“刷新”按钮。
对于既不处于“待处理”状态也不处于最终状态的作业,您可以选择以 10 秒为间隔自动刷新作业日志。要启用该选项,请在作业侧面板的“日志”部分中选择“刷新”旁边的下拉列表,然后选择“启用自动刷新”。“刷新”按钮会更改外观以确认您的选择。即使刷新浏览器窗口,该选项也会在以后的作业中保留。
作业日志会自动刷新,直到作业达到最终状态后的一分钟为止。此时,您无法再选择“启用自动刷新”,手动刷新日志成为唯一可用的选项。
要查看恢复暂停的作业所需的触发器,请单击相应的“详细信息”按钮。这将显示一个包括“恢复条件”选项卡的侧面板,其中包含为所选作业配置的工作流任务的详细信息。
您可以单击列表以访问其他作业的触发器。
要查看作业执行的视频录制以及基础日志,请单击相应的“详细信息”按钮。这将显示一个侧面板,其中包括“视频时间线”选项卡,顶部是视频窗格,底部是日志列表。
您也可以通过单击同一面板的“日志”选项卡上的“打开录制”来访问此选项卡。
有关详细信息,请参阅视频录制专用主题。
要下载出现故障的作业的记录,请单击“更多选项”>“下载录制”。将下载根据您的设置生成的执行介质。