For Each UI Element

UiPath.UIAutomationNext.Activities.NForEachUiElement

Beschreibung

Durchläuft eine Liste von UI-Elementen und führt für jedes von ihnen eine oder mehrere Actions aus.

Diese Aktivität muss innerhalb einer Use Application/Browser-Aktivität hinzugefügt werden.

Um diese Aktivität außerhalb einer Use Application/Browser-Aktivität zu verwenden, müssen Sie ein Input-Element angeben.

Diese Aktivität ist mit Object Repository kompatibel.

Projektkompatibilität

Windows - Legacy | Windows

Windows – Legacy, Windows-Konfiguration

Designer-Panel

• Klicken Sie auf In App/Browser anzeigen , um das UI-Element anzugeben, das mit dem Assistenten Für jedes UI-Element als Ziel verwendet werden soll. Weitere Informationen zur Verwendung dieser Aktivität und ihres Assistenten finden Sie hier.

Nachdem Sie das Ziel angegeben haben, wählen Sie das Menüaus Taste, um auf die folgenden Optionen zuzugreifen:

• Konfiguration bearbeiten – Öffnen Sie den Assistenten Für jedes UI-Element, um das Ziel zu konfigurieren.
• Neues Ziel konfigurieren – Geben Sie das Ziel erneut an.
• Informativen Screenshot entfernen – Entfernt den Screenshot der Zielanwendung oder Webseite.
• Zu Object Repository hinzufügen – Fügen Sie das aktuelle UI-Element zu einem Bibliotheksprojekt hinzu, von wo aus es im gesamten Automatisierungsprozess wiederverwendet werden kann. Um die Elemente zu filtern, die Sie mit Ihrer Auswahl extrahiert haben, wählen Sie Filter konfigurieren.

Eigenschaften-Panel

Allgemein

• Bei Fehler fortsetzen – Gibt an, ob die Automatisierung auch dann fortgesetzt werden soll, wenn die Aktivität einen Fehler ausgibt. Dieses Feld unterstützt nur Boolean -Werte (True, False). Der Standardwert ist False. Wenn das Feld leer ist und ein Fehler ausgegeben wird, wird die Ausführung des Projekts angehalten. Wenn der Wert auf „True“ gesetzt ist, wird die Ausführung des Projekts ungeachtet eines Fehlers fortgesetzt.
• Delay after - Delay (in seconds) between the time this activity is completed and the time the next activity begins any operations. The default value is 0.3 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.
• Delay before - Delay (in seconds) between the time the previous activity is completed and the time this activity begins performing any operations. The default value is 0.2 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.
• Anzeigename – Der Name, der für die Aktivität im Designerbereich angezeigt wird. Ein Anzeigename wird automatisch generiert, wenn Sie ein Ziel angeben.
• Zeitüberschreitung – Geben Sie die Zeitspanne (in Sekunden) an, die auf die Ausführung der Aktivität gewartet werden soll, bevor ein Fehler ausgegeben wird. Der Standardwert beträgt 30 Sekunden.

Eingabe

• Ziel – Das Zielelement. Zielelement muss festgelegt sein. Vor der Anzeige auf dem Bildschirm wird dieses Feld auf (null) festgelegt. Sobald das Ziel angegeben wurde, werden alle Eigenschaften in Bezug auf das angegebene Element angezeigt.

  • CV-Steuerelementtyp – Gibt den Steuerelementtyp an, der mithilfe von Computer Vision identifiziert wurde.
  • CV-Text – Gibt den Text an, der mit Computer Vision identifiziert wurde.
  • Fuzzy selector - The parameters for the fuzzy selector.
  • Nativer Text – Der Text, der zum Identifizieren des UI-Elements verwendet wird.
  • Reaktionsfähige Websites – Aktivieren Sie das Layout für reaktionsfähige Websites.
  • Strikter Selektor – Der für das UI-Element generierte strikte Selektor.
  • Zielmethoden – Die Selektortypen, die Sie zur Identifizierung des Elements verwenden möchten. Diese Eigenschaft kann auf eine beliebige Kombination im Dropdownmenü festgelegt werden:
    • Keine
    • Strikter Selektor
    • Fuzzy-Selektor
    • Bild
    • Nativer Text
    • Computer Vision – Um Computer Vision als Zielmethode zu verwenden, müssen Sie zu Projekteinstellungen > Computer Vision wechseln und sicherstellen, dass Sie den richtigen Serverendpunkt festlegen. Sie können dieses Feld unverändert lassen und UiPath Cloud verwenden, das standardmäßig ausgefüllt ist, oder Sie können einen anderen Wert eingeben, indem Sie einen der anderen öffentlichen Endpunkte auswählen, die für eine Serverregion spezifisch sind, oder Ihren eigenen lokalen Server. Eine andere Möglichkeit, Computer Vision als Zielmethode zu verwenden, besteht darin, Use Local Server auf True festzulegen. Das bedeutet, dass das UiPath.ComputerVision.LocalServer-Paket in Ihrem Projekt installiert ist. Wenn „Lokaler Server“ aktiviert ist, wird der Serverwert überschrieben. Der Lokale Server ist jedoch in plattformübergreifenden Projekten nicht verfügbar.
    • Semantischer Selektor – Nutzt große Sprachmodelle (LLMs), um funktionale, menschenähnliche Beschreibungen von UI-Elementen zu generieren. Diese Beschreibungen sind sehr zuverlässig, wodurch sie an Änderungen der Benutzeroberfläche angepasst werden können und die Belastbarkeit der Automatisierung erheblich verbessert wird, wenn herkömmliche Selektoren fehlschlagen.
  • Sichtbarkeitsprüfung – Überprüft, ob das UI-Element sichtbar ist oder nicht. Sie können eine der drei Optionen aus dem Dropdownmenü auswählen:
    • Keine – Prüft nicht die 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 verborgen sind.
    • Vollständig sichtbar
      • Überprüft, ob das UI-Element sichtbar ist oder nicht.
  • Auf Laden der Seite warten – Wartet vor der Ausführung der Aktion, bis die Anwendung zum Akzeptieren von Eingaben bereit ist. Sie können eine der drei Optionen aus dem Dropdownmenü auswählen:
    • Keine – Wartet nicht, bis das Ziel bereit ist.
    • Interaktiv - Wartet, bis nur ein Teil der App geladen ist.
    • Vollständig - Wartet bis die gesamte App geladen ist.
  • Fensterselektor (Anwendungsinstanz) – Der Selektor, der für das Anwendungsfenster verwendet wird. Nur anwendbar, wenn der Anhängemodus für Fenster auf Anwendungsinstanz festgelegt ist.

