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

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

Vorbereitungen

Download the SAP Java connector and dynamic library files (.dll file for Windows automation and .dylib file for macOS automation) from the SAP portal.

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 namens 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. To connect the bot to your SAP system, from the Actions panel, find SAP BAPI > Connect action and add it to the Bot editor.
    1. In JCo: SAP Java Connector package, specify the path to the Java connector .jar file.
    2. In JCo DLL/DYLIB dependency, specify the path to the dynamic library file.
      .dll for Windows automation and .dylib for macOS automation.
    3. Choose Custom Application Server as Connection Type.
    4. In Application server host name, specify the host name of the SAP application server.
      Anmerkung: As a best practice, use the Credential Vault to specify sensitive information such as host name, user name, and password.
    5. In System number, enter the instance number.
    6. In SAP instance system ID, enter the system ID.
    7. In Client number, enter the client number.
    8. In Logon language code, enter EN or the language specific to your system.
    9. In Router string, enter the SAP router string.
    10. In Username, enter your SAP username.
    11. In Password, enter your password.
    12. Run the bot to test the connection.
      If you specify the correct connection properties, the bot executes successfully.
  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_CREATEFROMDATA auszuführen, fügen Sie die Aktion SAP BAPI > Funktion ausführen 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-package 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 den bot aus.