Ejemplo de uso del comando Obtener estructura desde el paquete SAP BAPI

Con el paquete SAP BAPI, cree un bot que introduzca una estructura para obtener datos.

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_FLIGHT_GETLIST desde la aplicación de datos de vuelo de demostración de SAP. Cuando se ejecuta, el bot solicita la función BAPI ingresando el ID de una aerolínea y los detalles del destino, obtiene una lista de vuelos y escribe los datos de respuesta en un archivo CSV.

Usará los siguientes parámetros de importación para limitar su búsqueda:
  • AIRLINE: Use el parámetro para pasar el ID de la aerolínea.
  • DESTINATION_FROM: Use el parámetro para obtener la estructura y pasar el nombre de la ciudad y el ID del aeropuerto.
El tutorial pretende demostrar cómo realizar las siguientes acciones:
  • Obtener la estructura de un parámetro de importación.
  • Establecer los valores de los campos de la estructura recuperada.
  • Obtener los datos de respuesta en una tabla basada en los datos de entrada.

Procedimiento

  1. Cree un TaskBot llamado SAP-BAPI-FlightListReport.
    1. Inicie sesión en 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-FlightListReport 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 getFlightListByAirline.
    2. En Nombre de BAPI, introduzca BAPI_FLIGHT_GETLIST.
  4. Para filtrar los datos por el nombre de una aerolínea, agregue la acción SAP BAPI > Establecer valor de campo.
    1. En Nombre del alias de la función, introduzca getFlightListByAirline.
    2. Haga clic en el tabulador Función.
    3. En Nombre del campo, introduzca AIRLINE como nombre del parámetro de entrada.
    4. En Valor del campo, introduzca AZ.
  5. Para limitar la selección por el aeropuerto y la ciudad de destino, obtenga primero la estructura del parámetro de entrada DESTINATION_FROM y, luego, establezca los valores de los campos en la estructura recuperada. Para ello, agregue la acción SAP BAPI > Obtener estructura.
    1. En Nombre del alias de la función, introduzca getFlightListByAirline.
    2. En Nombre de la estructura, introduzca DESTINATION_FROM.
    3. Para asignar la estructura recuperada a un alias, haga clic en la pestaña Alias en Destino e introduzca destinationFrom en Crear alias de estructura.
      Ahora puede utilizar el alias para establecer los valores de los campos de la estructura recuperada.
  6. A fin de establecer un valor para el campo ID del aeropuerto en el parámetro DESTINATION_FROM, agregue la acción SAP BAPI > Establecer valor de campo.
    1. En Nombre del alias de la función, introduzca getFlightListByAirline.
    2. En Fuente, haga clic en el tabulador Estructura.
    3. En Alias de estructura, introduzca destinationFrom.
    4. En Nombre del campo, introduzca AIRPORTID.
    5. En Valor del campo, introduzca FCO.
  7. A fin de establecer un valor para el campo CITY en el parámetro DESTINATION_FROM, agregue la acción SAP BAPI > Establecer valor de campo.
    1. En Nombre del alias de la función, introduzca getFlightListByAirline.
    2. En Fuente, haga clic en el tabulador Estructura.
    3. En Alias de estructura, introduzca destinationFrom.
    4. En Nombre del campo, introduzca CITY.
    5. En Valor del campo, introduzca ROME.
  8. Para ejecutar BAPI_FLIGHT_GETLIST, agregue la acción SAP BAPI > Ejecutar función.
    1. En Nombre del alias de la función, introduzca getFlightListByAirline.
  9. Para obtener los datos filtrados de la tabla FLIGHT_LIST, agregue la acción SAP BAPI > Obtener tabla.
    1. En Nombre del alias de la función, introduzca getFlightListByAirline.
    2. En Nombre de tabla, haga clic en la pestaña FLIGHT_LIST.
    3. En Destino, haga clic en Variable para almacenar los datos de la tabla recuperada en la memoria.
    4. En Guardar el resultado en una variable, cree una variable llamada tblFlightList haciendo clic en (x).
  10. Para escribir los datos de la tabla recuperada en un archivo CSV, agregue la acción Tabla de datos > Escribir en archivo.
    1. En Tabla de datos, seleccione tblFlightList.
    2. En Introducir nombre del archivo, especifique la ruta del archivo CSV en el que desea escribir los datos.
    3. Seleccione Crear carpetas/archivos si no existen.
    4. Haga clic en Sobrescribir archivo existente.
  11. Guarde y, luego, ejecute el bot.