Actividad BAPI de invocación de SAP

Utilice la actividad BAPI de invocación de SAP para llamar a un método de objeto de negocio (BAPI), que está habilitado de forma remota en un punto final de SAP especificado durante el tiempo de ejecución.

Nota: Para conectarse con el sistema SAP desde Studio, debe descargar e instalar los archivos JAR y DLL de SAP en la máquina de desarrollo de Windows. Para más información, consulte Descarga e instalación de los archivos JAR y DDL de SAP.

Adición de la actividad BAPI de invocación de SAP a la orquestación

  1. Cree o abra una orquestación. Se visualiza una representación gráfica de la orquestación.
  2. Seleccione el separador Actividades y expanda la carpeta SAP.
  3. Arrastre la actividad BAPI de invocación de SAP a la orquestación.
  4. Seleccione la actividad. Se mostrará Lista de comprobación.

Creación, selección o edición de un punto final SAP

  1. Pulse la tarea Elegir punto final en la Lista de comprobación y seleccione una de las siguientes acciones:
    • Seleccione un punto final existente:
      1. Seleccione Examinar. Se mostrará Explorador de proyectos.
      2. Seleccione un punto final existente y pulse Aceptar. Diríjase al procedimiento Configuración de la actividad.
    • Seleccione un punto final existente y edítelo:
      1. Seleccione Examinar. Se mostrará Explorador de proyectos.
      2. Seleccione un punto final existente y pulse Aceptar.
      3. Pulse Editar. Se visualiza el panel Editar punto final.
    • Cree un punto final nuevo: seleccione Nuevo. Se mostrará el panel Crear punto final.
  2. Crear o editar un punto final de SAP.

Configuración de la actividad

  1. Seleccione la tarea Configurar en la lista de comprobación. Se mostrará el panel Configurar.
  2. En el campo Nombre de objeto, pulse Examinar.... Se visualizará el recuadro de diálogo Lista BAPI.
  3. Busque un objeto de empresa. Pulse un objeto de empresa de la lista e introduzca los caracteres iniciales del nombre del objeto de empresa.
  4. Expanda el objeto de negocio para visualizar los métodos BAPI asociados.
  5. Seleccione un objeto de negocio y un método y pulse Aceptar.
  6. Seleccione una de las siguientes Opciones de transacción:
    • No hacer nada (transacción manejada directamente por el BAPI) - Durante el tiempo de ejecución, el Dispositivo de integración que llama al BAPI no realiza ningún proceso de transacción. Si se asocia una transacción con el BAPI, dicho BAPI debe manejar completamente la transacción
    • Confirmar transacción tras terminación -  Durante el tiempo de ejecución, el Dispositivo de integración llama al BAPI y espera un mensaje de retorno del sistema SAP. El código de retorno del mensaje devuelto desde el sistema SAP determina si el dispositivo de integración debe enviar otro mensaje solicitando que el sistema SAP confirme o retrotraiga la transacción:
      • Si el código de retorno devuelto desde el BAPI señala que ha sido un éxito, el Dispositivo de integración envía otro mensaje solicitando que el sistema SAP confirme la transacción e inicia inmediatamente el proceso de la siguiente actividad en la orquestación.
      • Si el código de retorno devuelto desde el BAPI señala que se ha producido una anomalía, el Dispositivo de integración envía una solicitud de retrotracción al sistema SAP e inicia inmediatamente el proceso de la siguiente actividad en la orquestación.
    • Confirmar transacción y esperar la terminación -  Durante el tiempo de ejecución, el Dispositivo de integración invoca al BAPI y espera un mensaje de retorno del sistema SAP. El código de retorno del mensaje devuelto desde el sistema SAP determina si el Dispositivo de integración debe enviar otro mensaje solicitando que el sistema SAP confirme o retrotraiga la transacción:
      • Si el código de retorno devuelto desde el BAPI señala que ha sido un éxito, el Dispositivo de integración envía otro mensaje solicitando que el sistema SAP confirme la transacción. La orquestación espera a que el sistema SAP envíe un segundo mensaje que indique que la transacción se ha confirmado antes de procesar la siguiente actividad de la orquestación.
      • Si el código de retorno devuelto desde el BAPI señala que se ha producido una anomalía, el Dispositivo de integración envía una solicitud de retrotracción al sistema SAP. La orquestación espera a que el sistema SAP envíe un segundo mensaje indicando que la retrotracción de la transacción se ha producido antes de procesar la siguiente actividad de la orquestación.

