Über Selektoren

Selektoren in der UI-Automatisierung: Wie sie UI-Elemente, Tag-Struktur, Attributtypen und Best Practices identifizieren.

Um bestimmte Aktionen in der Benutzeroberfläche zu automatisieren, ist es nötig, dass Sie mit verschiedenen Fenstern, Schaltflächen, Dropdownlisten und vielen anderen interagieren. Eine der Möglichkeiten, wie UI-Elemente identifiziert werden können, ist die Verwendung ihrer Position auf dem Bildschirm, aber dies kann unzuverlässig sein

Um dieses Problem zu lösen, verwendet Studio sogenannte Selektoren. Diese speichern die Attribute eines grafischen Benutzeroberflächenelements und die übergeordneten Elemente in Form eines XML-Fragments.

In den meisten Fällen werden Selektoren automatisch von Studio generiert und erfordern keine weiteren Eingaben durch den Benutzer, insbesondere dann nicht, wenn die Apps, die automatisiert werden sollen, über eine statische Benutzeroberfläche verfügen.

Einige Softwareprogramme haben jedoch wechselnde Layouts und Attributknoten mit flüchtigen Werten, wie z. B. einige Web-Apps. Studio kann diese Änderungen nicht vorhersagen. Daher müssen Sie möglicherweise einige Selektoren manuell generieren.

Ein Selektor hat folgende Struktur:

<node_1/><node_2/>...<node_N/>

Der letzte Knoten repräsentiert das gewünschte GUI-Element und alle vorherigen repräsentieren die übergeordneten Elemente dieses Elements. <node_1> wird normalerweise als Stammknoten bezeichnet und stellt das Fenster der obersten Ebene der App dar.

Jeder Knoten verfügt über ein oder mehrere Attribute, mit denen Sie eine bestimmte Ebene der ausgewählten Anwendung korrekt identifizieren können.

Ein Knoten hat das folgende Format:

<ui_system attr_name_1='attr_value_1' ... attr_name_N='attr_value_N'/>

Jedes Attribut besitzt einen zugewiesenen Wert. Es ist wichtig, Attribute mit einem konstanten Wert auszuwählen. Wenn sich der Wert eines Attributs jedes Mal ändert, wenn die App gestartet wird, kann der Selektor das Element nicht korrekt identifizieren.

Selektoren werden im Eigenschaftenbereich der Aktivitäten unter Eingabe > Ziel > Selektor angezeigt. Alle Aktivitäten im Zusammenhang mit grafischen Elementen haben diese Eigenschaft.

Das Fenster Auswahloptionen ermöglicht es Ihnen, ein Ziel auszuwählen und zu bearbeiten. Um auf dieses Fenster zuzugreifen, klicken Sie im Bereich Workflow-Designer im Text einer Aktivität auf die Optionsschaltfläche und wählen Sie Ziel auf Bildschirm anzeigen oder Ziel bearbeiten aus.

Das Fenster Selector-Editor ermöglicht es Ihnen, automatisch generierte Selektoren anzuzeigen und diese und deren Attribute zu bearbeiten. Um auf dieses Fenster zuzugreifen, verwenden Sie die Ellipsenschaltfläche neben dem Feld Selektor im Eigenschaftenbereich .

