Ü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.

Supported tags and attributes

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	The file name of the application containing the UI element.
cls	Class name of the window containing the UI element.
title	The window title of the UI element.
aaname	'Active Accessibility' name of the UI element.
ctrlname (WinForms)	WinForms name of the UI element.
ctrlid (WinForms)	Win32 control ID of the window containing the UI element.
idx	The instance number of the UI element.
tid	ID of the thread that created the UI element.
pid	Process ID of the application containing the UI element.
isremoteapp
aastate	'Active Accessibility' state of the UI element.
sapClient (SAP)	SAP Client selected on the login screen.
sapLanguage (SAP)	SAP Language specified on the login screen.
sapProgram (SAP)	SAP source program that is currently being executed.
sapScreen (SAP)	SAP Screen number currently displayed.
sapSession (SAP)	SAP Session Number, also displayed in SAP GUI statusbar.
sapSysName (SAP)	SAP System Name.
sapSysNumber (SAP)	SAP Application server.
sapSysSessionId (SAP)	All SAP GUI sessions of the same connection are represented on the server with the same SysSessionId.
sapTransaction (SAP)	SAP Transaction that is currently being executed.
sapUser (SAP)	SAP User logged into the system.

HTML

Attribut	Beschreibung	Fuzzy	RegEx	Berücksichtigung von Groß- und Kleinschreibung
url	The URL of the web page containing the current element.
htmlwindowname
title	The window title of the element.
class	Class name of the accessible context of the element.
app	The file name of the application containing the UI element
idx	The instance number of the UI element.
pid	Process ID of the application containing the UI element.
tid	ID of the thread that created the UI element.
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 of the element.
idx	The instance number of the UI element.
aaname	'Active Accessibility' name of the UI element.
name	Name property of the UI element.
id	The unique identifier of the UI element.
parentid	HTML ID attribute of the fist ancestor element that have ID.
class
css-selector
innertext	The innerText property of a HTML element.
visibleinnertext
isleaf
parentclass	HTML class attribute of the fist ancestor element that has class.
parentname	HTML name attribute of the fist ancestor UI element that has a name.
src	Specifies the location, or source of the element.
href	The URL of the page the link goes to.
tableCol	Table column number that contains the UI element.
tableRow	Table row number that contains the UI element.
colName	The name of the table column that contains the UI element.
rowName	The name of the table row that contains the UI element.
aria-label	Aria label attribute of the element.
aria-labelledby

STRG

Attribut	Beschreibung	Fuzzy	RegEx	Berücksichtigung von Groß- und Kleinschreibung
Rolle	The 'Active Accessibility' role property of the UI element.
name	Name property of the UI element.
automationid	The 'UI Automation' ID of the UI element.
labeledby	The 'UI Automation' labeled by attribute of the UI element.
aastate	'Active Accessibility' state of the UI element.
virtualname	The name of the element given by the underlying accessibility technology.
text	The text of the UI element as it appears on the screen.
rowName	The name of the table row that contains the UI element.
idx	The instance number of the UI element.

UIA

Attribut	Beschreibung	Fuzzy	RegEx	Berücksichtigung von Groß- und Kleinschreibung
accelkey (Zugriffstaste)
acskey (Zugriffsschlüssel)
automationid	The 'UI Automation' ID of the UI element.
cls	Class name of the window containing the UI element.
helpText	The help string of the UI element.
legacyAccHelp (alte zugängliche Hilfe)
enabled
kbfocus (ist Tastatur-fokussierbar)
ispwd (ist Kennwort)
itemstatus
itemtype
rtid (Laufzeit-ID)
Rolle	The 'Active Accessibility' role property of the UI element.
name	Name property of the UI element.
pid	Process ID of the application containing the UI element.
tableRow	Table row number that contains the UI element.
tableCol	Table column number that contains the UI element.
rowName	The name of the table row that contains the UI element.
colName	The name of the table column that contains the UI element.
idx	The instance number of the UI element.

Java

Attribut	Beschreibung	Fuzzy	RegEx	Berücksichtigung von Groß- und Kleinschreibung
Rolle	The 'Active Accessibility' role property of the UI element.
name	Name property of the UI element.
virtualname	The name of the element given by the underlying accessibility technology.
javastate	The state of the UI element as provided by 'Java Accessibility Bridge.
tableRow	Table row number that contains the UI element.
tableCol	Table column number that contains the UI element.
rowName	The name of the table row that contains the UI element.
colName	The name of the table column that contains the UI element.
idx	The instance number of the UI element.

SAP

Attribut	Beschreibung	Fuzzy	RegEx	Berücksichtigung von Groß- und Kleinschreibung
id	The unique identifier of the UI element.
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	Table row number that contains the UI element.
tableCol	Table column number that contains the UI element.
colName	The name of the table column that contains the UI element.
relpath
itemId

Silverlight

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