Skip to Content
There are many cases where the existing adapter doesn’t meet all your requirements and you want to develop a new adapter  (http://help.sap.com/saphelp_nw04/helpdata/en/22/a7663bb3808c1fe10000000a114084/frameset.htm). 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  (http://help.sap.com/saphelp_nw04/helpdata/en/e9/61e1407e858031e10000000a1550b0/frameset.htm) 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  (http://help.sap.com/saphelp_nw04/helpdata/en/87/3ef4403ae3db12e10000000a155106/frameset.htm) 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  (http://help.sap.com/saphelp_nw04/helpdata/en/22/a7663bb3808c1fe10000000a114084/frameset.htm).The JNDI name of your deployed adapter will be “deployedAdapters/Create Adapter Meta Data in Integration Repository. The Meta data should be under the Namespace http://sap.com/xi/XI/sample  (http://sap.com/xi/XI/sample), 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
To report this post you need to login first.

10 Comments

You must be Logged on to comment or reply to a post.

  1. Anonymous
    Hi,
      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,
    Anirban.

    (0) 
  2. William Li
    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.

    Thanks,
    Bill

    (0) 
  3. manas mahani
    hi.

    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
        G:\tmp\usr\sample_ra\sample_ra.jar
        (server side name is:   G:\tmp\usr\sample_ra\sample_ra.jar)
        com.sap.sdm.util.sduread.IllFormattedSduFileException: 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
    MAnas

    (0) 
  4. Sugata Basu
    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 sugata.basu@gmail.com. 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.

    (0) 
  5. 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 http://sap.com/xi/XI/sample 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 SPIManagedConnectionFactory.java and XIConfiguration.java 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 kunaal-abhijit.masih@capgemini.com.

    Many Thanks
    Kunaal

    (0) 
  6. Anurag Garg
    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.

    (0) 

Leave a Reply