Option	Beschreibung
Überprüfen	Die Schaltfläche zeigt den Status des Selektors durch Überprüfen der Gültigkeit der Selektordefinition und die Sichtbarkeit des Zielelements auf dem Bildschirm. Die Schaltfläche Überprüfen hat drei Zustände: Selektor wird validiert Gültiger Selektor Ungültiger Selektor Geänderter Selektor, neu validieren Die Schaltfläche ist mit UI Explorer-Validierungsstatus korreliert.
Element angeben	Geben ein neues UI-Element an, um das vorherige zu ersetzen.
Reparieren	Ermöglicht Ihnen, dasselbe UI-Zielelement erneut anzugeben und den Selektor zu reparieren. Diese Operation ersetzt den vorherigen Selektor nicht vollständig. Die Schaltfläche ist nur verfügbar, wenn der Selektor ungültig ist.
Markieren (Highlight)	Stellt das Zielelement in den Vordergrund. Die Hervorhebung bleibt bestehen, bis die Option durch Klicken deaktiviert wird. Die Schaltfläche ist nur aktiviert, wenn der Selektor gültig ist.
Attribute bearbeiten (Edit Attributes)	Enthält alle Anwendungskomponenten, die zur Erkennung der Zielanwendung erforderlich sind (Fenster, Schaltfläche usw.). Dieser Abschnitt ist bearbeitungsfähig
Selektor bearbeiten (Edit Selector)	Enthält den jeweiligen Selektor. Dieser Abschnitt ist bearbeitungsfähig
In UI Explorer öffnen	Startet den UI Explorer. Die Schaltfläche ist nur aktiviert, wenn der Selektor gültig ist.

Hinweis:

In einigen Situationen, in denen Studio und die Zielanwendung mit unterschiedlichen erhöhten Berechtigungen geöffnet werden, funktioniert der Selektor möglicherweise nicht. Wir empfehlen, immer beide Anwendungen mit den gleichen Rechten zu öffnen.

Unterstützte Tags und Attribute

In folgenden Tabellen sehen Sie die Kompatibilität zwischen Tags und Attributen zur Erstellung von Selektoren und der Selektorfähigkeit.

Unter macOS können Selektortypen wie wnd, ax, java und sap für verschiedene Praxisfälle verwendet werden:

• AX-Selektoren sind für alle Arten von macOS-Desktopanwendungen verfügbar.

• SAP-Selektoren sind für SAP GUI für Java auf macOS verfügbar und benötigen einen SAP-Server mit aktiviertem Skripting. Diese Selektoren sind am stabilsten für SAP-Anwendungen und verfügen über die besten Funktionen, wie etwa die Extraktion von Tabellendaten.

• Java-Selektoren sind für Java-Anwendungen verfügbar. Da SAP GUI für Java auch eine Java-basierte Anwendung ist, können Sie mithilfe der Java-Auswahlstrategie von der Standardauswahlstrategie zu Java-Selektoren wechseln.

  Hinweis:

  Selectors generated for Java applications which contain multiple WND tags cannot be used with events monitoring.

WND

Attribut	Fuzzy	RegEx	Berücksichtigung von Groß- und Kleinschreibung	OS
app	✅	✅	✅	Windows macOS
cls	✅	✅	✅	Windows
title	✅	✅	✅	Windows macOS
aaname	✅	✅	✅	Windows
ctrlname (WinForms)	✅	✅	✅	Windows
ctrlid (WinForms)	✅	✅	✅	Windows
idx	❌	❌	❌	Windows macOS
tid	❌	❌	❌	Windows macOS
pid	❌	❌	❌	Windows macOS
isremoteapp	❌	❌	❌	Windows
aastate	✅	✅	✅	Windows
Rolle	✅	✅	✅	macOS
enabled	✅	✅	✅	macOS
fokussiert	✅	✅	✅	macOS
Ausgewählt	✅	✅	✅	macOS
Erweitert	✅	✅	✅	macOS
sapClient (SAP)	✅	✅	✅	Windows macOS
sapLanguage (SAP)	✅	✅	✅	Windows macOS
sapProgram (SAP)	✅	✅	✅	Windows macOS
sapScreen (SAP)	❌	❌	❌	Windows macOS
sapSession (SAP)	❌	❌	❌	Windows macOS
sapSysName (SAP)	✅	✅	✅	Windows macOS
sapSysNumber (SAP)	❌	❌	❌	Windows macOS
sapSysSessionId (SAP)	✅	✅	✅	Windows macOS
sapTransaction (SAP)	✅	✅	✅	Windows macOS
sapUser (SAP)	✅	✅	✅	Windows macOS
curlApplet (Curl)	✅	✅	✅	Windows

