Der Xtract Universal Designer bietet die Möglichkeit Extraktionen auszuführen, indem Sie Laufzeitparameter und andere Optionen übergeben.

Extraktion ausführen #

Wählen Sie eine Extraktion aus der Liste der Exraktionen aus und klicken Sie auf [Run], um das Fenster “Run Extraction” zu öffnen. Alternativ öffnen Sie es per Rechtsklick auf die Extraktion oder durch die Menüleiste “Extraction”.

Run-Table-Extraktion

Das “Run Extraction” Fenster beinhaltet:

  • General Info (1)
  • Runtime parameters (2)
  • URL und Kommandozeile (3)
  • Logs und Output (4)
  • Buttons (5)

General Info (1) #

Info Objekt Details
Extraction name Name der Exraktion
Source Information über die Quelleigenschaften (Name, Host, Client, Benutzername, Instanznr., Sprache)
Destination Name of der Destination (Name, Typ, Pull Destination)
Execution start Zeitstempel für den Beginn der Extraction
Time elapsed Vergangene Zeit seit Beginn der Extraktion
Rows extracted Anzahl extrahierter Zeilen
Status Status der Extraktion
Duration Dauer der Extraktion

Runtime parameters (2) #

Die Tabs “Extraction”, “Source” und “Custom” beinhalten die Extraktionsparameter der Extraktion. Wenn diese Parameter geändert werden, passen sich auch automatisch URL und Kommandozeile (3) entsprechend an.

Beispiel

  1. Wählen Sie eine Checkbox aus, um einen Parameter zu überschreiben.
  2. Tragen Sie den neuen Wert ein und bestätigen Sie ihn über die Eingabetaste.
    • Extraktions-URL vor der Parameteränderung
      http://localhost:8065?name=Plants
    • Extraktions-URL nach der Parameteränderung in rows:
      http://localhost:8065?name=Plants&rows=100

Run-Table-Extraction-param

Hinweis: Zusätzliche Parameter wie Package size, Row limit, etc. sind in Extraktionseinstellungen beschrieben.

URL und Kommandozeile (3) #

In URL und xu.exe wird ein generierter String angezeigt, der sich automatisch aktualisiert wenn Runtime Parameter(1) geändert werden. Benutzen Sie diese Strings, um eine Extraktion auch außerhalb vom Xtract Universal Designer durchzuführen.

URL

Die Extraktions-URL kann für verschiedene Anwendungsfälle verwendet werden.

  • Rufen Sie die Extraktion dort auf, wo es mit dem Kommandozeilen-Tool xu.exe nicht möglich ist, z. B. aus cloudbasierten Zielumgebungen.
  • Rufen Sie die URL auf, wenn eine Pull-Destination verwendet wird.
  • Führen Sie die Extraktion in einem Webbrowser aus, z. B. zu Testzwecken.
  • Weitere Anwendungsfälle sind möglich, z. B. der Aufruf in einem PowerShell-Skript.

Hinweis: Das Kopieren der URL mit [Strg+C] oder dem Button auf der rechten Seite und das Ausführen in einem Webbrowser entspricht der Funktionalität “Run in browser”, die durch Rechtsklick auf eine Extraktion in der Hauptfenster Übersicht verfügbar ist.

xu.exe

Der in xu.exe angezeigte Befehl ermöglicht die Ausführung einer Extraktion mit dem Kommandozeilen-Tool, das mit Xtract Universal installiert wird. Das Tool befindet sich im Installationsordner: C:\Program Files\XtractUniversal\xu.exe
Der Befehl kann mit [STRG+C] oder dem Button auf der rechten Seite kopiert werden.

Wir empfehlen die Verwendung des Kommandozeilen-Tools mit Push-Destinationen. Der Befehl kann von einem Windows-Skript oder einem beliebigen Scheduler, der Windows-Kommandozeilenaufrufe ausführen kann, aufgerufen werden.
Im einfachsten Fall kann der Windows Task Scheduler zum Aufrufen und Planen von Extraktionen mit xu.exe verwendet werden. Ausführlichere Informationen zum Einplanen von Extraktionen finden Sie unter Planen einer Extraktion.

Die Parameter “-s” (Server für die Extraktion), “-p” (Listener-Port des Xtract Universal Servers) und “-n” (Name der Exraktion) werden standardmäßig für jede Extraktion generiert.

Logs und Output (4) #

Wenn eine Extraktion ausgeführt wird, werden hier aktuelle Informationen angezeigt.

Log

Im Log Tab werden die Protokolle der Extraktion in Echtzeit angezeigt. Solange die Checkbox Auto scroll to the end aktiv ist, wird automatisch zum letzten Protokoll gescrollt.

xu.exe

Im xu.exe Tab werden die Befehle der xu.exe Kommandozeile angezeigt.

Output

Im Output Tab werden die Ergebnisse der Extraktion angezeigt. Die Anzeige ist nur bei folgenden Destinationen verfügbar:

  • HTTP-CSV
  • HTTP-JSON
  • Alteryx
  • Microsoft SQL Server
  • Power BI Report Server (SQL Server Reporting Services)
  • QlikSense&QlikView

Run-Extraction-Output

Anzahl der angezeigten Zeilen einschränken
Im Output Tab werden standardmäßig bis zu max. 500 Zeilen angezeigt. Die Anzahl der anzuzeigenden Zeilen kann über die Boxen Display rows from line unter der Anzeige angepasst werden.

Ergebnisse Filtern
Um die Ergebnisse nach bestimmten Werten zu filtern, geben Sie die gesuchten Werte über der jeweiligen Spalte ein und klicken Sie auf [Display]. Um die Filter wieder rückgängig zu machen, klicken Sie auf [Clear search] und anschließend wieder auf [Display].

Run, Abort und Close (5) #

[Run] startet die Extraktion, [Abort] bricht sie ab und [Close] schließt das Fenster.

Hinweis: Wenn die Option Request SAP credentials from caller when running extraction in den Einstellungen der SAP Quelle aktiv ist, werden Sie zur Eingabe Ihrer SAP-Anmeldedaten aufgefordert, sobald Sie eine Extraktion ausführen. Dafür müssen Extraktionen via HTTPS - unrestricted aufgerufen werden.