• Ziel (NächsteSchaltfläche) - Das nächste UI-Element, für das Sie Aktionen ausführen möchten. Bevor Sie auf dem Bildschirm das Ziel angeben, das Sie verwenden möchten, wird dieses Feld auf (null) festgelegt. Sobald das Ziel angegeben wurde, werden alle Eigenschaften in Bezug auf das angegebene Element angezeigt. Mit Ausnahme von Klick-Offset sind die untergeordneten Eigenschaften dieses Felds identisch mit den Eigenschaften, die für die Eigenschaft Target spezifisch sind.

  • Klick-Offset – Gibt einen Offset für die Klickaktivität an, der weiter konfiguriert werden kann.
    • Ankerpunkt – Beschreibt den Startpunkt des Cursors, zu dem er durch die Eigenschaften Offset X und Offset Y verschoben wird. Die folgenden Optionen sind verfügbar: ObenLinks, ObenRechts, UntenLinks, UntenRechts und Mitte. Standardmäßig ist Mitte ausgewählt.
    • Offset X - Horizontale Verschiebung der Cursorposition entsprechend der im Feld Ankerpunkt ausgewählten Option. Dieses Feld unterstützt nur Int32 -Variablen.
    • Offset Y - Vertikale Verschiebung der Cursorposition entsprechend der im Feld Ankerpunkt ausgewählten Option. Dieses Feld unterstützt nur Int32 -Variablen.

Eingabe/Ausgabe-Element

• Eingabeelement - Das UI-Element, auf dem die Aktivität ausgeführt wird, gespeichert in einem UIElement -Objekt. Dieses Feld unterstützt nur UIElement -Objekte. Dieses Objekt kann aus dem Eigenschaftsfeld Ausgabeelement anderer UI-Automatisierungsaktivitäten abgerufen werden.
• Ausgabeelement – Gibt ein Ziel-UI-Element aus und speichert es in einem UIElement -Objekt, das weiter verwendet werden kann, um mit anderen Aktivitäten auf dasselbe Element abzuzielen.

Sonstiges

• Privat - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert. Dieses Feld unterstützt nur Boolean -Werte (True, False). Der Standardwert ist False.

Optionen

• Delay between pages - The amount of time (in seconds) to wait until the next page is loaded if the data spans multiple pages.
• Input mode - Select which method the Robot should use to interact with the target application:
  • Wie App/Browser – Verwenden Sie den gleichen Eingabemodus wie die Aktivität Use Application/Browser . Dies ist die Standardauswahl.
  • Hardware-Ereignisse – Verwendet den Hardwaretreiber, um die Aktion auszuführen. Dies ist die langsamste Methode, die nicht im Hintergrund ausgeführt werden kann, aber sie ist mit allen Desktop-Apps kompatibel. Diese Option ist standardmäßig ausgewählt, wenn Sie die Standardeinstellung für eine der folgenden Eigenschaften Klicktyp, Maustaste oder Zusatztasten ändern.
  • Simulieren – Simuliert die Verwendung von Barrierefreiheits-APIs. Empfohlen für Browser, Java-basierte Anwendungen, SAP. In der Regel zuverlässiger als Hardware-Ereignisse. Sendet den gesamten Text in einer einzigen Aktion. Funktioniert auch dann, wenn die Ziel-App nicht im Fokus steht. Bitte testen Sie, ob das UI-Element der Zielanwendung dies unterstützt.
  • Chromium-API – Führt Aktionen mithilfe von Debugger-APIs aus. Funktioniert nur für Chromium-Elemente. Sendet den gesamten Text auf einmal. Funktioniert auch dann, wenn die Ziel-App nicht im Fokus ist. Weitere Informationen finden Sie auf dieser Seite.
  • Fenstermeldungen – Simulieren Sie die Verwendung von Win32-Nachrichten. Empfohlen für Desktop-Apps. In der Regel zuverlässiger als Hardware-Ereignisse. Sendet den gesamten Text in einer einzigen Aktion. Funktioniert auch dann, wenn die Ziel-App nicht im Fokus steht. Bitte testen Sie, ob das UI-Element der Zielanwendung dies unterstützt.
• Limit extraction to - The type of limit you want to apply when extracting data. The following options are available:
  • Max. UI-Elemente – Gibt die maximale Anzahl der UI-Elemente an, die Sie extrahieren möchten. Der Standardwert ist 1000.
  • No limit - Extracts all elements that can be found, without any limit.
  • Max. Seiten – Gibt die maximale Anzahl von Seiten an, aus denen Sie UI-Elemente extrahieren möchten, wenn Sie Daten aus Tabellen extrahieren, die sich über mehrere Seiten erstrecken.
• Number of items - The maximum number of results that you want to extract. If the value is 0, all of the identified items are extracted.