配置文件

UiPath.Settings 文件说明

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

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

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

参数	描述
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。要启用高密度机器人，请将值设置为 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. 选择“重新加载小组件”