Jeder Import, Export und Changings-Parameter kann einen der folgenden Darstellungen haben:
- ein Skalarfeld (z.B., Zeichen, Datum, Uhrzeit, Zahl, Menge, etc.)
- eine Struktur, die mehrere Komponenten beinhaltet
- eine Tabelle
Import-Parameter #
Imports repräsentiert die Eingabewerte, die vom Client an SAP gesendet werden. Im Tab Imports können Sie Eingabeparameter definieren, die entweder als Skalarwerte (1) oder Strukturen (2) übergeben werden.
Um die Filterfunktion zu verwenden, geben Sie in der Kopfzeile der Spalten Name und Description Suchbegriffe ein.
Skalarparameter hinzufügen (1)
Übergeben Sie Skalarparameter über eine der folgenden Optionen:
- als statischer Wert -
Symbol oder kein Symbol. - als SSIS-Variable / Parameter -
Symbol. Diese Option ist nur verfügbar, wenn SSIS-Variablen angelegt sind.
Klicken Sie auf das Symbol neben dem Eingabefeld, um zwischen statischen Werten und SSIS-Variablen zu wechseln. Wenn Sie SSIS-Variablen verwenden, stellen Sie sicher, dass die Eingabe den passenden Datentyp hat. Beispiel:
Note: Parameter, die von SAP vorausgefüllt sind, werden in einer grauen Schrift angezeigt.
Um diese Parameter zu deaktivieren, haken Sie die Checkbox neben dem Parameter an und lassen Sie das Feld frei.
Strukturen als Parameter hinzufügen (2)
Wenn eine Struktur verfügbar ist, können Sie ihr einzelne Elemente hinzufügen wie bei Skalarfeldern. Der gesamten Struktur nur einen Wert zuzuweisen ist nicht möglich.
- Klicken Sie auf
. Das Fenster “Edit Structures” öffnet sich. - Geben Sie unter Values statische Werte ein ( Symbol oder kein Symbol) oder weisen Sie den Feldern SSIS-Variablen / Parameter zu ( Symbol).
Export-Parameter #
Exports repräsentiert die Ausgabewerte, die von SAP zurück an den Client gesendet werden, nachdem die Funktion ausgeführt wurden.
Im Tab Exports können Sie Ausgabeparameter definieren, die entweder als Skalarwerte oder Strukturen übergeben werden.
Der Ausgabe Elemente hinzufügen
Aktivieren Sie die Checkbox in der Ausgabespalte, um ein Element der Ausgabe hinzuzufügen.
Um die Filterfunktion zu verwenden, geben Sie in der Kopfzeile der Spalten Name und Description Suchbegriffe ein.
Changings-Parameter #
Changings repräsentiert Parameter, die sowohl für Eingabe als auch Ausgabe verwendet werden können.
Im Tab Changings können Sie Import und Export-Parameter definieren.
Tables-Parameter #
Tables enthält Parameter mit einer Tabellenstruktur, die aus mehreren Zeilen besteht. Tabellen können als Eingabe und Ausgabe verwendet werden.
Im Tab Tables können Sie Tabellen-Parameter für Import und Export zu und von einer SAP BAPI definieren. Tabellen repräsentieren hier eine Struktur mehrerer Zeilen desselben Datentyps.
Um die Filterfunktion zu verwenden, geben Sie in der Kopfzeile der Spalten Name und Description Suchbegriffe ein.
Hinweis: Nur 5 Tabellen stehen für einen parallelen Export zur Verfügung.
- Klicken Sie auf
, um die Namen und Datentypen der Tabellenfelder zu prüfen (1). - Aktivieren Sie die Checkbox (2) neben den aufgelisteten Tabellen, um sie der Ausgabe hinzuzufügen.
- Klicken Sie auf , um die Tabelle zu bearbeiten (3).
Auf Metadaten der Tabelle zugreifen (1) #
Klicken Sie auf , um die Metadaten der ausgewählten Tabelle anzuzeigen, inklusive der Namen und Datentypen aller Felder.
Wenn der Funktionsbaustein in SAP bearbeitet wurde, aktualisieren Sie die Daten über Refresh metadata.
Der Ausgabe Tabellen hinzufügen (2) #
Aktivieren Sie die Checkbox in der Ausgabespalte, um Tabellen der Ausgabe hinzuzufügen.
Tabellen bearbeiten (3) #
- Klicken Sie auf das Symbol, um eine Tabelle zu bearbeiten. Das Fenster “Edit Table Contents” öffnet sich.
- Klicken Sie auf [Add], um neue Parameter hinzuzufügen.
- Geben Sie Werte oder SSIS-Variablen an.
Wenn Sie SSIS-Variablen verwenden, stellen Sie sicher, dass die Eingabe den passenden Datentyp hat.
- Klicken Sie auf [Remove], um die Eingabezeile zu entfernen.
Tabellen Mappen #
Wenn Sie Tabellen an die Xtract BAPI Komponente übergeben, wird automatisch ein Datenmapping durchgeführt.
Damit die Tabellenfelder korrekt zugewiesen werden, müssen folgende Voraussetzungen erfüllt sein:
- Die Spaltennamen der Eingangstabelle müssen mit denen in der Xtract BAPI Komponente überein stimmen.
- Die Datentypen in der Eingangstabelle müssen mit denen in der Xtract BAPI Komponente übereinstimmen
Klicken Sie auf das Symbol neben einer Tabelle, um die Spaltennamen und Datentypen in der Tabelle einzusehen.
Tipp: Wenn die Spaltennamen und / oder die Datentypen der Eingangstabelle nicht mit der Xtract BAPI Tabelle übereinstimmt, fügen Sie eine Derived Column Komponente hinzu, um die Eingangsdaten zu konvertieren.
Exceptions - Ausnahmen #
Exceptions bezieht sich auf die ABAP Exceptions / Fehlermeldungen eines BAPIs. Wenn zur Laufzeit eine Ausnahme auftritt, gibt Xtract IS eine entsprechende Fehlermeldung zurück.
Standardmäßig resultieren alle Ausnahmen in Fehlern, wenn die Xtract BAPI Komponente ausgeführt wird. Um Ausnahmen zur Laufzeit zu ignorieren, deaktivieren Sie die Ausnahmen im Tab Extractions.
Custom Properties (Benutzerdefinierte Eigenschaften) #
Die Benutzerdefinierten Eigenschaften (Custom Properties) definieren die für die Komponente eindeutigen Eigenschaften. Bei der Parametrierung der Komponente mittels SSIS-Variablen werden die Benutzerdefinierten Eigenschaften (Custom Properties) überschrieben.
Die Benutzerdefinierten Eigenschaften (Custom Properties) der Xtract BAPI-Komponente werden im Fenster „Eigenschaften“ der Komponente angezeigt.
Transaction Commit
Setzen Sie diese Option auf true, um den Funktionsbaustein BAPI_TRANSACTION_COMMIT nach der Verarbeitung des ausgewählten Funktionsbausteins/BAPI aufzurufen.
Einige SAP-Funktionsmodule erfordern diese Commit-Funktion, um Daten in der Datenbank erfolgreich zu aktualisieren, z. B. BAI_PO_CREATE.