HTML

Attribut	Fuzzy	RegEx	Berücksichtigung von Groß- und Kleinschreibung	OS
url	✅	✅	✅	Windows macOS Linux
htmlwindowname	✅	✅	✅	Windows macOS Linux
title	✅	✅	✅	Windows macOS Linux
class	✅	✅	✅	Windows macOS Linux
app	❌	❌	❌	Windows macOS Linux
idx	❌	❌	❌	Windows macOS Linux
pid	❌	❌	❌	Windows macOS Linux
tid	❌	❌	❌	Windows macOS Linux
excludehwnd	❌	❌	❌	Windows macOS Linux
bsid (Browser Session ID)	❌	❌	❌	Windows macOS Linux
isremoteapp	❌	❌	❌	Windows macOS Linux

WEBCTRL

Die Attribute Tag und idx verwenden Zeichenfolgenwerte. Alle anderen WEBCTRL-Attribute haben dynamische Werte.

Attribut	Fuzzy	RegEx	Berücksichtigung von Groß- und Kleinschreibung	OS
tag	✅	✅	✅	Windows macOS Linux
idx	✅	✅	✅	Windows macOS Linux
aaname	✅	✅	✅	Windows macOS Linux
name	✅	✅	✅	Windows macOS Linux
id	✅	✅	✅	Windows macOS Linux
parentid	✅	✅	✅	Windows macOS Linux
class	✅	✅	✅	Windows macOS Linux
css-selector	❌	❌	❌	Windows macOS Linux
innertext	✅	✅	✅	Windows macOS Linux
visibleinnertext	✅	✅	✅	Windows macOS Linux
isleaf	✅	✅	✅	Windows macOS Linux
parentclass	✅	✅	✅	Windows macOS Linux
parentname	✅	✅	✅	Windows macOS Linux
src	✅	✅	✅	Windows macOS Linux
href	✅	✅	✅	Windows macOS Linux
tableCol	✅	✅	✅	Windows macOS Linux
tableRow	✅	✅	✅	Windows macOS Linux
colName	✅	✅	✅	Windows macOS Linux
rowName	✅	✅	✅	Windows macOS Linux
aria-label	✅	✅	✅	Windows macOS Linux
aria-labelledby	✅	✅	✅	Windows macOS Linux

STRG

Attribut	Fuzzy	RegEx	Berücksichtigung von Groß- und Kleinschreibung	OS
Rolle	✅	✅	✅	Windows
name	✅	✅	✅	Windows
automationid	✅	✅	✅	Windows
labeledby	✅	✅	✅	Windows
aastate	✅	✅	✅	Windows
virtualname	✅	✅	✅	Windows
text	✅	✅	✅	Windows
rowName	✅	✅	✅	Windows
idx	❌	❌	❌	Windows

UIA

Attribut	Fuzzy	RegEx	Berücksichtigung von Groß- und Kleinschreibung	OS
accelkey (Accelerator Key)	✅	✅	✅	Windows
acskey (Access Key)	✅	✅	✅	Windows
automationid	✅	✅	✅	Windows
cls	✅	✅	✅	Windows
helpText	✅	✅	✅	Windows
legacyAccHelp (Legacy Accessible Help)	✅	✅	✅	Windows
enabled	✅	✅	✅	Windows
kbfocus (Is Keyboard Focusable)	✅	✅	✅	Windows
ispwd (Is Password)	✅	✅	✅	Windows
itemstatus	✅	✅	✅	Windows
itemtype	✅	✅	✅	Windows
rtid (Runtime ID)	✅	✅	✅	Windows
Rolle	✅	✅	✅	Windows
name	✅	✅	✅	Windows
pid	✅	✅	✅	Windows
tableRow	❌	❌	❌	Windows
tableCol	❌	❌	❌	Windows
rowName	✅	✅	✅	Windows
colName	✅	✅	✅	Windows
idx	❌	❌	❌	Windows

