Studio
2023.10
false
Studio 用户指南
Last updated 2024年7月15日

在 PDF 中使用辅助功能选项来识别用户界面元素

备注:

以下版本的 Adobe Reader DC 不支持检测无标记 PDF 文件中的用户界面元素:

  • 19.012.20036
  • 19.012.20035
  • 19.012.20034
  • 19.010.20100
  • 19.010.20099
  • 19.010.20098
  • 19.010.20091
  • 19.010.20069
  • 19.010.20064
  • 19.008.20081
  • 19.008.20080
  • 19.008.20074
  • 19.008.20071

我们建议使用 Adobe Reader DC 18 或 Adobe Reader DC 19.012.20040 或更高版本。

主动式辅助是一种 API,它为残障人士或者存在认知困难的认识提供了更好的阅读支持。在程序(如 Adobe Reader)中启用主动式辅助时,用户界面元素的访问、标识或操作可能变得困难或容易出错。

在 Studio 中,这意味着 PDF 文件页面上的元素被作为一个整体来识别,而不是单独识别。

下面是您在 PDF 文件中可能遇到的用户界面元素识别问题的几个例子,以及这些问题的解决方法。

UiPath.UIAutomation.Activities 包 v19.5.0 版起,更改当前文档的阅读选项窗口将会自动打开,且会根据您的屏幕指示选中相应选项。不过,若您在元素选取时仍遇到问题,我们建议您手动调整“辅助”选项,如下所述。



标记的 PDF 文档

在此场景中,PDF 文件包含页面内容中的元信息。这意味着辅助选项读取嵌入的信息(作为一个整体,而不是可见的页面元素),并将其呈现给用户界面探测器。这会干扰对页面本身中各个元素的检测,如下所示:



Adobe Reader DC 19

请注意,只有在 Adobe Reader DC 19.012.20040 或更高版本中,才支持从无标记 PDF 文件中选取用户界面元素。您需要标记 PDF 文件,以便交互式用户界面元素选择发挥作用。

在 PDF 文件标记之后,您需要选择以下选项:

  1. 在 Adobe Reader 中,打开编辑菜单,然后单击“辅助工具”子菜单中的“更改阅读选项”选项。系统将显示“更改当前文档的阅读选项”窗口。
  2. 阅读顺序下拉列表中,选择“标记的阅读顺序”选项。这将指示 Adobe Reader 在阅读文档时忽略 Active Accessibility。
  3. 阅读模式选项部分,选择“阅读整个文档”选项。
  4. 单击“开始”按钮。现在可以使用用户界面探测器来识别页面上的单独用户界面元素。


Adobe Reader DC 18

要解决这个问题,需要通过以下步骤更改文档辅助阅读顺序:

  1. 在 Adobe Reader 中,打开编辑菜单,然后单击“辅助工具”子菜单中的“更改阅读选项”选项。系统将显示“更改当前文档的阅读选项”窗口。
  2. 阅读顺序下拉列表中,选择“根据文档推断阅读顺序”选项。这将指示 Adobe Reader 在阅读文档时忽略 Active Accessibility。
  3. 阅读模式选项部分,选择“阅读整个文档”选项。
  4. 单击“开始”按钮。现在可以使用用户界面探测器来识别页面上的单独用户界面元素。


页面上的单个可见对象

在这里,文档包含一个在页面上可见的主动式辅助对象,该对象由多个元素(如文本和图片)组成。但是,当通过辅助选项进行打印或读取时,对象将被分解为单独元素。这里的问题是一样的,您可以看到:



同样,解决方法是更改文档的辅助阅读顺序,如下所示:

  1. 在 Adobe Reader 中,打开编辑菜单,然后单击“辅助工具”子菜单中的“更改阅读选项”选项。系统将显示“更改当前文档的阅读选项”窗口。
  2. 阅读顺序下拉列表中,选择“在原始打印流中使用阅读顺序”选项。这将指示 Adobe Reader 在阅读文档时忽略 Active Accessibility。
  3. 阅读模式选项中,选择“阅读整个文档”选项。
  4. 单击“开始”按钮。现在可以使用用户界面探测器来识别页面上的单独用户界面元素。



Security option in Adobe Reader DC

备注:

此问题已在 UiPath.UIAutomation.Activities 版本 22.12 中修复。

即使启用了“保护模式”安全选项,PDF 自动化也能正常工作。

对于 UiPath.UIAutomation.Activities 22.10 及更低版本以及 Adobe Reader DC 版本 22.003.20258(请参阅 Acrobat Reader 发行说明),PDF 自动化可能会受到影响。无法识别 PDF 文档中的各个元素,而是选择整个文档。

此问题可能是由 Adobe Reader DC 中提供的安全选项所引起:默认情况下“启动时启用保护模式”处于启用状态。

要解决此问题,请按照以下步骤禁用安全选项:

  1. 打开 Adobe Reader。
  2. 转到“编辑”>“首选项”。
  3. 从“类别”列表中,选择“安全性 (增强)”。
  4. 在“沙盒保护”部分中,清除“启动时启用保护模式”复选框。
  5. 系统将请求您确认。单击“是”以继续,然后单击“确定”。
  6. 重新启动 Adobe Reader。现在可以使用用户界面探测器来识别页面上的单独用户界面元素。


  • 标记的 PDF 文档
  • Adobe Reader DC 19
  • Adobe Reader DC 18
  • 页面上的单个可见对象
  • Security option in Adobe Reader DC

此页面有帮助吗?

获取您需要的帮助
了解 RPA - 自动化课程
UiPath Community 论坛
Uipath Logo White
信任与安全
© 2005-2024 UiPath。保留所有权利。