activities
latest
false
- 概述
- 用户界面自动化
- 通过用户界面自动化实现自动化的应用程序和技术
- 项目兼容性
- UI-ANA-016 - 拉取打开浏览器 URL
- UI-ANA-017 - 出错时继续 True
- UI-ANA-018 - 列出 OCR/图像活动
- UI-DBP-006 - 容器使用情况
- UI-DBP-013 - Excel 自动化误用
- UI-DBP-030 - 选取器中的禁止变量使用情况
- UI-PRR-001 - 模拟单击
- UI-PRR-002 - 模拟键入
- UI-PRR-003 - 打开应用程序误用
- UI-PRR-004 - 硬编码延迟
- UI-REL-001 - 选取器中的大 IDX
- UI-SEC-004 - 选取器电子邮件数据
- UI-SEC-010 - 应用程序/Url 限制
- UI-USG-011 - 不允许的属性
- UX-SEC-010 - 应用程序/Url 限制
- UX-DBP-029 - 使用不安全的密码
- UI-PST-001 - 项目设置中的审核日志级别
- UiPath 浏览器迁移工具
- 剪切区域
- 计算机视觉录制器
- 激活
- 锚点基准
- 附加浏览器
- 附加窗口
- 阻止用户输入
- 标注
- 选中
- 单击
- 单击图像
- 单击图像触发器
- 单击 OCR 文本
- 单击文本
- 单击触发器
- 关闭应用程序
- 关闭选项卡
- 关闭窗口
- 上下文感知锚点
- 复制选定文本
- 元素属性更改触发器
- 存在元素
- 元素作用域
- 元素状态更改触发器
- 导出用户界面树
- 提取结构化数据
- 查找子元素
- 查找元素
- 查找图像
- 查找图像匹配项
- 查找 OCR 文本位置
- 查找相对元素
- 查找文本位置
- 获取活动窗口
- 获取上级
- 获取属性
- 获取事件信息
- 从剪贴板获取
- 获取全文
- 获取 OCR 文本
- 获取密码
- 获取位置
- 获取源元素
- 获取文本
- 获取可见文本
- 返回
- 前往
- 转至主页
- Google Cloud Vision OCR
- 隐藏窗口
- 高亮显示
- 热键触发器
- 悬停
- 悬停在图像上方
- 悬停在 OCR 文本上方
- 悬停文本
- 存在图像
- 在屏幕上指定
- 注入 .NET 代码
- 插入 Js 脚本
- 调用 ActiveX 方法
- 按键触发器
- 加载图像
- 最大化窗口
- Microsoft Azure 计算机视觉 OCR
- Microsoft OCR
- Microsoft Project Oxford Online OCR
- 最小化窗口
- 监控事件
- 鼠标触发器
- 移动窗口
- 导航至
- 存在 OCR 文本
- 在元素出现时
- 在元素消失时
- 在图像出现时
- 在图像消失时
- 打开应用程序
- 打开浏览器
- 刷新浏览器
- 重播用户事件
- 还原窗口
- 保存图像
- 选择项目
- 选择多个项目
- 发送热键
- 设置剪切区域
- 设置焦点
- 设置文本
- 设置为剪贴板
- 设置网页属性
- 显示窗口
- 启动进程
- 系统触发器
- 截取屏幕截图
- Tesseract OCR
- 存在文本
- 工具提示
- 键入
- 输入安全文本
- 使用前台
- 等待属性
- 等待元素消失
- 等待图像消失
- Computer Vision Local Server
- 移动自动化
- 终端
重要 :
请注意此内容已使用机器翻译进行了部分本地化。
用户界面自动化活动
Last updated 2024年12月4日
附加
重点关注已打开的桌面应用程序或网页浏览器页面,以在用户界面自动化中使用。
使用此 API 时,您需要根据以下格式调用用户界面自动化服务:
uiAutomation.<APIMethod>()
。 例如uiAutomation.Open()
。
命名空间:UiPath.UIAutomationNext.API.Contracts
程序集:UiPath.UIAutomationNext.API.Contracts(在 UiPath.UIAutomationNext.API.Contracts dll 中)
重载 | 描述 |
---|---|
Attach(String, TargetAppOptions, String,
String) | 专注于要在用户界面自动化中使用的特定桌面应用程序或网页,由对象存储库中的屏幕名称标识。 |
Attach(TargetAppModel, TargetAppOptions) | 专注于要在用户界面自动化中使用的特定桌面应用程序或网页,由 TargetAppModel 对象标识。
|
Attach(String, String, String, NAppAttachMode,
NWindowResize, NInteractionMode) | 专注于要在用户界面自动化中使用的特定桌面应用程序或网页,由对象存储库中的屏幕名称以及应用程序或网页的其他自定义项标识。 |
专注于要在用户界面自动化中使用的特定桌面应用程序或网页,由对象存储库中的屏幕名称标识。
Attach(
string screenName,
TargetAppOptions targetAppOptions,
[string appName],
[string appVersion])
Attach(
string screenName,
TargetAppOptions targetAppOptions,
[string appName],
[string appVersion])
screeName
字符串- 要聚焦的屏幕的名称,为在对象存储库中记录的字符串。
targetAppOptions
TargetAppOptions
- 用于附加到应用程序或网页的其他选项和设置:
Timeout Double
- 指定在引发错误之前等待执行活动的秒数。 默认值为 30 秒。 在远程桌面环境中指定窗口时,“超时”默认设置为 60 秒。InteractionMode NInteractionMode
:HardwareEvents
- 使用硬件驱动程序执行 Actions。 这是最慢的 API,不能在后台工作,但可兼容所有桌面应用程序。Simulate
- 使用辅助功能 API 模拟 Actions 。 建议在浏览器自动化、Java 应用程序或 SAP 中使用。 比硬件事件更可靠。 在单个 Actions中发送所有文本。 即使目标应用程序不在焦点中,也适用。 请测试您的目标应用程序用户界面元素是否支持此功能。DebuggerApi
- 使用调试器 API 执行 Actions 。 仅适用于 Chromium 元素。 一次性发送所有文本。 即使目标应用程序不在焦点中,也适用。 有关更多详细信息,请查看此 页面。WindowMessages
- 通过 Win32 消息发送鼠标和键盘输入。 推荐用于桌面应用程序。 通常比硬件事件更可靠。 在单个 Actions中发送所有文本。 即使目标应用程序不在焦点中,也适用。 请测试您的目标应用程序用户界面元素是否支持此功能。Background
- 在后台运行 Actions 。 在可能的情况下尝试使用 Simulate 或 Chromium API,同时复杂的 API(图像、原生文本)将照常在前台运行。 强烈建议将此 API 与“ 验证执行 ”功能一起使用。
OpenMode NAppOpenMode
- 选择何时打开应用程序:Never
(从不打开应用程序)IfNotOpen
(仅在应用程序关闭时打开,这是默认选择,仅在提供FilePath
或URL
时有效)Always
(即使已打开应用程序的另一个实例,也要打开该实例,仅在提供FilePath
或URL
时有效)
WindowResize NWindowResize
- 选择窗口的大小:无
最大化
还原
Minimize
UserDataFolderMode BrowserUserDataFolderMode
- 要设置的UserDataFolderMode
。 它用于通过特定的用户数据文件夹启动浏览器。Automatic
- 画中画模式使用与默认模式不同的文件夹,如果未设置UserDataFolderPath
,则自动生成画中画。DefaultFolder
- 使用默认浏览器文件夹,无论它是在主会话还是 PIP 会话中运行。CustomFolder
- 使用UserDataFolderPath
中指定的文件夹;如果未设置UserDataFolderPath
,则使用自动生成的路径。
UserDataFolderPath String
- 浏览器使用的用户数据文件夹。 如果未设置,则默认为%LocalAppData%\UiPath\PIP Browser Profiles\BrowserType
。IsIncognito Boolean
- 如果要以隐身模式打开浏览器,请输入True
。 默认情况下,它设置为False
。WebDriverMode NWebDriverMode
- 指示打开新浏览器会话时如何使用 WebDriver。 提供以下选项:Disabled
- 禁用 WebDriver。WithGUI
- 显示浏览器的 GUI。Headless
- 浏览器以静默方式启动,没有 GUI。
appName
字符串- 要附加到的应用程序的名称。 此参数适用于桌面应用程序。
appVersion
字符串- 要附加到的应用程序版本。 此参数适用于桌面应用程序。
专注于要在用户界面自动化中使用的特定桌面应用程序或网页,由
TargetAppModel
对象标识。
Attach(
TargetAppModel targetApp,
[TargetAppOptions targetAppOptions]))
Attach(
TargetAppModel targetApp,
[TargetAppOptions targetAppOptions]))
targetApp
目标应用程序模型
- 要附加到的目标应用程序或网页。 它是类型为
TargetAppModel
的对象,可提供有关应用程序的信息:Selector String
- 此为 XML 片段,用于存储用户界面元素的属性。FilePath String
- 如果应用程序不是网页浏览器,请指定要打开的可执行文件的完整路径。Arguments String
- 如果应用程序不是网页浏览器,则可以指定要在启动时传递给目标应用程序的参数。Url String
- 如果应用程序是网页浏览器,则指定要打开的网页的 URL。Title String
- 应用程序或浏览器的标题。
targetAppOptions
TargetAppOptions
- 用于附加到应用程序或网页的其他选项和设置:
Timeout Double
- 指定在引发错误之前等待执行活动的秒数。 默认值为 30 秒。 在远程桌面环境中指定窗口时,“超时”默认设置为 60 秒。InteractionMode NInteractionMode
:HardwareEvents
- 使用硬件驱动程序执行 Actions。 这是最慢的 API,不能在后台工作,但可兼容所有桌面应用程序。Simulate
- 使用辅助功能 API 模拟 Actions 。 建议在浏览器自动化、Java 应用程序或 SAP 中使用。 比硬件事件更可靠。 在单个 Actions中发送所有文本。 即使目标应用程序不在焦点中,也适用。 请测试您的目标应用程序用户界面元素是否支持此功能。DebuggerApi
- 使用调试器 API 执行 Actions 。 仅适用于 Chromium 元素。 一次性发送所有文本。 即使目标应用程序不在焦点中,也适用。 有关更多详细信息,请查看此 页面。WindowMessages
- 通过 Win32 消息发送鼠标和键盘输入。 推荐用于桌面应用程序。 通常比硬件事件更可靠。 在单个 Actions中发送所有文本。 即使目标应用程序不在焦点中,也适用。 请测试您的目标应用程序用户界面元素是否支持此功能。Background
- 在后台运行 Actions 。 在可能的情况下尝试使用 Simulate 或 Chromium API,同时复杂的 API(图像、原生文本)将照常在前台运行。 强烈建议将此 API 与“ 验证执行 ”功能一起使用。
OpenMode NAppOpenMode
- 选择何时打开应用程序:Never
(从不打开应用程序)IfNotOpen
(仅在应用程序关闭时打开,这是默认选择,仅在提供FilePath
或URL
时有效)Always
(即使已打开应用程序的另一个实例,也要打开该实例,仅在提供FilePath
或URL
时有效)
WindowResize NWindowResize
- 选择窗口的大小:无
最大化
还原
Minimize
UserDataFolderMode BrowserUserDataFolderMode
- 要设置的UserDataFolderMode
。 它用于通过特定的用户数据文件夹启动浏览器。Automatic
- 画中画模式使用与默认模式不同的文件夹,如果未设置UserDataFolderPath
,则自动生成画中画。DefaultFolder
- 使用默认浏览器文件夹,无论它是在主会话还是 PIP 会话中运行。CustomFolder
- 使用UserDataFolderPath
中指定的文件夹;如果未设置UserDataFolderPath
,则使用自动生成的路径。
UserDataFolderPath String
- 浏览器使用的用户数据文件夹。 如果未设置,则默认为%LocalAppData%\UiPath\PIP Browser Profiles\BrowserType
。IsIncognito Boolean
- 如果要以隐身模式打开浏览器,请输入True
。 默认情况下,它设置为False
。WebDriverMode NWebDriverMode
- 指示打开新浏览器会话时如何使用 WebDriver。 提供以下选项:Disabled
- 禁用 WebDriver。WithGUI
- 显示浏览器的 GUI。Headless
- 浏览器以静默方式启动,没有 GUI。
专注于要在用户界面自动化中使用的特定桌面应用程序或网页,由对象存储库中的屏幕名称以及应用程序或网页的其他自定义项标识。
Attach(string screenName,
[string appName],
[string appVersion],
[NAppAttachMode appAttachMode],
[NWindowResize windowResize],
[NInteractionMode interactionMode]))
Attach(string screenName,
[string appName],
[string appVersion],
[NAppAttachMode appAttachMode],
[NWindowResize windowResize],
[NInteractionMode interactionMode]))
screeName
字符串- 要聚焦的屏幕的名称,为在对象存储库中记录的字符串。
appName
字符串- 要附加到的应用程序的名称。 此参数适用于桌面应用程序。
appVersion
字符串- 要附加到的应用程序版本。 此参数适用于桌面应用程序。
appAttachMode
NAppAttachMode
-
ByProcessName
- 进一步的 API 将在所有窗口中使用与指定应用程序相同的流程名称进行搜索。ByInstance
- 其他 API 将在指定的应用程序实例中搜索,包括所有父窗口和子窗口(警示、弹出窗口等)。 排除应用程序的其他实例。SingleWindow
- 其他 API 将仅在指定的窗口中搜索。
windowResize
NWindowResize
- 选择窗口大小:
无
最大化
还原
Minimize
interactionMode
NInteractionMode
- 选择机器人与目标应用程序交互时应使用的 API:
HardwareEvents
- 使用硬件驱动程序执行 Actions。 这是最慢的 API,不能在后台工作,但可兼容所有桌面应用程序。Simulate
- 使用辅助功能 API 模拟 Actions 。 建议在浏览器自动化、Java 应用程序或 SAP 中使用。 比硬件事件更可靠。 在单个 Actions中发送所有文本。 即使目标应用程序不在焦点中,也适用。 请测试您的目标应用程序用户界面元素是否支持此功能。DebuggerApi
- 使用调试器 API 执行 Actions 。 仅适用于 Chromium 元素。 一次性发送所有文本。 即使目标应用程序不在焦点中,也适用。 有关更多详细信息,请查看此 页面。WindowMessages
- 通过 Win32 消息发送鼠标和键盘输入。 推荐用于桌面应用程序。 通常比硬件事件更可靠。 在单个 Actions中发送所有文本。 即使目标应用程序不在焦点中,也适用。 请测试您的目标应用程序用户界面元素是否支持此功能。Background
- 在后台运行 Actions 。 在可能的情况下尝试使用 Simulate 或 Chromium API,同时复杂的 API(图像、原生文本)将照常在前台运行。 强烈建议将此 API 与“ 验证执行 ”功能一起使用。
要在无头配置中操作网页驱动程序模式,这些步骤可以用作指南。
首先为屏幕定义变量。使用函数
uiAutomation.Open
在您选择的浏览器中打开一个新应用程序 - 在本例中为 Edge。之后,在重载中使用 Options
类来指定某些浏览器选项。在这些选项中,将 webDriverMode
设置为 NWebDriverMode.Headless
。
相应的代码如下所示:
var screen = uiAutomation.Open(Descriptors.NewApplication.Edge, Options.AppOpen().WithBrowserOptions(webDriverMode: NWebDriverMode.Headless));
var screen = uiAutomation.Open(Descriptors.NewApplication.Edge, Options.AppOpen().WithBrowserOptions(webDriverMode: NWebDriverMode.Headless));
此代码用于将网页驱动程序设置为无头模式,从而在无需看到打开浏览器的情况下启用浏览器自动化。