Actividad IDOC de envío a SAP

Utilice la actividad IDOC de envío a SAP para enviar un IDOC al punto final de SAP especificado durante el tiempo de ejecución.

Si envía los datos de SAP directamente al sistema SAP utilizando un puerto RFC, debe utilizar la actividad IDOC de envío a SAP. Si envía los datos de SAP como un archivo a través de un puerto de archivo SAP al sistema de SAP, debe utilizar la opción de menú de la barra de herramientas de Esquema Proyecto > Importar > IDOC de SAP durante el tiempo de diseño para generar un esquema de archivo sin formato para los metadatos del IDOC y utilizar la actividad Grabar archivo sin formato para grabar los datos de SAP. Para más información, consulte Generación de un esquema de archivo sin formato a partir de un IDOC.

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.

Durante el tiempo de ejecución, si la actividad Envío de IDOC a SAP procesa dos instancias de un IDOC en el que ambas instancias tienen el mismo número de IDOC; la actividad Envío de IDOC a SAP adjunta el segmento de datos de la segunda instancia a la primera instancia.

Nota: Una orquestación que contenga una actividad Envío de IDOC a SAP debe tener la persistencia habilitada. Para más información, consulte Habilitar la persistencia.

Adición de una actividad IDOC de envío a SAP en una 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 Enviar IDOC 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 de 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. Pulse Examinar....
  3. Seleccione una fila de IDOC y pulse Aceptar. Se llenan el Tipo de mensaje, el Tipo de IDOC y el Tipo de IDOC ampliado en la tarea Configurar.

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 Envío de IDOC a 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. Se visualiza el parámetro de entrada de la actividad en el panel A actividad. El esquema XML generado desde el tipo de IDOC seleccionado y el tipo de IDOC ampliado pasa a ser el parámetro de entrada de la actividad.
  2. Pulse con el botón derecho en la sección A actividad y seleccione Mostrar parámetros opcionales.

    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.
  3. Cree una correlación entre variable de orquestación y las tablas y parámetros de entrada del IDOC. Consulte Creación de una correlación para obtener instrucciones generales sobre las correlaciones.

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, 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.