Aktivitäten

Neuestes

False

UIAutomation-Aktivitäten

Letzte Aktualisierung 26. Apr. 2024

Erweiterte Deskriptorkonfiguration

Weitere Informationen zur Verwendung der erweiterten Funktionen des Auswahlbildschirms finden Sie im folgenden Video.

Duplikate

Die Angabe eines Ziels kann zu Duplikaten führen, bei denen es sich um andere UI-Elemente handelt, die dem Ziel-UI-Element sehr ähnlich sind und dazu führen können, dass die Automatisierung zur Laufzeit fehlschlägt. Wenn Duplikate gefunden werden, werden sie gelb hervorgehoben und über ihnen mit einem Label, das einen Buchstaben enthält, der der Zielmethode entspricht, bei der jedes Duplikat gefunden wurde:

Eine der besten Möglichkeiten zur Vermeidung von Duplikaten ist die Angabe eines Ankers.

Anker

Um einen zuverlässigen Deskriptor zu erstellen, wird empfohlen, einen Anker anzugeben, nachdem das Ziel angegeben wurde. Sie können bis zu drei Anker für ein Ziel angeben. Anker können in mehreren Szenarien gefunden werden, wie unten beschrieben:

Anker automatisch gefunden

Nachdem Sie ein Ziel angegeben haben, wird versucht, automatisch einen Anker dafür zu identifizieren.

Wichtig: Wenn ein Anker nicht mit 100 %iger Sicherheit gefunden wird oder wenn Duplikate gefunden werden, gilt er nicht als automatischer Anker.

Wenn ein automatischer Anker erfolgreich gefunden wurde, wird er blau hervorgehoben, und der Auswahloptionen-Helper bestätigt, dass das Ziel und sein Anker OK sind.

Methode zur Ankeridentifizierung

In diesem Abschnitt finden Sie weitere technische Details zur Methode, mit der diese Suche durchgeführt wird.

Sobald ein Ziel angegeben ist, wird der Typ des angegebenen UI-Elements identifiziert. Es wird nach den folgenden Elementen und Richtungen gesucht:

Schaltfläche – innerhalb des Elements.
Kontrollkästchen – rechts neben dem Element.
Dropdown – links und über dem Element.
Eingabefeld – links und über dem Element. Bei der Browser-Automatisierung wird die Bezeichnung auch im Eingabefeld nach dem Attribut AreaLabeledBy gesucht. Wenn diese Bezeichnung nicht identifiziert wird, wird nach einem Element mit tag=label und for='id of the input box' gesucht.
Optionsfeld – rechts neben dem Element.
Bild – rechts und unter dem Element.

Je nach Typ des identifizierten Elements wird automatisch ein entsprechender Anker für das Element gesucht.

Ein automatisch identifizierter Anker hat die Form eines Textelements, das immer in der Nähe des Zielelements vorhanden ist und daher verwendet werden kann, um das Element zur Runtime genauer zu identifizieren.

Wenn keine der oben genannten Anweisungen Ergebnisse liefert, wird ein allgemeiner Fall verwendet, der in der Elementhierarchie nach einem geeigneten Anker sucht.

Manuelles Hinzufügen eines Ankers

Falls ein Anker nicht automatisch gefunden und dem angegebenen Ziel hinzugefügt wird, werden Sie vom Helper „Auswahloptionen“ benachrichtigt, wie im folgenden Screenshot gezeigt:

In dieser Situation können Sie manuell einen Anker für Ihr Zielelement auswählen. Wenn Sie mit der Maus auf ein anderes Element zeigen, wird es blau hervorgehoben und mit einer Linie zu dem von Ihnen ausgewählten Ziel verbunden. Um den gewünschten Anker auszuwählen, können Sie einfach auf den Text klicken, den Sie als Anker verwenden möchten.

Hover-Menü

Sie können auch ein bestimmtes Element (sei es Ziel oder Anker) bearbeiten, indem Sie auf das Menü zugreifen, das angezeigt wird, wenn Sie mit der Maus über das Zielelement zeigen. Dieses Menü hat mehrere Optionen:

Das Mit der Schaltfläche wird der Anzeigeprozess geschlossen und die von Ihnen vorgenommenen Änderungen gespeichert.

