订阅

UiPath Studio

UiPath Studio 指南

在 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 在读取文档时忽略主动式辅助。
  3. 在“阅读模式选项”部分,选择“阅读整个文档”选项。
  4. 单击“开始”按钮。现在可以使用用户界面探测器来识别页面上的单独用户界面元素。

Adobe Reader DC 18

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

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

页面上的单个可见对象

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

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

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

大约一年前更新

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


建议的编辑仅限用于 API 参考页面

您只能建议对 Markdown 正文内容进行编辑,而不能建议对 API 规范进行编辑。