用户界面自动化活动

描述​

项目兼容性​

Windows 和跨平台配置​

• 选择“在屏幕上指明目标” ，通过将鼠标移动到应用程序窗口并选择应用程序来标识该应用程序。如果目标是浏览器网页，请先导航到该页面，然后再指定应用程序。
• 指定目标后，通过选择菜单选项按钮并选择以下选项之一来管理目标：
  • 在屏幕上指定目标 - 再次指定应用程序。如果描述符是在对象存储库中定义的，则如果您只想为当前活动指定描述符，则必须取消与对象存储库的链接。
  • 在对象存储库中显示 - 打开“对象存储库”面板，并选中“描述符”。
  • 取消与对象存储库的链接 - 取消描述符与对象存储库的链接。
  • 添加到对象存储库- 将当前用户界面元素添加到库项目中，这样就可以在整个自动化流程中重用该元素。
• 在作用域内工作 - 选择呈现要自动化的网页应用程序的浏览器选项卡。如果您指定了 Java 应用程序，则该应用程序将列在浏览器标签页的下拉菜单中。只有一个选项卡可用时，该选项隐藏。
• “生成” - 打开“用户界面自动化 Autopilot 录制器”，您可以在其中生成用户界面自动化工作流序列。您还可以从信息屏幕截图框的右上角选择“使用 Autopilot 生成用户界面自动化活动”图标。有关更多详细信息，请查看用户界面自动化 Autopilot 录制器页面。
• URL - 网页应用程序的 URL。选择选项卡后，系统会自动填充该值。您还可以通过转到更多选项菜单，选择“在新选项卡中打开 URL” 。如果 URL 已打开，您可以将其设为焦点，或在新选项卡中再次打开。
• 需要身份验证？- 启用多重身份验证。有关更多详细信息，请查看“用户界面自动化浏览器连接”页面。

• 消除警示- 启用自动关闭 JavaScript 警示对话框。
• 关闭确认- 启用自动关闭 JavaScript 确认对话框。
• 确认对话框响应- 对 JavaScript 确认对话框的响应： “取消”或“确定” 。仅当“关闭确认”设置为True时，此选项才可用。
• “消除提示” - 启用自动消除 JavaScript 提示对话框。
• 提示对话框响应- 对 JavaScript 提示对话框的响应： “取消”或“确定” 。仅当“消除提示”设置为True时，才可用。
• 提示响应文本- JavaScript 提示对话框的文本响应。仅当“消除提示”设置为True时，才可用。

• “输入元素” - 要在其上执行活动的用户界面元素，存储在UIElement对象中。此字段仅支持UIElement对象。可以从其他用户界面自动化活动的“输出元素”属性字段中获取该对象。
• “输出元素” - 输出目标用户界面元素，并将其存储在UIElement对象中，该对象可进一步用于与其他活动针对同一元素。

• 打开- 定义是否先打开目标应用程序，然后再执行其中的活动。

  • “始终” - 每次都打开浏览器窗口。
  • 如果未打开- 如果没有一个与选取器和 URL 匹配的浏览器窗口，则打开新的浏览器窗口。这是默认值。
  • “从不”- 从不打开浏览器窗口。

• 关闭- 定义是否在执行目标应用程序中的活动之前关闭目标应用程序。

  • “始终” - 每次都关闭浏览器窗口。
  • 如果由“使用浏览器”打开- 仅在浏览器窗口由“使用浏览器”活动打开时关闭。这是默认值。
  • “从不” - 从不关闭浏览器窗口。

• 输入模式- 用于生成键盘和鼠标输入的方法。

  • Chromium API - Performs actions using debugger APIs. Works only for Chromium elements. Sends all text in one go. Works even if target app is not in focus.
  • “模拟” - 使用辅助功能 API 模拟操作。适用于浏览器。在单个操作中发送所有文本。在后台工作（即使目标应用程序不在焦点中）。

• 无痕/隐私窗口- 如果选中，则以无痕/隐私模式打开新的浏览器会话。该字段仅支持“布尔值”（ True 、 False ）。默认值为False 。

• 用户数据文件夹模式 - 要设置的用户数据文件夹模式。该模式用于通过特定用户数据文件夹启动浏览器。

  • 自动 - 使用不同于默认文件夹的单独用户数据文件夹自动触发画中画 (PiP) 模式。如果未设置用户数据文件夹路径，则会自动生成一个文件夹。当您在自动化任务期间寻求浏览器隔离，并将数据与主浏览会话分开时，这可能会有所帮助。
  • 默认文件夹 - 使用默认浏览器文件夹，无论其在主浏览会话还是 PiP 会话中运行。如果您希望机器人使用现有的用户数据文件夹，并且不需要用于自动化任务的单独或隔离的会话，则此选项非常有用。
  • 自定义文件夹- 使用在用户 数据文件夹路径中指定的文件夹。如果未设置用户数据文件夹路径，则系统会使用自动生成的路径。此选项通过设置用户数据文件夹的自定义路径，为您提供更大的灵活性和控制力，以管理不同自动化任务的文件夹。设置浏览器用户数据文件夹仅适用于 Chrome、Edge Chromium 和 Firefox。

