Start of Content Area

Function documentation Message Exchange  Locate the document in its SAP Library structure

Use

The Adapter Framework controls the exchange of synchronous and asynchronous XI messages and communicates with the Integration Server to do this. The adapters in the Adapter Framework convert XI messages to the protocols of connected external systems and the other way around.

Activities

Follow the rules and design guidelines that are described in the following sections:

      The adapter must differentiate between synchronous and asynchronous messages.

More information: Synchronous Messages, Asynchronous Messages

      In the case of Exactly Once and Exactly Once In Order, the adapter must ensure guaranteed message delivery.

More information: Parts of an XI Message, under Quality of Service.

      To guarantee the delivery of a message, the adapter should use the AS Java Transaction Manager and the MessageIDMapper.

More information: Asynchronous Messages

      The adapter must use the Message interface to read the message.

This can be used either in the JCA adapter or in your own modules.

      The adapter can use the ModuleProcessorExitBean of the Adapter Framework to forward the message to the JCA adapter part.

Note the requirements of the Adapter Framework CCI.

More information: Adapter Framework JCA CCI Library

      The adapter must use the messaging service message factory to generate response messages in synchronous communication.

      The adapter must forward a message object that implements the Message interface to the Adapter Framework messaging service.

      To create a message and send it on to the Adapter Framework, the adapter must use the Message Factory messaging service.

      The adapter must call the module processor to send new messages to the Adapter Framework. It must not call CallSapAdapter directly or call the messaging service by using the connection class for this purpose.

      The last module in the module processor for sender channels is normally CallSapAdapter.

Other modules can follow this module if further processing is to be undertaken after a message has been sent to the Integration Server.

 

End of Content Area