浏览器文件选取器作用域

UiPath.UIAutomationNext.Activities.NBrowserFilePickerScope

描述

捕获并处理浏览器文件选取器对话框。此活动应用于打开文件选取器对话框的活动的作用域。

支持 Windows、MacOS 和 Linux 上的 Chrome 和 Edge 浏览器。

此活动必须添加到“使用应用程序/浏览器”活动中。

项目兼容性

Windows | 跨平台

配置

设计器面板

• 从“模式”下拉菜单中，选择要执行的上传类型：
  • 单个文件
  • 多个文件
• 文件路径- 要在文件选取器对话框中输入的文件路径。
  • 当“模式” = “单个文件”时，请提供字符串或字符串变量。
  • 当“模式” = “多个文件”时，请提供文件路径集合 ( List<String> )
• 触发文件选取器的操作- 在此处添加打开文件选取器对话框的活动。

属性面板

计时

• “等待对话框显示超时”- 指定在引发错误之前等待文件选取器对话框显示的时间（以秒为单位）。默认值为 30 秒。

选项

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

已知限制

“浏览器文件选取器作用域”活动具有以下限制：

• 浏览器兼容性：仅在Google Chrome或Microsoft Edge中支持。
• 扩展程序权限: 需要为浏览器扩展程序启用“允许访问文件 URL”权限。
• 输入方法要求：触发文件选取器对话框的活动（例如“单击”活动）必须使用Chromium API或HardwareEvents输入方法。必须通过用户交互激活该页面，然后才能打开文件选取器，并且只有这两种输入方法可以模拟必要的交互。
• 不支持的 API ： 不支持 通过“显示打开文件选取器”API 打开的文件选取器对话框。

允许文件访问

“浏览器文件选取器作用域”活动要求浏览器扩展程序具有访问文件的权限。

您可以按照以下说明，通过相应的浏览器扩展程序启用文件 URL 的访问权限来满足此要求：

• 对于Google Chrome
• 对于Microsoft Edge

另一种方法是使用命令行标志--disable-extensions-file-access-check启动浏览器。该标志仅在启动全新的浏览器实例时适用。这可能需要关闭现有的浏览器进程和/或禁用 Edge 中的启动加速功能。

重要提示：此替代方法将允许所有浏览器扩展程序访问文件，这可能会带来安全风险。

通过将此参数添加到使用应用程序/浏览器活动中，即可打开浏览器以允许访问文件。