Ejemplo de escritura de datos en SAP con el paquete SAP BAPI

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

Antes de empezar

Descargue el conector SAP Java y el DLL del sitio web de SAP.

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. Cree 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, ingrese SAP-BAPI-CreateNewFlightCustomer y haga clic en Crear y editar.
  2. Para conectar el bot a su sistema SAP, desde el menú Acciones, busque la acción SAP BAPI > Conectar y agréguela al Editor de bots.
    1. En JCo: Paquete del conector Java de SAP, especifique la ruta del archivo .jar del conector Java.
    2. En Dependencia de JCo DLL, especifique la ruta del archivo DLL.
    3. Elija Servidor de aplicaciones personalizado como Tipo de conexión.
    4. En Nombre del host del servidor de la aplicaciónespecifique el nombre del servidor de aplicaciones SAP.
      Nota: Como práctica recomendada, utilice la Credential Vault para especificar información sensible como el nombre de host, el nombre de usuario y la contraseña.
    5. En Número de sistema, ingrese el número de instancia.
    6. En ID del sistema de instancia SAP, ingrese el ID del sistema.
    7. En Número de cliente, ingrese el número de cliente.
    8. En Código de idioma de inicio de sesión, ingrese ES o el idioma específico de su sistema.
    9. En Cadena de enrutamiento, ingrese la cadena de enrutamiento SAP.
    10. En Nombre de usuario, ingrese el nombre de usuario SAP.
    11. En Contraseña, ingrese su contraseña.
    12. Ejecute el bot para probar la conexión.
      Si las propiedades de conexión especificadas son correctas, el bot se ejecuta con éxito.
  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 paquete 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.