Le package BAPI SAP vous permet de créer un bot qui écrit des données dans la base de données SAP.

Prérequis

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

Dans ce tutoriel, vous allez créer un bot qui invoque BAPI_FLCUST_CREATEFROMDATA à partir de l'application de démonstration SAP Flight Data. Vous utiliserez le paramètre d'importation CUSTOMER_DATA pour transmettre les données du client à la BAPI. Lorsqu'elle est exécutée, le bot crée un nouvel enregistrement client dans la base de données SAP et affiche le numéro de client renvoyé par la BAPI.

Dans ce tutoriel, nous vous expliquons comment effectuer les actions suivantes :
  • Utiliser la commande Obtenir la structure pour définir les valeurs des paramètres d\'importation.
  • Créer un nouvel enregistrement dans un tableau SAP.
  • Recevoir une réponse d\'une BAPI.

Procédure

  1. Créez un bot nommé SAP-BAPI-CreateNewFlightCustomer.
    1. Connectez-vous à la Control Room.
    2. Dans le volet de gauche, cliquez sur Automatisation.
    3. Cliquez sur l\'icône Créer un robot.
    4. Dans le champ Nom, saisissez SAP-BAPI-CreateNewFlightCustomer, puis cliquez sur Créer et modifier.
  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.
      Remarque : 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. Pour créer une fonction, ajoutez l\'action BAPI SAP > Créer une fonction.
    1. Dans Nom d\'alias de la fonction, saisissez createNewFlightCustomer.
    2. Dans Nom de la BAPI, saisissez BAPI_FLCUST_CREATEFROMDATA.
  4. Dans la mesure où le paramètre CUSTOMER_DATA est de type structure, vous devez obtenir la structure du paramètre d\'importation et l\'affecter à un alias. Pour ce faire, ajoutez l\'action BAPI SAP > Obtenir la structure.
    1. Dans Nom d\'alias de la fonction, saisissez createNewFlightCustomer.
    2. Dans Nom de la structure, saisissez CUSTOMER_DATA.
    3. Pour enregistrer la structure récupérée en tant qu\'alias, cliquez sur l\'onglet Alias dans la zone Destination.
    4. Dans Créer un alias de la structure, saisissez CustomerData.
      Cet alias vous permettra de définir les valeurs du champ d\'importation dans la structure récupérée.
  5. Pour définir la valeur du champ CUSTNAME, ajoutez l\'action BAPI SAP > Définir la valeur du champ.
    1. Dans Nom d\'alias de la fonction, saisissez createNewFlightCustomer.
    2. Dans Source, cliquez sur l\'onglet Structure.
    3. Dans Alias de la structure, saisissez CustomerData.
    4. Dans Nom du champ, saisissez CUSTNAME.
    5. Dans Valeur du champ, saisissez John Doe.
  6. Répétez l\'étape 5 pour ajouter et configurer le champ Définir la valeur du champ pour chacun des champs suivants :
    Nom du champ Valeur de champ
    STREET testStreet
    POSTCODE 101001
    CITY testCity
    COUNTR US
    COUNTR 00000000
    EMAIL test@example.com
    CUSTTYPE P
  7. Pour exécuter BAPI_FLCUST_CREATEFROMDATA, ajoutez l\'action BAPI SAP > Exécuter la fonction.
    1. Dans Nom d\'alias de la fonction, saisissez createNewFlightCustomer.
    Remarque : Si vous voulez que BAPI_FLCUST_CREATEFROMDATA écrive les données dans la base de données SAP, vous devez sélectionner les options Terminer la séquence et Valider la transaction. Si vous sélectionnez l\'option Terminer la séquence, veillez à sélectionner l\'option Commencer la séquence dans l\'action Créer une fonction.

    L\'exemple de bot créé à l\'aide de ce tutoriel permet de comprendre le fonctionnement des BAPI Create() lors de l\'utilisation du package BAPI SAP. Il n\'est pas destiné à modifier la base de données.

    La BAPI attribue et renvoie un numéro de client après la création d\'un nouvel enregistrement client.
  8. Pour obtenir ce numéro dans une variable, ajoutez l\'action BAPI SAP > Obtenir la valeur du champ.
    1. Dans Nom d\'alias de la fonction, saisissez createNewFlightCustomer.
    2. Dans Source, cliquez sur l\'onglet Fonction.
    3. Dans Nom du champ, saisissez CUSTOMERNUMBER.
    4. Dans Enregistrer la sortie dans une variable, créez une variable nommée strCustomerNumber en cliquant sur (x) et sélectionnez la variable.
  9. Pour afficher le numéro de client, ajoutez l\'action Zone de message.
    1. Dans Entrer le message à afficher, sélectionnez la variable strCustomerNumber.
  10. Enregistrez le bot et exécutez-le.