在 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 文件包含页面内容中的元信息。这意味着辅助选项读取嵌入的信息（作为一个整体，而不是可见的页面元素），并将其呈现给 UI Explorer。这会干扰对页面本身中各个元素的检测：

Adobe Reader 2024

要设置“阅读整个文档”选项，请在 Adobe Reader 2024 中执行以下步骤：

1. 转到“菜单 > 首选项”。

2. 从“类别”列表中，选择“阅读”。

3. 在“页面与文档”下，从下拉菜单中选择“读取整个文档”选项。

4. 在“阅读顺序选项”下，选择“覆盖标记文档中的阅读顺序”复选框。

   

5. 要保存更改，请选择“确定”。

Adobe Reader DC 19

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

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

1. 在 Adobe Reader 中，打开“编辑”菜单，然后从“辅助工具”子菜单中单击“更改阅读选项”选项。系统将显示“更改当前文档的阅读选项”窗口。

2. 从“阅读顺序”下拉菜单中，选择“标记的阅读顺序”选项。这将指示 Adobe Reader 在读取文档时忽略主动式辅助。

3. 在“阅读模式选项”部分，选择“阅读整个文档”选项。

4. 单击“开始”按钮。 UI Explorer 现在可用于识别页面上的各个 UI 元素。

   

Adobe Reader DC 18

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

1. 在 Adobe Reader 中，打开“编辑”菜单，然后从“辅助工具”子菜单中单击“更改阅读选项”选项。系统将显示“更改当前文档的阅读选项”窗口。

2. 从“阅读顺序”下拉列表中，选择“从文档推断阅读顺序”选项。这将指示 Adobe Reader 在读取文档时忽略主动式辅助。

3. 在“阅读模式选项”部分，选择“阅读整个文档”选项。

4. 单击“开始”按钮。 UI Explorer 现在可用于识别页面上的各个 UI 元素。

   

页面上的单个可见对象

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

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

1. 在 Adobe Reader 中，打开“编辑”菜单，然后从“辅助工具”子菜单中单击“更改阅读选项”选项。系统将显示“更改当前文档的阅读选项”窗口。

2. 从“阅读顺序”下拉列表中，选择“使用原始打印流中的阅读顺序”选项。这将指示 Adobe Reader 在读取文档时忽略主动式辅助。

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 文档中的单个元素，而是选择整个文档。

This issue is caused by a security option available in Adobe Reader DC, Enable Protected Mode at startup, which is enabled by default.

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

1. 打开 Adobe Reader。

2. 转到“菜单 > 首选项”。

3. From the Categories list, select Security (Enhanced).

4. 在“沙盒保护”部分中，清除“启动时启用保护模式”复选框。

   

5. A confirmation is requested. Click Yes to continue, then click OK.

6. 重新启动 Adobe Reader。现在可以使用用户界面探测器来识别页面上的单独用户界面元素。