Abonnieren

UiPath Studio

UiPath Studio-Anleitung

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

The last node represents the GUI element that interests you, and all the previous ones represent the parents of that element. <node_1> is usually referred to as a root node, and represents the top window of the app.

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.

580580

The Selector Editor window enables you to see the automatically-generated selector and edit it and its attributes. To access this window, in the Workflow Designer panel, click the Options Options buttonOptions button button in the body of an activity and select Edit Selector.

12021202

This can also be done by using the Ellipsis image alt textimage alt text button next to the Selector field, in the Properties panel.

609609

Option

Description

Validate

The button shows the status of the selector by checking the validity of the selector definition and the visibility of the target element on the screen.
The Validate button has three states:
image alt textimage alt text Selector is being validated
image alt textimage alt text Valid selector
image alt textimage alt text Invalid selector
image alt textimage alt text Modified selector, revalidate

The button is correlated with UI Explorer validation states.

Indicate Element

Indicate a new UI element to replace the previous one.

Repair

Enables you to re-indicate the same target UI element and repair the selector. This operation does not completely replace the previous selector. The button is available only when the selector is invalid.

Highlight

Brings the target element in the foreground. The highlight stays on until the option is disabled with a click. The button is enabled only if the selector is valid.

Edit Attributes

Contains all the application components needed to identify the target application (a window, a button etc.). This section is editable.

Edit Selector

Holds the actual selector. This section is editable.

Open in UI Explorer

Launches the UI Explorer. The option is enabled only for valid selectors.

📘

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:

WND

Attribute

Fuzzy

RegEx

app

check_markcheck_mark

check_markcheck_mark

cls

check_markcheck_mark

check_markcheck_mark

title

check_markcheck_mark

check_markcheck_mark

aaname

check_markcheck_mark

check_markcheck_mark

ctrlname (WinForms)

check_markcheck_mark

check_markcheck_mark

ctrlid (WinForms)

check_markcheck_mark

check_markcheck_mark

idx

no_rightno_right

no_rightno_right

tid

no_rightno_right

no_rightno_right

pid

no_rightno_right

no_rightno_right

isremoteapp

no_rightno_right

no_rightno_right

aastate

check_markcheck_mark

check_markcheck_mark

sapClient (SAP)

check_markcheck_mark

check_markcheck_mark

sapLanguage (SAP)

check_markcheck_mark

check_markcheck_mark

sapProgram (SAP)

check_markcheck_mark

check_markcheck_mark

sapScreen (SAP)

no_rightno_right

no_rightno_right

sapSession (SAP)

no_rightno_right

no_rightno_right

sapSysName (SAP)

sapSysNumber (SAP)

no_rightno_right

no_rightno_right

sapSysSessionId (SAP)

check_markcheck_mark

check_markcheck_mark

sapTransaction (SAP)

check_markcheck_mark

check_markcheck_mark

sapUser (SAP)

check_markcheck_mark

check_markcheck_mark

HTML

Attribute

Fuzzy

RegEx

url

check_markcheck_mark

check_markcheck_mark

htmlwindowname

check_markcheck_mark

check_markcheck_mark

title

check_markcheck_mark

check_markcheck_mark

app

no_rightno_right

no_rightno_right

idx

no_rightno_right

no_rightno_right

pid

no_rightno_right

no_rightno_right

tid

no_rightno_right

no_rightno_right

excludehwnd

no_rightno_right

no_rightno_right

bsid (Browser Session ID)

no_rightno_right

no_rightno_right

isremoteapp

no_rightno_right

no_rightno_right

WEBCTRL

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

Attribute

Fuzzy

RegEx

tag

no_rightno_right

no_rightno_right

idx

check_markcheck_mark

check_markcheck_mark

aaname

check_markcheck_mark

check_markcheck_mark

name

check_markcheck_mark

check_markcheck_mark

id

check_markcheck_mark

check_markcheck_mark

parentid

check_markcheck_mark

check_markcheck_mark

class

check_markcheck_mark

check_markcheck_mark

css-selector

no_rightno_right

no_rightno_right

innertext

