studio
2023.10
false
Studio-Benutzerhandbuch
Last updated 23. Sep. 2024

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

  • docs image Selektor wird validiert
  • docs image Gültiger Selektor
  • docs image Ungültiger Selektor
  • docs image 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

available

available

available

cls

available

available

available

title

available

available

available

aaname

available

available

available

ctrlname (WinForms)

available

available

available

ctrlid (WinForms)

available

available

available

idx

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

tid

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

pid

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

isremoteapp

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

aastate

available

available

available

sapClient (SAP)

available

available

available

sapLanguage (SAP)

available

available

available

sapProgram (SAP)

available

available

available

sapScreen (SAP)

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

sapSession (SAP)

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

sapSysName (SAP)

available

available

available

sapSysNumber (SAP)

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

sapSysSessionId (SAP)

available

available

available

sapTransaction (SAP)

available

available

available

sapUser (SAP)

available

available

available

HTML

Attribut

Fuzzy

RegEx

Berücksichtigung von Groß- und Kleinschreibung

url

available

available

available

htmlwindowname

available

available

available

title

available

available

available

class

available

available

available

app

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

idx

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

pid

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

tid

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

excludehwnd

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

bsid (Browser Session ID)

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

isremoteapp

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

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

available

available

available

idx

available

available

available

aaname

available

available

available

name

available

available

available

id

available

available

available

parentid

available

available

available

class

available

available

available

css-selector

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

innertext

available

available

available

visibleinnertext

available

available

available

isleaf

available

available

available

parentclass

available

available

available

parentname

available

available

available

src

available

available

available

href

available

available

available

tableCol

available

available

available

tableRow

available

available

available

colName

available

available

available

rowName

available

available

available

aria-label

available

available

available

aria-labelledby

available

available

available

STRG

Attribut

Fuzzy

RegEx

Berücksichtigung von Groß- und Kleinschreibung

Rolle

available

available

available

name

available

available

available

automationid

available

available

available

labeledby

available

available

available

aastate

available

available

available

virtualname

available

available

available

text

available

available

available

rowName

available

available

available

idx

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

UIA

Attribut

Fuzzy

RegEx

Berücksichtigung von Groß- und Kleinschreibung

accelkey (Zugriffstaste)

available

available

available

acskey (Zugriffsschlüssel)

available

available

available

automationid

available

available

available

cls

available

available

available

helpText

available

available

available

legacyAccHelp (alte zugängliche Hilfe)

available

available

available

enabled

available

available

available

kbfocus (ist Tastatur-fokussierbar)

available

available

available

ispwd (ist Kennwort)

available

available

available

itemstatus

available

available

available

itemtype

available

available

available

rtid (Laufzeit-ID)

available

available

available

Rolle

available

available

available

name

available

available

available

pid

available

available

available

tableRow

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

tableCol

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

rowName

available

available

available

colName

available

available

available

idx

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

Java

Attribut

Fuzzy

RegEx

Berücksichtigung von Groß- und Kleinschreibung

Rolle

available

available

available

name

available

available

available

virtualname

available

available

available

javastate

available

available

available

tableRow

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

tableCol

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

rowName

available

available

available

colName

available

available

available

idx

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

SAP

Attribut

Fuzzy

RegEx

Berücksichtigung von Groß- und Kleinschreibung

id

available

available

available

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.

available

available

available

tableRow

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

tableCol

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

colName

available

available

available

relpath

available

available

available

itemId

available

available

available

Silverlight

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

  • Unterstützte Tags und Attribute
  • WND
  • HTML
  • WEBCTRL
  • STRG
  • UIA
  • Java
  • SAP
  • Silverlight

War diese Seite hilfreich?

Hilfe erhalten
RPA lernen – Automatisierungskurse
UiPath Community-Forum
Uipath Logo White
Vertrauen und Sicherheit
© 2005–2024 UiPath. Alle Rechte vorbehalten