Saltar al contenido

Guía de Inicio de SAP Event Listener

Introducción

Esta guía resume los pasos de configuración necesarios para comenzar a usar SAP Event Listener y describe cómo Harmony y SAP Event Listener procesan eventos IDoc.

Pasos para Comenzar

Utilice los pasos a continuación como guía para el orden recomendado en el que completar la configuración de SAP Event Listener. Estos pasos incluyen enlaces a otras páginas dentro de SAP Event Listener sección de documentación que proporciona detalles e instrucciones adicionales.

1. Configuración del Sistema SAP

Un administrador de SAP debe configurar el sistema SAP como se describe en Configuración del sistema SAP Event Listener de SAP. Como parte de este proceso, configurarán el destino RFC de Jitterbit, crearán un puerto tRFC (el puerto tRFC se utiliza para las llamadas de función tRFC y qRFC) y configurarán Jitterbit como socio de SAP.

En esta etapa del proceso de configuración, un administrador de SAP no podrá probar correctamente la conexión dentro del sistema SAP, ya que se necesita una configuración adicional fuera del sistema SAP para establecer la conectividad.

2. Descarga de los Archivos SDK de SAP JCo

Un usuario de SAP debe descargar los archivos SDK de SAP Java Connector (SAP JCo) 3.1 desde la página de SAP SAP Java Connector en la sección Descargar Java Connector 3.1 SDK (se requiere inicio de sesión en SAP). Estos archivos son necesarios durante la instalación de la aplicación SAP Event Listener, como se describe en Descarga de los componentes necesarios en Instalación de SAP Event Listener.

3. Instalación de los Archivos SDK de SAP JCo

Un usuario con acceso a cada máquina donde se va a instalar SAP Event Listener debe instalar los archivos JCo SDK relevantes como se describe en Instalación de los componentes necesarios en Instalación de SAP Event Listener.

4. Descarga de SAP Event Listener

Un usuario de Harmony debe descargar SAP Event Listener desde Descargas del portal de Harmony como se describe en Descarga de SAP Event Listener en Instalación de SAP Event Listener.

5. Instalación de SAP Event Listener

Un usuario con acceso a cada máquina donde se instalará SAP Event Listener debe instalar la aplicación SAP Event Listener como se describe en Instalación de SAP Event Listener. Durante el proceso de instalación, se le solicita que configure SAP Event Listener, como se describe en el siguiente paso.

6. Configuración de la Escucha de Eventos de SAP

Un usuario con acceso a cada máquina de SAP Event Listener debe configurar la aplicación SAP Event Listener como se describe en Configuración de SAP Event Listener.

En esta etapa del proceso de configuración, la parte Detalles del evento de la configuración de SAP Event Listener no se puede completar, ya que se requiere una configuración adicional fuera de la configuración de SAP Event Listener para obtener la entrada para este campo. Deje la parte Detalles del evento de la configuración vacía hasta que se le indique en un paso posterior.

También debe agregar el puerto de la puerta de enlace de SAP al sistema operativo. services archivo, si no está ya presente.

Luego puede probar la conexión dentro de la configuración de SAP Event Listener y verificar que el servicio SAP Event Listener se está ejecutando. El servicio debería estar ejecutándose aunque aún no se hayan ingresado los detalles del evento.

7. Habilitación de Eventos SAP IDoc en Design Studio

Un usuario de Harmony que esté diseñando el proyecto de integración debe habilitar una configuración en la aplicación Design Studio que permita la configuración de eventos SAP IDoc como se describe en Habilitación de eventos SAP IDoc en Configuración y uso de SAP Event Listener Design Studio.

8. Obtención de Detalles del Evento

Un usuario de Harmony que esté diseñando el proyecto de integración debe crear una operación de evento SAP IDoc para cada evento en Design Studio para obtener la configuración de eventos necesaria para completar la configuración de SAP Event Listener. Esto se describe en Creación de una operación de evento de SAP IDoc y obtención de detalles del evento en Configuración y uso de SAP Event Listener Design Studio.

9. Finalización de la Configuración de SAP Event Listener

Un usuario con acceso a cada máquina de SAP Event Listener debe terminar de configurar la aplicación SAP Event Listener ingresando las configuraciones de eventos obtenidas en el paso anterior en el campo Detalles del evento de la configuración de SAP Event Listener. Los Detalles del evento se ingresan en Propiedades de conexión de eventos de SAP de la sección Configuración de SAP Event Listener.

