SAP Basis Tech Supports

Symptom
You are experiencing problems with the SAP XI 3.0/7.x Axis Adapter and/or needing further information about its configuration and operation.
Other terms
XI30, Adapter Framework, Frequently Asked Questions, HOWTO
Reason and Prerequisites
This note servces as FAQ document for the SAP XI 3.0/7.x Axis Adapter. It contains answers to commonly asked questions about the configuration and the operation of the adapter.
Solution
See the attached FAQ Document.
The following questions are answered in this FAQ.
———————————————————————–
General Questions
1. How can I start using the Axis adapter?
2. How can I check if the Axis adapter is successfully deployed on my system?
3. How to prepare aii_af_axisprovider.sda?
4. I cannot deploy the aii_af_axisprovider.sda archive.
5. I deployed the aii_af_axisprovider.sda archive with the required jar files, but I still get the error at the servlet page.
6. Do I need to worry about any optional components at the servlet page.
7. I am getting java.lang.LinkageError.
8. I am getting java.lang.NoClassDefFoundError.
9. I am getting java.lang.ClassNotFoundException.
10. I am getting org.apache.axis.ConfiguraitonException: adapter is null
11. Which version of Axis is currently supported?
12. Which components are relevant for generating a debug trace output?
13. When opening an OSS problem report, which information do I have to include?
Sender Adapter General
1. How can I configure a simple sender adapter for testing and what can I do with it?
2. Where can I place some additional SAP adapter module in my sender channel configuration?
3. Where can I place some additional Axis handler in my sender channel configuration?
4. What is the effect of setting the XI parameter Quality of Service to BestEffort?
5. What is the effect of setting the XI parameter Quality of Service to ExactlyOnce?
6. What is the effect of setting the XI parameter Quality of Service to ExactlyOnceInOrder?
7. How is the XI error message mapped to the SOAP fault message?
8. What is the effect of setting the XI parameter Keep XI Headers?
9. What is the effect of setting the XI parameter Keep Attachments?
10. What are the differences among the XI parameter Payload Extraction options at the sender adapter?
11. What is the URL for sending SOAP messages to my channel?
12. Which security role is associated with the Axis adapter message servlet?
13. Which security policy is associated with the Axis adapter message servlet?
14. Can I supply the Message ID when sending a SOAP message?
15. What will happen when I send a message with the same message ID more than once?
16. How can I determine why the call from my SOAP client fails?
17. How can I configure my sender channel to use SSL?
18. How can I configure my sender channel to use principal propagation?
19. Can I configure my channel to accept only those messages that are authenticated by some specific security mechanism?
20. Can I receive a SOAP message other than at the Axis adapter’s message servlet?
21. How can I configure my sender channel to use DIME or MTOM?
22. Can I use SOAP 1.2 for my sender channel?
23. Can I configure my sender channel to read SOAP messages from files?
24. Can I configure my sender channel to receive SOAP messages using POP3?
25. Can I configure my sender channel to receive SOAP messages using JMS?
26. Can I use the sender adapter without XI30InboundHandler so that it can directly receive XI messages?
27. I get the DuplicateMessageException when I send a message with Quality of Service set to ExactlyOnce
28. My ABAP client cannot process the HTTP 202 response from the sender adapter wihtout XI30InboundHandler.
29. How can I process a SOAP message with more than one Body child elements?
30. How can I process a SOAP message with multiRef references at the sender adapter?
31. Can I modify or disable the user authenticatio performed at the Axis adapter message servlet?
32. Can I configure user login per channel using a handler
33. Can I perform a channel specific authenticaiton scheme using a handler (e.g., performing Basic Password, UsernameToken)
Receiver Adapter General
1. How can I configure a simple receiver adapter for testing and what can I do with it?
2. Where can I place some additional SAP adapter module in my receiver channel configuration?
3. Where can I place some additional Axis handler in my receiver channel configuration?
4. What should the web service return when it is called from a synchronous interface?
5. What should the web service return when it is called from an asynchronous interface?
6. Can I include the Message ID when sending a SOAP message?
7. How can I determine why the call to the web service fails?
8. How is the SOAP fault message mapped to the XI error message?
9. What are the differences among the XI parameter Payload Extraction options at the receiver adapter?
10. How can I configure my receiver channel to use SSL?
11. How can I configure my receiver channel to use principal propagation?
12. How can I configure my receiver channel to use SSL with a client certificate?
13. How can I use Windows NTLM authentication module in my receiver channel?
14. Where can I set SOAPAction?
15. Can I use HTTP 1.1?
16. Can I use SOAP 1.2 for my receiver channel?
17. Where can I set the action parameter for SOAP 1.2?
18. How can I configure my receiver channel to use DIME or MTOM?
19. Can I configure my receiver channel to store SOAP messages in files?
20. Can I configure my receiver channel to send SOAP messages using SMTP?
21. Can I configure my receiver channel to send SOAP messages using JMS?
22. How can I use CommonsHTTPSender as the transport handler?
23. Can I use the receiver adapter without XI30OutbundHandler so that it can directly send XI messages?
24. Can I call the target service with HTTP GET?
25. How can I call some service over an HTTP proxy server?
26. How can I transmit a SOAP message with more than one Body child elements?
27. How can I transmit a SOAP message using multiRef references from the receiver adapter?
28. How can I set the timeout value for the transport handler?
29. Can the receiver adapter handle HTTP redirects?
Handler related questions
1. Is there any sample handler I can try?
2. When I write my own handler, where can I package it?
3. How can I add or delete some SOAP headers?
4. Where can I learn more about the Axis handlers?
5. How can I write to the adapter engine’s trace (defaultTrace)?
6. Can I hide the value of some handler parameter in the module parameter table?
7. Is there a log handler that can write the message content into a file?
Advanced usage questions
1. How can I enable the WS-Security features?
2. Where can I get additional information about the WS-Security handlers?
3. How can I configure a channel to use the UsernameToken authentication of WS-Security?
4. How can I insert the Nonce and/or Created elements for WS-Security UsernameToken?
5. How can I configure a channel to use the encryption and signature feature of WS-Security?
6. Do I need Bouncy Castle to use WS-Security?
7. Can I turn off the WS-Security header’s mustUnderstand flag?
8. How can I insert the Timestamp element for WS-Security?
9. How can I encode arbitrary elements using WS-Security?
10. How can I use the UsernameToken and encrypt its content using WS-Security?
11. Can I include the sender’s certificate in the signed message using WS-Security?
12. Can I include the sender’s certificate issuer serial in the signed message using WS-Security?
13. Can I use a different symmetric algorithm like aes256-cbc or tripledes-cbc for WS-Security?
14. Can I combine several WS-Security actions?
15. Can I chain several WS-Security handlers?
16. Can I use WS-Security with SAML?
17. How can I enable the WS Addressing features?
18. How can I include the WS Addressing headers in my SOAP message?
19. What is the Receiver task used in the sender adapter?
20. Is there any sample code for a receiver task?
21. What is the Subscriber task used in the sender adapter?
22. Is there any sample code for a subscriber task?
23. Can I deploy an Axis java proxy and call it as the service target?
24. How can I read some MIME or transport headers using the XI DynamicConfiguration header (ASMA)?
25. How can I set some MIME or transport headers using the XI DynamicConfiguration header (ASMA)?
26. How can I set the target URL using the XI DynamicConfiguration header (ASMA)?
27. How can I set the SOAPAction value using the XI DynamicConfiguration header (ASMA)?
28. Can I extract some ID value from the SOAP envelope and use it as the message ID?
29. Can I insert some SOAP headers?
30. Can I use the Axis adapter functionality in my own adapter implementation?
31. Can I directly forward the XI message to some specified XI system from the sender adapter?
32. What is the Axis sample adapetr SDK?
33. Can I invoke a service internally using Axis’ service provider mechanism?
34. Can I invoke a POJO or EJB based service internally as the target?
35. How can I invoke an internal POJO based service using the java:RPC provider?
36. How can I invoke an internal POJO based service using the java:MSG provider?
37. How can I invoke an internal EJB based servine using the java:EJB provider?
38. Can I use the typeMapping or beanMapping features when I invoke some internal service?
39. Can I get the WSDL file for the internally configured service?
40. How can I set or change the values of some Axis message context properties?