activities
latest
false
重要 :
请注意，此内容已使用机器翻译进行了部分本地化。 新发布内容的本地化可能需要 1-2 周的时间才能完成。
UiPath logo, featuring letters U and I in white

用户界面自动化活动

上次更新日期 2025年12月5日

UI Automation Modern Project Settings

这些项目设置适用于“Windows - 旧版”和“Windows”项目中的新式活动。

使用项目设置在项目级别配置更改。这些全局设置会影响包中具有下面列出的属性的所有活动。有关详细信息，请参阅配置活动项目设置。

只有在尚未编辑其属性的情况下，“项目设置”中配置的属性才会在工作流的活动中生效。手动编辑属性不再将项目设置应用于属性。

要配置用户界面自动化新式项目设置，请按照以下步骤操作：

  1. 在“项目”面板中，转到“项目设置”。
  2. 导航到“活动设置”>“新式 UIAutomation”。
  3. 根据要更改的内容修改设置。
  4. 单击“确定”以保存更改。

您可以使用窗口顶部的“ 批量操作 ” 下拉菜单将所有设置重置为其默认值，或复制调试字段和生产字段之间的所有值。

泛型

以下设置适用于“Windows - 旧版”中的用户界面自动化新式活动，以及具有以下任一属性的“Windows”项目。

属性名称描述
在之后延迟（秒）当前活动和下一个活动之间的延迟时间。
在之前延迟（秒）上一个活动和当前活动之间的延迟。
超时 (秒)在引发错误之前等待执行当前活动的时间。
等待页面加载执行操作前，等待应用程序做好接受输入的准备。可选择以下选项：
  • “无”- 不等待目标变为就绪状态。
  • “交互式”– 等待直到加载了应用程序的一部分。
  • “完整”– 等待整个应用程序被加载。
捕获屏幕截图指示是否在设计时由支持此功能的所有活动捕获屏幕截图。如果该设置设为 False，则禁用上下文菜单中的“删除信息屏幕截图”选项。
在“未找到元素”错误消息中显示最接近的匹配项如果设置为“True”，则日志中将显示十个最接近的选取器匹配项建议，这些建议可用于替换错误的选取器。
更改禁用元素如果选中，即使禁用指定的用户界面元素，系统也仍会执行选择项目操作。如果输入模式
等待主要定位方法，直至超时如果设置为“True”，则此设置允许主要定位方法使用其完全超时，直到可以使用任何回退定位方法为止。
就运行时错误询问用户如果设置为True ，系统将显示提示，让您决定下一步要做什么并继续自动化，而不是仅仅停止执行。
自动将用户界面元素添加到对象存储库如果设置为“True”，则所有用户界面元素都将自动添加到对象存储库。

定位方法 - 桌面应用程序

以下设置适用于桌面应用程序的指定目标和锚点。

属性名称描述
输入模式选择操作的执行方式：
  • 硬件事件 - 使用硬件驱动程序模拟单击。该方法速度最慢，且不能在后台工作，但可兼容所有桌面应用程序。
  • 模拟 - 使用辅助功能 API 模拟单击。推荐在浏览器自动化、Java 应用程序或 SAP 中使用。比硬件事件更可靠。即使目标应用程序不在焦点中也适用。请测试您的目标应用程序用户界面元素是否支持此方法。
  • 窗口消息 - 使用 Win32 消息进行模拟。推荐用于桌面应用程序。通常比硬件事件更可靠。一次性发送所有文本。即使目标应用程序不在焦点中也适用。在使用此方法之前，请测试您的目标应用程序用户界面元素是否支持此方法。
  • 后台 - 在后台运行操作。在可能的情况下尝试使用模拟，同时复杂的活动（图像、原生文本）将照常在前台运行。

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

