8/5/2015 Standard Adapter Framework modules [AF_Modules]... | SCN

http://scn.sap.com/people/gabrielsagayaselvam.panneerselvam/blog/2009/12/07/standardadapterframeworkmodulesafmodulesinpi71part2 1/5

Getting Started Newsletters Store   

Products Services & Support About SCN Downloads

Industries Training & Education Partnership Developer Center

Lines of Business University Alliances Events & Webinars Innovation

Log On Join UsHi, Guest Search the Community

Activity Communications Actions

Browse

gabrielsagayaselvam.panneerselvam 

0 Tweet 0

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 toflat structure and vice versa. It has 2 conversion types as given below.a) StructXML2Plainfor simple conversionb) SimpleXML2Plainfor complex conversion

For both sender and  receiver  channel, we can choose either  simple or  complex  transformation.  In simpletransformation 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 CharacterSeparatedValue  (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 XSLTmapping 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  valuecharset=utf8  and  xml.conversionType  has  the  value  either  StructPlain2XML/SimplePlain2XML  and  other  FCCConfiguration  parameter  names.  Please  view  Solve  Key  Field  Problem  using  StructPlain2XML  inMessageTransformationBean!! for better understanding of MessageTransformBean

  

Standard Adapter Framework modules [AF_Modules]in PI 7.1 –Part 2Posted by Gabriel Sagaya Selvam Panneer Selvam in gabrielsagayaselvam.panneerselvam on Dec 7,

2009 8:13:12 AM

Share 0Like

8/5/2015 Standard Adapter Framework modules [AF_Modules]... | SCN

http://scn.sap.com/people/gabrielsagayaselvam.panneerselvam/blog/2009/12/07/standardadapterframeworkmodulesafmodulesinpi71part2 2/5

 8) 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 inthe 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 theXI header parameters against the parameter values we configure in the communication channel. In order to use thismodule, 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  ofsender  and  receiver  Business  component  and  sender  interface  and  sender  interface  namespace  that  should  bevalidated  by  Adapter  Engine.  This  SAP  help  Documentation  will  give  the  clear  picture  about  the  usage  ofXiHeaderValidationBean.

  

 9) RequestResponseBean 

A standard module used for converting asynchronous request message to a synchronous request message. Ifthe 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 themodule in a sender adapter, it calls the messaging system. If we are using the module in a receiver adapter, it calls areceiver. If we configure the module in passThrough mode, it forwards the message to the adapter modules. This Wikiwill clearly explain the use of RequestResponseBean.  10) ResponseOnewayBean

A standard module used for converting an inbound message to an asynchronous message. If the thread thatenters the module is part of a suspended transaction, the transaction is resumed. Business CaseWe 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 weare using the module in a sender adapter, it calls the receiver. If we are using the module in a receiver adapter, it callsa messaging system. The inbound data in the module is application response messages. 

8/5/2015 Standard Adapter Framework modules [AF_Modules]... | SCN

http://scn.sap.com/people/gabrielsagayaselvam.panneerselvam/blog/2009/12/07/standardadapterframeworkmodulesafmodulesinpi71part2 3/5

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

A standard module used for converting an inbound message to an asynchronous message. If we are usingthis module in a sender adapter, it sends the asynchronous message to the messaging system. If we are using thismodule  in  a  receiver  adapter,  it  sends  the  asynchronous  message  to  a  receiver.  If  we  configure  the  module  inpassThrough 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  timeperiod, 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 aspassThrough  that  has  the  value  true  in  order  to  forward  the  message  to  next  module.  The  wait  module  for  theWaitResponseBean 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. 

8/5/2015 Standard Adapter Framework modules [AF_Modules]... | SCN

http://scn.sap.com/people/gabrielsagayaselvam.panneerselvam/blog/2009/12/07/standardadapterframeworkmodulesafmodulesinpi71part2 4/5

Average User Rating

(3 ratings)

My Rating:

0 Tweet 0

 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 theattribute before message  is sent  to  the waiting process. For better understanding of  this RequestOnewayBean andWaitResponseBean and NotifyReponseBean, Please visit  Sync/Async scenarios without BPM.

8074 Views  

Share 0Like

4 Comments

Like (1)

sachin kotalwar Dec 16, 2009 9:29 AM

quite useful to have a list of all the modules and their usage at one place so this will be a referencepoint!Nice blog.Sachin

Like (0)

Deepak Shah Feb 6, 2011 10:50 PM

Hi Gabriel,

Thanks a lot for such a useful blog.

Regards,Deepak.

Like (0)

divyesh vasani Mar 20, 2014 10:09 AM

Thanks for consolidating all modules and relevant blogs in one place... Divyesh

Like (0)

Aaron Myers Aug 15, 2014 8:14 PM

Wiki link for section 9 has moved to:  http://wiki.scn.sap.com/wiki/display/XI/Using+Request+Response+Bean+Module+in+FILE+Adapter

8/5/2015 Standard Adapter Framework modules [AF_Modules]... | SCN

http://scn.sap.com/people/gabrielsagayaselvam.panneerselvam/blog/2009/12/07/standardadapterframeworkmodulesafmodulesinpi71part2 5/5

Follow SCNSite Index Contact Us SAP Help PortalPrivacy Terms of Use Legal Disclosure Copyright