Das Mit der Schaltfläche können Sie Elemente unabhängig von ihrem spezifischen Textinhalt als Ziel verwenden. Dies kann hilfreich sein, wenn Sie versuchen, das erste Element in einer Suchliste auszuwählen, wenn Sie nicht genau wissen, womit die Liste gefüllt wird, oder wenn Sie mit einem dynamischen Element interagieren, das seine Beschriftung aus verschiedenen Gründen ändert. Wenn Sie diese Funktion verwenden, wenn Sie ein Ziel angeben, wird nur die Fuzzy-Selektormethode zur Identifizierung verwendet und der Fuzzy-Selektor wird reduziert, um sicherzustellen, dass das Element unabhängig von Bezeichnungsänderungen weiterhin angezielt wird.

Durch Klicken auf können Sie ein benachbartes UI-Element auswählen, das als zusätzlicher Anker fungiert. Sie können bis zu drei Anker für ein beliebiges Ziel angeben.

Das Mit der Schaltfläche wird der Zielabschnitt in den Auswahloptionen erweitert, sodass Sie die Zielmethoden konfigurieren können, die für den aktuellen Deskriptor verwendet werden.

Das Mit der Schaltfläche wird das angegebene Ziel gelöscht und Sie können ein anderes auswählen.

Konfigurieren des Deskriptors

Optionen

Der Abschnitt Optionen kann erweitert werden, um die folgenden Optionen anzuzeigen:

Änderungen automatisch anwenden – Wenn diese Option ausgewählt ist, werden Änderungen automatisch auf Ziel- und Ankerelemente angewendet.
Reaktionsfähige Websites – Wenn diese Option ausgewählt ist, kann der Anker automatisch vom linken zum oberen Rand des Ziels oder von oben nach links vom Ziel verschoben werden, sodass Sie Websites automatisieren können, die reaktionsfähig sind.
Elementsichtbarkeit – Prüft, ob das UI-Element sichtbar ist oder nicht. Im Dropdown-Menü sind drei Optionen verfügbar:
- Keine - Prüft nicht auf Sichtbarkeit.
- Interaktiv (für Fuzzy-Selektor) – Standardoption. Prüft, ob das Element potenziell sichtbar ist, ignoriert Seitenscrollen und Behinderungen durch andere Apps oder die Tatsache, dass die Anwendung minimiert ist. Diese Überprüfung ist nützlich, um sicherzustellen, dass Sie nicht auf unsichtbare Elemente abzielen, die im DOM vorhanden, aber ausgeblendet sind.
- Vollständig sichtbar – Stellt sicher, dass das UI-Element auf dem Bildschirm sichtbar ist.

Fensterselektor

Der Abschnitt Fensterselektor kann erweitert werden, um den Selektor der angegebenen Zielanwendung anzuzeigen und zu bearbeiten. Sie können auch die Schaltfläche In UI-Explorer öffnen verwenden, um den Fensterselektor im UI-Explorer zu bearbeiten.

Ziel

Bei der Suche nach einem UI-Element werden verschiedene Zielmethoden verwendet:

Diese Zielmethoden sind untereinander redundant und es gibt eine Rangliste, nach der die Zielmethoden verwendet werden. Die Hierarchie berücksichtigt die Zielleistung und Resilienz gegenüber UI-Änderungen jeder Zielmethode. Bei der Suche des UI-Elements wird daher die folgende Reihenfolge verwendet:

Die primäre Zielmethode wird durch Selektoren dargestellt: Strikter Selektor oder Fuzzy-Selektor.
Die sekundäre Zielmethode ist Computer Vision.
Die tertiäre Zielmethode ist Bild (standardmäßig deaktiviert).

Das Symbol wird zur Entwurfszeit neben der führenden Zielmethode angezeigt und simuliert das Szenario zur Laufzeit.

Standardprojekteinstellungen für die technologieübergreifende Ausrichtung auf Methoden

In der folgenden Tabelle werden die Standardprojekteinstellungen für Zielmethoden in verschiedenen Technologien angezeigt.

Zielmethoden	Desktop-Anwendungen	Webbrowsers	Java	SAP
Strikter Selektor
Fuzzy-Selektor
Computer Vision
Bild

Projekteinstellung: Bis zum Timeout auf primäre Zielmethode warten