选取器 - 默认查找类型选择用户界面元素选取器使用的默认查找类型。可选择以下选项：
  • 已禁用- 不使用“选取器”定位方法来查找用户界面元素。
  • 一个匹配项- 使用精确匹配方法。此方法可确保精确识别元素，但如果这些属性动态更改或用户界面缺少稳定的标识符，则可能会失败。
  • 所有匹配项- 有意产生多个匹配项。它设计为始终与锚点一起使用以优化选择，使其更能适应轻微的用户界面更改，同时确保上下文准确性。
  • 自动- 自动选择用户界面元素选取器的最合适的查找类型：一个匹配项或全部匹配项。
默认值为一个匹配项。

Computer Vision

如果设置为 True，则使用 Computer Vision 方法。 默认值为 True。
图像如果设置为 True，则使用“ 图像”定位 方法。

注意：如果禁用其他方法，则此方法仅用于检查应用程序状态活动。

生成原生 WPF 选取器（预览）为 WPF 应用程序启用原生 WPF 选取器生成功能。

定位方式 - 网页浏览器

以下设置适用于网页应用程序的指定目标和锚点。

属性名称描述
适用于 Edge、Chrome 的输入模式选择操作的执行方式：
  • “硬件事件 ” - 使用硬件驱动程序模拟单击。 这是最慢的方法，无法在后台运行，但与所有桌面应用程序兼容。
  • 模拟 - 使用辅助功能 API 模拟单击。推荐在浏览器自动化、Java 应用程序或 SAP 中使用。比硬件事件更可靠。即使目标应用程序不在焦点中也适用。请测试您的目标应用程序用户界面元素是否支持此方法。
  • Chromium API - 使用调试器 API 执行操作。仅适用于 Chromium 元素。一次性发送所有文本。即使目标应用程序不在焦点中也适用。有关更多详细信息，请查看 Chromium API 页面。

    注意：当使用 Chromium API 启动浏览器时，系统将显示一个功能区，此功能区说明浏览器以调试模式启动。如果通过策略安装扩展程序，则不会显示此消息。

  • 窗口消息 - 使用 Win32 消息进行模拟。推荐用于桌面应用程序。通常比硬件事件更可靠。一次性发送所有文本。即使目标应用程序不在焦点中也适用。在使用此方法之前，请测试您的目标应用程序用户界面元素是否支持此方法。
  • 后台 - 在后台运行操作。在可能的情况下尝试使用模拟，同时复杂的活动（图像、原生文本）将照常在前台运行。
适用于 Firefox、IE、IE 模式 Edge 的输入模式选择操作的执行方式：
  • “硬件事件 ” - 使用硬件驱动程序模拟单击。 这是最慢的方法，无法在后台运行，但与所有桌面应用程序兼容。
  • 模拟 - 使用辅助功能 API 模拟单击。推荐在浏览器自动化、Java 应用程序或 SAP 中使用。比硬件事件更可靠。即使目标应用程序不在焦点中也适用。请测试您的目标应用程序用户界面元素是否支持此方法。
  • 窗口消息 - 使用 Win32 消息进行模拟。推荐用于桌面应用程序。通常比硬件事件更可靠。一次性发送所有文本。即使目标应用程序不在焦点中也适用。在使用此方法之前，请测试您的目标应用程序用户界面元素是否支持此方法。
  • 后台 - 在后台运行操作。在可能的情况下尝试使用模拟，同时复杂的活动（图像、原生文本）将照常在前台运行。
选取器 - 默认查找类型选择用户界面元素选取器使用的默认查找类型。可选择以下选项：
  • 已禁用- 不使用“选取器”定位方法来查找用户界面元素。
  • 一个匹配项- 使用精确匹配方法。此方法可确保精确识别元素，但如果这些属性动态更改或用户界面缺少稳定的标识符，则可能会失败。
  • 所有匹配项- 有意产生多个匹配项。它设计为始终与锚点一起使用以优化选择，使其更能适应轻微的用户界面更改，同时确保上下文准确性。
  • 自动- 自动选择用户界面元素选取器的最合适的查找类型：一个匹配项或全部匹配项。
