Ü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 UiPath 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. UiPath 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 Aktivitätspanel Eigenschaften (Properties) unter Eingabe > Ziel > Selektor (Input > Target > Selector) gespeichert. Alle Aktivitäten im Zusammenhang mit grafischen Elementen haben diese Eigenschaft.

Das Fenster Selector-Editor ermöglicht es Ihnen, automatisch generierte Selektoren anzuzeigen und diese und deren Attribute zu bearbeiten. Um auf dieses Fenster zuzugreifen, klicken Sie auf die Schaltfläche Optionen im Körper einer Aktivität im Bereich Workflow-Designer und wählen Sie Selektor bearbeiten aus.

Sie können auch im Bereich Eigenschaften auf die Schaltfläche mit den Auslassungspunkten neben dem Selektor-Feld klicken.

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	Fuzzy	RegEx	Berücksichtigung von Groß- und Kleinschreibung
app
cls
title
aaname
ctrlname (WinForms)
ctrlid (WinForms)
idx
tid
pid
isremoteapp
aastate
sapClient (SAP)
sapLanguage (SAP)
sapProgram (SAP)
sapScreen (SAP)
sapSession (SAP)
sapSysName (SAP)
sapSysNumber (SAP)
sapSysSessionId (SAP)
sapTransaction (SAP)
sapUser (SAP)

HTML

Attribut	Fuzzy	RegEx	Berücksichtigung von Groß- und Kleinschreibung
url
htmlwindowname
title
app
idx
pid
tid
excludehwnd
bsid (Browser Session ID)
isremoteapp

WEBCTRL

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

Attribut	Fuzzy	RegEx	Berücksichtigung von Groß- und Kleinschreibung
tag
idx
aaname
name
id
parentid
class
css-selector
innertext
isleaf
parentclass
parentname
title
src
href
tableCol
tableRow
colName
rowName

STRG

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

UIA

Attribut	Fuzzy	RegEx	Berücksichtigung von Groß- und Kleinschreibung
accelkey (Zugriffstaste)
acskey (Zugriffsschlüssel)
automationid
cls
helpText
legacyAccHelp (alte zugängliche Hilfe)
enabled
kbfocus (ist Tastatur-fokussierbar)
ispwd (ist Kennwort)
itemstatus
itemtype
rtid (Laufzeit-ID)
Rolle
name
pid
tableRow
tableCol
rowName
colName
idx

Java

Attribut	Fuzzy	RegEx	Berücksichtigung von Groß- und Kleinschreibung
Rolle
name
virtualname
javastate
tableRow
tableCol
rowName
colName
idx

SAP

Attribut	Fuzzy	RegEx	Berücksichtigung von Groß- und Kleinschreibung
id
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
tableCol
colName
relpath
itemId