Ejemplo de uso de la llamada de función remota en SAP

En este ejemplo, se describe cómo desarrollar un bot que creará un documento en SAP utilizando el método de llamada de función remota.

Antes de empezar

Descargue el paquete conector Java de SAP y el DLL desde el sitio web de SAP.

Procedimiento

  1. Abrir un nuevo bot:
    1. En el panel izquierdo, haga clic en Automatización.
    2. Haga clic en Crear nuevo > Bot.
    3. En la ventana Crear bot de tareas, introduzca un nombre de bot.
    4. Haga clic en Crear y editar.
  2. Establezca una conexión con la aplicación SAP mediante la acción Conectar.
    1. En el campo Sesión SAP BAPI, introduzca Default.
    2. Seleccione la opción Escritorio, busque y seleccione el paquete de conector de Java y SAP que está disponible en su dispositivo.
      Ejemplo: F:\SAP \SAP JCo 3.1.3\Microsoft Windows and Windows Server\64-bit\sapjco3.jar
    3. Seleccione la opción Escritorio, busque y seleccione el DLL del conector de Java y SAP que está disponible en su dispositivo.
      Ejemplo: F:\SAP \SAP JCo 3.1.3\Microsoft Windows and Windows Server\64-bit\sapjco3.dll
    4. Seleccione la opción Grupo/Servidor como tipo de conexión.
    5. Seleccione Cadena insegura e introduzca AWINAAWO12.bcone.com para especificar el nombre del servidor de mensajes SAP.
    6. Introduzca AWINAAWO12.bcone.com en el campo Host de puerta de enlace para conectarse al servidor.
    7. Ingrese los siguientes valores:
      Campo Valor
      Grupo de inicio de sesión Público
      Número de sistema 01
      ID de sistema de instancia de SAP AAI
      Número de cliente 800
      Código de idioma de inicio de sesión EN-US
      Cadena del enrutador /H/115.112.148.66/S/3299
    8. Seleccione Cadena insegura e ingrese ISR3 para especificar el nombre de usuario que desea utilizar para conectarse al servidor SAP.
    9. Seleccione Cadena insegura e ingrese Automation@123 para especificar la contraseña que desea utilizar para conectarse al servidor SAP.
  3. Utilice la acción Crear función para crear una función para la función de SAP BAPI.
    1. Cree un alias para una función BAPI de SAP y guárdela con un nombre de alias.
    2. En el campo Nombre de sesión, introduzca Default.
    3. En el campo Nombre del alias de la función, ingrese BAPI_Post.
    4. En el campo Nombre de BAPI, introduzca BAPI_ACC_DOCUMENT_POST.
      Nota: El nombre de la función BAPI de SAP y otros parámetros son específicos del entorno del cliente al crear el bot de Automation 360.
  4. Para crear BAPI_ACC_DOCUMENT_POST en SAP, primero se deben crear la estructura y las tablas. Seleccione Obtener estructura para obtener datos de una estructura utilizando el alias de la función.
    1. En el campo Alias de la función de BAPI, ingrese BAPI_POST (el alias que ha proporcionado a la función BAPI de SAP mediante la acción Crear función).
    2. En el campo Nombre de la estructura, ingrese DOCUMENTHEADER (el nombre de la estructura de la que desea obtener datos).
    3. En el campo Sesión BAPI de SAP, ingrese Default (el nombre de sesión que utilizó para conectarse a la aplicación SAP en la acción Conectar).
    4. Seleccione la opción Alias para guardar los datos recuperados de la estructura e ingrese Doc en el campo Crear alias de estructura.
  5. Seleccione la acción Obtener tabla para obtener datos tabulares de una tabla utilizando el alias de la función.
    1. En el campo Alias de la función de BAPI, ingrese BAPI_Post (el alias que ha proporcionado a la función BAPI de SAP mediante la acción Crear función).
    2. En el campo Nombre de tabla, ingrese ACCOUNTGL (el nombre de la tabla de la que desea obtener datos).
    3. En el campo Sesión de SAP BAPI, ingrese Default, el nombre de sesión que utilizó para conectarse a la aplicación SAP en la acción Conectar.
    4. Seleccione la opción Alias para guardar los datos recuperados de la tabla e ingrese GL en el campo Crear alias de tabla.
  6. Repita el paso 5. En el Paso 5(b), introduzca el valor CURRENCYAMOUNT en el campo Nombre de tabla y, en el Paso 5(d), introduzca el valor Currency en el campo Crear alias de tabla.
  7. Seleccione la acción Establecer valor de campo para establecer los datos en la estructura y la tabla vacías creadas anteriormente.
    1. En el campo Alias de la función BAPI, introduzca BAPI_Post.
    2. En el campo Origen, seleccione Estructura.
    3. Introduzca DOC en el campo Alias de estructura.
    4. En el campo Nombre de campo, ingrese USERNAME (el nombre del campo en el que desea establecer datos).
    5. En el campo Valor de campo, ingrese sy-uname (el valor que desea establecer).
    6. En el campo Sesión SAP BAPI, introduzca Default.
  8. Repita el Paso 7 siete veces e ingrese los mismos valores que ingresó previamente en los Pasos 7(a), 7(b), 7(c) y 7(f). Introduzca los siguientes valores para los Pasos 7(d) y 7(e).
    Nombre del campo Valor de campo
    BUS_ACT RFBU
    HEADER_TXT TEST BOC BAPI POSTING
    COMP_CODE 1000
    DOC_DATE 20210127
    PSTNG_DATE 20210127
    DOC_TYPE SA
    FIS_PERIOD 00
  9. Seleccione la acción Obtener estructura.
    1. En el campo Alias de la función BAPI, introduzca BAPI_POST.
    2. En el campo Nombre de la estructura, introduzca DOCUMENTHEADER.
    3. En el campo Sesión SAP BAPI, introduzca Default.
    4. Seleccione la opción Variable para almacenar los datos recuperados de la estructura en una variable de tabla. Cree la variable de tabla Sap-Bapi-Table.
  10. Haga doble clic o arrastre la acción Tabla de datos Escribir en el archivo.
    1. Seleccione la variable de tabla Sap-Bapi-Table que contiene los datos para escribir de la lista Nombre de la tabla de datos.
    2. Especifique la ubicación del archivo en el que desea escribir datos en el campo Introduzca el nombre del archivo. Por ejemplo, D:/definido por el usuario/Escritorio/Prueba SAP/DOCUMENTHEADER.csv.
    3. Seleccione la casilla de verificación Crear carpetas/archivos si no existen.
    4. Seleccione la opción Anular archivo existente al escribir datos en un archivo existente.
    5. Seleccione la opción nueva línea en el campo Delimitador de fila.
    6. Seleccione la opción coma en el campo Delimitador de columna.
    7. Seleccione la opción ANSI en la Lista de codificación.
  11. Haga doble clic en la acción Establecer valor de campo o arrástrela para establecer los datos en la tabla.
    1. En el campo Alias de la función BAPI, introduzca BAPI_POST.
    2. En el campo Fuente, seleccione Tabla.
    3. Ingrese GL en el campo Alias de tabla.
    4. En el campo Nombre de campo, ingrese ITEMNO_ACC (el nombre del campo en el que desea establecer datos).
    5. En el campo Valor de campo, ingrese 2 (el valor que desea establecer).
    6. En el campo Sesión BAPI de SAP, ingrese Predeterminado (el nombre de sesión que utilizó para conectarse a la aplicación SAP en la acción Conectar).
  12. Repita el paso 11 siete veces para establecer los datos en una tabla.

    Mientras establece los valores en la tabla, conserve el mismo valor que ingresó previamente en los Pasos 11(a), 11(b), 11(c) y 11(f). Cambie los siguientes valores para los Pasos 11(d) y 11(e):

    Valor de campo Nombre del campo
    GL_ACCOUNT 0000078310
    PSTNG_DATE 20210127
    ITEM_TEXT PRUEBA DE PUBLICACIÓN DE ELEMENTO DE DÉBITO
    CANTIDAD 1000
    BASE_UOM EA
    COMP_CODE 1000
    DOC_TYPE SA
  13. Seleccione la acción del campo Establecer valor.
    1. En el campo Alias de la función BAPI, introduzca BAPI_POST.
    2. En el campo Fuente, seleccione Tabla.
    3. Ingrese GL en el campo Alias de tabla.
    4. Seleccione la casilla de verificación Crear nueva fila para introducir datos en la siguiente fila.
    5. En el campo Nombre de campo, ingrese ITEMNO_ACC, el nombre del campo en el que desea establecer datos.
    6. En el campo Valor de campo, ingrese 1 (el valor que desea establecer).
    7. En el campo Sesión de BAPI SAP, ingrese Predeterminado (el nombre de sesión que utilizó para conectarse a la aplicación SAP en la acción Conectar).
  14. Seleccione la acción Obtener tabla.
    1. En el campo Alias de la función BAPI, introduzca BAPI_POST.
    2. En el campo Nombre de tabla, introduzca ACCOUNTGL.
    3. En el campo Sesión SAP BAPI, introduzca Default.
    4. Seleccione la opción Variable para almacenar los datos recuperados de la tabla en una variable de tabla. Cree la variable de tabla Sap-Bapi-Table.
  15. Haga doble clic en la opción Tabla de datos > Escribir en el archivo o arrástrela.
    1. Seleccione la variable de tabla Sap-Bapi-Table que contiene los datos para escribir de la lista Nombre de la tabla de datos.
    2. Especifique la ubicación del archivo en el que desea escribir datos en el campo Introduzca el nombre del archivo. Por ejemplo, D:/definido por el usuario/Escritorio/Prueba SAP/ACCOUNTGL.csv.
    3. Seleccione la casilla de verificación Crear carpetas/archivos si no existen.
    4. Seleccione la opción Anular archivo existente al escribir datos en un archivo existente.
    5. Seleccione la opción nueva línea en el campo Delimitador de fila.
    6. Seleccione la opción coma en el campo Delimitador de columna.
    7. Seleccione la opción ANSI en la Lista de codificación.
  16. Haga doble clic en la acción Establecer valor de campo o arrástrela para establecer los datos en una tabla.
    1. En el campo Alias de la función BAPI, introduzca BAPI_POST.
    2. En el campo Fuente, seleccione Tabla.
    3. Ingrese CURRENCY en el campo Alias de tabla.
    4. En el campo Nombre de campo, ingrese ITEMNO_ACC, el nombre del campo en el que desea establecer datos.
    5. En el campo Valor de campo, ingrese 2, el valor que desea establecer.
    6. En el campo Sesión de SAP BAPI, ingrese Default, el nombre de sesión que utilizó para conectarse a la aplicación SAP en la acción Conectar.
  17. Repita el Paso 16 siete veces para establecer los datos en una tabla.

    Mientras configura los valores en la tabla, conserve el mismo valor que ingresó previamente en los Pasos 16(a), 16(b), 16(c) y 16(f). Cambie los siguientes valores para los Pasos 16(d) y 16(e):

    Nombre del campo Valor de campo
    MONEDA USD
    AMT_DOCCUR -2000
    ITEMNO_ACC 1
    MONEDA USD (repetido) línea 43
    AMT_DOCCUR 2000
  18. Repita el paso 14 e introduzca CURRENCYAMOUNT en el campo Nombre de tabla.
  19. Repita el paso 15 y especifique la ubicación del archivo, por ejemplo D:/user defined /My Desktop/SAP Test/CURRENCYAMOUNT.csv.
  20. Seleccione la acción Ejecutar función para ejecutar la función de BAPI de SAP.
    1. En el campo Alias de la función BAPI, introduzca BAPI_POST.
    2. Seleccione la opción Terminar secuencia para marcar el final de un proceso y la opción Confirmar transacción para confirmar los cambios realizados durante el proceso.
    3. En el campo Sesión SAP BAPI, introduzca Default.
  21. Seleccione la acción Obtener table.
    1. En el campo Alias de la función BAPI, introduzca BAPI_POST.
    2. En el campo Nombre de tabla, introduzca RETURN.
    3. En el campo Sesión SAP BAPI, introduzca Default.
    4. Seleccione la opción Variable para almacenar los datos recuperados de la tabla en una variable de tabla. Cree la variable de tabla Sap-Bapi-Table.
  22. Repita el Paso 15 y especifique la ubicación del archivo, por ejemplo D:/user defined /My Desktop/SAP Test/Return.csv.
  23. Seleccione la acción Obtener valor del campo para obtener los datos de un campo especificado desde una función.
    1. En el campo Alias de la función BAPI, introduzca BAPI_POST.
    2. Seleccione la pestaña Función en el campo Fuente.
    3. En el campo Nombre del campo, introduzca OBJ_KEY.
    4. En el campo Sesión SAP BAPI, introduzca Predeterminado.
    5. Seleccione Prompt-Assignment en el campo Guardar la salida en una variable.
  24. Haga doble clic en la acción Cuadro de mensaje o arrástrela.
    1. Ingrese Automation Anywhere Enterprise Client en el campo Introduzca el título de la ventana del cuadro de mensaje.
    2. Introduzca $Prompt-Assignment$.
    3. Introduzca 30 en el campo Barra de desplazamiento después de las líneas para mostrar una barra de desplazamiento.
  25. Repita los pasos 23 y 24 (en el Paso 23c, introduzca el valor OBJ_SYS).
  26. Repita los pasos 23 y 24 (en el Paso 23c, introduzca el valor OBJ_TYPE).
  27. Haga clic en Guardar y Ejecutar.