UiPath.Settings 文件说明

UiPath.Settings 文件说明

UiPath.Settings 文件包含有关机器人如何执行流程的所有必要详细信息。您可通过直接编辑该文件和相应字段来修改这些设置。另一方面，您也可通过 Orchestrator 来修改这些设置。这是通过“设置”选项卡完成的。

备注：

请注意，修改这些设置需要本地系统和管理员权限。如要使更改生效，请务必重启 UiPath 机器人服务（此操作需要管理员权限），并关闭机器人托盘。

在用户模式下部署机器人时，UiPath.Settings 文件存储在 %localappdata%\UiPath\ 文件夹中，在服务模式下部署机器人时，该文件存储在 %programdata%\UiPath\ 文件夹中。当 UiPath 机器人服务首次启动时，系统便会创建此文件。该文件包含以下参数：

参数	描述
NuGet API 密钥	NuGet 订阅源的 API 密钥。 未连接到 Orchestrator 时，如果您使用的是本地订阅源，则不需要 API 密钥。 如果使用私有的 MyGet 订阅源，请注意此参数为必填项。 连接到 Orchestrator 时，不会考虑此值。
NuGet 服务器 URL	将项目推送到以及从中检索项目的位置。此参数可以是本地订阅源（例如文件系统路径），也可以是使用 NuGet 协议（NuGet、MyGet 等）的网页订阅源。 未连接到 Orchestrator 时，默认值为 %ProgramData%\UiPath\packages（用户模式）或 `%。如果您使用私有 MyGet 订阅源，请使用“预验证的 V2 URL（无基本身份验证）”下提供的 URL。请注意，这不是 MyGet 的免费服务。 当连接到 Orchestrator 时，不考虑此值。
活动订阅源	活动的存储地址。只有在您未连接到 Orchestrator 时，系统才会填充此字段。其默认值为 ~/NuGetPackages/Activities。如果已连接到 Orchestrator，则不考虑此字段。在此页面上，详细了解活动订阅源，以及基于机器人部署类型安装包的位置。
UiPath 服务器 URL	Orchestrator 实例的地址。 未连接到 Orchestrator 时，此参数为空。 连接到 Orchestrator 时，系统会自动填充您在“Orchestrator 设置”窗口中提供的 URL。
追踪级别	机器人应记录信息的级别。以下选项可用：Verbose、Trace、Information、Warning、Error、Critical 和 Off。 您也可以在 Orchestrator 设置窗口的“级别”下拉列表中更改此设置。
低级别追踪	指示是否在跟踪级别记录信息，以帮助您对崩溃和错误进行故障排除。默认情况下，此参数设置为 false。要启动低级别跟踪，请将此参数的值设置为 true。您还可以在命令行中更改此值。
安全许可证密钥	用于连接到 Orchestrator 的计算机密钥。UiPath.settings 文件中的密钥均经过 DPAPI 加密处理。您也可通过“Orchestrator 设置”窗口填写和修改此值。如果未连接到 Orchestrator，则此参数应为空。
登录到控制台	允许机器人连接到安装机器人的计算机的控制台会话。 此外，它还会指示是否可以使用多个用户（高密度机器人）将多个机器人连接到 Orchestrator。 其默认值为 true。要启用 High-Density Robots，请将值设置为 false。
分辨率宽度	计算机的显示分辨率宽度。此选项默认设置为 0，这意味着系统会自动检索并使用检测到的分辨率宽度。您可以使用自定义值，前提是工作站支持该值。
分辨率高度	机器的显示分辨率高度。此选项默认设置为 0，这意味着系统会自动检索并使用检测到的分辨率宽度。您可以使用自定义值，前提是工作站支持该值。
分辨率深度	机器的显示分辨率深度。此选项默认设置为 0，这意味着系统会自动检索并使用检测到的分辨率深度。您可以使用自定义值，前提是工作站支持该值。
字体平滑	提高文本识别能力。如果设为“True”，则启用 RDP 连接上的“字体平滑”选项。这意味着目标计算机将启用“ClearType”。
ConnectionString	Orchestrator 中生成的字符串，可用于在不提供“计算机名称”和“计算机密钥”的情况下将机器人注册到该平台。
禁用工作流执行	启用此参数后，您将无法通过命令行执行流程。系统默认会隐藏并禁用此功能。
webProxySettings	用于配置 Robot 代理设置的参数。有关更多信息，请参阅通过代理重定向机器人文档。

UiPath Robot 系统变量

可以通过系统环境变量配置进一步的自定义行为。

重要提示：

修改任意系统变量后，请重新启动机器人服务。

以下列表总结了最常见的用例：

• UIPATH_SESSION_TIMEOUT - 更改创建交互式会话的默认 60 秒超时时间。 根据与机器人交互的系统的性能和加载时间调整此值，以调整机器人的行为。

  示例：

  UIPATH_SESSION_TIMEOUT=75
  

• UIPATH_PIP_SESSION_TIMEOUT - 更改在机器人会话中启动流程的默认 180 秒超时时间。

  示例：

  UIPATH_PIP_SESSION_TIMEOUT=60
  

• UIPATH_LANGUAGE - 设置机器人运行时使用的语言。 优先级为:

  1. UIPATH_LANGUAGE 值
  2. 计算机环境变量
  3. 当前线程用户界面区域性
  4. 默认 UiPath 语言（英语）

  示例：

  UIPATH_LANGUAGE=French
  

• UIPATH_HEADLESS_WITH_USER - 使用先前在 Orchestrator 中配置的特定用户的凭据。

  示例：

  UIPATH_HEADLESS_WITH_USER=True
  

• UIPATH_PRE_LOADED_EXECUTOR - 默认情况下，预加载的执行程序在机器人启动时启动。 要更改此行为并仅在第一个流程运行时启动预加载的执行程序，请将此变量设置为 None。

  示例：

  UIPATH_PRE_LOADED_EXECUTOR=None
  

• UIPATH_DISABLE_PRE_LOADED_EXECUTOR - 禁用预加载执行程序功能。

  示例：

  UIPATH_PRE_LOADED_EXECUTOR=None
  

• UIPATH_ROBOTJS_ALLOWLIST - 在机器人 JS SDK 和机器人执行程序之间建立连接时，自动接受机器人同意对话框。 该变量接受用分号分隔的自定义应用程序 URL。如果端口号与标准端口（80 或 443）不同，请在 URL 中包含该端口号。

  示例：

  UIPATH_ROBOTJS_ALLOWLIST=cloud.uipath.com;mydomain.com;
  

• UIPATH_DNS_MACHINENAME - 允许在创建 RDP 会话时使用“本地主机” (Localhost) 的 DNS 主机名。要在对 RDP 使用 Kerberos 身份验证的环境中执行 Unattended 作业，请将此值设置为 True。

  示例：

  UIPATH_DNS_MACHINENAME=True
  

• NUGET_FALLBACK_PACKAGES - 配置备用包文件夹的路径。 使用分号分隔多个路径。 如果没有此变量，机器人会在该Nuget.config文件中搜索回退包文件夹。

• NUGET_SCRATCH - 允许同一台计算机上的多个用户模式机器人共享用于存储包的本地路径。 该值必须是与 NuGet 安装文件夹不同的路径，并且充当 NuGet 的临时文件夹。

  备注：

  只有 NUGET_SCRATCH 变量应使用已配置的临时文件夹。

  示例：

  NUGET_SCRATCH=C:\NuGetTempFolder
  

• UIPATH_PRESERVE_CREDENTIALS_CASE - 保留日志记录凭据的原始大小写（域名\用户名）。

  示例：

  UIPATH_PRESERVE_CREDENTIALS_CASE = True
  

• UIPATH_SESSION_BEHAVIOR - 配置作业完成后会话还原的行为方式。 可选择以下选项：

  • TryReuseAndRestoreSession — 默认选项。尝试重用会话，并在作业完成后将其恢复到先前的状态。如果没有可以重复使用的初始会话，则会在还原时注销。
  • ForceNew — 创建一个全新的会话，无论之前的会话状态如何。始终在还原时注销。
  • LeaveSessionActive — 防止恢复初始会话状态。
  • LeaveSessionDisconnected — 还原时始终断开会话。

  示例：

  UIPATH_SESSION_BEHAVIOR = LeaveSessionDisconnected
  

重新启动机器人组件

请记得在重新启动之前保存任何正在进行的工作，避免丢失任何未保存的进度。

• 机器人服务
  • 服务模式安装
    1. 打开“任务管理器”>“服务”。
    2. 查找 UiPathRobotSvc 服务。
    3. 右键单击该服务，然后选择“重新启动”。
  • 用户模式安装 - 退出，然后重新启动 Assistant，或：
    1. 打开“任务管理器”>“详细信息”。
    2. 选择 UiPath.Service.UserHost.exe 流程。
    3. 选择结束任务。
• 更新服务
  1. 打开“任务管理器”>“服务”。
  2. 查找 UiPath.UpdateService.Agent 服务。
  3. 右键单击该服务，然后选择“重新启动”。
• UiPath RobotJS 服务主机
  1. 打开“任务管理器”>“服务”。
  2. 查找 UiPath.RobotJS.ServiceHost 服务。
  3. 右键单击该服务，然后选择“重新启动”。
• UiPath Assistant
  1. 在 Assistant 中，选择“首选项”，然后选择“退出”。
  2. 重新启动 Assistant。
• 小组件 - 重新启动 Assistant，或：
  1. 右键单击任务栏中的 Assistant 图标。
  2. 选择“重新加载小组件”