默认值为所有匹配项。
Computer Vision如果设置为 True，则使用 Computer Vision 方法。 默认值为 True。
图像如果设置为 True，则使用“ 图像”定位 方法。

注意：如果禁用其他方法，则此方法仅用于检查应用程序状态活动。

定位方式 - Java

以下设置适用于 Java 应用程序的指定目标和锚点。

属性名称描述
输入模式选择操作的执行方式：
  • “硬件事件 ” - 使用硬件驱动程序模拟单击。 这是最慢的方法，无法在后台运行，但与所有桌面应用程序兼容。
  • 模拟 - 使用辅助功能 API 模拟单击。推荐在浏览器自动化、Java 应用程序或 SAP 中使用。比硬件事件更可靠。即使目标应用程序不在焦点中也适用。请测试您的目标应用程序用户界面元素是否支持此方法。
  • 窗口消息 - 使用 Win32 消息进行模拟。推荐用于桌面应用程序。通常比硬件事件更可靠。一次性发送所有文本。即使目标应用程序不在焦点中也适用。在使用此方法之前，请测试您的目标应用程序用户界面元素是否支持此方法。
  • 后台 - 在后台运行操作。在可能的情况下尝试使用模拟，同时复杂的活动（图像、原生文本）将照常在前台运行。
选取器 - 默认查找类型选择用户界面元素选取器使用的默认查找类型。可选择以下选项：
  • 已禁用- 不使用“选取器”定位方法来查找用户界面元素。
  • 一个匹配项- 使用精确匹配方法。此方法可确保精确识别元素，但如果这些属性动态更改或用户界面缺少稳定的标识符，则可能会失败。
  • 所有匹配项- 有意产生多个匹配项。它设计为始终与锚点一起使用以优化选择，使其更能适应轻微的用户界面更改，同时确保上下文准确性。
  • 自动- 自动选择用户界面元素选取器的最合适的查找类型：一个匹配项或全部匹配项。
默认值为一个匹配项。
Computer Vision如果设置为 True，则使用 Computer Vision 方法。 默认值为 True。
图像如果设置为 True，则使用“ 图像”定位 方法。

注意：如果禁用其他方法，则此方法仅用于检查应用程序状态活动。

定位方式 - SAP

以下设置适用于 SAP 的指定目标和锚点。

属性名称描述
输入模式选择操作的执行方式：
  • “硬件事件 ” - 使用硬件驱动程序模拟单击。 这是最慢的方法，无法在后台运行，但与所有桌面应用程序兼容。
  • 模拟 - 使用辅助功能 API 模拟单击。推荐在浏览器自动化、Java 应用程序或 SAP 中使用。比硬件事件更可靠。即使目标应用程序不在焦点中也适用。请测试您的目标应用程序用户界面元素是否支持此方法。
  • 窗口消息 - 使用 Win32 消息进行模拟。推荐用于桌面应用程序。通常比硬件事件更可靠。一次性发送所有文本。即使目标应用程序不在焦点中也适用。在使用此方法之前，请测试您的目标应用程序用户界面元素是否支持此方法。
  • 后台 - 在后台运行操作。在可能的情况下尝试使用模拟，同时复杂的活动（图像、原生文本）将照常在前台运行。
选取器 - 默认查找类型选择用户界面元素选取器使用的默认查找类型。可选择以下选项：
  • 已禁用- 不使用“选取器”定位方法来查找用户界面元素。
  • 一个匹配项- 使用精确匹配方法。此方法可确保精确识别元素，但如果这些属性动态更改或用户界面缺少稳定的标识符，则可能会失败。
  • 所有匹配项- 有意产生多个匹配项。它设计为始终与锚点一起使用以优化选择，使其更能适应轻微的用户界面更改，同时确保上下文准确性。
  • 自动- 自动选择用户界面元素选取器的最合适的查找类型：一个匹配项或全部匹配项。
默认值为一个匹配项。
Computer Vision如果设置为 True，则使用 Computer Vision 方法。 默认值为 False。
图像如果设置为 True，则使用“ 图像”定位 方法。

