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

Extraktion ausführen #

Der folgende Abschnitt beschreibt die Parameter einer Extraktion, welche dynamisch zur Laufzeit gesetzt werden können. Zu diesen Parametern gelangen Sie über das Fenster “Run Extraction”.

Die Extraktionsparameter definieren wie Daten aus der Datenquelle extrahiert werden. Sie werden im Fenster “Run extractions” unter Runtime Parameters eingestellt.

Extraction parameters

Wählen Sie eine Extraktion im Hauptfenster des Designers und klicken Sie auf [Run] um das Fenster “Run extractions” zu öffnen. Weitere Informationen finden Sie in Eine Extraktion ausführen.

Extraction #

Die Anzahl der verfügbaren Parameter ist abhängig von dem Extraktionstyp und der Destination, z.B. ist decimalSeparator ein Parameter, der nur in der CSV-Destination vorhanden ist.

Parametername Beschreibung Spezielle Infos
clearBuffer leert den Ergebnis-Buffer Standardwert - false
preview aktiviert die Preview Standardwert - false
source ermöglicht das dynamische Auswählen eines SAP-Quellsystems aus dem die Daten extrahiert werden.
Nur aktiv, wenn mehrere SAP-Quellsysteme verfügbar sind, z.B. sap_dev und sap_prod.		 -
destination ermöglicht das dynamische Auswählen einer Destination, in die die extrahierten Daten geschrieben werden.
Nur aktiv, wenn mehrere Destinationen verfügbar sind, z.B. db_1 und db_2.		 -
rows setzt die maximale Anzahl der extrahierten Datensätze verfügbar in Table
where setzt die WHERE-Bedingung verfügbar in Table
packageSize setzt die Paketgröße verfügbar in Table
updateMode Update Modus für die Ausführung verfügbar in ODP
subscriptionSuffix Suffix um mehrere inits auf einem SAP System zu verwenden verfügbar in ODP
extractDataOnDeltaInit Datenextraktion bei delta init verfügbar in ODP
hierarchyName Name der zu extrahierenden Hierarchie verfügbar in ODP, DeltaQ & Hierarchy
representation Name der Repräsentation / des Ausgabeformats der zu extrahierenden Hierarchie: “ParentChild”, “Natural” oder “ParentChildWithNodeNames” verfügbar in Hierarchy
dateTo Gültigkeitsdatum der zu extrahierenden Hierarchie im Format YYYYMMDD verfügbar in Hierarchy
variant Name einer Variante verfügbar in Report & SAP Query
batchJobName Name des Batch Jobs verfügbar in Report
gatwewayHost Gateway Host verfügbar in DeltaQ
gatewayService Gateway Service verfügbar in DeltaQ
programID Program ID verfügbar in DeltaQ
logicalDestination Logische Destination verfügbar in DeltaQ
requestID Request ID (nur für Repair Request) verfügbar in DeltaQ
updateType F (Full), C (Delta Init), S (Init no data), D (Delta Update), R (Repeat) verfügbar in DeltaQ
decimalSeparator setzt ein Symbol zwischen dem Ganzzahlteil und dem Bruchzahlteil verfügbar in CSV Destinationen
columnSeparator setzt ein Symbol, das den Anfang einer Spalte bezeichnet verfügbar in CSV Destinationen

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 source:
      http://localhost:8085/?name=Plants&source=SAP_PROD

Source #

Die Verbindungseinstellungen zu einer SAP Quelle können dynamisch über die URL oder die xu.exe geändert werden.

Im Tab Source können Sie die Werte überschreiben, die in den SAP-Source-Einstellungen definiert sind.

Source parameters

Parametername Beschreibung
lang ändert dynamisch die SAP-Anmeldesprache des SAP-Quellsystems
logonTicket ändert dynamisch das Anmeldeticket. Siehe SSO mit SAP Logon Ticket für mehr Details.

Hinweis: Der Parameter logonTicket kann nur gesetzt werden, wenn “SAP logon ticket” als Authentifizierungsmethode in den SAP-Source-Einstellungen ausgewählt ist.

Es gibt auch Parameter, welche vom Typ der Destination abhängen. Bei einer Destination vom Typ vom Typ HTTP-CSV oder Flatfile-CSV sind es decimalSeparator und columnSeperator.

Parametername Beschreibung Spezielle Infos
decimalSeparator setzt ein Symbol zwischen dem Ganzzahlteil und dem Bruchzahlteil verfügbar bei Destinationen vom Typ HTTP-CSV oder Flatfile-CSV
columnSeparator setzt ein Symbol, das den Anfang einer Spalte bezeichnet verfügbar bei Destinationen vom Typ HTTP-CSV oder Flatfile-CSV

Run-Extraction-Connection-Parameters

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 lang:
      http://localhost:8085/?name=Plants&lang=DE
Parametername Beschreibung Spezielle Infos
rows setzt die maximale Anzahl der extrahierten Datensätze verfügbar bei Table-Extraktionen
where setzt die WHERE-Bedingung verfügbar bei Table-Extraktionen
packageSize setzt die Paketgröße verfügbar bei Table-Extraktionen

Custom #

Hinweis: Der Tab Custom ist nur dann aktiv, wenn mindestens ein Laufzeitparameter angelegt ist.

Aktivieren Sie die Checkbox und geben Sie einen neuen Wert ein, um den Parameter zu überschreiben.

Custom parameters

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 myParameter:
      http://localhost:8085/?name=Plants&myParameter=EN