[REL-46]Proposal for REL-46

All -

 As per my AI from the last con. call, here is the proposal for
REL-46.

 Issue: As per SOAP 1.1 spec. for Faults (section 4.4), "soap:detail

 MUST NOT be used to carry information about error information
belonging

 to header entries. Detailed error information belonging to header
entries

 MUST be carried within header entries". Unfortunately, this is
not the case

 with the initial WS-Reliability spec. as all WS-Reliability specific
faults are

 sent in /Body/detail. [[Actually, this is more an outstanding
issue. It was in

 the Issues list at one point, but it was removed when Issues
list was converted

 to Futures list as this is too low-level (technically) to fit
into the former. ]]

 

 Porposal:

 When a Fault occurs, we will be still sending the SOAP:Fault,
however, without

 the /soap/Fault/detail sub-element.  Instead, we will be
sending the RM specific

 fault code as a Header element. So we will be having an additional
Header

 element called RMFault. The schema for RMFault will be the same
as the

 earlier  rmFault.

 Ex:

 New changes in bold:

<SOAP:Envelope>

   <SOAP:Headers>

     <rm:MessageHeader>

        ...

     </rm:MessageHeader>

     <rm:RMResponse>

         ...

     </rm:RMResponse>

      <rm:RMFault xmlns:rm=”http://schemas.fujitsu.com/rm”>

           <rm:faultcode>rm:InvalidMessageHeader</rm:faultcode>

       </rm:RMFault>

   </SOAP:Headers>

   <SOAP:Body>

    <SOAP:Fault>

      <faultcode>SOAP:Client</faultcode>

      <faultstring>Error in the Message
Header sent from Server</faultstring>

      <!-- <detail> ... </detail>
element will NOT be there -->

   </SOAP:Fault>

 <SOAP:Envelope>

 Schema for RMFault Header element:

   <xsd:element name="RMFault">

     <xsd:complexType>

        <xsd:sequence>

            
<xsd:element name="faultcode" type="xsd:QName" />

         </xsd:sequence>

     </xsd:complexType>

   </xsd:element>

 

 Note that there  is no 'soap:mustUnderstand' attribute unlike
some

 other RM Headers, as this Header is for informational purposes.

 Comments?

 -Sunil