在 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。现在可以使用用户界面探测器来识别页面上的单独用户界面元素。