注意：如果禁用其他方法，则此方法仅用于检查应用程序状态活动。

验证执行

The settings below apply to all the activities that have the Verify Execution feature: Click, Type Into, Hover, Keyboard Shortcuts.

属性名称描述
超时 (秒)等待验证元素出现/消失的时间（以秒为单位）。如果重试设置为 True，则系统将在活动超时属性的指定持续时间内再次执行此操作，然后实施验证。
重试设置为 True 后，如果系统未获得预期结果，则将在活动超时的持续时间内再次执行此操作。默认情况下，该复选框处于选中状态。
始终自动验证已输入的文本如果设置为 True，则使用验证执行功能验证任何输入文本的操作。

应用程序/浏览器

以下设置适用于使用应用程序/浏览器活动。

属性名称描述
打开定义是否先打开目标应用程序，然后再执行其中的活动。可选择以下选项：

  • “从不” - 从不启动/打开新的应用程序实例或浏览器窗口。

  • 如果未打开- 如果选取器与任何现有实例都不匹配，则打开新的应用程序实例或浏览器窗口。

  • 始终- 始终打开新的应用程序实例或浏览器窗口。打开新实例时，文件路径和参数用于启动应用程序。

关闭定义是否先执行目标应用程序中的活动，然后再关闭该目标应用程序。可选择以下选项：

  • “从不” - 在执行作用域内的活动后，不要关闭应用程序实例或浏览器窗口，即使它是由“使用应用程序/浏览器”活动打开的。

  • 如果由应用程序/浏览器打开- 仅当应用程序实例或浏览器窗口由“使用应用程序/浏览器”活动打开时，才将其关闭。

  • “始终”- 执行作用域内的活动后始终关闭应用程序实例或浏览器窗口。

窗口附加模式

指定新添加的“使用应用程序/浏览器”活动使用的默认窗口附加模式。可选择以下选项：

  • 应用程序实例- 内部活动将在指定的应用程序实例中搜索，包括所有的父窗口和子窗口（警示、弹出窗口等）。应用程序的其他实例均将排除在外。

  • 单个窗口- 内部活动将仅在指定窗口中进行搜索。

调整窗口大小定义是否在初始化时调整应用程序/浏览器的大小。
  • 无 – 不可调整应用程序/浏览器大小。
  • 最大化 – 初始化时，应用程序/浏览器已最大化
  • 还原至设计时大小 – 如有可能，系统会将应用程序/浏览器的大小和位置调整并移动到指定时的位置和大小。
  • 最小化 – 初始化时，应用程序/浏览器已最小化。
运行时浏览器指定要在运行时使用的浏览器。可选择以下选项：
  • Firefox
  • Edge
  • Chrome
  • 无
WebDriver 模式指示打开新浏览器会话时如何使用 WebDriver。可选择以下选项：
  • “已禁用 ” - 禁用 WebDriver。
  • 使用 GUI - 显示浏览器的 GUI。
  • 无头 - 浏览器静默启动，没有 GUI。
自动下载 WebDriver若设为True ，指定是否要自动下载所需的 WebDriver 可执行版本。
用户数据文件夹模式您要设置的用户数据文件夹模式。该模式用于通过特定用户数据文件夹启动浏览器。
  • 自动 - 画中画模式使用与默认模式下不同的文件夹。如果未设置用户数据文件夹路径，则系统会自动生成该路径。
  • 默认文件夹 - 使用默认浏览器文件夹，无论其在主会话还是 PIP 会话中运行。
  • 自定义文件夹 - 使用用户数据文件夹路径中指定的文件夹。如果未设置用户数据文件夹路径，则使用自动生成的路径。
用户数据文件夹路径浏览器使用的用户数据文件夹的路径。
打开浏览器超时 (秒)配置浏览器启动超时。

关闭警示

启用自动关闭 JavaScript 警示对话框。

关闭确认对话框

启用自动关闭 JavaScript 确认对话框。

