Ü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

Die folgenden Tabellen zeigen die Kompatibilität zwischen Tags und Attributen, die zum Erstellen von Selektoren verwendet werden, und die Selektorfunktion:

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	Beschreibung	Fuzzy	RegEx	Berücksichtigung von Groß- und Kleinschreibung
app	Der Dateiname der Anwendung, die das UI-Element enthält.
cls	Klassenname des Fensters, das das UI-Element enthält.
title	Der Fenstertitel des UI-Elements.
aaname	„Active Accessibility“-Name des UI-Elements.
ctrlname (WinForms)	WinForms-Name des UI-Elements.
ctrlid (WinForms)	Win32-Steuerelement-ID des Fensters, das das UI-Element enthält.
idx	Die Instanznummer des UI-Elements.
tid	ID des Threads, der das UI-Element erstellt hat.
pid	Prozess-ID der Anwendung, die das UI-Element enthält.
isremoteapp
aastate	„Active Accessibility“-Status des UI-Elements.
sapClient (SAP)	Auf dem Anmeldebildschirm ausgewählter SAP-Client.
sapLanguage (SAP)	Auf dem Anmeldebildschirm angegebene SAP-Sprache.
sapProgram (SAP)	Derzeit ausgeführtes SAP-Quellprogramm.
sapScreen (SAP)	Derzeit angezeigte SAP-Bildschirmnummer.
sapSession (SAP)	SAP-Sitzungsnummer, wird auch in der SAP-GUI-Statusleiste angezeigt.
sapSysName (SAP)	SAP-Systemname.
sapSysNumber (SAP)	SAP-Anwendungsserver.
sapSysSessionId (SAP)	Alle SAP-GUI-Sitzungen der gleichen Verbindung werden auf dem Server mit der gleichen SysSessionId dargestellt.
sapTransaction (SAP)	SAP-Transaktion, die derzeit ausgeführt wird.
sapUser (SAP)	Im System angemeldeter SAP-Benutzer.

HTML

Attribut	Beschreibung	Fuzzy	RegEx	Berücksichtigung von Groß- und Kleinschreibung
url	Die URL der Webseite, die das aktuelle Element enthält.
htmlwindowname
title	Der Fenstertitel des Elements.
class	Klassenname des zugänglichen Kontexts des Elements.
app	Der Dateiname der Anwendung, die das UI-Element enthält
idx	Die Instanznummer des UI-Elements.
pid	Prozess-ID der Anwendung, die das UI-Element enthält.
tid	ID des Threads, der das UI-Element erstellt hat.
excludehwnd
bsid (Browser Session ID)
isremoteapp

WEBCTRL

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

Attribut	Beschreibung	Fuzzy	RegEx	Berücksichtigung von Groß- und Kleinschreibung
tag	HTML-Tag des Elements.
idx	Die Instanznummer des UI-Elements.
aaname	„Active Accessibility“-Name des UI-Elements.
name	Name-Eigenschaft des UI-Elements.
id	Der eindeutige Bezeichner des UI-Elements.
parentid	HTML-ID-Attribut des ersten Vorgängerelements mit ID.
class
css-selector
innertext	Die „innerText“-Eigenschaft eines HTML-Elements.
visibleinnertext
isleaf
parentclass	HTML-Klassenattribut des ersten Vorgängerelements mit Klasse.
parentname	HTML-Name-Attribut des ersten Vorgängerelements des UI-Elements mit Name.
src	Gibt den Speicherort oder die Quelle des Elements an.
href	Die URL der Seite, auf die der Link verweist.
tableCol	Nummer der Tabellenspalte, die das UI-Element enthält.
tableRow	Nummer der Tabellenzeile, die das UI-Element enthält.
colName	Der Name der Tabellenspalte, die das UI-Element enthält.
rowName	Der Name der Tabellenzeile, die das UI-Element enthält.
aria-label	Aria-Bezeichnungsattribut des Elements.
aria-labelledby

STRG

Attribut	Beschreibung	Fuzzy	RegEx	Berücksichtigung von Groß- und Kleinschreibung
Rolle	Die „Active Accessibility“-Rolleneigenschaft des UI-Elements.
name	Name-Eigenschaft des UI-Elements.
automationid	Die „UI Automation“-ID des UI-Elements.
labeledby	Die durch das Attribut des UI-Elements gekennzeichnete „UI-Automatisierung“.
aastate	„Active Accessibility“-Status des UI-Elements.
virtualname	Der Name des Elements, der von der zugrunde liegenden Barrierefreiheitstechnologie angegeben wird.
text	Der Text des UI-Elements, wie er auf dem Bildschirm erscheint.
rowName	Der Name der Tabellenzeile, die das UI-Element enthält.
idx	Die Instanznummer des UI-Elements.

UIA

Attribut	Beschreibung	Fuzzy	RegEx	Berücksichtigung von Groß- und Kleinschreibung
accelkey (Zugriffstaste)
acskey (Zugriffsschlüssel)
automationid	Die „UI Automation“-ID des UI-Elements.
cls	Klassenname des Fensters, das das UI-Element enthält.
helpText	Die Hilfezeichenfolge des UI-Elements.
legacyAccHelp (alte zugängliche Hilfe)
enabled
kbfocus (ist Tastatur-fokussierbar)
ispwd (ist Kennwort)
itemstatus
itemtype
rtid (Laufzeit-ID)
Rolle	Die „Active Accessibility“-Rolleneigenschaft des UI-Elements.
name	Name-Eigenschaft des UI-Elements.
pid	Prozess-ID der Anwendung, die das UI-Element enthält.
tableRow	Nummer der Tabellenzeile, die das UI-Element enthält.
tableCol	Nummer der Tabellenspalte, die das UI-Element enthält.
rowName	Der Name der Tabellenzeile, die das UI-Element enthält.
colName	Der Name der Tabellenspalte, die das UI-Element enthält.
idx	Die Instanznummer des UI-Elements.

Java

Attribut	Beschreibung	Fuzzy	RegEx	Berücksichtigung von Groß- und Kleinschreibung
Rolle	Die „Active Accessibility“-Rolleneigenschaft des UI-Elements.
name	Name-Eigenschaft des UI-Elements.
virtualname	Der Name des Elements, der von der zugrunde liegenden Barrierefreiheitstechnologie angegeben wird.
javastate	Der Status des UI-Elements, wie von „Java Accessibility Bridge“ bereitgestellt.
tableRow	Nummer der Tabellenzeile, die das UI-Element enthält.
tableCol	Nummer der Tabellenspalte, die das UI-Element enthält.
rowName	Der Name der Tabellenzeile, die das UI-Element enthält.
colName	Der Name der Tabellenspalte, die das UI-Element enthält.
idx	Die Instanznummer des UI-Elements.

SAP

Attribut	Beschreibung	Fuzzy	RegEx	Berücksichtigung von Groß- und Kleinschreibung
id	Der eindeutige Bezeichner des UI-Elements.
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.
tableRow	Nummer der Tabellenzeile, die das UI-Element enthält.
tableCol	Nummer der Tabellenspalte, die das UI-Element enthält.
colName	Der Name der Tabellenspalte, die das UI-Element enthält.
relpath
itemId

Silverlight

Bitte beachten Sie, dass das Silverlight-Tag nicht unterstützt Unscharf, RegExund Groß-/Kleinschreibung beachten Fähigkeiten.