Die Projekteinstellung Warten auf primäre Zielmethode bis Timeout (Projekteinstellungen > UI-Automatisierung modern) ist in neuen Projekten ab Aktivitätspaketversion 23.10.3 standardmäßig aktiviert und kann manuell für Projekte aktiviert werden, die vor dieser Aktivitätspaketversion erstellt wurden bietet der primären Zielmethode etwas mehr Zeit, um ihr gesamtes Timeout zu verbrauchen, bis eine Fallback-Zielmethode verwendet werden kann.

Wenn eine der primären Zielmethoden das UI-Element vor dem Ablauf des Timeouts findet, wird sie als Methode zur Interaktion mit dem UI-Element verwendet. Der strikte Selektor ist die Zielmethode, die zuerst nach dem UI-Element sucht, kurz darauf folgt der Fuzzy-Selektor. Zudem hat der strikte Selektor Vorrang vor dem Fuzzy-Selektor.

Wenn das UI-Element von den primären Zielmethoden nicht gefunden wird, bevor das Timeout abläuft, also wenn nach allen Wiederholungen innerhalb des zugewiesenen Timeouts weder der strikte Selektor noch der Fuzzy-Selektor das UI-Element findet, beginnen die sekundären und tertiären Zielmethoden mit der Suche nach dem UI-Element innerhalb eines eigenen Timeouts.

Diese Projekteinstellung bietet auch mehr Vorhersagbarkeit und Transparenz über Probleme im Zusammenhang mit Selektoren, sodass Sie eine bessere Kontrolle über die Ausrichtung Ihrer UI-Elemente haben und gleichzeitig über das solide Fallback verfügen, das Computer Vision bietet.

Wenn Sie diese Projekteinstellung deaktivieren, konkurrieren alle Zielmethoden im Rahmen eines einzigen Timeout bei der Suche nach dem UI-Element, wobei die Hierarchie beachtet wird: Ein Ziel, das von einer Zielmethode mit niedrigerem Rang gefunden wird, wird nur verwendet, wenn es von keiner Zielmethode mit einem höheren Rang gefunden wird.

Projekteinstellung: Höchste Übereinstimmungen in der Fehlermeldung „Element nicht gefunden“ anzeigen

Höchste Übereinstimmungen in der Projekteinstellung Fehlermeldung „Element nicht gefunden“ anzeigen (Projekteinstellungen > UI-Automatisierung modern) ist in neuen Projekten ab Aktivitätspaketversion 23.10.3 standardmäßig aktiviert und kann manuell für zuvor erstellte Projekte aktiviert werden der Aktivitätspaketversion. Wenn diese Einstellung aktiviert ist, wird bei einem Fehler bei einem Selektor in den Protokollen eine Warnung angezeigt, welche die Methode zum Auffinden des UI-Elements zusammen mit zehn Vorschlägen der höchsten Selektorübereinstimmungen zeigt, die als Ersatz für den fehlerhaften Selektor verwendet werden können.

Es wird nicht empfohlen, den Deskriptor manuell zu bearbeiten, da dieser gesamte Prozess für den Benutzer nahtlos sein und gute Ergebnisse liefern sollte, ohne dass eine erweiterte Konfiguration erforderlich ist. Wenn Sie dennoch erweiterte Funktionen für Ihren Deskriptor konfigurieren möchten, können Sie die Zielmethoden aktivieren, deaktivieren und bearbeiten.

Strikter Selektor

Selektoren sind XML-Fragmente, die die Attribute von UI-Elementen und übergeordneten Elementen enthalten. Selektoren werden verwendet, um UI-Elemente auf dem Bildschirm anzuzielen, indem sie und ihre Attribute überprüft und mit den Attributen im Selektor abgeglichen werden. Weitere Informationen darüber, was ein Selektor im UiPath-Ökosystem ist, finden Sie auf dieser Seite.

Der strikte Selektor des Zielelements kann in dem entsprechenden Abschnitt im Fenster „Auswahloptionen“ bearbeitet werden. Sie können auch die Schaltfläche In UI-Explorer öffnen verwenden, um den Selektor im UI-Explorer zu bearbeiten.

Das Feld Strikter Selektor unterstützt die Verwendung und Erstellung von Variablen und Argumenten über das Kontextmenü (zugänglich durch Rechtsklick).

Sie können auch einen Teil des Selektors auswählen und das Kontextmenü verwenden, um ihn direkt in eine Variable zu konvertieren, die mit Ihrer Auswahl vorab ausgefüllt wird.

Sie können auch eine bereits erstellte Variable aus dem Dropdownmenü Variablenname auswählen und in Ihrem Selektor verwenden.

