UiPath Studio Guide

Identifying UI Elements in PDF With Accessibility Options

Important:

Accessibility options in Adobe Reader DC 19 cause improper detection of UI elements in PDF files which are poorly, or not tagged. For the time being, we recommend using Adobe Reader 18, or a lower version of Adobe Reader DC 18.

Active Accessibility is an API which provides greater reading support for individuals with physical or cognitive difficulties. When enabled in programs, such as Adobe Reader, access, identification, or manipulation of UI elements can become difficult or prone to errors.

In Studio, this means that elements on a page of a PDF file are identified as a whole, rather than individually.

Below there are a couple of examples of UI element identification issues in PDF files you might encounter, as well as how to solve them.

Tagged PDF Documents

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 UIExplorer. This interferes with the detection of individual elements on the page itself, as you can see below:

To fix this, the document Accessibility reading order needs to be changed, by following these steps:

  1. In Adobe Reader, open the Edit menu, and click the Change Reading Options option from the Accessibility sub-menu. The Change Reading Options of Current Document window is displayed.
  2. From the Reading Order drop-down, select the Infer reading order from document option. This instructs Adobe Reader to ignore Active Accessibility when reading the document.
  3. In the Reading Mode Options section, select the Read the entire document option.
  4. Click the Start button. UIExplorer can now be used to identify individual UI elements on the page.

Single Visible Object on Page

Here, the document contains a single Active Accessibility object which is visible on a page, composed of multiple elements, such as text and pictures. However, when printed or read by Accessibility options, the object is decomposed in individual elements. The issue here is the same, as you can see:

Again, the fix is to change the document Accessibility reading order, as follows:

  1. In Adobe Reader, open the Edit menu, and click the Change Reading Options option from the Accessibility sub-menu. The Change Reading Options of Current Document window is displayed.
  2. From the Reading Order drop-down, select the Use reading order in raw print stream option. This instructs Adobe Reader to ignore Active Accessibility when reading the document.
  3. In the Reading Mode Options, select the Read the entire document option.
  4. Click the Start button. UIExplorer can now be used to identify individual UI elements on the page.

Identifying UI Elements in PDF With Accessibility Options


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.