Über Selektoren

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 Selektor-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: Selektoren, die für Java-Anwendungen generiert wurden und mehrere WND-Tags enthalten, können nicht mit der Ereignisüberwachung verwendet werden.

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 (Zugriffstaste)				Windows
acskey (Zugriffsschlüssel)				Windows
automationid				Windows
cls				Windows
helpText				Windows
legacyAccHelp (alte zugängliche Hilfe)				Windows
enabled				Windows
kbfocus (ist Tastatur-fokussierbar)				Windows
ispwd (ist Kennwort)				Windows
itemstatus				Windows
itemtype				Windows
rtid (Laufzeit-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
leafid 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

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 nicht unterstützt Unscharf, RegExund Groß-/Kleinschreibung beachten Fähigkeiten.

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