- 概述
- 用户界面自动化
- 通过用户界面自动化实现自动化的应用程序和技术
- 项目兼容性
- 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
- 移动自动化
- 终端
插入 Js 脚本
UiPath.Core.Activities.NInjectJsScript
UiElement
对应的网页上下文中执行 JavaScript 代码。
无法在使用应用程序/浏览器活动内添加此活动。
要在“使用应用程序/浏览器”活动之外使用此活动,您需要提供输入元素。
此活动可与对象存储库兼容。
设计器面板
-
单击 “在应用程序/浏览器 中指定”,以指定要用作目标的用户界面元素。
指定目标后,选择“ 菜单” 按钮以访问以下选项:
- “在屏幕上指定目标”- 再次指定目标。
- 编辑目标 - 打开选择模式以配置目标。
- 删除信息屏幕截图 - 删除目标应用程序或网页的屏幕截图。
- 添加到对象存储库 - 将当前用户界面元素添加到库项目中,以便在整个自动化流程中重复使用该元素。
-
“脚本代码”- 要运行的 JavaScript 代码。可在此处将其写作字符串形式,或添加包含待执行代码的
.js
文件的完整路径。其应包含单个匿名函数,如下例所示。function (element, input) { return "result"; }
function (element, input) { return "result"; }async function (element, input) { const asyncResult = await new Promise((resolvePromiseCb) => { const timeoutMs = 100; setTimeout(() => { resolvePromiseCb("async_result"); }, timeoutMs); }); return asyncResult; }
async function (element, input) { const asyncResult = await new Promise((resolvePromiseCb) => { const timeoutMs = 100; setTimeout(() => { resolvePromiseCb("async_result"); }, timeoutMs); }); return asyncResult; }其中element
表示与调用用户界面节点对应的 HTML 元素,input
表示调用者提供的输入字符串。 - “输入参数”- JavaScript 代码的输入数据,为字符串或字符串变量形式。
- 将脚本输出保存到 - 用于保存 JavaScript 代码结果的位置。
属性面板
常见
-
“出错时继续” - 指定在活动引发错误时是否应继续自动化操作。 此字段仅支持
Boolean
值(True、 False)。 默认值为 False。 因此,如果该字段为空且活动引发错误,系统将停止执行项目。 如果该值设置为 True,则无论出现何种错误,系统都将继续执行项目。 -
“延迟 时间” - 此活动完成与下一个活动开始执行任何操作之间的延迟时间(以秒为单位)。 默认值为 0.3 秒。 在活动之间添加延迟可确保一个活动有足够的时间完成,然后再开始下一个活动。
-
“在此之前延迟”- 上一个活动完成与此活动开始执行任何操作之间的延迟(以秒为单位)。默认值为 0.2 秒。在活动之间添加延迟可确保一个活动有足够的时间完成,然后再开始下一个活动。
-
显示名称- 设计器面板中活动的显示名称指定目标时,系统会自动生成显示名称。
-
“超时”- 指定最长等待时间(以秒为单位),如果超出该时间后活动并未执行,系统便会抛出错误。 默认值为 30 秒。
输入
- “输入参数 ”- 请参阅“设计器”面板中的“ 输入参数 ”。
- “脚本代码 ”- 请参阅“ 设计器”面板中的“ 脚本代码 ”。
-
“目标 ” - 目标元素。 必须设置目标元素。 在屏幕上指定之前,此字段设置为
(null)
。 指定目标后,将显示与指定元素相关的所有属性。- CV 控件类型 - 指示使用 Computer Vision 识别的控件类型。
- 计算机视觉文本 - 表示使用 Computer Vision 识别的文本。
- “模糊选取器 ” - 模糊选取器的参数。
- 原生文本 - 用于标识用户界面元素的文本。
- 响应式网站 - 启用响应式网站布局。
- “严格选取器 ” - 为用户界面元素生成的“严格选取器”。
- 定位方法 - 要用于标识元素的选取器类型。 可以将此属性设置为下拉菜单中的任意组合:
- 无
- 精确选取器
- 模糊选取器
- 图像
- 原生文本
- Computer Vision - 要将 Computer Vision 用作定位方法,您需要转到“项目设置”>“Computer Vision”,并确保设置正确的服务器端点。您可以原样保留此字段,并使用 UiPath Cloud(默认情况下已填写),也可以通过选择特定于服务器区域的任何其他公共端点或您自己的本地部署服务器来输入其他值。
将 Computer Vision 用作定位方法的另一种方法是将“使用本地服务器”设置为 True。这意味着 UiPath.ComputerVision.LocalServer 包已安装在项目中。启用“本地服务器”后,服务器值将被覆盖。但是,“本地服务器”在跨平台项目中不可用。
- 可见性检查 - 检查用户界面元素是否可见。 您可以从下拉菜单中选择以下三个选项之一:
- “无 ”- 不检查可见性。
- 交互式(用于模糊选取器) - 默认选项。 检查元素是否可能可见,忽略页面滚动和其他应用程序的阻碍或应用程序已最小化。 当尝试确保您没有以 DOM 中存在但隐藏的不可见元素为目标时,此检查非常有用。
- 完全可见 - 检查用户界面元素是否可见。
- 等待页面加载 - 在执行 Actions之前,等待应用程序准备好接受输入。 您可以从下拉菜单中选择以下三个选项之一:
- 无- 不等待目标变为就绪状态。
- “交互式”– 等待直到加载了应用程序的一部分。
- “完整”– 等待整个应用程序被加载。
- 窗口选取器 (应用程序实例) - 用于应用程序窗口的选取器。 仅在窗口附加模式设置为“应用程序实例”时适用。
输入/输出元素
- 输入元素 - 用于执行活动的用户界面元素,存储在
UIElement
对象中。 此字段仅支持UIElement
对象。 可以从其他用户界面自动化活动的 输出元素 属性字段获取此对象。 - 输出元素 - 输出目标用户界面元素并将其存储在
UIElement
对象中,该对象可进一步用于通过其他活动定位同一元素。
其他
- “私有” - 如果选中,则不再以“Verbose”级别记录变量和参数的值。 此字段仅支持
Boolean
(True和 False) 值。 默认值为 False。
选项
- 执行 环境 - 用于执行脚本的 JavaScript 环境。 从下拉菜单中选择两个选项之一:
- “隔离 ” - 允许访问 HTML 元素,但禁止访问页面变量和代码。 使用此选项可确保脚本执行不会与页面冲突。 这是默认选择。
- “页面” - 允许访问 HTML 元素、页面变量和代码。 如果您需要访问页面变量(例如
jQuery $
)或与页面代码交互(例如window.alert
),请使用此选项。 要修复此特定于 MV3 扩展程序的 已知问题 ,则需要使用此选项。
您可以通过 “ 项目设置”更改所有“注入 Js 脚本”活动的“执行”世界属性。
输出
- “脚本输出”- JavaScript 代码返回的字符串结果。
-
在屏幕上指定目标 - 指定要用作目标的用户界面元素。
指定目标后,选择加号按钮以访问以下选项:
- “在屏幕上指定目标”- 再次指定目标。
- 编辑目标 - 打开选择模式以配置目标。
-
“脚本代码”- 要运行的 JavaScript 代码。可在此处将其写作字符串形式,或添加包含待执行代码的
.js
文件的完整路径。其应包含单个匿名函数,如下例所示。function (element, input) { return "result"; }
function (element, input) { return "result"; }async function (element, input) { const asyncResult = await new Promise((resolvePromiseCb) => { const timeoutMs = 100; setTimeout(() => { resolvePromiseCb("async_result"); }, timeoutMs); }); return asyncResult; }
async function (element, input) { const asyncResult = await new Promise((resolvePromiseCb) => { const timeoutMs = 100; setTimeout(() => { resolvePromiseCb("async_result"); }, timeoutMs); }); return asyncResult; }其中element
表示与调用用户界面节点对应的 HTML 元素,input
表示调用者提供的输入字符串。
其他选项
计时
-
“在此之前延迟”- 上一个活动完成与此活动开始执行任何操作之间的延迟(以秒为单位)。默认值为 0.2 秒。在活动之间添加延迟可确保一个活动有足够的时间完成,然后再开始下一个活动。
-
“延迟 时间” - 此活动完成与下一个活动开始执行任何操作之间的延迟时间(以秒为单位)。 默认值为 0.3 秒。 在活动之间添加延迟可确保一个活动有足够的时间完成,然后再开始下一个活动。
-
“超时”- 指定最长等待时间(以秒为单位),如果超出该时间后活动并未执行,系统便会抛出错误。 默认值为 30 秒。
-
“出错时继续” - 指定在活动引发错误时是否应继续自动化操作。 此字段仅支持
Boolean
值(True、 False)。 默认值为 False。 因此,如果该字段为空且活动引发错误,系统将停止执行项目。 如果该值设置为 True,则无论出现何种错误,系统都将继续执行项目。
选项
- 执行 环境 - 用于执行脚本的 JavaScript 环境。 从下拉菜单中选择两个选项之一:
- “隔离 ” - 允许访问 HTML 元素,但禁止访问页面变量和代码。 使用此选项可确保脚本执行不会与页面冲突。 这是默认选择。
- “页面” - 允许访问 HTML 元素、页面变量和代码。 如果您需要访问页面变量(例如
jQuery $
)或与页面代码交互(例如window.alert
),请使用此选项。 要修复此特定于 MV3 扩展程序的 已知问题 ,则需要使用此选项。
您可以通过 “ 项目设置”更改所有“注入 Js 脚本”活动的“执行”世界属性。
输出
- “脚本输出”- JavaScript 代码返回的字符串结果。
输入/输出
- 输入元素 - 用于执行活动的用户界面元素,存储在
UIElement
对象中。 此字段仅支持UIElement
对象。 可以从其他用户界面自动化活动的 输出元素 属性字段获取此对象。 - 输出元素 - 输出目标用户界面元素并将其存储在
UIElement
对象中,该对象可进一步用于通过其他活动定位同一元素。