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 diesem Szenario enthält die PDF-Datei Metainformationen innerhalb des Seiteninhalts. Das bedeutet, dass die Zugriffsoptionen die eingebetteten Informationen (insgesamt anstatt sichtbare Seitenelemente) lesen und dem UI-Explorer präsentieren. Dies wirkt sich auf die Erkennung einzelner Elemente auf der Seite selbst aus:

Adobe Reader 2024

Um die Option Ganzes Dokument lesen festzulegen, führen Sie die folgenden Schritte in Adobe Reader 2024 aus:

1. Gehen Sie zu Menü > Einstellungen.
2. Wählen Sie in der Liste Kategorien die Option Lesen aus.
3. Wählen Sie unter Seite im Vergleich zu Dokument die Option Ganzes Dokument lesen aus dem Dropdownmenü aus.
4. Aktivieren Sie unter Lesereihenfolgeoptionen das Kontrollkästchen Lesereihenfolge in mit Tags versehenen Dokumenten überschreiben.
   
   

   

   
   
5. Um die Änderungen zu speichern, wählen Sie OK aus.

Adobe Reader DC 19

Die Auswahl von UI-Elementen in nicht markierten PDF-Dateien ist nur für Adobe Reader DC 19.012.20040 oder höher möglich. Sie müssen PDF-Dateien mit Tags versehen, damit die interaktive UI-Elementauswahl funktioniert.

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. Klicken Sie auf die Schaltfläche Starten (Start). UIExplorer kann jetzt zum Erkennen einzelner UI-Elemente auf der Seite verwendet werden.
   
   

   

   
   

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. Klicken Sie auf die Schaltfläche Starten (Start). UIExplorer kann jetzt zum Erkennen einzelner UI-Elemente auf der Seite verwendet werden.
   
   

   

   
   

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

Hinweis: Dieses Problem wurde in UiPath.UIAutomation.Activities Version 22.12 behoben.

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. Gehen Sie zu Menü > Einstellungen.
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. Starten Sie Adobe Reader neu. UIExplorer kann jetzt zum Identifizieren einzelner UI-Elemente auf der Seite verwendet werden.