关闭提示对话框

启用自动关闭 JavaScript 提示对话框。

确认对话框响应

设置对 JavaScript 确认对话框的响应： “取消”或“确定” 。

提示对话框响应

设置对 JavaScript 提示对话框的响应： “取消”或“确定” 。

提示响应文本

设置 JavaScript 提示对话框的文本响应。

键盘事件

以下设置适用于“ 输入信息 ” 和“ 键盘快捷方式 ” 活动。

属性名称描述
输入 - 点击后再输入在键入文本之前是否单击指定的用户界面元素，以及要执行的单击类型。 提供以下选项：
  • 无
  • 单个
  • Double
输入 - 空字段是否在键入文本之前删除现有内容，以及如何清除该字段。 提供以下选项：
  • 无
  • 单行 [End，Shift+Home，Del]
  • 多行 [Ctrl+A，Del]

键入 - 剪贴板

指示是否使用剪贴板输入给定文本。可选择以下选项：

  • 从不– 从不使用剪贴板。

  • 始终– 始终使用剪贴板。

  • 尽可能– 尽可能使用剪贴板。这取决于操作系统和要键入的文本（例如，如果使用了任何特殊键，则将不会使用剪贴板）。

“键入到” - 按键之间的延迟（秒）连续击键之间的延迟时间。
键盘快捷方式 - 快捷方式之间的延迟时间连续特殊键之间的延迟时间。
键盘快捷方式 - 键与键之间的延迟（秒）连续击键之间的延迟时间。

SAP

The settings below apply to any UI Automation activity during SAP automation.
Important: These project settings apply to both Classic and Modern UI Automation activities.
属性名称描述
Enforce hard timeout (only for SAP WinGUI and GUI for Java)Enforces a hard timeout for all activities performing SAP WinGUI or SAP GUI for Java automation.
启用其他缩放比例启用 SAP WinGUI 额外扩展，以支持 SAP 原生多显示器扩展感知。
启用 SAP 监控在运行时启用 SAP 自动化监控。 适用于 SAP WinGUI、SAP WebGUI 和 SAP Fiori。
SAP 登录 - 重试次数活动尝试连接到 SAP 脚本编写界面的次数。
SAP 登录 - 重试间隔指定每次重试之间的时间间隔（以秒为单位）。

ScreenPlay

The settings below apply to the ScreenPlay activity. Settings changed here take effect at Runtime if the corresponding property is left blank in the activity.
属性名称描述
模型

Indicates the underlying LLM used by ScreenPlay for task execution planning and reasoning.

可用的选项如下：

UiPath (with Gemini Flash 2.0)

  • Works best on browsers
  • Uses a proprietary implementation based on the page's DOM, using Gemini Flash for reasoning and image understanding
  • Moderately fast
  • An order of magnitude cheaper than the others
UiPath（使用 Gemini 2.5 Flash）
  • 基本模式
  • Works best on browsers
  • Uses a proprietary implementation based on the page's DOM, using Gemini Flash for reasoning and image understanding
  • Moderately fast
UiPath (with GPT-4.1)
  • Standard model - for complex tasks
  • Works best on browsers
  • Uses a proprietary implementation based on the page's DOM and image understanding, using GPT-4.1 for reasoning
  • Not very fast
UiPath (with GPT-4.1 mini)
  • Basic model - faster, cheaper
  • Works best on browsers
  • Uses a proprietary implementation based on the page's DOM and image understanding, using GPT-4.1 mini for reasoning
  • Moderately fast
UiPath (with GPT-5)
  • Standard model - for complex tasks
  • Works best on browsers
  • Uses a proprietary implementation based on the page's DOM and image understanding, using GPT-5 for reasoning
  • Slow
UiPath (with GPT-5 mini)
  • Basic model - faster, cheaper
  • Works best on browsers
  • Uses a proprietary implementation based on the page's DOM and image understanding, using GPT-5 mini for reasoning
  • Moderately fast