Especificación de opciones de reintento

  1. Seleccione la tarea Reintentar de la lista de comprobación. Se visualiza el panel Reintentar.
  2. Configure las opciones de reintento para establecer la conexión con un sistema SAP. La siguiente tabla describe las opciones de reintento para establecer la conexión con un sistema SAP:  
    Opciones de reintento Descripción
    1) Esperar ___ segundos entre cada reintento. Especifica el número de segundos que el Dispositivo de integración espera antes de intentar establecer una conexión con el sistema SAP.
    2) Intentar establecer la conexión ___ veces antes de fallar. Especifica el número máximo de veces que el Dispositivo de integración intenta establecer una conexión con el sistema SAP antes de emitir un error o detener el proceso del trabajo de orquestación actual. Si despliega una orquestación que contiene una actividad BAPI de invocación SAP y el Dispositivo de integración no se ha podido conectar con el sistema SAP especificado, el Dispositivo de integración registra los errores de conexión como Avisos en el sistema y la orquestación sigue realizando estos registros hasta que se alcanza el valor de recuento de reintentos. Cuando se alcanza el recuento de reintentos, el Dispositivo de integración registra un error en el sistema y en los registros de orquestación y detiene el proceso del trabajo de orquestación actual. Por ejemplo, el usuario establece el recuento de reintentos en 3. El primer, el segundo y el tercer error de conexión aparecen en el registro del sistema como Avisos. El Dispositivo de integración registra el cuarto error de conexión como un error y detiene el proceso del trabajo de orquestación actual.

Correlación de las entradas de la actividad

  1. Seleccione la tarea Correlacionar entradas en la lista de comprobación. Los esquemas XML generados desde los parámetros de entrada del BAPI aparecen como nodos bajo el parámetro de entrada solicitud en el panel A actividad. Además, si el BAPI contiene las tablas del RFC, los esquemas XML que representan las tablas del BAPI se visualizan como nodos bajo el parámetro de entrada Solicitud en el panel A actividad.
  2. Cree una correlación entre variable de orquestación y las tablas y parámetros de entrada del BAPI. Consulte Creación de una correlación para obtener instrucciones generales sobre la correlación.

    Los valores deben proporcionarse durante el tiempo de ejecución para todos los elementos obligatorios de las tablas o parámetros de entrada del BAPI. Se puede indicar un valor especificando un valor predeterminado para el elemento o enlazando el elemento con el nodo de entrada. Durante el tiempo de ejecución, si no se suministra ningún valor para un elemento obligatorio, la actividad lanza una excepción durante el tiempo de ejecución que es notificada por la consola de gestión web (WMC). Si no se proporciona un valor durante el tiempo de ejecución para un elemento opcional de tablas o parámetros de entrada del BAPI, no se lanza ninguna excepción durante el tiempo de ejecución.

Correlación de salidas de la actividad

  1. Seleccione la tarea Correlacionar salidas en la lista de comprobación. El esquema XML generado a partir de los tipos de retorno de BAPI aparece como nodos bajo el parámetro de salida respuesta en el panel De actividad. Además, si el BAPI contiene tablas, los esquemas XML que representan las tablas se visualizan como nodos bajo el nodo Respuesta en De actividad.
  2. Cree una correlación entre los parámetros de salida del BAPI y variables de orquestación y tablas. Consulte Creación de una correlación para obtener instrucciones generales sobre la correlación.

Nota sobre el despliegue de una orquestación de SAP

Antes de poder desplegar una orquestación con actividades de SAP utilizando la consola de gestión web (WMC), el dispositivo de integración debe poder establecer una conexión con el sistema SAP. Si el dispositivo de integración no puede establecer la conexión con el sistema SAP, no se despliega la orquestación.