Con el package SAP BAPI, cree un bot que escriba datos en la base de datos de SAP.

Antes de empezar

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

En este tutorial, creará un bot que invoca BAPI_FLCUST_CREATEFROMDATA desde la aplicación de datos de vuelo de demostración de SAP. Utilizará el archivo CUSTOMER_DATA para pasar los datos del cliente a la BAPI. Cuando se ejecuta, el bot crea un nuevo registro de cliente en la base de datos de SAP y muestra el número de cliente devuelto por la BAPI.

El tutorial muestra cómo realizar las siguientes acciones:
  • Utilizar el comando Obtener estructura para establecer los valores de los parámetros de importación.
  • Crear un nuevo registro en una tabla SAP.
  • Recibir una respuesta de una BAPI.

Procedimiento

  1. Crear un bot llamado SAP-BAPI-CreateNewFlightCustomer.
    1. Inicie sesión en el Control Room.
    2. En el panel izquierdo, haga clic en Automatización.
    3. Haga clic en el ícono Crear un bot.
    4. En el campo Nombre, introduzca SAP-BAPI-CreateNewFlightCustomer y haga clic en Crear y editar.
  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.
      Nota: 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. Para crear una función, agregue la acción SAP BAPI > Crear función.
    1. En Nombre del alias de la función, introduzca createNewFlightCustomer.
    2. En Nombre de BAPI, introduzca BAPI_FLCUST_CREATEFROMDATA.
  4. Debido a que el parámetro CUSTOMER_DATA es de tipo estructura, obtenga la estructura del parámetro de importación y asígnelo a un alias. Para ello, agregue la acción SAP BAPI > Obtener estructura.
    1. En Nombre del alias de la función, introduzca createNewFlightCustomer.
    2. En Nombre de la estructura, introduzca CUSTOMER_DATA.
    3. Para almacenar la estructura recuperada como un alias, haga clic en el tabulador Alias en Destino.
    4. En Crear alias de estructura, introduzca CustomerData.
      Utilizará el alias para establecer valores para el campo de importación dentro de la estructura recuperada.
  5. Para establecer el valor del campo CUSTNAME, agregue la acción SAP BAPI > Establecer valor de campo.
    1. En Nombre del alias de la función, introduzca createNewFlightCustomer.
    2. En Fuente, haga clic en el tabulador Estructura.
    3. En Alias de estructura, introduzca CustomerData.
    4. En Nombre del campo, introduzca CUSTNAME.
    5. En Valor del campo, introduzca John Doe.
  6. Repita el paso 5 para agregar y configurar la acción Establecer valor de campo para cada uno de los siguientes campos:
    Nombre del campo Valor de campo
    STREET testStreet
    POSTCODE 101001
    CITY testCity
    COUNTR US
    COUNTR 00000000
    EMAIL test@example.com
    CUSTTYPE P
  7. Para ejecutar BAPI_FLCUST_CREATEFROMDATA, agregue la acción SAP BAPI > Ejecutar función.
    1. En Nombre del alias de la función, introduzca createNewFlightCustomer.
    Nota: Si desea que BAPI_FLCUST_CREATEFROMDATA escriba los datos en la base de datos de SAP, debe seleccionar las opciones Terminar secuencia y Confirmar transacción. Si selecciona la opción Terminar secuencia, asegúrese de seleccionar la opción Comenzar secuencia en la acción Crear función.

    El bot de ejemplo creado con la ayuda de este tutorial pretende demostrar cómo funcionan las BAPI Create() cuando se utiliza el package SAP BAPI. No está diseñado para modificar la base de datos.

    La BAPI asigna y devuelve un número de cliente tras la creación de un registro de nuevo cliente.
  8. Para obtener el número en una variable, agregue la acción SAP BAPI > Obtener valor de campo.
    1. En Nombre del alias de la función, introduzca createNewFlightCustomer.
    2. En Fuente, haga clic en el tabulador Función.
    3. En Nombre del campo, introduzca CUSTOMERNUMBER
    4. En Guardar el resultado en una variable, cree una variable llamada strCustomerNumber haciendo clic en (x) y seleccione la variable.
  9. Para mostrar el número de cliente, agregue la acción Cuadro de mensaje.
    1. En Escribir el mensaje para mostrar, seleccione la variable strCustomerNumber.
  10. Guarde y ejecute el bot.