check_markcheck_mark

check_markcheck_mark

isleaf

check_markcheck_mark

check_markcheck_mark

parentclass

check_markcheck_mark

check_markcheck_mark

parentname

check_markcheck_mark

check_markcheck_mark

title

check_markcheck_mark

check_markcheck_mark

src

check_markcheck_mark

check_markcheck_mark

href

check_markcheck_mark

check_markcheck_mark

tableCol

check_markcheck_mark

check_markcheck_mark

tableRow

check_markcheck_mark

check_markcheck_mark

colName

check_markcheck_mark

check_markcheck_mark

rowName

check_markcheck_mark

check_markcheck_mark

STRG

Attribute

Fuzzy

RegEx

role

check_markcheck_mark

check_markcheck_mark

name

check_markcheck_mark

check_markcheck_mark

automationid

check_markcheck_mark

check_markcheck_mark

labeledby

check_markcheck_mark

check_markcheck_mark

aastate

check_markcheck_mark

check_markcheck_mark

virtualname

check_markcheck_mark

check_markcheck_mark

text

check_markcheck_mark

check_markcheck_mark

rowName

check_markcheck_mark

check_markcheck_mark

idx

no_rightno_right

no_rightno_right

UIA

Attribute

Fuzzy

RegEx

accelkey (Accelerator Key)

check_markcheck_mark

check_markcheck_mark

acskey (Access Key)

check_markcheck_mark

check_markcheck_mark

automationid

check_markcheck_mark

check_markcheck_mark

cls

check_markcheck_mark

check_markcheck_mark

helpText

check_markcheck_mark

check_markcheck_mark

legacyAccHelp (Legacy Accessible Help)

check_markcheck_mark

check_markcheck_mark

enabled

check_markcheck_mark

check_markcheck_mark

kbfocus (Is Keyboard Focusable)

check_markcheck_mark

check_markcheck_mark

ispwd (Is Password)

check_markcheck_mark

check_markcheck_mark

itemstatus

check_markcheck_mark

check_markcheck_mark

itemtype

check_markcheck_mark

check_markcheck_mark

rtid (Runtime ID)

check_markcheck_mark

check_markcheck_mark

role

check_markcheck_mark

check_markcheck_mark

name

check_markcheck_mark

check_markcheck_mark

pid

check_markcheck_mark

check_markcheck_mark

tableRow

no_rightno_right

no_rightno_right

tableCol

no_rightno_right

no_rightno_right

rowName

check_markcheck_mark

check_markcheck_mark

colName

check_markcheck_mark

check_markcheck_mark

idx

no_rightno_right

no_rightno_right

Java

Attribute

Fuzzy

RegEx

role

check_markcheck_mark

check_markcheck_mark

name

check_markcheck_mark

check_markcheck_mark

virtualname

check_markcheck_mark

check_markcheck_mark

javastate

check_markcheck_mark

check_markcheck_mark

tableRow

no_rightno_right

no_rightno_right

tableCol

no_rightno_right

no_rightno_right

rowName

check_markcheck_mark

check_markcheck_mark

colName

check_markcheck_mark

check_markcheck_mark

idx

no_rightno_right

no_rightno_right

SAP

Attribute

Fuzzy

RegEx

id

check_markcheck_mark

check_markcheck_mark

leafid
This attribute is not exposed in the Attribute panel because it is mutual-exclusive with the id attribute. It can be added manually.

check_markcheck_mark

check_markcheck_mark

tableRow

no_rightno_right

no_rightno_right

tableCol

no_rightno_right

no_rightno_right

colName

check_markcheck_mark

check_markcheck_mark

relpath

check_markcheck_mark

check_markcheck_mark

itemId

check_markcheck_mark

check_markcheck_mark

Silverlight

Please note that the Silverlight tag does not support Fuzzy and RegEx capabilities.

Vor ungefähr einem Jahr aktualisiert


Über Selektoren


Auf API-Referenzseiten sind Änderungsvorschläge beschränkt

Sie können nur Änderungen an dem Textkörperinhalt von Markdown, aber nicht an der API-Spezifikation vorschlagen.