• 用户数据文件夹路径- 浏览器使用的用户数据文件夹。如果未设置，则默认为%LocalAppData%\UiPath\PIP Browser Profiles\BrowserType 。

• Resize window - Defines whether the application/browser is resized when initialized.

  • 无 – 不可调整应用程序/浏览器大小。
  • 最大化 – 初始化时，应用程序/浏览器已最大化
  • 还原至设计时大小 – 如有可能，系统会将应用程序/浏览器的大小和位置调整并移动到指定时的位置和大小。
  • 最小化 – 初始化时，应用程序/浏览器已最小化。

• Window attach mode - Defines where inner activities search for their target elements.

  • Application instance - Inner activities search the indicated application instance, including all parent and child windows (alerts, popups, etc). Other instances of the application are excluded.
  • Single window - Inner activities search only in the indicated window.

• Healing Agent 模式- 根据流程或作业级别的监管或 Orchestrator 设置，配置此活动的 Healing Agent 行为。

  • 已禁用 - 关闭此活动的 Healing Agent。
  • 继承作业设置- 在流程或作业级别应用在监管或 Orchestrator 中定义的设置。
  • “仅建议” - 允许 Healing Agent 提供有关如何修复正在运行的作业中的用户界面自动化问题的建议，但前提是监管或 Orchestrator 设置允许。
  • 与应用程序/浏览器相同- 从父级“使用应用程序/浏览器”活动继承配置。

• WebDriver mode - Indicates how the WebDriver is used when opening a new browser session. The following options are available:

  • 已禁用- 禁用 WebDriver。
  • “使用 GUI” - 显示浏览器的 GUI。
  • 无头- 浏览器以静默启动方式启动，没有 GUI。更多详细信息，请参阅关于 WebDriver 协议。

• “出错时继续” - 指定在活动抛出错误时是否应继续自动化操作。此字段仅支持Boolean值（ True ， False ）。默认值为False 。因此，如果该字段为空且活动引发错误，系统将停止执行项目。如果该值设为True ，则无论出现何种错误，系统都将继续执行项目。

• URL - If the application is a web browser, specifies the URL of the web page to open. If a URL is specified, the File path property is cleared.
• File path - If the application is not a web browser, specifies the full path of the executable file to open. If a file path is specified, the URL property is cleared.
  备注：

  当“文件路径”字段中定义的路径为动态路径时，如果目标应用程序尚未打开，则在子活动中选择“在屏幕上指明目标”会生成错误。

• 选取器- 用于查找特定浏览器窗口的属性列表。
• 参数- 启动时传递到目标应用程序的参数。
• “工作目录” - 当前工作目录的路径。该字段仅接受字符串变量或字符串值，且必须为其加上引号。

• “超时” - 指定在引发错误之前等待执行活动的时间（以秒为单位）。默认值为 30 秒。

Windows - 旧版配置​

• 选择“指定应用程序” ，通过将鼠标移动到应用程序窗口并选择应用程序来标识该应用程序。如果目标是浏览器网页，请先导航到该页面，然后再指定应用程序。

• 指定目标后，通过选择菜单选项按钮并选择以下选项之一来管理目标：

  • Indicate target on screen - Indicate the application again.
  • Highlight Target - View the indicated application on your screen surrounded in a box.
  • Show informative screenshot - View a screenshot of the target application or web page.
  • 删除信息性屏幕截图 - 删除目标应用程序或网页的屏幕截图。
  • OCR 引擎 - 选择以下两个选项之一：
    • 嵌入式 OCR 引擎 - 使用 Computer Vision AI 模型中嵌入的 OCR 引擎，即 UiPath 屏幕 OCR。
    • 自定义 OCR 引擎 - 使用自定义 OCR 引擎。选择此选项后，将在活动卡中添加一个面板，您可以在其中放置与 UiPath 屏幕 OCR 不同的 OCR 引擎活动。
  • 添加到对象存储库- 将当前用户界面元素添加到库项目中，这样就可以在整个自动化流程中重用该元素。

• 您可以在保留当前配置设置的情况下，使用按钮。在“应用程序路径” （如果是应用程序）或“浏览器 URL” （如果是浏览器）字段旁边。如果通过此按钮打开浏览器，则应用“选项 - 浏览器”属性部分中进行的所有配置，从而使您能够在设计时测试活动的行为，从而减少运行时可能出现的故障。