Java

Attribut	Fuzzy	RegEx	Berücksichtigung von Groß- und Kleinschreibung	OS
Rolle	✅	✅	✅	Windows macOS
name	✅	✅	✅	Windows macOS
virtualname	✅	✅	✅	Windows macOS
javastate	✅	✅	✅	Windows macOS
tableRow	❌	❌	❌	Windows macOS
tableCol	❌	❌	❌	Windows macOS
rowName	✅	✅	✅	Windows macOS
colName	✅	✅	✅	Windows macOS
idx	❌	❌	❌	Windows macOS
cls	✅	✅	✅	Windows macOS
Zugänglicheklasse	✅	✅	✅	Windows macOS

SAP

Attribut	Fuzzy	RegEx	Berücksichtigung von Groß- und Kleinschreibung	OS
id	✅	✅	✅	Windows macOS
Sheetid Dieses Attribut wird im Bereich Attribut nicht verfügbar gemacht, da es sich gegenseitig mit dem Attribut id ausschließt. Es kann manuell hinzugefügt werden.	✅	✅	✅	Windows macOS
tableRow	❌	❌	❌	Windows macOS
tableCol	❌	❌	❌	Windows macOS
colName	✅	✅	✅	Windows macOS
relpath	✅	✅	✅	Windows macOS
itemId	✅	✅	✅	Windows macOS

AX

Attribut	Fuzzy	RegEx	Berücksichtigung von Groß- und Kleinschreibung	OS
Rolle	✅	✅	✅	macOS
Unterrolle	✅	✅	✅	macOS
name	✅	✅	✅	macOS
title	✅	✅	✅	macOS
Bezeichner	✅	✅	✅	macOS
FileName	✅	✅	✅	macOS
url	✅	✅	✅	macOS
Hilfe	✅	✅	✅	macOS
enabled	✅	✅	✅	macOS
fokussiert	✅	✅	✅	macOS
Ausgewählt	✅	✅	✅	macOS
Erweitert	✅	✅	✅	macOS
idx	❌	❌	❌	macOS
Zeilenanzahl	❌	❌	❌	macOS
Spaltenanzahl	❌	❌	❌	macOS
tableRow	❌	❌	❌	macOS
tableCol	❌	❌	❌	macOS
rowName	✅	✅	✅	macOS
colName	✅	✅	✅	macOS

cURL

Attribut	Fuzzy	RegEx	Berücksichtigung von Groß- und Kleinschreibung	OS
cls	✅	✅	✅	Windows
Rolle	✅	✅	✅	Windows
text	✅	✅	✅	Windows
title	✅	✅	✅	Windows
tableRow	❌	❌	❌	Windows
tableCol	❌	❌	❌	Windows
colHeader	✅	✅	✅	Windows
idx	❌	❌	❌	Windows

Silverlight

Bitte beachten Sie, dass das Silverlight- Tag keine Fuzzy-, RegEx- und Groß-/Kleinschreibung- Funktionen unterstützt.

Attribut	Fuzzy	RegEx	Berücksichtigung von Groß- und Kleinschreibung	OS
Rolle	❌	❌	❌	Windows
name	❌	❌	❌	Windows
text	❌	❌	❌	Windows
idx	❌	❌	❌	Windows

RDP

Das RDP-Tag wird für die Remote-Automatisierung verwendet, und seine Attribute sind identisch mit dem WND-Tag.

Attribut	Fuzzy	RegEx	Berücksichtigung von Groß- und Kleinschreibung	OS
app	✅	✅	✅	Windows
cls	✅	✅	✅	Windows
title	✅	✅	✅	Windows
aaname	✅	✅	✅	Windows
ctrlname (WinForms)	✅	✅	✅	Windows
ctrlid (WinForms)	✅	✅	✅	Windows
idx	❌	❌	❌	Windows
tid	❌	❌	❌	Windows
pid	❌	❌	❌	Windows