Additional Blogs by Members
cancel
Showing results for 
Search instead for 
Did you mean: 
GabrielSagaya
Active Contributor

This weblog is continuation of the Standard Adapter Framework modules [AF_Modules] in PI 7.1 –Part 1.

In this Weblog I am going to explain remaining list of SAP provided standard Adapter Framework modules [AF_Modules] shipped with the module processor in Process Integration PI 7.1

 

 7) MessageTransformBean 

 

A standard module used for calling the transformation functions and enabling conversion of XML structure to flat structure and vice versa. It has 2 conversion types as given below.

a) StructXML2Plain-for simple conversion

b) SimpleXML2Plain-for complex conversion

For both sender and receiver channel, we can choose either simple or complex transformation. In simple transformation all rows of the input file have the same structure. If each row of the input file has a different structure, then it is referred to as complex transformation. All transformations can handle Character-Separated-Value (CSV) structures and structures with fixed field length.

 

Business Case 

MessageTransformBean is used to convert flat file into xml structure whether it is simple or complex. We can use XSLT mapping directly in the adapter module. We can use this module in the sender and receiver communication channels.

 

 

In the above Receiver File Adapter, The Plain2XML module for the MessageTransformationBean has list of parameter names as Transform.class has the value as Converison and Transform.contentType has the value charset=utf-8 and xml.conversionType has the value either StructPlain2XML/SimplePlain2XML and other FCC Configuration parameter names. Please view Solve Key Field Problem using StructPlain2XML in MessageTransformationBean!! for better understanding of MessageTransformBean

 

 

 😎 XiHeaderValidationBean (A New Adapter module in PI 7.1)

 

A standard module used to check the XI header parameters on the basis of parameters that we configured in the communication channel.

 

Business Case

 

            We can use this module only in sender communication channels. Whenever the Integration Server transforms the incoming sender protocol message into XI message format, the header validation module validates the XI header parameters against the parameter values we configure in the communication channel. In order to use this module, we need to select option Validation in the Adapter in sender agreement.

 

 

 

In above sender File adapter, validate module for the XiHeaderValidationBean has the list of parameter names as SenderService, Interface, InterfaceNamespace and ReceiverService has corresponding Values of sender and receiver Business component and sender interface and sender interface namespace that should be validated by Adapter Engine. This SAP help Documentation will give the clear picture about the usage of XiHeaderValidationBean.

 

 

 9) RequestResponseBean

 

A standard module used for converting asynchronous request message to a synchronous request message. If the thread that enters the module is part of a transaction, the transaction is suspended.

 

Business Case

          We can use this module for an Async/sync bridge in the sender and receiver JMS Adapters. If we are using the module in a sender adapter, it calls the messaging system. If we are using the module in a receiver adapter, it calls a receiver. If we configure the module in passThrough mode, it forwards the message to the adapter modules. This Wiki will clearly explain the use of RequestResponseBean. 

 

10) ResponseOnewayBean

A standard module used for converting an inbound message to an asynchronous message. If the thread that enters the module is part of a suspended transaction, the transaction is resumed.

 

Business Case

We can use this module for an async/sync bridge for sender and receiver JMS Adapters. Using these modules [RequestResponseBean and ResponseOnewayBean], we can have file adapter behave in synchronous fashion. If we are using the module in a sender adapter, it calls the receiver. If we are using the module in a receiver adapter, it calls a messaging system. The inbound data in the module is application response messages.

 

In the above sender File Adapter, request module for the RequestResponseBean has the parameter name as passThrough which has the value as true in order to pass the message to next module (response). The response module for the ResponseOnewayBean has the parameter names as receiverService and receiverChannel which has the corresponding value of Receiver Business system and Receiver Communication channel in order to search for collaboration agreement. Please go through this wiki for better understanding of RequestResponseBean and ResponseOnewayBean

 

 11) RequestOnewayBean

A standard module used for converting an inbound message to an asynchronous message. If we are using this module in a sender adapter, it sends the asynchronous message to the messaging system. If we are using this module in a receiver adapter, it sends the asynchronous message to a receiver. If we configure the module in passThrough mode, it forwards the message to the adapter modules.

 

 Business Case

         We can use this module for a Sync/Async bridge for sender and receiver channels.

 

 12) WaitResponseBean

A standard module waits for a response message. If the response message arrives in the specified time period, it is forwarded. If the response message does not arrive in the specified time period, an exception is set.

 

 Business Case

We can use this module for a Sync/Async bridge for sender and receiver channels.

 

In above Receiver File Adapter, the request module for the RequestOnewayBean has the parameter name as passThrough that has the value true in order to forward the message to next module. The wait module for the WaitResponseBean is also included in order to wait for the response message.

 

 13) NotifyResponseBean

A standard module used for sending a message as a response to an application message

 

 Business Case

We can use this module for a Sync/Async bridge for sender and receiver channels.

 

 

In the above Sender File Adapter, module key wait for the NotifyResponseBean is inserted after the DynamicConfigurationBean module having the parameter name key.0 and value.0 to write the correlation ID to the attribute before message is sent to the waiting process. For better understanding of this RequestOnewayBean and WaitResponseBean and NotifyReponseBean, Please visit Sync/Async scenarios without BPM.

4 Comments