• 配置应用程序启动设置：

  • 如果应用程序是网页浏览器，请选择“浏览器 URL”字段右侧的加号，然后使用菜单中的某个选项编辑要打开网页的 URL。
  • 如果应用程序不是网页浏览器，您可以执行以下操作：

    • 从“应用程序参数”字段指定要在启动时传递给目标应用程序的参数。例如，如果目标应用程序是 Acrobat Reader，则可以通过提供特定 PDF 文件的完整路径来打开该文件。要打开文件 C:\Sample.pdf，选择加号> “文本” ，然后在文本生成器中输入C:\Sample.pdf 。系统会自动识别某些应用程序类型并自动填充“参数”属性，例如 Java 应用程序、Office 套件应用程序、Adobe Acrobat 或 Windows 文件资源管理器。

    • 选择“应用程序路径”字段右侧的加号，然后使用菜单中的某个选项编辑要打开的可执行文件的完整路径。对于以用户模式安装的应用程序，自动化不会保存包含用户名的实际路径，而是使用相对路径，并在字段中显示为User Folder 。

      备注：

      当“应用程序路径”字段中定义的路径为动态路径时，如果目标应用程序尚未打开，则在子活动中选择“在屏幕上指明目标”会生成错误。

    • 选中或取消选中“匹配确切标题”复选框。仅当您指示应用程序的整个窗口，而不仅仅是应用程序中的元素时，才会显示此选项。此外，当您指定网页浏览器时，此选项也不会出现。选中后，仅可在自动化中使用与当前应用程序标题完全匹配的应用程序。取消选中（默认）时，标题匹配度最高的窗口将用于自动化。

属性面板​

• “出错时继续” - 指定在活动抛出错误时是否应继续自动化操作。此字段仅支持Boolean值（ True ， False ）。默认值为False 。因此，如果该字段为空且活动引发错误，系统将停止执行项目。如果该值设为True ，则无论出现何种错误，系统都将继续执行项目。

• 显示名称 -“设计器”面板中活动的显示名称。 指定目标时，系统会自动生成显示名称。

  重要提示：

  “使用应用程序/浏览器”活动的显示名称也用作指向目标应用程序或浏览器的引用。指定目标后，除非手动设置，否则显示名称将自动更改为以下格式：* 对于应用程序： Use Application: [title] - [app name] * 对于浏览器： Use Browser [browser type] : [title]对于嵌套应用程序卡，卡中的每个活动都显示一个下拉列表- 在其正文中向下菜单，使您可以选择要与其一起使用的应用程序卡。

• “超时” - 指定在引发错误之前等待执行活动的时间（以秒为单位）。默认值为 30 秒。

  备注：

  在远程桌面环境中指定窗口时，超时默认设置为 60 秒。

• Unified Target Application - Expand this category to configure the following settings:

  • Arguments - If the application is not a web browser, you can specify parameters to pass to the target application at startup. You can use this property to open a specific file with the application. For example, if the target application is Acrobat Reader, you can open a specific workbook by providing the full path to the file. To open the file C:\Sample.pdf, enter "C:\Sample.pdf". Certain application types are automatically identified and autofill the Arguments property, such as Java apps, Office Suite apps, Adobe Acrobat, or Windows File Explorer.
  • File path - If the application is not a web browser, specifies the full path of the executable file to open. If a file path is specified, the URL property is cleared.
    备注：

    当“文件路径”字段中定义的路径为动态路径时，如果目标应用程序尚未打开，则在子活动中选择“在屏幕上指明目标”会生成错误。

  • Selector - An XML fragment that stores the attributes of a user interface element.
  • URL - If the application is a web browser, specifies the URL of the web page to open. If a URL is specified, the File path property is cleared.
  • 工作目录- 当前工作目录的路径。该字段仅接受字符串变量或字符串值，且必须为其加上引号。

• “输入元素” - 要与此应用程序一起使用的目标元素，存储在UIElement对象中。可以从另一个用户界面自动化活动的“输出元素”属性中检索此对象。您可以使用此属性字段将上一个活动中的目标元素传递到此活动，而无需再次指定。此字段仅支持UIElement变量。

• Output Element - Outputs the target element indicated in this activity to an UIElement variable which can then be reused in other activities. This field supports only UIElement variables.

• “私有” - 选中后将不再以“Verbose”级别记录变量和参数的值。此字段仅支持Boolean （ True ， False ）值。默认值为False 。

• 关闭- 选择自动化执行此活动中添加的所有活动后关闭目标应用程序的时间：

  • “从不” - 从不关闭应用程序。
  • 如果由应用程序/浏览器打开 - 仅在由自动化打开应用程序时关闭。这是默认值。
  • “始终” - 每次都关闭应用程序。

