Beispiel für das Schreiben von Daten in SAP mit dem SAP BAPI-Paket

Erstellen Sie mithilfe des SAP BAPI-Pakets einen Bot, der Daten in die SAP-Datenbank schreibt.

Vorbereitungen

Laden Sie den SAP Java Connector und die DLL von der SAP-Website herunter.

In dieser Anleitung erstellen Sie einen Bot, der in der SAP-Demoanwendung „Flugdaten“ BAPI_FLCUST_CREATEFROMDATA aufruft. Sie verwenden den Importparameter CUSTOMER_DATA, um die Kundendaten an BAPI zu übergeben. Bei der Ausführung legt der Bot einen neuen Kundendatensatz in der SAP-Datenbank an und zeigt die von BAPI zurückgegebene Kundennummer an.

Das Tutorial zeigt, wie Sie die folgenden Aktionen durchführen können:
  • Verwenden des Befehls „Struktur erhalten“, um Werte für die Importparameter festzulegen.
  • Erstellen eines neuen Datensatzes in einer SAP-Tabelle.
  • Empfangen einer Antwort von einem BAPI.

Prozedur

  1. Erstellen Sie einen Bot mit dem Namen SAP-BAPI-CreateNewFlightCustomer.
    1. Melden Sie sich beim Control Room an.
    2. Klicken Sie im linken Fensterbereich auf Automatisierung.
    3. Klicken Sie auf das Symbol Bot erstellen.
    4. Geben Sie SAP-BAPI-CreateNewFlightCustomer in das Feld Name ein, und klicken Sie auf Erstellen und bearbeiten.
  2. Wenn Sie den Bot mit Ihrem SAP-System verbinden möchten, suchen Sie im Bereich Aktionen nach der Aktion SAP BAPI > Verbinden und fügen diese dem Bot Editor hinzu.
    1. Geben Sie unter JCo: SAP Java Connector Paket den Pfad zur .jar-Datei des Java Connectors an.
    2. Geben Sie unter Abhängigkeit von JCo DLL den Pfad zu der DLL-Datei an.
    3. Wählen Sie Nutzerdefinierter Anwendungsserver als Verbindungstyp aus.
    4. Geben Sie unter Anwendungs-Serverhostname den Hostnamen des SAP-Anwendungsservers an.
      Anmerkung: Verwenden Sie am besten den Credential Vault, um vertrauliche Informationen wie den Hostnamen, den Nutzernamen und das Passwort anzugeben.
    5. Geben Sie unter Systemnummer die Instanznummer ein.
    6. Geben Sie unter SAP Instanz-System-ID die System-ID ein.
    7. Geben Sie unter Client-Nummer die Client-Nummer ein.
    8. Geben Sie unter Anmelde-Sprachcode EN oder die für Ihr System spezifische Sprache ein.
    9. Geben Sie unter Router-Zeichenfolge die Router-Zeichenfolge für SAP ein.
    10. Geben Sie unter Nutzername Ihren SAP-Nutzernamen ein.
    11. Geben Sie unter Passwort Ihr Passwort ein.
    12. Führen Sie den Bot aus, um die Verbindung zu testen.
      Wenn die angegebenen Verbindungseigenschaften korrekt sind, wird der Bot erfolgreich ausgeführt.
  3. Um eine Funktion zu erstellen, fügen Sie die Aktion SAP BAPI > Funktion erstellen hinzu.
    1. Geben Sie createNewFlightCustomer in Funktionsaliasname ein.
    2. Geben Sie BAPI_FLCUST_CREATEFROMDATA in BAPI-Name ein.
  4. Da der Parameter CUSTOMER_DATA vom Typ Struktur ist, holen Sie sich die Struktur des Importparameters und weisen ihn einem Alias zu. Dazu fügen Sie die Aktion SAP BAPI > Struktur erhalten hinzu.
    1. Geben Sie createNewFlightCustomer in Funktionsaliasname ein.
    2. Geben Sie CUSTOMER_DATA in Name der Struktur ein.
    3. Um die abgerufene Struktur als Alias zu speichern, klicken Sie auf die Registerkarte Alias in Ziel.
    4. Geben Sie CustomerData in Struktur-Alias erstellen ein.
      Sie werden den Alias verwenden, um Werte für das Importfeld in der abgerufenen Struktur festzulegen.
  5. Um den Wert für das Feld CUSTNAME festzulegen, fügen Sie die Aktion SAP BAPI > Feldwert festlegen hinzu.
    1. Geben Sie createNewFlightCustomer in Funktionsaliasname ein.
    2. Klicken Sie unter Quelle auf die Registerkarte Struktur.
    3. Geben Sie CustomerData in Struktur-Alias ein.
    4. In Feldname geben Sie CUSTNAME ein.
    5. In Feldwert geben Sie John Doe ein.
  6. Wiederholen Sie Schritt 5, um die Aktion Feldwert festlegen für jedes der folgenden Felder hinzuzufügen und zu konfigurieren:
    Feldname Feldwert
    STREET testStreet
    POSTCODE 101001
    CITY testCity
    COUNTR US
    COUNTR 00000000
    EMAIL test@example.com
    CUSTTYPE P
  7. Um BAPI_FLCUST_CREATEFROMDATAauszuführen, fügen Sie die SAP BAPI > Funktion ausführen Aktion hinzu.
    1. Geben Sie createNewFlightCustomer in Funktionsaliasname ein.
    Anmerkung: Wenn Sie möchten, dass BAPI_FLCUST_CREATEFROMDATA die Daten in die SAP-Datenbank schreibt, müssen Sie die Optionen Sequenz beenden und Commit für die Transaktion ausführen auswählen. Wenn Sie die Option Sequenz beenden wählen, stellen Sie sicher, dass Sie die Option Sequenz beginnen in der Aktion Funktion erstellen wählen.

    Der mit Hilfe dieses Tutorials erstellte Beispiel-Bot soll demonstrieren, wie die Create()-BAPIs funktionieren, wenn das SAP BAPI-Paket verwendet wird. Es ist nicht beabsichtigt, die Datenbank zu verändern.

    Das BAPI vergibt und gibt nach dem Anlegen eines neuen Kundendatensatzes eine Kundennummer zurück.
  8. Um die Zahl in eine Variable zu übertragen, fügen Sie die Aktion SAP BAPI > Feldwert abrufen hinzu.
    1. Geben Sie createNewFlightCustomer in Funktionsaliasname ein.
    2. Klicken Sie unter Quelle auf die Registerkarte Funktion.
    3. In Feldname geben Sie CUSTOMERNUMBER ein.
    4. Erstellen Sie in Ergebnis als Variable speichern eine Variable namens strCustomerNumber, indem Sie auf (x) klicken und die Variable auswählen.
  9. Um die Kundennummer anzuzeigen, fügen Sie die Aktion Nachrichtenfeld hinzu.
    1. Wählen Sie unter Anzuzeigende Nachricht angeben die Variable strCustomerNumber.
  10. Speichern Sie die Datei und führen Sie sie den Bot aus.