在 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 文档

In this scenario, the PDF file contains meta-information inside the page content. This means that Accessibility options read the embedded information (as a whole, instead of visible page elements) and present it to UI Explorer. This interferes with the detection of individual elements on the page itself:

Adobe Reader 2024

To set the Read the entire document option, follow these steps in Adobe Reader 2024:

1. Go to Menu > Preferences.
2. From the Categories list, select Reading.
3. Under Page vs Document, select the Read the entire document option from the drop-down menu.
4. Under Reading Order Options, select the Override the reading order in tagged documents checkbox.
   
   

   

   
   
5. To save the changes, select OK.

Adobe Reader DC 19

The selection of UI elements inside untagged PDF files is only possible for Adobe Reader DC 19.012.20040 or greater. You need to tag PDF files for interactive UI element selection to function.

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

1. 在 Adobe Reader 中，打开编辑菜单，然后单击“辅助工具”子菜单中的“更改阅读选项”选项。系统将显示“更改当前文档的阅读选项”窗口。
2. 从阅读顺序下拉列表中，选择“标记的阅读顺序”选项。这将指示 Adobe Reader 在阅读文档时忽略 Active Accessibility。
3. 在阅读模式选项部分，选择“阅读整个文档”选项。
4. Click the Start button. UI Explorer can now be used to identify individual UI elements on the page.
   
   

   

   
   

Adobe Reader DC 18

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

1. 在 Adobe Reader 中，打开编辑菜单，然后单击“辅助工具”子菜单中的“更改阅读选项”选项。系统将显示“更改当前文档的阅读选项”窗口。
2. 从阅读顺序下拉列表中，选择“根据文档推断阅读顺序”选项。这将指示 Adobe Reader 在阅读文档时忽略 Active Accessibility。
3. 在阅读模式选项部分，选择“阅读整个文档”选项。
4. Click the Start button. UI Explorer can now be used to identify individual UI elements on the page.
   
   

   

   
   

页面上的单个可见对象

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

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

1. 在 Adobe Reader 中，打开编辑菜单，然后单击“辅助工具”子菜单中的“更改阅读选项”选项。系统将显示“更改当前文档的阅读选项”窗口。
2. 从阅读顺序下拉列表中，选择“在原始打印流中使用阅读顺序”选项。这将指示 Adobe Reader 在阅读文档时忽略 Active Accessibility。
3. 在阅读模式选项中，选择“阅读整个文档”选项。

4. 单击“开始”按钮。现在可以使用用户界面探测器来识别页面上的单独用户界面元素。

   
   

   

   
   

Security option in Adobe Reader DC

Note: This issue has been fixed in UiPath.UIAutomation.Activities version 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. Go to Menu > Preferences.
3. 从“类别”列表中，选择“安全性 (增强)”。
4. 在“沙盒保护”部分中，清除“启动时启用保护模式”复选框。
   
   

   

   
   
5. 系统将请求您确认。单击“是”以继续，然后单击“确定”。
6. Restart Adobe Reader. UI Explorer can now be used to identify individual UI elements on the page.