• Input mode - Select which method the Robot should use to interact with the target application:

  • Hardware Events - Uses the hardware driver to perform the action. This is the slowest method, it cannot work in the background, but it is compatible with all desktop apps.
  • 模拟- 使用辅助功能 API 进行模拟。建议用于浏览器、基于 Java 的应用程序、SAP。通常比“硬件事件”更可靠。在单个操作中发送所有文本。即使目标应用程序不在焦点中，也适用。请测试您的目标应用程序用户界面元素是否支持此方法。
  • Chromium API - 使用调试器 API 执行操作。仅适用于 Chromium 元素。一次性发送所有文本。即使目标应用程序不在焦点中，也适用。有关更多详细信息，请查看此页面。
  • Window 消息- 使用 Win32 消息进行模拟。推荐用于桌面应用程序。通常比“硬件事件”更可靠。在单个操作中发送所有文本。即使目标应用程序不在焦点中，也适用。请测试您的目标应用程序用户界面元素是否支持此方法。
  • 后台- 在后台运行操作。在可能的情况下，尝试使用 Simulate 或 Chromium API，同时复杂的活动（图像、原生文本）照常在前台运行。强烈建议将此方法与“验证执行”功能一起使用。
    备注：

    不支持对通用 Windows 平台应用程序使用后台输入模式，这意味着此类应用程序无法在后台自动化。

• 打开- 选择何时打开目标应用程序以执行自动化：

  • “从不” - 从不打开应用程序。
  • 如果未打开- 仅在应用程序关闭时打开。这是默认值。仅在填充“文件路径”或“URL”字段时才有效。
  • “始终”- 打开应用程序的另一个实例，即使已打开一个实例。仅在填充“文件路径”或“URL”字段时才有效。

• Resize window - Defines whether the application/browser is resized when initialized.

  • 无 – 不可调整应用程序/浏览器大小。
  • 最大化 – 初始化时，应用程序/浏览器已最大化
  • 还原至设计时大小 – 如有可能，系统会将应用程序/浏览器的大小和位置调整并移动到指定时的位置和大小。
  • 最小化 – 初始化时，应用程序/浏览器已最小化。

• Window attach mode - Defines where inner activities search for their target elements.

  • Application instance - Inner activities search the indicated application instance, including all parent and child windows (alerts, popups, etc). Other instances of the application are excluded.
  • Single window - Inner activities search only in the indicated window.

• “对话框处理” - 选择DialogHandling值而不是(null)值后，您可以配置以下选项：

  • 消除警示- 启用自动关闭 JavaScript 警示对话框。
  • 关闭确认- 启用自动关闭 JavaScript 确认对话框。
  • 确认对话框响应- 对 JavaScript 确认对话框的响应： “取消”或“确定” 。
  • “消除提示” - 启用自动消除 JavaScript 提示对话框。
  • 提示对话框响应- 对 JavaScript 提示对话框的响应： “取消”或“确定” 。
  • 提示响应文本- JavaScript 提示对话框的文本响应。

• Incognito/private window - If selected, opens the new browser session in incognito/private mode. By default, this check box is cleared.

• 用户数据文件夹模式 - 要设置的用户数据文件夹模式。该模式用于通过特定用户数据文件夹启动浏览器。

  • 自动 - 使用不同于默认文件夹的单独用户数据文件夹自动触发画中画 (PiP) 模式。如果未设置用户数据文件夹路径，则会自动生成一个文件夹。当您在自动化任务期间寻求浏览器隔离，并将数据与主浏览会话分开时，这可能会有所帮助。
  • 默认文件夹 - 使用默认浏览器文件夹，无论其在主浏览会话还是 PiP 会话中运行。如果您希望机器人使用现有的用户数据文件夹，并且不需要用于自动化任务的单独或隔离的会话，则此选项非常有用。
  • 自定义文件夹- 使用在用户数据文件夹路径中指定的文件夹。如果未设置用户数据文件夹路径，则系统会使用自动生成的路径。此选项通过设置用户数据文件夹的自定义路径，为您提供更大的灵活性和控制力，以管理不同自动化任务的文件夹。设置浏览器用户数据文件夹仅适用于 Chrome、Edge Chromium 和 Firefox。

• 用户数据文件夹路径- 浏览器使用的用户数据文件夹。如果未设置，则默认为%LocalAppData%\UiPath\PIP Browser Profiles\BrowserType 。有关用户数据文件夹模式和用户数据文件夹路径的更多详细信息，请参见此处。

• WebDriver mode - Indicates how the WebDriver is used when opening a new browser session. The following options are available:

  • 已禁用- 禁用 WebDriver。
  • “带 GUI” - 显示浏览器的 GUI。
  • 无头- 以静默方式启动浏览器，没有 GUI。有关WebDriver的更多详细信息，请参阅此处。