Strukturierte Daten extrahieren (Extract Structured Data)

UiPath.Core.Activities.ExtractData

Extrahiert Daten von einer angezeigten Webseite. Sie können durch Angabe einer XML-Zeichenfolge im Feld ExtractMetadata im Panel Properties angeben, welche Informationen extrahiert werden sollen. Über die Eigenschaftensätze kann diese Extraktion einfach mit dem Data-Scraping-Assistenten generiert werden.

Eigenschaften

Eingabe

• ExtractMetadata - An XML string that enables you to define what data to extract from the indicated web page.
• 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.

Optionen

• ZwischenSeitenVerzögernMS (DelayBetweenPagesMS) - Die Dauer in Millisekunden, die gewartet wird, bis die nächste Seite geladen wird. (Wenn die Ladezeit der Seite länger ist, sollte dieser Wert höher sein.)
• MaxAnzahlAnErgebnissen (MaxNumberOfResults) - Die maximale Anzahl an zu extrahierenden Ergebnissen. Ist der Wert 0, werden alle identifizierten Elemente der Ausgabe hinzugefügt. Der Standardwert is 100.
• SelektorNächsterLink (NextLinkSelector) - Der Selektor, der den Link/die Schaltfläche zum Navigieren zur nächsten Seite identifiziert. Sollte relativ zur Eigenschaft ExistingUiElement sein.
• FenstermeldungenSenden - Bei Auswahl wird in dem Fall, dass sich die zu extrahierenden Daten über mehrere Seiten erstrecken, der Klick, der die Seite wechselt, ausgeführt, indem eine spezielle Nachricht an die Zielanwendung gesendet wird. Diese Eingabemethode kann im Hintergrund arbeiten, ist mit den meisten Desktop-Apps kompatibel, aber nicht die schnellste Methode. Standardmäßig ist diese Methode nicht ausgewählt. Wenn weder diese Eigenschaft noch die Auswahlfelder für KlickSimulieren ausgewählt sind, simuliert die Standardmethode die Texteingabe über den Hardware-Treiber. Die Standardmethode ist die langsamste, kann nicht im Hintergrund arbeiten, ist aber mit allen Desktop-Apps kompatibel.
• KlickSimulieren - Bei Auswahl wird in dem Fall, dass sich die zu extrahierenden Daten über mehrere Seiten erstrecken, der Klick simuliert, der die Seite wechselt, indem die Technologie der Zielanwendung verwendet wird. Diese Eingabemethode ist die schnellste von den dreien und kann im Hintergrund arbeiten. Standardmäßig ist dieses Auswahlfeld nicht ausgewählt. Wenn weder diese Eigenschaft noch die Auswahlfelder für FenstermeldungenSenden ausgewählt sind, simuliert die Standardmethode den Klick über den Hardware-Treiber. Die Standardmethode ist die langsamste, kann nicht im Hintergrund arbeiten, ist aber mit allen Desktop-Apps kompatibel.

Ausgabe

• DatenTabelle (DataTable) - Die Informationen, die von einer Webseite extrahiert werden. Dieses Feld unterstützt nur Variablen vom Typ DataTable.

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.

Sonstiges

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