Ensuring Exactly Once in the SOAP Sender Adapter

PDF download from SAP Help Portal:

http://help.sap.com/saphelp_nw73ehp1/helpdata/en/5e/164442c1a1c353e10000000a1550b0/content.htm
Created on August 19, 2016

The documentation may have changed since you downloaded the PDF. You can always find the latest information on SAP Help
Portal.

Note
This PDF document contains the selected topic and its subtopics (max. 150) in the selected structure. Subtopics from other structures are not included.

2016 SAP SE or an SAP affiliate company. All rights reserved. No part of this publication may be reproduced or transmitted in any form or for any purpose
without the express permission of SAP SE. The information contained herein may be changed without prior notice. Some software products marketed by SAP
SE and its distributors contain proprietary software components of other software vendors. National product specifications may vary. These materials are
provided by SAP SE and its affiliated companies ("SAP Group") for informational purposes only, without representation or warranty of any kind, and SAP
Group shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP Group products and services are those that are set
forth in the express warranty statements accompanying such products and services, if any. Nothing herein should be construed as constituting an additional
warranty. SAP and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP SE in
Germany and other countries. Please see www.sap.com/corporate-en/legal/copyright/index.epx#trademark for additional trademark information and notices.

Table of content

PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.

Page 1 of 3

Table of content
1 Ensuring Exactly Once in the SOAP Sender Adapter

PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.

Page 2 of 3

1 Ensuring Exactly Once in the SOAP Sender Adapter

Use
The SOAP adapter ensures exactly once end-to-end processing in different ways, depending on whether the SOAP message provided by the SOAP client
contains a GUID or not.

Procedure
SOAP Message with GUID
If the SOAP message contains a GUID, select Use Encoded Headers and Use Query String in the adapter configuration.
The GUID can be provided in a valid XI message header in the SOAP message header or specified in a corresponding query string in the URL.
For example: http://< host name>:<port name>/XISOAPAdapter/MessageServlet?senderParty=<name of the sender party>&senderService=<name of the
sender service>&interface=<name of the interface>&receiverParty=<name of the receiver party>&receiverService=<name of the receiver
service>&interfaceNamespace=<name of the interface namespace>&MessageId=<GUID>

Note
SOAP Message Without GUID
If the SOAP message does not contain a GUID, the SOAP adapter generates one.
...
In the adapter configuration, select Exactly Once under Quality of Service.
The GUID is generated and the adapter calls the XI service exactly once.

Result
SOAP Message with GUID
If the SOAP client receives an empty SOAP message in HTTP 200 as a response, this means that the message has been successfully persisted and
will be processed exactly once.
If the SOAP client receives a SOAP fault or any response not in HTTP 200, it must resend the message until it receives an empty SOAP message in
HTTP 200.
SOAP Message Without GUID
If the XI message is successfully persisted, the adapter sends an empty SOAP message (HTTP 200) to the SOAP client as a response. The SOAP
client now knows that the message has been sent successfully.
If the SOAP client receives a SOAP fault, it must resend the message until it receives an empty SOAP message (HTTP 200).
If the SOAP client receives an incomplete HTTP 200, the client can assume that the message has been processed successfully.
If the SOAP client receives an incomplete HTTP 4xx or 5xx, the client can assume that the message has not been processed.
If the SOAP client does not receive a response, the situation is uncertain. In this case, the message should be sent again. However, this can mean that
the message is executed more than once.

PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.

Page 3 of 3