- 入门指南
- 设置和配置
- 自动化项目
- 依赖项
- 工作流类型
- 控制流程
- 文件比较
- 自动化最佳实践
- 源代码控件集成
- 调试
- 日志记录
- 诊断工具
- 工作流分析器
- 变量
- 参数
- 导入的命名空间
- 编码自动化
- 基于触发器的 Attended 自动化
- 对象存储库
- ScreenScrapeJavaSupport 工具
- 扩展程序
- Studio 测试
- 故障排除
特定于 MV3 扩展程序的已知问题
面向 Chrome 的 MV3 扩展程序的已知问题,包括 javascript: URI 单击处理程序的单击活动限制。
在特定网页元素上使用“模拟”的“单击”活动失败
The Click activity with the Simulate input method no longer works on HTML elements that have a click handler with javascript: URI.
在这种情况下,模拟点击将不会生效,也不会报告任何错误。
这已报告为 Chromium 错误。此问题非常罕见,因为很少有 HTML 元素在此表单中具有单击处理程序。
解决方法
此问题有两种解决方法:
- 确定工作流中失败的“选择”活动,并将输入法从“模拟”更改为任何其他输入法(Chromium API、硬件事件、窗口消息)。
- 升级到 UiPath.UIAutomation.Activities 包 v22.12 或更高版本,并使用“项目设置” 中的“启用使用 MV3 扩展程序的模拟选择的解决方法” 。
必须明确允许开发者工具访问权限
从 Chrome 149 开始,使用“组策略”安装 UiPath Chrome 扩展程序时,必须明确允许开发者工具访问权限。
解决方法
选项 1. 使用 DeveloperToolsAvailabilityAllowlist 和 DeveloperToolsAvailabilityBlocklist
通过 DeveloperToolsAvailabilityAllowlist 和 DeveloperToolsAvailabilityBlocklist 策略,您可以仅为 UiPath 扩展程序 ID 启用开发者工具,同时对其他所有扩展程序禁用这些工具。此方法可保留您的浏览器加固状态,是托管环境或安全环境的推荐选项。
如果使用“组策略”安装了 UiPath Chrome 扩展程序,则 DeveloperToolsAvailabilityAllowlist 和 DeveloperToolsAvailabilityBlocklist 会自动配置为启用扩展程序的全部功能。
您可以通过运行包含以下内容的 .reg 文件,或在注册表中手动配置策略,来应用此策略:
Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Google\Chrome\DeveloperToolsAvailabilityAllowlist]
"1"="chrome-extension://ndmegdjihnhfmljjoaiimbipfhodnbgf"
"2"="chrome-extension://pgbnimfaaifjpebleldfhgcjdnaeafdi"
[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Google\Chrome\DeveloperToolsAvailabilityBlocklist]
"1"="https://uipath-devtools-blocklist-placeholder.invalid/"
Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Google\Chrome\DeveloperToolsAvailabilityAllowlist]
"1"="chrome-extension://ndmegdjihnhfmljjoaiimbipfhodnbgf"
"2"="chrome-extension://pgbnimfaaifjpebleldfhgcjdnaeafdi"
[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Google\Chrome\DeveloperToolsAvailabilityBlocklist]
"1"="https://uipath-devtools-blocklist-placeholder.invalid/"
必须应用 DeveloperToolsAvailabilityAllowlist 和 DeveloperToolsAvailabilityBlocklist 策略值才能使更改生效。仅配置 DeveloperToolsAvailabilityAllowlist 还不够。
正确配置这些策略值后,即使DeveloperToolsAvailability=2(禁止使用开发者工具),也能恢复完整 UiPath 扩展程序功能。
选项 2. 将 DeveloperToolsAvailability 设置为 1
在 GPO 中或直接在受影响计算机的 Windows 注册表中将 DeveloperToolsAvailability 策略配置为 1(允许使用开发者工具)。
您可以通过运行包含以下内容的 .reg 文件,或在注册表中手动配置策略,来应用此策略:
Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Google\Chrome]
"DeveloperToolsAvailability"=dword:00000001
Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Google\Chrome]
"DeveloperToolsAvailability"=dword:00000001
DeveloperToolsAvailability 策略可能的值如下:
- 0 - 禁止在通过企业策略安装的应用程序和扩展程序上使用开发者工具,或者从版本 114 开始,如果是托管用户,则禁止在浏览器内置扩展程序上使用。允许在其他上下文中使用开发者工具。
- 1 - 允许使用开发者工具。
- 2 - 禁止使用开发者工具。
如果将 DeveloperToolsAvailability 设置为 2,将会出现以下限制:
InjectJS活动无法运行。ChromiumAPI输入法无法运行。- 适用于 Chrome 的 UiPath 扩展程序仅限
UiPath.UiAutomation.Activities的 LTS 版本。
如果您的组织使用组策略进行浏览器扩展程序管理,并设置了不同的值,则 DeveloperToolsAvailabilityAllowlist / DeveloperToolsAvailabilityBlocklist 或 DeveloperToolsAvailability 策略值可能会被覆盖。
选项 3. 切换为使用 Chromium 自动化,而非浏览器扩展程序
此操作使用 Chromium 自动化方法(而非“浏览器扩展程序”)实现浏览器自动化。
当 DeveloperToolsAvailability 组策略设置为 2 时,Chromium 自动化会被阻止。
UiPath 网页自动化浏览器窗口显示警告
如果无法启动 ChromeNativeMessaging.exe,UiPath 网页自动化浏览器窗口将显示以下警告:Cannot communicate with UiPath Platform The native part of the extension is not configured correctly.
从 UiPath Studio 中重新安装扩展程序。
无法再使用“注入 JS 脚本”活动来访问页面变量和代码
默认情况下,“注入 Js 脚本”活动不能再用于访问页面变量,例如jQuery $,或与页面代码交互(例如,window.alert)。 “注入 Js 脚本”活动不会报告错误,但脚本将无法执行,并且将在浏览器开发者工具 (F12) 中报告以下错误:Refused to execute inline script because it violates the following Content Security Policy directive。
这是 MV3 平台引入的限制。
解决方案
要解决此问题,请从“注入 JS 脚本”活动中选择“执行环境 - 页面”选项。
从 UiPath.UIAutomation.Activities v22.12.0-preview 开始提供此属性。
Your existing JavaScript code doesn't require any changes, and by using the Execution world - Page option it will work for both MV2 and MV3 extensions.
“打开浏览器”活动的超时时间不足
对于 MV3 扩展程序,浏览器将在加载网页的稍后加载扩展程序。这意味着,在速度较慢的计算机上, UiPath.UiAutomation.Activities 22.10 或更低版本中的“打开浏览器”活动可能会在扩展程序启动前达到 20 秒的内部超时时间。
从 v22.12.0 预览版开始,“打开浏览器”活动的内部超时已从 20 秒增加到 60 秒。
由于您可能需要为浏览器启动设置更长的超时时间,因此现在可以通过“使用应用程序/浏览器”和“打开浏览器”活动对其进行配置。已添加以下项目设置:
- 用户界面自动化传统 → 浏览器 → 打开浏览器超时 (秒)
- 用户界面自动化新式 → 应用程序/浏览器 → 打开浏览器超时 (秒)
此外,您可以通过 UIPATH_OPEN_BROWSER_TIMEOUT_SECONDS 环境变量配置超时。 例如,将 UIPATH_OPEN_BROWSER_TIMEOUT_SECONDS=120 设置为使用 120 秒作为活动的超时时间。