Export UI Tree

UiPath.Core.Activities.ExportUiTree

Exportiert alle UI-Elemente und ihre jeweiligen Attribute und Werte, die im angegebenen Element gefunden wurden, als XML- oder JSON-Datei. Diese Aktivität hilft Ihnen zu verstehen, warum ein Selektor während der Ausführung fehlgeschlagen ist, indem Sie die Ausgabe der Aktivität überprüfen und mit der Selektorkonfiguration vergleichen.

Eigenschaften

Allgemein

• BeiFehlerFortfahren (ContinueOnError) - Gibt an, ob die Automatisierung auch bei Auftreten eines Fehlers weiterlaufen soll. Das Feld unterstützt nur Boolesche Werte (Wahr, Falsch). Der Standardwert ist Falsch. Dadurch wird die Ausführung des Projekts beim Auftreten eines Fehlers angehalten, wenn das Feld leer. Wenn der Wert auf Wahr gesetzt ist, wird das Projekt weiter ausgeführt, auch wenn Fehler auftreten.

  Hinweis: Wenn diese Aktivität in Try Catch enthalten ist und der Wert der Eigenschaft BeiFehlerFortsetzen auf „True“ gesetzt ist, wird kein Fehler beim Ausführen des Projekts aufgefangen.
• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität.

Eingabe

• 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.
• 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.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.

Sonstiges

• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert.

Optionen

• ExportFormat – Eine Dropdownliste, die das Format angibt, in dem die UI-Elemente exportiert werden sollen. Sie können zwischen XML und JSONwählen. Standardmäßig ist XML ausgewählt.
• Exportpfad - Der Pfad, unter dem die Datei mit der extrahierten UI-Struktur erstellt werden soll. Wenn dieses Feld leer bleibt, wird die Datei als ExportedString-Ausgabeargument exportiert. Dieses Feld unterstützt nur Strings und String-Variablen.
• Filter – Ein Filter, mit dem Sie nur bestimmte Selektortypen exportieren können. Die exportierte UI-Struktur enthält enthält nur UI-Elemente, die von den in diesem Feld angegebenen Selektortypen abhängen.
• ScreenshotsEinschließen – Wenn diese Option ausgewählt ist, werden Screenshots der UI-Struktur zusammen mit der Datei mit den Selektoren gespeichert. Standardmäßig ist dieses Kontrollkästchen deaktiviert.
• TimeoutBeiVorgang (Millisekunden) – Gibt die Zeit (in Millisekunden) an, die gewartet werden soll, bis die Aktivität die Datei generiert, die die exportierte UI-Struktur enthält.
• Überschreiben – Wenn diese Option ausgewählt ist, überschreibt die Aktivität alle Dateien, die unter dem Pfad vorhanden sind, der im Eigenschaftsfeld Exportpfad angegeben ist. Standardmäßig ist dieses Kontrollkästchen deaktiviert.
• UIFramework – Ein Dropdownmenü, welches das UI-Framework angibt, das zum Erkennen von UI-Elementen der obersten Ebene verwendet wird. Es gibt drei mögliche Optionen: Standard, Active Accessibility und UiAutomation. Standardmäßig ist Standard ausgewählt. Dieses Eigenschaftsfeld wird nur beim Exportieren des Inhalts des gesamten Desktops verwendet.

Im Textkörper der Aktivität

Im Textkörper der Aktivität können Sie mehrere Parameter der Aktivität konfigurieren, ohne mit dem Eigenschaftenbereich zu interagieren, z. B.:

Mit der Schaltfläche Auf Bildschirm anzeigen können Sie die Zielanwendung auswählen, deren UI-Struktur Sie exportieren möchten.

Im Dropdownmenü Exportformat können Sie zwischen den Formaten XML und JSON auswählen, die für die exportierte Datei verwendet werden können.

Im Feld Zieldatei können Sie den Pfad angeben, in dem die Datei gespeichert werden soll, oder nach dem Ordner suchen.

Das Kontrollkästchen Screenshots einfügen gibt an, ob Screenshots der tatsächlichen UI-Elemente zusammen mit der Datei mit der UI-Struktur gespeichert werden sollen oder nicht. Standardmäßig ist das Kontrollkästchen deaktiviert.