From:  Business Transaction Protocol. Pre-final Draft 0.9
See: http://xml.coverpages.org/OASIS-BTP-Specification-DRAFT090.pdf
* XML Schema for SOAP Bindings
* Example scenario using SOAP binding

--------------------------------------------------------------------------

Example scenario using SOAP binding

The example below shows an application request with CONTEXT
message sent from client.example.com (which includes the Superior)
to services.example.com (Service).

<soap:Envelope
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
    soap-env:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">

  <soap:Header>

    <btp:messages xmlns:btp="urn:oasis:names:tc:BTP:xml">
      <btp:context superior-type="atom">
        <btp:superior-address>
          <btp:binding>soap-http-1</btp:binding>
          <btp:binding-address>http://client.example.com/soaphandler</btp:binding-address>
          <btp:additional-information>btpengine</btp:additional-information>
        </btp:superior-address>
        <btp:superior-identifier>1001</btp:superior-identifier>
        <btp:qualifiers>
          <btpq:transaction-timelimit xmlns:btpq="urn:oasis:names:tc:BTP:qualifiers">1800</btpq:transaction-timelimit>
	 </btp:qualifiers>
      </btp:context>
    </btp:messages>

  </soap:Header>

  <soap:Body>

    <ns1:orderGoods xmlns:ns1="http://example.com/2001/Services/xyzgoods">
      <custID>ABC8329045</custID>
      <itemID>224352</itemID>
      <quantity>5</quantity>
    </ns1:orderGoods>

  </soap:Body>

</soap:Envelope>


The example below shows CONTEXT_REPLY and a related (and therefore
contained) ENROL message sent from services.example.com to
client.example.com, in reply to the previous message. There is no
application response, so the BTP messages are in the SOAP:Body.

<soap:Envelope
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
    soap-env:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">

  <soap:Header>
  </soap:Header>

  <soap:Body>

    <btp:messages xmlns:btp="urn:oasis:names:tc:BTP:xml">
	<btp:context-reply>
	  <btp:superior-address>
           <btp:binding>soap-http-1</btp:binding>
           <btp:binding-address>
		http://client.example.com/soaphandler
           </btp:binding-address>
           <btp:additional-information>
		btpengine
	    </btp:additional-information>
        </btp:superior-address>
        <btp:superior-identifier>1001</btp:superior-identifier>
        <completion-status>related</completion-status>	  
  
	 <btp:enrol reply-requested="false">
          <btp:target-additional-information>
		btpengine
          </btp:target-additional-information>
	   <btp:superior-identifier>
		1001
	   </btp:superior-identifier>
          <btp:inferior-address>
            <btp:binding>soap-http-1</btp:binding>
	     <btp:binding-address>
		http://services.example.com/soaphandler
	     </btp:binding-address>
          </btp:inferior-address>
	   <btp:inferior-identifier>
		AAAB
	   </btp:inferior-identifier>
	  </btp:enrol>

       </btp:context-reply>

    </btp:messages>

  </soap:Body>

</soap:Envelope>


 
SOAP + Attachments Binding

This binding describes how BTP messages will be carried using SOAP as
in the SOAP Messages with Attachments specification. It is a superset
of the Basic SOAP binding, soap-http-1. The two bindings only differ
when application messages are sent

Binding name: soap-attachments-http-1

BTP message representation: As for soap-http-1

Mapping for BTP messages (unrelated): As for "soap-http-1" , except
the SOAP:Envelope containing the SOAP-Body containing the BTP messages
shall be in a MIME body part, as specified in SOAP Messages with
Attachments specification. If an application message is being sent at
the same time, the mapping for related messages for this binding shall
be used, as if the BTP messages were related to the application
message(s).

Mapping for BTP messages related to application messages: MIME
packaging shall be used. One of the MIME multipart/related parts shall
contain a SOAP:Envelope, whose SOAP:Headers element shall contain
precisely one btp:messages element, containing any BTP messages. Any
BTP CONTEXT in the btp:messages is considered to be related to the
application message(s) in the SOAP:Body, and to also any of the MIME
parts referenced from the SOAP:Body (using the "href" attribute).