Mit dem Kontrollkästchen Standardwert überschreiben können Sie den Wert in Ihrer vordefinierten Variablen durch Ihre aktuelle Auswahl ersetzen.

Die Schaltfläche Bestätigen speichert die Änderungen, die Sie in Ihrem Selektor vorgenommen haben.

Die folgenden Hotkeys sind verfügbar:

Ctrl+Space: Variable auswählen
Ctrl+Shift+Space: Argument auswählen
Ctrl+K: Variable erstellen
Ctrl+M: Argument erstellen

Wichtig:

Wenn es eine Variable und ein Argument mit demselben Namen gibt, wird zur Laufzeit standardmäßig immer die Variable verwendet.

Argumente, deren Namen mit Variablen identisch sind, werden im Variablenauswahlmenü im Auswahlbildschirm ausgeblendet.

Änderungen, die mit Variablen und Argumenten vorgenommen werden, können auf alle anderen Instanzen übertragen werden, in denen sie gefunden werden. Wenn eine Variable beispielsweise sowohl in den Feldern Strikter Selektor als auch Fuzzy-Selektor verwendet wird, wird bei einer Änderung in einem der Felder eine Meldung generiert, die Sie darüber informiert, dass derselbe Wert in einem anderen Feld gefunden wurde, und Ihnen die Option anbietet, alle Instanzen durch . zu ersetzen den neuen Wert.

Strikte Selektoren unterstützen auch Platzhalter, die verwendet werden können, um null oder mehrere Zeichen in einer Zeichenfolge zu ersetzen. Weitere Informationen zu dieser Funktion finden Sie hier.

Fuzzy-Selektor

Der Fuzzy-Selektor ähnelt dem strengen Selektor sehr, mit dem Unterschied, dass seine Attribute unscharf und nicht perfekt übereinstimmend sind. Dies bedeutet, dass ein Fuzzy-Selektor mehrere Elemente ausgeben kann, im Gegensatz zum strengen Selektor, der jeweils ein einzelnes Element ausgibt.

Der Fuzzy-Selektor kann im entsprechenden Abschnitt im Fenster „Auswahloptionen“ bearbeitet werden.

Die Übereinstimmungsgenauigkeit des Fuzzy-Selektors basiert auf dem Levenshtein-Distanz-Algorithmus, um die Ähnlichkeit von Selektoren zu beziffern. Der Standardwert ist 0,5 und kann entweder über den Schieberegler Genauigkeit oder durch die direkte Eingabe eines gültigen Werts in das Eingabefeld konfiguriert werden. Die Übereinstimmungsgenauigkeit kann in einem Bereich von 0,4 bis 1 festgelegt werden, wobei ein niedrigerer Wert einer niedrigeren Genauigkeit entspricht, sodass der Fuzzy-Selektor mehr Elemente ausgibt, während ein höherer Wert einer höheren Genauigkeit entspricht, sodass der Fuzzy-Selektor weniger Elemente ausgibt.

Genau wie der strikte Selektor unterstützt das Fuzzy-Selektorfeld die Verwendung und Erstellung von Variablen und Argumenten sowie Platzhalter. Weitere Einzelheiten finden Sie in den oben zur Verfügung gestellten Informationen.

Wenn das angegebene Element Text enthält, wird der Text im Eingabefeld unter dem Fuzzy-Selektor-Bearbeitungsfenster angezeigt. Wenn in diesem Eingabefeld Text angezeigt wird, muss er zur Runtime im Element selbst gefunden werden, um als Übereinstimmung zu gelten.

Das Dropdownmenü neben dem Eingabefeld bietet die folgenden Optionen:

Text ist/InnerText ist/FullText ist (abhängig von der verwendeten Text-Scraping-Methode) – Zeigt den extrahierten Text an; Die beste Scraping-Methode wird automatisch identifiziert und es wird empfohlen, sie zu verwenden.
Text ignorieren – Ignoriert den im Eingabefeld angegebenen Text.

Computer Vision

Computer Vision ist ein KI-gestütztes Modul, mit der UiPath-Roboter jedes UI-Element auf einem Computerbildschirm sehen und verstehen können. Computer Vision verbessert die Zielsuche: Wenn der Treiber einige UI-Elemente nicht „sehen“ kann, kann Computer Vision die UI-Automatisierung ermöglichen. Sie erhöht also die Zuverlässigkeit und Resilienz bei Änderungen von UI-basierten Automatisierungen und ist ein nützlicher Fallback für die anderen Zielmethoden.