10. Reinicio del Servicio de Escucha de Eventos de SAP

Un usuario con acceso a cada máquina de SAP Event Listener debe reiniciar el servicio de SAP Event Listener después de los cambios de configuración, como se describe en Reinicio del servicio de SAP Event Listener en Instalación de SAP Event Listener.

11. Verificación de la Conectividad con SAP Event Listener

Un administrador de SAP debe verificar la conectividad entre la puerta de enlace de SAP y el detector de eventos de SAP probando la conexión del destino RFC configurado. Esto se describe en Verificación de la conectividad con SAP Event Listener en Configuración del sistema SAP Event Listener SAP.

Descripción del Procesamiento de Eventos de IDoc

Esta sección describe cómo Harmony y SAP Event Listener procesan cada evento IDoc, dependiendo de si se utiliza el protocolo RFC en cola (qRFC) o el protocolo RFC transaccional (tRFC). Harmony y SAP Event Listener utilizan el ID de programa configurado en el destino SAP RFC para recibir el evento IDoc.

Procesamiento de Eventos Qrfc IDoc

En cualquier momento, cuando los IDoc qRFC se envían desde SAP a un ID de programa de servidor registrado, las operaciones de Harmony reciben los IDoc en secuencia para esa cola en particular. Las operaciones de Harmony también completan el procesamiento de qRFC IDocs en la misma secuencia en que se recibieron los IDocs.

El procesamiento de eventos qRFC IDoc se produce en este orden:

  1. SAP envía el primer IDoc qRFC para un ID de programa a través de SAP Event Listener. Harmony impide que SAP envíe otro qRFC IDoc hasta que la operación haya completado correctamente el procesamiento del qRFC IDoc actual.
  2. Harmony envía un mensaje de éxito solo después de que la operación se haya completado con éxito. El mensaje de éxito se envía a través de SAP Event Listener a SAP.
  3. Una vez que SAP recibe un mensaje de éxito para el primer qRFC IDoc, el siguiente qRFC IDoc en la secuencia para el ID del programa se envía a SAP Event Listener.
  4. Si la operación no logra procesar correctamente el IDoc qRFC, Harmony envía un mensaje de falla a través de SAP Event Listener a SAP. SAP vuelve a enviar/reintenta el IDoc qRFC hasta que se recibe un mensaje de éxito de SAP Event Listener.
  5. SAP Event Listener recibe el siguiente IDoc qRFC relacionado con la cola/ID de programa de SAP solo después de que el IDoc anterior se haya procesado correctamente. Sin embargo, SAP Event Listener recibe otros mensajes para procesar que pertenecen a una cola/ID de programa diferente.

Si SAP Event Listener deja de funcionar o se detiene mientras procesa un IDoc qRFC, SAP Event Listener no recibirá un mensaje de éxito o falla. Puede verificar en los archivos de registro si el último IDoc qRFC se procesó correctamente:

  • Si Harmony procesó correctamente el IDoc de qRFC, asegúrese de que cualquier mensaje fallido para ese IDoc de qRFC se elimine de SAP antes de reiniciar SAP Event Listener.
  • Si la operación qRFC IDoc no se completó con éxito, SAP ya estará esperando en un estado fallido. En ese caso, reinicie SAP Event Listener, y SAP reenviará/reintentará procesar el IDoc qRFC anterior.

Procesamiento de Eventos Trfc IDOC

En cualquier momento, cuando los IDOC de tRFC se envían desde SAP a un ID de programa de servidor registrado, las operaciones de Harmony completan el procesamiento de los IDOC de tRFC en cualquier orden. Los IDOC de tRFC se procesan en paralelo en todas las instalaciones disponibles de SAP Event Listener y Agente Privado.

Si alguna operación de tRFC no completa el procesamiento, SAP Event Listener aún puede recibir otros IDocs de tRFC de SAP y el Agente Privado puede completar el proceso.

En cualquier momento, SAP Event Listener garantiza que los IDOC de tRFC fallidos se almacenen en SAP.

Si SAP Event Listener está configurado en varios Agentes Privados en un Grupo de Agentes Privados, y SAP envía un IDoc tRFC a cualquier ID de programa registrado, solo una de las instancias de SAP Event Listener recibe el IDoc.

Por ejemplo, si se envían cinco IDocs tRFC desde SAP, el mismo SAP Event Listener puede recibir los cinco IDocs, o los cinco IDocs pueden distribuirse entre varias instancias de SAP Event Listener.