OpenAI - Operator
  • Standard model - for complex tasks
  • Works on any type of application, including image-based interfaces
  • Uses OpenAI Operator, an image-based reasoning model. Likely the best of the bunch
  • Slow
Anthropic - Computer Use
  • Standard model - for complex tasks
  • Works on any type of application, including image-based interfaces
  • Uses Anthropic Computer Use, an image-based reasoning model
  • Slow
Type by clipboard

Indicates whether the clipboard is used for typing the given text.

可用的选项如下：

  • Never - Never use the clipboard
  • Always - Always use the clipboard
  • Whenever possible - Use the clipboard when possible. This depends on the OS and the text to be typed (e.g. If any special key is used, then the clipbaord will not be used)
Max number of stepsThe maximum number of steps that ScreenPlay can take to achieve its goal.
Use DOM when available

Indicates whether DOM data will be used/sent to the LLM Model for applications where DOM can be extracted.

DOM can be used only by UiPath LAM implementations.

Disable if DOM-based targeting leads to incorrect element coordinates.

日志记录

Specifies at what level the logs generated by the ScreenPlay activity are stored.

可用的选项如下：

  • 关闭
  • 信息
  • 追踪
启用追踪文件

Specifies the type of trace files generated by the ScreenPlay activity.

可用的选项如下：

  • Disabled - No trace file will be saved/stored.
  • Html - Html trace files will be saved/stored.
  • Html and json - Html and main json trace files will be saved stored.
  • Full - Html, main json and iteration json trace files will be saved/stored.
Trace files retention (days)Number of days to retain traces before deletion. Set to 0 to keep the traces indefinitely.

其他活动

以下设置适用于“检查应用程序状态”、“提取表格数据”、“高亮显示”、“悬停”、“注入 Js 脚本”、“关闭弹出窗口”和“SAP 登录”活动。

属性名称描述
检查应用程序状态 - 超时（秒）等待目标元素出现或消失的时间。
提取表格数据 - 页面之间的延迟（秒）如果数据跨越多个页面，则等待加载每个页面的时间。
高亮显示 - 持续时间（秒）高亮显示目标元素的时长。
悬停 - 持续时间 (秒)将鼠标悬停在目标元素上的时长。
注入 Js 脚本 - 执行世界全局应用 InjectJs.ExecutionWorld 设置。 有关详细信息，请参阅“ 注入 Js 脚本 ”活动。
关闭弹出窗口 - 弹出窗口出现超时等待弹出窗口出现的时间 (以秒为单位)。

机器人日志记录

有关用于识别目标和锚点的方法的信息，以及每个方法在运行时的性能，可以保存在机器人执行日志中。 这些选项适用于所有受支持的活动。

属性名称属性说明受影响的活动
日志目标和锚点搜索步骤指定我们存储用于识别目标和锚点的方法日志的级别。可选择以下选项：
  • 关闭
  • 信息
  • 追踪
  • 选中/取消选中
  • 查看应用程序状态
  • 单击
  • 提取表格数据
  • 获取文本
  • 高亮显示
  • 悬停
  • 键盘快捷方式
  • 选择项目
  • 键入
日志定位方法计时指定我们将每种定位方式的性能日志存储在哪个级别。可选择以下选项：
  • 关闭
  • 信息
  • 追踪
  • 选中/取消选中
  • 查看应用程序状态
  • 单击
  • 提取表格数据
  • 获取文本
  • 高亮显示
  • 悬停
  • 键盘快捷方式
  • 选择项目
  • 键入
记录审核信息指定存储使用应用程序/浏览器活动生成的日志的级别。可选择以下选项：
  • 关闭
  • 信息
  • 追踪
 使用应用程序/浏览器

此页面有帮助吗？

支持与服务
获取您需要的帮助
UiPath Academy
了解 RPA - 自动化课程
UiPath 论坛
UiPath Community 论坛
Uipath Logo
信任与安全
使用条款
隐私策略
Cookie 政策
© 2005-2025 UiPath。保留所有权利。