Skip to Content
Author's profile photo Former Member

Testing Sample Adapter

There are many cases where the existing adapter doesn’t meet all your requirements and you want to develop a new adapter  ( But where to start?     SAP provides a Sample Adapter for this purpose. You can start testing this adapter, understand the code and do modifications.    Deploy     The Sample Adapter  ( is present on the adapter engine with the name sample_ra.sda.You can search for it on your XI Server or on decentralized adapter engine (if u have)     Extract the sample_ra.sda with WinZip. You will get sample_ra.rar and some .xml files(Deployment descriptors).    Extract the sample_ra.rar with WinZip and you can find the sample_ra.jar and .xml files.     To get the Java Doc and source text of sample adapter  ( extract the sample_ra.jar file.      If the sample adapter is already deployed then no need to deploy it again. If it is not deployed then deploy the sample_ra.sda file though SDM  ( JNDI name of your deployed adapter will be “deployedAdapters/Create Adapter Meta Data in Integration Repository. The Meta data should be under the Namespace  (, with the name JCA and the software component could be anything (it doesn’t matter). This restriction is because; in the ra.xml (extract the sample_ra.rar) file these deployment descriptors were given. If u wants to create Adapter Meta Data with some other name and namespace then change the corresponding values in ra.xml file and deploy it. To create the Adapter Meta Data copy the contents of SampleRa.xml (Extract the sample_ra.jar file) file and paste it in Adapter Meta Data Source Document View (4th icon on create Adapter metadata screen). Once you active the Meta Data Object, then it is ready to be used in Integration Directory at configuration time.        image   Configuration     At configuration time in communication channel, select the Adapter(the Adapter name is same as Metadata name)that is displayed with the name that u have given for Metadata at Design time. You can use this adapter both on Sender and Receiver side.     image

Assigned Tags

      You must be Logged on to comment or reply to a post.
      Author's profile photo Sravya Talanki
      Sravya Talanki
      Will be useful .
      Author's profile photo Former Member
      Former Member
      Its simply gr8.
      Author's profile photo Former Member
      Former Member
        Its a great Blog, but i have a basic question is Software Deployment Manager the only way to deploy? Is their any alternate way to it.

      Best Regards,

      Author's profile photo chandra shekar dasari
      chandra shekar dasari
      Great blog for starters
      Author's profile photo Former Member
      Former Member
      I tried this on SP15, but no messages were sent. 

      Have you tried it on SP15?  The screenshot of the comm chan config looks different than what you have in the weblog.  Don't know if the newer version still works.


      Author's profile photo Former Member
      Former Member
      Sorry about the post.  Everything works fine in SP15.  It was a pilot error 🙂


      Author's profile photo Former Member
      Former Member

      I read ur blog and it is really helpful for me to develop a new adapter.
      Now I am facing problem while deploying the sample_ra.jar file on the server.The errors are

      Error loading archive
          (server side name is:   G:\tmp\usr\sample_ra\sample_ra.jar)
 The information about the development component
      found in the SDA G:\tmp\usr\sample_ra\sample_ra.jar is either missing or incomplete!
      Manifest attributes are missing or have badly formatted value:
      attribute keylocation is missing
      attribute keyname is missing
      attribute keyvendor is missing
      attribute keycounter is missing

      I need ur help to solve the problem

      THAnks And REgards

      Author's profile photo Former Member
      Former Member
      Hi Gowti,

      This blog was very helpful to me. If you have anymore documents to share with then you can send it to me at As long as sample adapter is deployed it's ok. But if I am to develop a custom adapter and deploy then what are the step by step process I need to follow.

      Author's profile photo KUNAAL MASIH
      Hi Goutham,

         I found your blog very helpful and I could run the sample adapter successfully with the help of your blog.

         Rightnow I have a requirement to develop a new custom adapter in my project. I copied sample.xml file and changed it as per my requirement and imported it under adapter metadata, under namespace in IR.
      But I am not able to find out the proper class where I can put my own code. As per SAP help it is and where we can put the code.

      So can you please help me on how to go about on custom Adapter development? You can send me your inputs at

      Many Thanks

      Author's profile photo Former Member
      Former Member
      Hi, Its a wonderful blog and very helpful for us to reach till stage where our Custom Adapter is running in PI box.

      But  we are facing a very weird issue , in which we need to re-deploy the Sample_ra.sda File again and again daily for making it to start working which is disgusting. Any answers what we  have done wrong or its a some Basis Setting in server?
      Please reply.