Erkennen von UI-Elementen in PDF mit Zugriffsoptionen.

Hinweis:

Die Erkennung von UI-Elementen für nicht markierte PDF-Dateien wird für die folgenden Versionen von Adobe Reader DC nicht unterstützt:

• 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

Es wird empfohlen, Adobe Reader DC 18 oder Adobe Reader DC 19.012.20040 oder höher zu verwenden.

Active Accessibility ist eine API, die bessere Unterstützung beim Lesen für Personen mit physischen oder kognitiven Problemen bietet. Bei Aktivierung in Programmen wie Adobe Reader können Zugriff, Erkennung oder Manipulation von UI-Elementen schwierig oder fehlerbehaftet sein.

In Studio bedeutet dies, dass Elemente auf einer Seite in PDF-Dateien insgesamt anstatt einzeln erkannt werden.

Nachfolgend sind einige Beispiele für Probleme mit der UI-Elementerkennung in PDF-Dateien aufgeführt, auf die Sie stoßen können, und wie sie zu lösen sind.

Ab Version 19.5.0 des UiPath.UIAutomation.Activities-Pakets wird das Fenster Leseoptionen des aktuellen Dokuments ändern automatisch geöffnet, und die entsprechenden Optionen werden ausgewählt, wenn Sie auf ein Element auf dem Bildschirm deuten. Falls bei der Auswahl der Elemente weiterhin Probleme auftreten, wird empfohlen, wie unten beschrieben die Barrierefreiheitsoptionen anzupassen.

PDF-Dokumente mit Tags

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.

Nachdem die PDF-Dateien mit Tags versehen wurden, müssen Sie folgende Option auswählen:

1. Öffnen Sie in Adobe Reader das Menü Bearbeiten (Edit) und klicken Sie auf Leseoptionen ändern (Change Reading Options) im Untermenü Zugriff. Das Fenster Leseoptionen des aktuellen Dokuments ändern (Change Reading Options of Current Document wird eingeblendet.
2. Wählen Sie aus der Dropdownliste Lesereihenfolge (Reading Order) die Option Mit Tags festgelegte Lesereihenfolge (Tagged reading order). Damit wird Adobe Reader angewiesen, Active Accessibility beim Lesen des Dokuments zu ignorieren.
3. Wählen Sie im Abschnitt Lesemodusoptionen (Reading Mode Options) die Option Ganzes Dokument lesen (Read the entire document) aus.
4. Click the Start button. UI Explorer can now be used to identify individual UI elements on the page.
   
   

   

   
   

Adobe Reader DC 18

Um dieses Problem zu lösen, muss die Reihenfolge des Lesenzugriffs im Dokument folgendermaßen geändert werden:

1. Öffnen Sie in Adobe Reader das Menü Bearbeiten (Edit) und klicken Sie auf Leseoptionen ändern (Change Reading Options) im Untermenü Zugriff. Das Fenster Leseoptionen des aktuellen Dokuments ändern (Change Reading Options of Current Document wird eingeblendet.
2. Wählen Sie aus der Dropdownliste Lesereihenfolge (Reading Order) die Option Lesereihenfolge aus Dokument ableiten (Infer reading order from document). Damit wird Adobe Reader angewiesen, Active Accessibility beim Lesen des Dokuments zu ignorieren.
3. Wählen Sie im Abschnitt Lesemodusoptionen (Reading Mode Options) die Option Ganzes Dokument lesen (Read the entire document) aus.
4. Click the Start button. UI Explorer can now be used to identify individual UI elements on the page.
   
   

   

   
   

Einzelnes sichtbares Objekt auf Seite

Hier enthält das Dokument ein einzelnes Active Accessibility-Objekt, das auf einer Seite sichtbar und aus mehreren Elementen zusammengesetzt ist, wie etwa Text und Bilder. Beim Drucken oder Lesen mit Accessibility-Optionen wird das Objekt jedoch in einzelne Elemente zerlegt. Wie Sie sehen können, ist das Problem hierbei dasselbe:

Um das Problem zu lösen, müssen Sie auch hier die Lesereihenfolge beim Zugriff auf das Dokument folgendermaßen ändern:

1. Öffnen Sie in Adobe Reader das Menü Bearbeiten (Edit) und klicken Sie auf Leseoptionen ändern (Change Reading Options) im Untermenü Zugriff. Das Fenster Leseoptionen des aktuellen Dokuments ändern (Change Reading Options of Current Document wird eingeblendet.
2. Wählen Sie aus der Dropdownliste Lesereihenfolge (Reading Order) die Option Lesereihenfolge im rohen Druck-Stream verwenden) aus. Damit wird Adobe Reader angewiesen, Active Accessibility beim Lesen des Dokuments zu ignorieren.
3. Wählen Sie in den Lesemodusoptionen (Reading Mode Options) die Option Ganzes Dokument lesen (Read the entire document) aus.

4. Klicken Sie auf die Schaltfläche Starten (Start). UIExplorer kann jetzt zum Erkennen einzelner UI-Elemente auf der Seite verwendet werden.

   
   

   

   
   

Security option in Adobe Reader DC

Note: This issue has been fixed in UiPath.UIAutomation.Activities version 22.12.

Die PDF-Automatisierung funktioniert auch dann, wenn die Sicherheitsoption Geschützter Modus aktiviert ist.

Für UiPath.UIAutomation.Activities 22.10 und älter sowie Adobe Reader DC Version 22.003.20258 (siehe Versionshinweise zu Acrobat Reader) kann die PDF-Automatisierung betroffen sein. Es ist nicht möglich, einzelne Elemente in PDF-Dokumenten zu identifizieren, stattdessen wird das gesamte Dokument ausgewählt.

Dieses Problem kann durch eine Sicherheitsoption verursacht werden, die in Adobe Reader DC verfügbar ist: Geschützten Modus beim Start aktivieren ist standardmäßig aktiviert.

Um dies zu beheben, deaktivieren Sie die Sicherheitsoption mit den folgenden Schritten:

1. Öffnen Sie den Adobe Reader.
2. Go to Menu > Preferences.
3. Wählen Sie in der Liste Kategorien die Option Sicherheit (erweitert) aus.
4. Deaktivieren Sie im Abschnitt Sandbox-Schutz das Kontrollkästchen Geschützten Modus beim Start aktivieren.
   
   

   

   
   
5. Eine Bestätigung wird angefordert. Klicken Sie auf Ja, um fortzufahren, und klicken Sie dann auf OK.
6. Restart Adobe Reader. UI Explorer can now be used to identify individual UI elements on the page.