Text vorhanden (Text Exists)

UiPath.Core.Activities.TextExists

Prüft, ob ein Text in einem angegebenen UI-Element gefunden wird.

Hinweis: Diese Aktivität funktioniert nicht ordnungsgemäß, wenn sie in Browsern verwendet wird, die automatisierte Erweiterungen erfordern, z. B. Chrome, Firefox und Edge.

Eigenschaften

Eingabe

• Text (Text) - Die zu suchende Zeichenfolge.

  Hinweis: Alle Zeichenfolgen müssen zwischen Anführungszeichen gesetzt werden.
• Auftreten (Occurrence) - Wenn die Zeichenfolge im Textfeld öfter als ein Mal im angezeigten UI-Element erscheint, können Sie an dieser Stelle angeben, welches Auftreten des Textfelds gefunden werden soll. Wenn die Zeichenfolge beispielsweise vier Mal erscheint und das erste Auftreten gefunden werden soll, geben Sie 1 in dieses Feld ein. Der Standardwert ist 1.

Optionen

• FormatierterText (FormattedText) - Wenn dieses Auswahlfeld ausgewählt ist, wird der Bildschirmaufbau des extrahierten Texts beibehalten.

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.
• Target.TimeoutMS – Gibt die Zeit (in Millisekunden) an, die auf die Ausführung der Aktivität gewartet werden soll, bevor der Fehler SelectorNotFoundException ausgegeben wird. 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 – Das <webctrl>-Tag wird verwendet, um zu überprüfen, ob der Status Bereit des HTML-Dokuments Abgeschlossen ist. Darüber hinaus muss der Status Beschäftigt auf „False“ festgelegt werden.
  2. Andere – Das <webctrl>-Tag wird verwendet, um zu überprüfen, ob der Bereitschafts-Status des HTML-Dokuments Abgeschlossen ist.
  • 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.
• Ziel.BereichAusschneiden (Target.ClippingRegion) - Definiert das Ausschneide-Rechteck relativ zum UiElement.

Ausgabe

• Besteht (Exists) - Zeigt an, ob der Text vorhanden ist oder nicht. Das Feld unterstützt nur boolesche Variablen.

Allgemein

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