Bild

Wenn die Bildautomatisierung für Ihr Ziel verwendet wird, können Sie auch den Screenshot des Elements anzeigen sowie die Bildgenauigkeit anpassen. Der Standardwert ist 0,8 und kann entweder über den Schieberegler für Genauigkeit oder direkt über das Eingabefeld durch Eingabe eines gültigen Werts konfiguriert werden. Die Genauigkeit kann in einem Bereich von 0,4 bis 1 festgelegt werden. Weitere Informationen finden Sie im Abschnitt Bild- und Textautomatisierung .

Wenn Sie Nur-Bild-Ziele definieren möchten, können Sie die Bildbereichsauswahl (F3) verwenden oder eine Feldauswahl des Bereichs zeichnen, den Sie beim Markieren als Ziel/Anker verwenden möchten.

Sie können auch die Aktualisierung verwenden Klicken Sie auf die Schaltfläche, um das ausgewählte Bild manuell zu aktualisieren, falls sich das Bild des Elements geändert hat, seit es angezeigt wurde.

Die Bildzielmethode ist in den Projekteinstellungen standardmäßig deaktiviert.

Um sie auf Projektebene zu aktivieren, wechseln Sie zu Projekteinstellungen > UI-Automatisierung modern > Zielmethoden: Desktopanwendungen / Zielmethoden: Webbrowser / Zielmethoden: Java / Zielmethoden: SAP (je nach Anwendungstyp der Automatisierung) > Bild > True auswählen.

Um die Methode für ein bestimmtes Element zu aktivieren, muss das Element gültig sein.

Nativer Text

Wenn Sie beim Angeben des Elements das Kontrollkästchen Native-Text aktivieren aktiviert haben, wird die Zielmethode „ Nativer Text “ verwendet. Mit dieser Methode können Sie alle Textbeschriftungen verwenden, die mit der Native-Methode identifiziert werden, um das Element zu identifizieren, mit dem Sie interagieren möchten.

Die mit dieser Methode identifizierte Textbezeichnung kann im entsprechenden Abschnitt bearbeitet werden, und Sie können mit der Schaltfläche Groß-/Kleinschreibung umschalten festlegen, ob der Text zwischen Groß- und Kleinschreibung beachtet werden soll oder nicht.

Offlinebearbeitung

Wenn eine Anwendung nicht mehr geöffnet ist, Sie aber ihren Deskriptor bearbeiten möchten, werden Sie durch Auswählen von Ziel bearbeiten (E) aus dem Kontextmenü im Hauptteil der Aktivität zu Wiederholen ( Retry), Offline bearbeitenoder Abbrechen ( Cancel) aufgefordert.

Wenn Sie die Option Offline bearbeiten auswählen , wird der Auswahlbildschirm im Offline-Bearbeitungsmodus geöffnet. Im Offlinebearbeitungsmodus können Sie keine Anker hinzufügen, den Deskriptor oder andere Funktionen überprüfen, die eine Live-Anwendung erfordern.

Validieren des Deskriptors

Der Validierungsprozess stellt sicher, dass alle Kombinationen von Suchmethoden für das Ziel korrekt funktionieren. Sie können Ihre Auswahl validieren , indem Sie die Schaltfläche Validieren auf dem Auswahlbildschirm verwenden.

Wenn Sie ein Paar aus Ziel und Anker haben, verwendet jedes von ihnen alle verfügbaren Methoden für das Ziel. Um das endgültige Ziel zu finden, werden alle möglichen Kombinationen für jedes dieser Elemente den Elementen auf dem Bildschirm zugeordnet, und nach dem Abgleich wird eine Punktzahl angegeben.

Wenn nach der Validierung Duplikate gefunden werden, werden diese in der Zielanwendung hervorgehoben. Wenn keine Duplikate gefunden werden, werden neben den Zielmethoden Symbole angezeigt, die Sie über den Status jeder Zielmethode in der jeweiligen Situation informieren. Folgende Symbole werden verwendet:

Die schnellste Zielmethode

Die Methode hat funktioniert, war aber nicht die schnellste

Bei der Methode wurden Duplikate gefunden, und das richtige Element wurde identifiziert, indem diese Methode neben anderen Zielmethoden verwendet wurde