Studio-Benutzerhandbuch

Letzte Aktualisierung 17. Dez. 2024

Fuzzy-Suche

Informationen zur Fuzzy-Suche

Ein Selektor enthält ein Tag der obersten Ebene, das auf das Zielfenster oder den Zielbrowsertab verweist. Es enthält Attribute wie Titel, Prozessname, URL, Fenstername usw., mit denen Sie ordnungsgemäß die Elemente identifizieren können, die Sie in Ihren Automatisierungsprojekten verwenden möchten.

Häufig unterliegen die Werte von Tags der obersten Ebene dynamischen Änderungen, da sie von der Zielanwendung basierend auf Ihren Aktionen neu geschrieben werden. Der Titel einer Webseite kann sich beispielsweise während des Automatisierungsprozesses ändern. Der entsprechende Selektor wird dadurch ungültig.

In diesem Zusammenhang ermöglichen die Funktionen für die Fuzzy-Suche des Selektors Ihnen das Suchen von Zeichenfolgen auf der Grundlage eines Musters und nicht einer genauen Entsprechung Ihrer Eingabe. Dies ermöglicht eine flexiblere Methode zur Ermittlung von Elementen und validiert Selektoren gemäß mehreren Attributen, auch wenn sich einige während des Automatisierungsprozesses ändern können.

Funktionsweise der Fuzzy-Suche

Um die Funktionen für die Fuzzy-Suche zu nutzen, müssen einige Übereinstimmungsoptionen in das Tag der obersten Ebene des Zielselektors aufgenommen werden. Gehen Sie dazu wie folgt vor:

Option	Beschreibung
`matching:<tag_name>=fuzzy`	Ermöglicht die Angabe des Zielsuch-Tags, wird durch den Wert `<tag_name>` bestimmt.
`fuzzyLevel:<tag_name>=<numerical_value>`	Bestimmt den Übereinstimmungsschwellenwert für das Ziel `<tag_name>`. Unterstützt wird ein numerischer Wert zwischen 0 und 1: Näher bei 0: Gibt Ergebnisse mit geringerer Ähnlichkeit mit `<tag_name>` zurück. Näher bei 1: Gibt Ergebnisse mit höherer Ähnlichkeit mit `<tag_name>` zurück.

Hinweis: Werden mehrere Elemente gefunden, wird die Zielaktion für das erste Element ausgeführt.

Unterstützte Selektortypen

Die Fuzzy-Suche wird derzeit von den folgenden Selektortypen unterstützt:

Selektortyp	Support
`<wnd>`
`<html>`
`<webctrl>`
`<java>`
`<ctrl>`
`<uia>`
`<sap>`
`<rdp>`
`<silverlight>`
Tags, die einen Prozessnamen angeben. Beispiel: `<html app="firefox.exe">`.

Hinweis:

Wenn Sie check:text="example" in einem Fuzzy-Selektor hinzufügen, wird überprüft, ob das Zielelement den angegebenen Text enthält.

Wenn Sie z. B. check:text="Options" zu einem Fuzzy-Selektor hinzufügen, wird überprüft, ob das Zielelement den Text Options enthält.

Beispiele für die Verwendung der Fuzzy-Suche

Mit der Fuzzy-Suche kann nahezu jeder Attributtyp in den Tags der obersten Ebene von Selektoren ermittelt werden. In den folgenden Beispielen werden gültige Selektoren mit falsch geschriebenen Attributen erstellt:

A. Verwenden einer hohen Fuzzy-Stufe

Angenommen, Sie möchten einen Selektor zum Ermitteln des <title>-Attributs W3Schools Online Web Tutorials erstellen. In diesem Beispiel ist das Attribut falsch geschrieben und der Selektor dadurch ungültig.

<html app='firefox.exe' title='WEScho0ls Online Web Tutorials' /><html app='firefox.exe' title='WEScho0ls Online Web Tutorials' />

Um dieses Problem zu beheben, müssen Sie die Fuzzy-Suche in das Tag <html> einfügen. Das relevante Attribut ist <title>. Daher muss das <tag_name>-Element des Ausdrucks für die Fuzzy-Suche das Format matching:title=fuzzy haben. Der Fehler im Attribut <title> ist unbedeutend, daher kann eine Fuzzy-Stufe nahe 1 verwendet werden. Der folgende Selektor wird erstellt, der das richtige <title>-Attribut zurückgibt (in diesem Fall W3Schools Online Web Tutorials):

<html app='firefox.exe' title='WEScho0ls Online Web Tutorials'
      matching:title='fuzzy' fuzzylevel:title='0.8' /><html app='firefox.exe' title='WEScho0ls Online Web Tutorials'
      matching:title='fuzzy' fuzzylevel:title='0.8' />

B. Verwenden einer niedrigen Fuzzy-Stufe

In diesem zweiten Beispiel müssen Sie Selektoren für das Attribut <aaname> erstellen. Das Zielattribut lautet Colorpicker, in diesem Beispiel ist es jedoch falsch geschrieben: Clorker. Selbstverständlich ist der Selektor mit einem falsch geschriebenen Attribut ungültig und sieht ungefähr wie folgt aus:

<html title='W3Schools Online Web Tutorials' /> 
<webctrl aaname='Clorker' parentid='main' tag='IMG' /><html title='W3Schools Online Web Tutorials' /> 
<webctrl aaname='Clorker' parentid='main' tag='IMG' />

Die Fuzzy-Suche muss in das Tag <webctrl> aufgenommen werden. In diesem Fall ist unser Ziel <aaname>. Da unser Ziel mehrere Rechtschreibfehler enthält, senken wir die Fuzzy-Stufe auf einen Wert nahe 0, um die Wahrscheinlichkeit für eine genaue Erkennung zu erhöhen. Der folgende Selektor wird generiert, der das richtige <aaname>-Attribut zurückgibt, in diesem Fall Colorpicker:

<html title='W3Schools Online Web Tutorials' /> 
<webctrl aaname='Colorker' parentid='main' tag='IMG' matching:aaname='fuzzy' fuzzylevel:aaname='0.4' /><html title='W3Schools Online Web Tutorials' /> 
<webctrl aaname='Colorker' parentid='main' tag='IMG' matching:aaname='fuzzy' fuzzylevel:aaname='0.4' />