Untergeordnete Elemente finden (Find Children)

UiPath.Core.Activities.FindChildren

Ruft eine Sammlung von untergeordneten UI-Elementen zum angegebenen Bereich und Filter auf.

Eigenschaften

Eingabe

• Filter – Der Filter ist ein Selektor. Die Aktivität sucht nach allen untergeordneten oder Nachfolgern des Zielelements, die mit dem Selektor übereinstimmen. Zum Beispiel würde die Verwendung von <webctrl tag='UL' /> eine Suche nach ungeordneten Listenelementen innerhalb einer bestimmten Webseite initiieren.

  Hinweis:

  Wenn die von Ihnen verwendete Filterbedingung alle möglichen Elemente auslässt, wird eine leere Liste von Elementen zurückgegeben.

Optionen

• Scope – Ermöglicht Ihnen, den Scope der UI-Elemente in der Sammlung festzulegen. Die folgenden Optionen sind verfügbar:
  • FIND_CHILDREN – Die Suche umfasst die unmittelbaren untergeordneten Elemente des Elements.
  • FIND_DESCENDANTS – Die Suche umfasst die Nachfolger des Elements, einschließlich der untergeordneten Elemente.
  • FIND_TOP_Level – Die Suche umfasst die Reihenfolge und die Anzahl der untergeordneten Elemente.
  • FIND_PROCESS – Die Suche beinhaltet die Datentypen für die untergeordneten Elemente.
  • FIND_THREAD – Die Suche umfasst die Standard- und festen Werte für die untergeordneten Elemente.

Ausgabe

• Children - All UI children found according to the filter and scope set. The field supports only IEnumerable<UiElement>variables.

Sonstiges

• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert.
• Ziel.Selektor (Target.Selector) - Texteigenschaft zum Suchen eines bestimmten UI-Elements, wenn die Aktivität ausgeführt wird. Die Eigenschaft ist genau genommen ein XML-Fragment, das Attribute des gesuchten GUI-Elements und einige übergeordnete Elemente spezifiziert.
• Ziel.AuszeitMS (Target.TimeoutMS) - Gibt die Wartezeit (in Millisekunden) bis zur Fehlerausgabe SelectorNotFoundException einer laufenden Aktivität an. Der Standardwert ist 30000 Millisekunden (30 Sekunden).
• Ziel.WartenBisBereit (Target.WaitForReady) - Vor Ausführung der Aktionen warten, bis das Ziel bereit ist. Folgende Optionen sind verfügbar:
  • Keine (None) - Wartet ausschließlich auf das UI-Zielelement, bevor die Aktion ausgeführt wird. Sie können diese Option beispielsweise verwenden, wenn Sie nur Text einer Website abrufen oder eine bestimmte Schaltfläche anklicken möchten, ohne auf das Laden aller UI-Elemente warten zu müssen. Beachten Sie, dass dies ungewünschte Folgen haben kann, wenn die Schaltfläche von Elementen wie Skripten abhängt, die noch nicht geladen sind.
  • Interaktiv/Abgeschlossen – Wartet, bis alle UI-Elemente in der Ziel-App vorhanden sind, bevor die Aktion tatsächlich ausgeführt wird. Um zu beurteilen, ob sich eine Anwendung im Status „Interaktiv“ oder „Abgeschlossen“ befindet, werden die folgenden Tags überprüft:
  • Desktop-Anwendungen (Desktop applications) - Eine Nachricht wm_null wird versendet, um zu prüfen, ob die Tags<wnd>, <ctrl>, <java> oder <uia> vorhanden sind. Sind die Tags vorhanden, wird die Aktivität ausgeführt.
  • Webanwendung
  1. Internet Explorer - The <webctrl> tag is used to check if the Ready state of the HTML document is set to Complete. Additionally, the Busy state has to be set to "False".
  2. Others - The <webctrl> tag is used to check if the Ready state of the HTML document is Complete.
  • SAP-Anwendungen (SAP applications) - Zuerst wird geprüft, ob der Tag <wnd> vorhanden ist. Anschließend wird eine SAP-spezifische API verwendet, um zu prüfen, ob die Session verfügbar ist.
• Ziel.Element (Target.Element) - Verwendet die Variable UIElement, die von einer anderen Aktivität zurückgegeben wird. Die Eigenschaft kann nicht zusammen mit der Auswahleigenschaft verwendet werden. Dieses Feld unterstützt nur Variablen vom Typ UIElement.
• Target.ClippingRegion - Definiert das Ausschneide-Rechteck in Pixel im Verhältnis zum UIElement in folgenden Richtungen: links, oben, rechts, unten. Es unterstützt sowohl positive als auch negative Zahlen.

Allgemein

• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität.

• BeiFehlerFortsetzen – Gibt an, ob die Automatisierung auch dann fortgesetzt werden soll, wenn die Aktivität einen Fehler ausgibt. Dieses Feld unterstützt nur boolesche 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.

  Hinweis:

  Wenn die Aktivität in Abfangen versuchen (Try Catch) enthalten ist und der Wert der Eigenschaft BeiFehlerFortfahren (ContinueOnError) auf Wahr (True) gesetzt ist, wird kein Fehler bei der Ausführung des Projekts abgefangen.