Implicit messages: As for soap-http-1.

Faults: As for soap-http-1.

Relationship to other bindings: A BTP address for Superior or Inferior
that has the binding string "soap-http-1" is considered to match one
that has the binding string "soap-attachements-http-1" if the binding
address and additional information fields match.

Limitations on BTP use: None

Other: As for soap-http-1

Example using SOAP + Attachments binding

MIME-Version: 1.0
Content-Type: Multipart/Related; boundary=MIME_boundary; type=text/xml;
        start="someID"

--MIME_boundary
Content-Type: text/xml; charset=UTF-8
Content-ID: someID

<?xml version='1.0' ?>
<soap:Envelope
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
    soap-env:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">

  <soap:Header>

    <btp:messages xmlns:btp="urn:oasis:names:tc:BTP:xml">
      <btp:context superior-type="atom">
         <btp:superior-address>
           <btp:binding>soap-http-1</btp:binding>
           <btp:binding-address>
	        http://client.example.com/soaphandler
	    </btp:binding-address>
         </btp:superior-address>
        <btp:superior-identifier>1001</btp:superior-identifier>
      </btp:context>
    </btp:messages>

  </soap:Header>

  <soap:Body>
    <orderGoods href="cid:anotherID"/>
  </soap:Body>

</soap:Envelope>

--MIME_boundary
Content-Type: text/xml
Content-ID: anotherID

    <ns1:orderGoods xmlns:ns1="http://example.com/2001/Services/xyzgoods">
      <custID>ABC8329045</custID>
      <itemID>224352</itemID>
      <quantity>5</quantity>
    </ns1:orderGoods>


--MIME_boundary--


XML Schema for SOAP Bindings

