Positionsbezogene Suche

Eine positionsbezogene Suche findet ein Ziel anhand seiner Lage relativ zu einem anderen Element. Verwenden Sie sie immer dann, wenn sich der benötigte Wert bei jedem Lauf ändert, daneben aber etwas Stabiles steht – eine Feldbeschriftung, eine Spaltenüberschrift in einer Tabelle, eine Zeilenkennung.

Felder

Parameter	Beschreibung
Referenz	Der stabile Anker, den der Roboter immer finden kann, z. B. die Beschriftung Email: oder eine Spaltenüberschrift.
Abfrage	Das Ziel, das in der angegebenen Richtung von der Referenz aus gesucht wird. Lassen Sie dessen Beschriftung leer, um jedes Element dieses Typs zu treffen.
Elementindex	Welcher Treffer genommen wird, wenn mehrere Elemente in Frage kommen. (Erweiterte Optionen)

Sowohl Referenz als auch Abfrage sind selbst vollständige Suchobjekte, jedes hat also seine eigene Beschriftung, Suchmethode und seinen eigenen Typ.

Suchrichtungen

Über / Unter – findet das Element oberhalb oder unterhalb der Referenz.

Parameter	Beschreibung
Suchausrichtung	Von welchem Ankerpunkt der Referenz aus der horizontale Abstand gemessen wird. Möglich sind LEFT (Standard), RIGHT oder MIDDLE. Kombinieren Sie dies mit DISTANCE, um auf beiden Achsen zu messen, oder mit THRESHOLD, um nur streng ausgerichtete Elemente zu akzeptieren.

Links von / Rechts von – findet das Element links oder rechts von der Referenz.

Parameter	Beschreibung
In derselben Zeile suchen	Wenn an (Standard), müssen beide Elemente in derselben Zeile liegen. Schalten Sie die Option aus für Layouts, in denen der Wert vertikal leicht versetzt ist.

📸 Screenshot erforderlich – /img/editor/objects/so-above.png

Aufnehmen: den Suchobjekt-Editor Unter mit Referenz, Abfrage und der aufgeklappten Auswahlliste Suchausrichtung mit LEFT / RIGHT / MIDDLE. Warum neu aufnehmen: Die Ausrichtungsoptionen sind jetzt eine echte Enum-Auswahlliste und liegen unter Erweiterte Optionen.

📸 Screenshot erforderlich – /img/editor/objects/so-right.png

Aufnehmen: den Editor Rechts von und dazu eine Live-Ansicht eines Formulars, in der die Beschriftung die Referenz ist und der Wert rechts daneben als Abfrage hervorgehoben ist. Beschriften: Markieren Sie Referenz und Abfrage mit zwei unterschiedlich farbigen Rahmen.

Ausgearbeitetes Beispiel

Auslesen einer Rechnungsnummer, die sich jedes Mal ändert und rechts neben einer festen Beschriftung steht:

Feld	Wert
Objekttyp	Rechts von
Referenz → Typ / Beschriftung	Text / Invoice number
Abfrage → Typ / Beschriftung	Text / ^\d{8}$
Abfrage → Suchmethode	REGEX
In derselben Zeile suchen	an

Der Roboter findet die feste Beschriftung und liest dann die erste achtstellige Zahl in derselben Zeile – unabhängig davon, wo sich das Fenster auf dem Bildschirm befindet.

tipp

Die Verankerung an einer Beschriftung macht die Automatisierung unempfindlich gegen Layoutverschiebungen. Ein regulärer Ausdruck in der Abfrage wählt dann nur den gewünschten Teil aus und ignoriert umgebenden Text wie etwa ein Währungssuffix.