Guía de Introducción a SAP Event Listener¶

Introducción¶

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

Pasos para Comenzar¶

Utilice los pasos siguientes 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. Configurar el Sistema SAP¶

Un administrador de SAP debe configurar el sistema SAP como se describe en Configuración del sistema SAP de SAP Event Listener. Como parte de este proceso, configurarán el destino RFC de Jitterbit, crearán un puerto tRFC (el puerto tRFC se utiliza para 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 con éxito la conexión dentro del sistema SAP, ya que es necesaria 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 (es necesario iniciar 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 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 instalará SAP Event Listener debe instalar los archivos JCo SDK relevantes como se describe en Instalar 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 página como se describe en Descargar SAP Event Listener en Instalación de SAP Event Listener.

5. Instalación del Detector de Eventos de SAP¶

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 solicitará que configure SAP Event Listener, como se describe en el siguiente paso.

6. Configurar el Detector 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 puerta de enlace de SAP al sistema operativo services archivo, si aún no está 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 IDoc de SAP 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 IDoc de SAP como se describe en Habilitación de eventos IDoc de SAP 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 IDoc de SAP para cada evento en Design Studio para obtener la configuración de evento necesaria para completar la configuración de escucha de eventos de SAP. Esto se describe en Creación de una operación de evento IDoc de SAP 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 del 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 sección de la 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 SAP Event Listener después de los cambios de configuración, como se describe en Reinicio del servicio 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 SAP Event Listener 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 de SAP Event Listener.

Comprensión del Procesamiento de Eventos 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 del programa configurado en el destino RFC de SAP para recibir el evento IDoc.

Procesamiento de Eventos IDoc Qrfc¶

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

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

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 IDoc qRFC hasta que la operación haya completado exitosamente el procesamiento del IDoc qRFC actual.
Harmony envía un mensaje de éxito solo después de que la operación se haya completado exitosamente. El mensaje de éxito se envía a través de SAP Event Listener a SAP.
Una vez que SAP recibe un mensaje de éxito para el primer IDoc qRFC, el siguiente IDoc qRFC en la secuencia para el ID del programa se envía al escucha de eventos de SAP.
Si la operación no logra procesar exitosamente el IDoc qRFC, Harmony envía un mensaje de error a través de SAP Event Listener a SAP. SAP reenvía/reintenta el IDoc qRFC hasta que se recibe un mensaje de éxito del escucha de eventos de SAP.
SAP Event Listener recibe el siguiente IDoc qRFC relacionado con el IDoc de cola/programa de SAP solo después de que el IDoc anterior se procese exitosamente. Sin embargo, SAP Event Listener recibe otros mensajes para su procesamiento 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 error. Puede verificar en los archivos de registro si el último IDoc qRFC se procesó correctamente:

Si Harmony procesó exitosamente 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 IDoc qRFC no se completó correctamente, SAP ya estará esperando en un estado fallido. En ese caso, reinicie SAP Event Listener, y SAP reenviará/intentará procesar el IDoc qRFC anterior.

Procesamiento de Eventos IDoc Trfc¶

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

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

En cualquier momento, SAP Event Listener garantiza que los IDOC 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 IDOC tRFC desde SAP, el mismo SAP Event Listener puede recibir los cinco IDOC o los cinco IDOC se pueden distribuir entre varias instancias de SAP Event Listener.