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 DLL y JAR 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 la BAPI contiene tablas, los esquemas XML que representan las tablas de la BAPI se visualizan como nodos bajo el parámetro de entrada request (solicitud) en el panel A actividad.

    El conector SAP también soporta conexiones dinámicas de punto final a un sistema SAP distinto. En tiempo de ejecución, añada parámetros opcionales en sapConnectionProperties de la correlación de entradas si desea conectar dinámicamente a un sistema SAP distinto del configurado en el panel de punto final, si desea conectar con el mismo sistema SAP con un nombre de usuario y una contraseña distintos de los indicados en los campos utilizados en el panel de punto final, o si desea un token SSO distinto del añadido en el panel de punto final. Los parámetros de sapConnectionProperties se describen en la tabla siguiente:
    Tabla 1. Propiedades de conexión
    Parámetro opcional Descripción
    Parámetros de sapConnectionProperties
    hostName Especifica la dirección IP o el nombre de la máquina que contiene el sistema SAP.
    systemNumber Especifica el número que identifica la instancia específica del sistema SAP con el que Studio debería conectarse. El administrador de SAP debe proporcionar esta información.
    client Especifica un número que identifica a Studio y al Dispositivo de integración como un cliente para el sistema SAP. El administrador de SAP debe proporcionar esta información.
    lenguaje Especifica la opción de idioma de mensaje para SAP. por ejemplo, EN es el código ISO del inglés.
    Parámetros de basicAuthentication
    username Especifica el nombre de usuario que debe utilizarse al conectarse con el sistema SAP.
    password Especifica la contraseña correspondiente al nombre de usuario al establecer la conexión con el sistema SAP.
    Parámetros de ssoAuthentication
    ssotoken Especifica el token de inicio de sesión único (SSO).
    Parámetros de sncAuthentication
    sncmode Especifica si está habilitado el modo de conexiones de red seguras (SNC).
    sncname Especifica el nombre distinguido de la conexión SNC.
    partner Especifica el nombre distinguido del partner SNC.
    qop Especifica el nivel de seguridad de SNC.
    Certificado X509 Especifica el certificado X509 que se utilizará como tíquet de inicio de sesión. Este campo solo es opcional si se utiliza una Autenticación basada en nombre de usuario/contraseña con SNC.
    Parámetros de connectionPool
    maximumConnections Especifica las conexiones de SAP adicionales, hasta el número indicado, que el Dispositivo de integración abrirá en función de la carga de mensajes.
    maxIdleTime Especifica el número de minutos que una conexión de SAP puede estar abierta y desocupada antes de ser cerrada por el Dispositivo de integración.
  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.




Comentarios | Notices


Icono de fecha y hora Última actualización: Friday, November 8, 2013


http://pic.dhe.ibm.com/infocenter/wci/v7r0m0/topic/com.ibm.wci.doc/SAP_Invoke_BAPI_Activity.html