<?xml version="1.0"?>
<schema targetNamespace="urn:oasis:names:tc:BTP:xml" 
        xmlns="http://www.w3.org/2001/XMLSchema" 
        xmlns:tns="urn:oasis:names:tc:BTP:xml">

    <complexType name="qualifier_type">
        <simpleContent>
            <extension base="string">
                <attribute name="must-be-understood" type="boolean"/>
                <attribute name="to-be-propagated" type="boolean"/>
            </extension>
        </simpleContent>
    </complexType>
    <element name="qualifier" type="tns:qualifier_type"/>
    <element name="qualifiers">
        <complexType>
            <sequence>
                <element ref="tns:qualifier" maxOccurs="unbounded"/>
            </sequence>
        </complexType>
    </element>

    <complexType name="address">
        <sequence>
            <element name="binding-name" type="string"/>
            <element name="binding-address" type="string"/>
            <element name="additional-information" type="string" minOccurs="0"/>
        </sequence>
    </complexType>
            
    <simpleType name="identifier">      
      <restriction base="string">
       <pattern value="([0-9,A-Z])*"/>
      </restriction>
    </simpleType>

    <simpleType name="superior-type">
        <restriction base="string">
            <enumeration value="cohesion"/>
            <enumeration value="atom"/>
        </restriction>
    </simpleType>

    <simpleType name="transaction-type">
        <restriction base="string">
            <enumeration value="cohesion"/>
            <enumeration value="atom"/>
        </restriction>
    </simpleType>


    <element name="context">
        <complexType>
            <sequence>
                <element name="superior-address" type="tns:address" maxOccurs="unbounded"/>
                <element name="superior-identifier" type="tns:identifier"/>
                <element ref="tns:qualifiers" minOccurs="0"/>
            </sequence>
            <attribute name="id" type="ID" use="optional"/>
            <attribute name="superior-type" type="tns:superior-type" use="required"/>
        </complexType>
    </element>

    <element name="context-reply">
        <complexType>
            <sequence>
                <element name="superior-address" type="tns:address" maxOccurs="unbounded"/>
                <element name="superior-identifier" type="tns:identifier"/>
                <element name="completion-status">
                    <simpleType>
                        <restriction base="string">
                            <enumeration value="completed"/>
                            <enumeration value="related"/>
                            <enumeration value="repudiated"/>
                        </restriction>
                    </simpleType>
                </element>
                <element ref="tns:qualifiers" minOccurs="0"/>
            </sequence>
            <attribute name="id" type="ID"/>
            <attribute name="superior-type" type="tns:superior-type" use="required"/>
        </complexType>
    </element>

    <element name="begin">
        <complexType>
            <sequence>
                <element name="target-additional-information" type="string"/>
                <element name="reply-address" type="tns:address"/>
                <element ref="tns:qualifiers" minOccurs="0"/>
            </sequence>
            <attribute name="id" type="ID"/>
            <attribute name="transaction-type" type="tns:superior-type" use="required"/>
        </complexType>
    </element>

    <element name="begun">
        <complexType>
            <sequence>
                <element name="target-additional-information" type="string"/>
                <element name="decider-address" type="tns:address" minOccurs="0"/>
                <element name="transaction-identifier" type="tns:identifier" minOccurs="0"/>
                <element name="inferior-handle" type="tns:identifier" minOccurs="0"/>
                <element name="inferior-address" type="tns:address" minOccurs="0"/>
                <element ref="tns:qualifiers" minOccurs="0"/>
            </sequence>
            <attribute name="id" type="ID"/>
            <attribute name="transaction-type" type="tns:superior-type" use="required"/>
        </complexType>
    </element>

    <element name="enrol">
        <complexType>
            <sequence>
                <element name="target-additional-information" type="string"/>
                <element name="superior-identifier" type="tns:identifier"/>
                <element name="reply-address" type="tns:address" minOccurs="0"/>
                <element name="inferior-address" type="tns:address" minOccurs="1" maxOccurs="unbounded"/>
                <element name="inferior-identifier" type="tns:identifier"/>
                <element ref="tns:qualifiers" minOccurs="0"/>
            </sequence>
            <attribute name="id" type="ID"/>
            <attribute name="reply-requested" type="boolean"/>
        </complexType>
    </element>


    <element name="enrolled">
        <complexType>
            <sequence>
                <element name="target-additional-information" type="string"/>
                <element name="inferior-identifier" type="tns:identifier"/>
                <element name="inferior-handle" type="tns:identifier" minOccurs="0"/>
                <element ref="tns:qualifiers" minOccurs="0"/>
            </sequence>
            <attribute name="id" type="ID"/>
        </complexType>
    </element>

    <element name="resign">
        <complexType>
            <sequence>
                <element name="target-additional-information" type="string"/>
                <element name="superior-identifier" type="tns:identifier"/>
                <element name="inferior-address" type="tns:address" minOccurs="1" maxOccurs="unbounded"/>
                <element name="inferior-identifier" type="tns:identifier"/>
                <element ref="tns:qualifiers" minOccurs="0"/>
            </sequence>
            <attribute name="id" type="ID"/>
            <attribute name="response-requested" type="boolean"/>
        </complexType>
    </element>
    
    <element name="resigned">
        <complexType>
            <sequence>
                <element name="target-additional-information" type="string"/>
                <element name="inferior-identifier" type="tns:identifier"/>
                <element ref="tns:qualifiers" minOccurs="0"/>
            </sequence>
            <attribute name="id" type="ID"/>
        </complexType>
    </element>
    
    <element name="prepare">
        <complexType>
            <sequence>
                <element name="target-additional-information" type="string"/>
                <element name="inferior-identifier" type="tns:identifier" minOccurs="0"/>
                <element name="reply-address" type="tns:address" minOccurs="0"/>
                <element name="transaction-identifier" type="tns:identifier" minOccurs="0"/>
                <element name="inferiors-list" minOccurs="0">
                    <complexType>
                        <sequence>
                            <element name="inferior-handle" type="tns:identifier" maxOccurs="unbounded"/>
                        </sequence>
                    </complexType>
                </element>
                <element ref="tns:qualifiers" minOccurs="0"/>
            </sequence>
            <attribute name="id" type="ID"/>
        </complexType>
    </element>

    <element name="prepared">
        <complexType>
            <sequence>
                <element name="target-additional-information" type="string"/>
                <element name="superior-identifier" type="tns:identifier"/>
                <element name="inferior-address" type="tns:address" maxOccurs="unbounded"/>
                <element name="inferior-identifier" type="tns:identifier"/>
                <element ref="tns:qualifiers" minOccurs="0"/>
            </sequence>
            <attribute name="id" type="ID"/>
            <attribute name="default-is-cancel" type="boolean"/>
        </complexType>
    </element>
    
    <element name="confirm">
        <complexType>
            <sequence>
                <element name="target-additional-information" type="string"/>
                <element name="inferior-identifier" type="tns:identifier"/>
                <element ref="tns:qualifiers" minOccurs="0"/>
            </sequence>
            <attribute name="id" type="ID"/>
        </complexType>
    </element>
    
    <element name="confirmed">
        <complexType>
            <sequence>
                <element name="target-additional-information" type="string"/>
                <element name="superior-identifier" type="tns:identifier"/>
                <element name="inferior-address" type="tns:address" minOccurs="0"/>
                <element name="inferior-identifier" type="tns:identifier" minOccurs="0"/>
                <element name="decider-address" type="tns:address" minOccurs="0"/>
                <element name="transaction-identifier" type="tns:identifier" minOccurs="0"/>
                <element ref="tns:qualifiers" minOccurs="0"/>
            </sequence>
            <attribute name="id" type="ID"/>
            <attribute name="confirmed-received" type="boolean"/>
        </complexType>
    </element>

    <element name="cancel">
        <complexType>
            <sequence>
                <element name="target-additional-information" type="string"/>
                <element name="inferior-identifier" type="tns:identifier" minOccurs="0"/>
                <element name="reply-address" type="tns:address" minOccurs="0"/>
                <element name="transaction-identifier" type="tns:identifier" minOccurs="0"/>
                <element name="decider-address" type="tns:address" minOccurs="0"/>
                <element name="transaction-identifier" type="tns:identifier" minOccurs="0"/>
                <element name="inferiors-list" minOccurs="0">
                    <complexType>
                        <sequence>
                            <element name="inferior-handle" type="tns:identifier" maxOccurs="unbounded"/>
                        </sequence>
                    </complexType>
                </element>
                <element ref="tns:qualifiers" minOccurs="0"/>
            </sequence>
            <attribute name="id" type="ID"/>
        </complexType>
    </element>

    <element name="cancelled">
        <complexType>
            <sequence>
                <element name="target-additional-information" type="string"/>
                <element name="superior-identifier" type="tns:identifier"/>
                <element name="inferior-address" type="tns:address" maxOccurs="unbounded"/>
                <element name="inferior-identifier" type="tns:identifier" minOccurs="0"/>
                <element name="decider-address" type="tns:address" minOccurs="0"/>
                <element name="transaction-identifier" type="tns:identifier" minOccurs="0"/>
                <element ref="tns:qualifiers" minOccurs="0"/>
            </sequence>
            <attribute name="id" type="ID"/>
        </complexType>
    </element>
    
    <element name="hazard">
        <complexType>
            <sequence>
                <element name="target-additional-information" type="string"/>
                <element name="superior-identifier" type="tns:identifier"/>
                <element name="inferior-address" type="tns:address" maxOccurs="unbounded"/>
                <element name="inferior-identifier" type="tns:identifier"/>
                <element ref="tns:qualifiers" minOccurs="0"/>
            </sequence>
            <attribute name="id" type="ID"/>
        </complexType>
    </element>
    
    <element name="contradiction">
        <complexType>
            <sequence>
                <element name="target-additional-information" type="string"/>
                <element name="inferior-identifier" type="tns:identifier"/>
                <element ref="tns:qualifiers" minOccurs="0"/>
            </sequence>
            <attribute name="id" type="ID"/>
        </complexType>
    </element>
    
    <element name="superior-state">
        <complexType>
            <sequence>
                <element name="target-additional-information" type="string"/>
                <element name="inferior-identifier" type="tns:identifier"/>
                <element name="status">
                    <simpleType>
                        <restriction base="string">
                            <enumeration value="active"/>
                            <enumeration value="prepared-received"/>
                            <enumeration value="inaccessible"/>
                            <enumeration value="unknown"/>
                        </restriction>
                    </simpleType>
                </element>
                <element ref="tns:qualifiers" minOccurs="0"/>
            </sequence>
            <attribute name="id" type="ID"/>
            <attribute name="reply-requested" type="boolean"/>
        </complexType>
    </element>  

    <element name="inferior-state">
        <complexType>
            <sequence>
                <element name="target-additional-information" type="string"/>
                <element name="superior-identifier" type="tns:identifier"/>
                <element name="inferior-address" type="tns:address" maxOccurs="unbounded"/>
                <element name="inferior-identifier" type="tns:identifier"/>
                <element name="status">
                    <simpleType>
                        <restriction base="string">
                            <enumeration value="active"/>
                            <enumeration value="prepared-received"/>
                            <enumeration value="inaccessible"/>
                            <enumeration value="unknown"/>
                        </restriction>
                    </simpleType>
                </element>
                <element ref="tns:qualifiers" minOccurs="0"/>
            </sequence>
            <attribute name="id" type="ID"/>
            <attribute name="reply-requested" type="boolean"/>
        </complexType>
    </element>  
    
    <element name="confirm-one-phase">
        <complexType>
            <sequence>
                <element name="target-additional-information" type="string"/>
                <element name="inferior-identifier" type="tns:identifier"/>
                <element ref="tns:qualifiers" minOccurs="0"/>
            </sequence>
            <attribute name="id" type="ID"/>
            <attribute name="report-hazard" type="boolean"/>
        </complexType>
    </element>
    
    <element name="request-confirm">
        <complexType>
            <sequence>
                <element name="target-additional-information" type="string"/>
                <element name="reply-address" type="tns:address"/>
                <element name="transaction-identifier" type="tns:identifier"/>
                <element name="inferiors-list" minOccurs="0">
                    <complexType>
                        <sequence>
                            <element name="inferior-handle" type="tns:identifier" maxOccurs="unbounded"/>
                        </sequence>
                    </complexType>
                </element>
                <element ref="tns:qualifiers" minOccurs="0"/>
            </sequence>
            <attribute name="id" type="ID"/>
            <attribute name="report-hazard" type="boolean"/>
        </complexType>
    </element>
    
    <element name="request-statuses">
        <complexType>
            <sequence>
                <element name="target-additional-information" type="string"/>
                <element name="reply-address" type="tns:address"/>
                <element name="transaction-identifier" type="tns:identifier"/>
                <element name="inferiors-list" minOccurs="0">
                    <complexType>
                        <sequence>
                            <element name="inferior-handle" type="tns:identifier" maxOccurs="unbounded"/>
                        </sequence>
                    </complexType>
                </element>
                <element ref="tns:qualifiers" minOccurs="0"/>
            </sequence>
            <attribute name="id" type="ID"/>
        </complexType>
    </element>
    
    <element name="inferior-statuses">
        <complexType>
            <sequence>
                <element name="target-additional-information" type="string"/>
                <element name="decider-address" type="tns:address"/>
                <element name="transaction-identifier" type="tns:identifier"/>
                <element name="status-list">
                  <complexType>
                    <sequence>
                      <element name="status-item" maxOccurs="unbounded">
                    <complexType>
                      <sequence>
                        <element name="inferior-handle" type="tns:identifier"/>
                        <element name="status">
                          <simpleType>
                        <restriction base="string">
                            <enumeration value="active"/>
                            <enumeration value="resigned"/>
                            <enumeration value="preparing"/>
                            <enumeration value="prepared"/>
                            <enumeration value="autonomously-confirmed"/>
                            <enumeration value="autonomously-cancelled"/>
                            <enumeration value="confirming"/>
                            <enumeration value="confirmed"/>
                            <enumeration value="cancelling"/>
                            <enumeration value="cancelled"/>
                            <enumeration value="cancel-contradiction"/>
                            <enumeration value="confirm-contradiction"/>
                            <enumeration value="hazard"/>
                        </restriction>
                          </simpleType>
                        </element>
                        <element ref="tns:qualifiers" minOccurs="0"/>
                      </sequence>
                    </complexType>
                      </element>
                    </sequence>
                  </complexType>
                </element>
                <element ref="tns:qualifiers" minOccurs="0"/>
            </sequence>
            <attribute name="id" type="ID"/>
        </complexType>
    </element>
    
    <element name="request-status">
        <complexType>
            <sequence>
                <element name="target-additional-information" type="string"/>
                <element name="reply-address" type="tns:address"/>
                <element name="inferior-identifier" type="tns:identifier" minOccurs="0"/>
                <element name="transaction-identifier" type="tns:identifier" minOccurs="0"/>
                <element ref="tns:qualifiers" minOccurs="0"/>
            </sequence>
            <attribute name="id" type="ID"/>
        </complexType>
    </element>  

    <element name="status">
        <complexType>
            <sequence>
                <element name="target-additional-information" type="string"/>
                <element name="inferior-address" type="tns:address" minOccurs="0"/>
                <element name="inferior-identifier" type="tns:identifier" minOccurs="0"/>
                <element name="decider-address" type="tns:address" minOccurs="0"/>
                <element name="transaction-identifier" type="tns:identifier" minOccurs="0"/>
                <element name="status-value">
                      <simpleType>
                    <restriction base="string">
                        <enumeration value="created"/>
                        <enumeration value="enrolling"/>
                        <enumeration value="active"/>
                        <enumeration value="resigning"/>
                        <enumeration value="resigned"/>
                        <enumeration value="preparing"/>
                        <enumeration value="prepared"/>
                        <enumeration value="confirming"/>
                        <enumeration value="confirmed"/>
                        <enumeration value="cancelling"/>
                        <enumeration value="cancelled"/>
                        <enumeration value="cancel-contradiction"/>
                        <enumeration value="confirm-contradiction"/>
                        <enumeration value="hazard"/>
                        <enumeration value="contradicted"/>
                        <enumeration value="unknown"/>
                        <enumeration value="inaccessible"/>
                    </restriction>
                      </simpleType>
                </element>
                <element ref="tns:qualifiers" minOccurs="0"/>
            </sequence>
            <attribute name="id" type="ID"/>
        </complexType>
    </element>
    
    <element name="redirect">
        <complexType>
            <sequence>
                <element name="target-additional-information" type="string"/>
                <element name="superior-identifier" type="tns:identifier" minOccurs="0"/>
                <element name="inferior-identifier" type="tns:identifier"/>
                <element name="old-address" type="tns:address" maxOccurs="unbounded"/>
                <element name="new-address" type="tns:address" maxOccurs="unbounded"/>
                <element ref="tns:qualifiers" minOccurs="0"/>
            </sequence>
            <attribute name="id" type="ID"/>
        </complexType>
    </element>

    <element name="fault">
        <complexType>
            <sequence>
                <element name="target-additional-information" type="string"/>
                <element name="superior-identifier" type="tns:identifier" minOccurs="0"/>
                <element name="inferior-identifier" type="tns:identifier" minOccurs="0"/>
                <element name="fault-type" type="string"/>
                <element name="fault-data" type="anyType" minOccurs="0"/>
                <element ref="tns:qualifiers" minOccurs="0"/>
            </sequence>
            <attribute name="id" type="ID"/>
        </complexType>
    </element>
 
</schema>