SAP Event Listener¶
The Jitterbit SAP Event Listener is a locally installed application that listens for IDocs that are outbound from SAP. Its configuration requires the use of the SAP Connector for Jitterbit Harmony Design Studio to configure an SAP IDoc Event as part of a Design Studio operation. Once the SAP Event Listener is fully configured, the IDocs that it receives trigger the Design Studio operation.
If following our recommendation to install the SAP Event Listener on a Private Agent, all prerequisites of a Private Agent must be met, as described in System Requirements for Private Agents.
These prerequisites specific to the SAP Event Listener must also be met:
- The SAP system must be configured with an RFC destination, a transactional RFC (tRFC) port, and a partner profile for use by the Jitterbit SAP Event Listener.
- The SAP Event Listener must be installed on a machine that meets these requirements:
- Has a 64-bit operating system using Windows Server 2012 R2 or later, Windows 8 or later, or a recent Debian- or RPM-based Linux distribution.
- Has the appropriate SAP Java Connector (SAP JCo) 3.1 SDK files installed.
- The SAP Event Listener must be configured to use a Private Agent. We recommend installing the SAP Event Listener on the same machine as a Private Agent.
- For the SAP Event Listener to have high availability, if there is more than one Private Agent in a Private Agent Group, an instance of the SAP Event Listener must be installed and configured in exactly the same way on each agent in the group.
- If using SAP S4HANA on-premises, the SAP Event Listener version 22.214.171.124 or later is required. (SAP ECC is supported with no minimum version number.)
- Design Studio version 126.96.36.199 or later is required to configure and use the SAP Event Listener.
The SAP Event Listener Get Started Guide provides a summary and recommended order of installation and configuration steps to start using the SAP Event Listener, as well as a description of how Jitterbit Harmony and the SAP Event Listener process IDoc events.
Supported RFC Protocols¶
The SAP Event Listener supports the transactional RFC (tRFC) and queued RFC (qRFC) protocols:
- Transactional RFCs
- A tRFC function call is executed exactly once in the target system.
- The system checks if a TID (unique transaction identifier) has already been processed. If it has, the tRFC function call is ignored.
- If the target system is not available when the call is made, the SAP Connector continues to retry to process the transaction. The SAP Connector also continues to process other tRFC function calls.
- The order in which the tRFC function calls are processed is not guaranteed.
- Queued RFCs
- Each qRFC function call is placed in an outbound queue that is processed in a specific order.
- A qRFC function call cannot be executed until all of its predecessors in the queue have been processed. A qRFC function call is transferred only if it has no predecessors in the participating queue.
- After a qRFC function call is executed, the system attempts to start the next qRFC transaction in the sequence from the queue.
- A queue name and a queue counter are required for each qRFC transaction for queue administration. Each qRFC call that is to be processed chronologically is assigned a queue name.
The latest version of the SAP Event Listener has this known issue:
SAP Event Listener: The Windows configuration UI cannot be opened
Summary: On attempting to open the Windows SAP Event Listener configuration through the UI, an exception occurs.
Additional Information: This issue occurs when a previously saved configuration that includes the required outer set of
</events>tags in the Event Details field has since been inadvertently saved without those tags.
Recovery: Manually edit the configuration file at
C:\ProgramData\JitterbitSAPEventListener\conf\sapeventconfig.xmlto replace the required outer tags. The Windows configuration UI can again be opened.