- From: Marc Hadley via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 19 Jul 2005 20:08:18 +0000
- To: public-ws-addressing-eds@w3.org
Update of /sources/public/2004/ws/addressing
In directory hutz:/tmp/cvs-serv5227
Modified Files:
ws-addr-soap.xml
Log Message:
Added partial resolution to issue lc76 - added new sections for standard detail items and grouped faults in new section
Index: ws-addr-soap.xml
===================================================================
RCS file: /sources/public/2004/ws/addressing/ws-addr-soap.xml,v
retrieving revision 1.82
retrieving revision 1.83
diff -C2 -d -r1.82 -r1.83
*** ws-addr-soap.xml 19 Jul 2005 18:46:56 -0000 1.82
--- ws-addr-soap.xml 19 Jul 2005 20:08:16 -0000 1.83
***************
*** 427,432 ****
<div1 id="faults">
<head>Faults</head>
! <p>The faults defined in this section are generated if the condition stated in the preamble in
! each subsection is met.</p>
<p>Endpoints compliant with this specification MUST include the required message addressing
properties serialized as SOAP headers in generated fault messages. Fault messages are
--- 427,432 ----
<div1 id="faults">
<head>Faults</head>
! <p>The faults defined in this section are generated if the condition stated in the
! preamble in each subsection is met.</p>
<p>Endpoints compliant with this specification MUST include the required message addressing
properties serialized as SOAP headers in generated fault messages. Fault messages are
***************
*** 573,686 ****
</example>
</div2>
! <div2 id="invalidmapfault">
! <head> Invalid Addressing Header</head>
! <p>A header representing a WS-Addressing 1.0 Message Addressing Property is invalid and
! cannot be processed. The validity failure can be either structural or semantic, e.g. a
! [destination] that is not an IRI or a [relationship] to a [message id] that was never
! issued.</p>
! <p> [Code] a QName representing the value S:Sender</p>
! <p> [Subcode] a QName representing the value wsa:InvalidAddressingHeader</p>
! <p> [Reason] the string: "A header representing a Message Addressing Property is not valid
! and the message cannot be processed" </p>
! <p> [Detail] a <wsa:InvalidAddressingHeader> element</p>
! <p> The following describes the <wsa:InvalidAddressingHeader> element:</p>
! <glist>
! <gitem>
! <label>/wsa:InvalidAddressingHeader</label>
! <def>
! <p>A QName representing the name of the root element of the invalid header block</p>
! </def>
! </gitem>
! <gitem>
! <label>/wsa:InvalidAddressingHeader/@{any}</label>
! <def>
! <p>Optional extensibility attributes that do not affect processing.</p>
! </def>
! </gitem>
! </glist>
! </div2>
! <div2 id="missingmapfault">
! <head> Message Addressing Header Required</head>
! <p>A required header representing a Message Addressing Property is absent.</p>
! <p> [Code] a QName representing the value S:Sender</p>
! <p> [Subcode] a QName representing the value wsa:MessageAddressingHeaderRequired</p>
! <p> [Reason] the string: "A required header representing a Message Addressing Property is
! not present"</p>
! <p> [Detail] a <wsa:MessageAddressingHeaderRequired> element</p>
! <p> The following describes the <wsa:MessageAddressingHeaderRequired> element:</p>
! <glist>
! <gitem>
! <label>/wsa:MessageAddressingHeaderRequired</label>
! <def>
! <p>A QName representing the name of the missing header element</p>
! </def>
! </gitem>
! <gitem>
! <label>/wsa:MessageAddressingHeaderRequired/@{any}</label>
! <def>
! <p>Optional extensibility attributes that do not affect processing.</p>
! </def>
! </gitem>
! </glist>
! </div2>
! <div2 id="destinationfault">
! <head> Destination Unreachable</head>
! <p>The endpoint identified by the value of [destination] property cannot be reached.</p>
! <p> [Code] a QName representing the value S:Sender</p>
! <p> [Subcode] a QName representing the value wsa:DestinationUnreachable</p>
! <p> [Reason] the string: "No route can be determined to reach [destination]"</p>
! <p> [Detail] (empty)</p>
! </div2>
! <div2 id="actionfault">
! <head> Action Not Supported</head>
! <p>The [action] property in the message is not supported at this endpoint.</p>
! <p> [Code] a QName representing the value S:Sender</p>
! <p> [Subcode] a QName representing the value wsa:ActionNotSupported</p>
! <p> [Reason] the string: "The [action] cannot be processed at the receiver"</p>
! <p> [Detail] a <wsa:ActionNotSupported> element</p>
! <p> The following describes the <wsa:ActionNotSupported> element:</p>
! <glist>
! <gitem>
! <label>/wsa:ActionNotSupported</label>
! <def>
! <p>The value of the wsa:Action header block</p>
! </def>
! </gitem>
! <gitem>
! <label>/wsa:ActionNotSupported/@{any}</label>
! <def>
! <p>Optional extensibility attributes that do not affect processing.</p>
! </def>
! </gitem>
! </glist>
</div2>
! <div2 id="unavailablefault">
! <head> Endpoint Unavailable</head>
! <p>The endpoint is unable to process the message at this time either due to some transient
! issue or a permanent failure. </p>
! <p>The endpoint may optionally include a RetryAfter parameter in the detail. The source
! SHOULD NOT retransmit the message until this duration has passed.</p>
! <p> [Code] a QName representing the value S:Receiver</p>
! <p> [Subcode] a QName representing the value wsa:EndpointUnavailable</p>
! <p> [Reason] the string "The endpoint is unable to process the message at this time"</p>
! <p> [Detail] a <wsa:RetryAfter> element</p>
! <p> The following describes the <wsa:RetryAfter> element:</p>
! <glist>
! <gitem>
! <label>/wsa:RetryAfter</label>
! <def>
! <p>This element (whose content is of type xs:unsignedLong) is a suggested minimum
! duration in milliseconds to wait before retransmitting the message. Omission of this
! element indicates that a retry is never likely to succeed.</p>
! </def>
! </gitem>
! <gitem>
! <label>/wsa:RetryAfter/@{any}</label>
! <def>
! <p>Optional extensibility attributes that do not affect processing.</p>
! </def>
! </gitem>
! </glist>
</div2>
</div1>
<div1 id="securityconsiderations">
--- 573,755 ----
</example>
</div2>
!
! <div2>
! <head>Fault Detail Elements</head>
! <p>The following subsections define a set of elements used to convey additional information
! in the faults described in <specref ref="soapfaults"/>.</p>
! <div3>
! <head>Problem Header</head>
! <p> The following describes the <wsa:ProblemHeader> element:</p>
! <glist>
! <gitem>
! <label>/wsa:ProblemHeader</label>
! <def>
! <p>The root element of the invalid header block, all descendants of the root element
! are also included.</p>
! </def>
! </gitem>
! <gitem>
! <label>/wsa:ProblemHeader/@{any}</label>
! <def>
! <p>Optional extensibility attributes that do not affect processing.</p>
! </def>
! </gitem>
! </glist>
! </div3>
! <div3>
! <head>Problem Header QName</head>
! <p> The following describes the <wsa:ProblemHeaderQName> element:</p>
! <glist>
! <gitem>
! <label>/wsa:ProblemHeaderQName</label>
! <def>
! <p>A QName representing the name of the root element of the problem header block.</p>
! </def>
! </gitem>
! <gitem>
! <label>/wsa:ProblemHeaderQName/@{any}</label>
! <def>
! <p>Optional extensibility attributes that do not affect processing.</p>
! </def>
! </gitem>
! </glist>
! </div3>
! <div3>
! <head>Problem IRI</head>
! <p> The following describes the <wsa:ProblemIRI> element:</p>
! <glist>
! <gitem>
! <label>/wsa:ProblemIRI</label>
! <def>
! <p>The IRI that caused the problem.</p>
! </def>
! </gitem>
! <gitem>
! <label>/wsa:ProblemIRI/@{any}</label>
! <def>
! <p>Optional extensibility attributes that do not affect processing.</p>
! </def>
! </gitem>
! </glist>
! </div3>
! <div3>
! <head>Problem Action</head>
! </div3>
</div2>
!
! <div2 id="soapfaults">
! <head>Predefined Faults</head>
! <div3 id="invalidmapfault">
! <head> Invalid Addressing Header</head>
! <p>A header representing a WS-Addressing 1.0 Message Addressing Property is invalid and
! cannot be processed. The validity failure can be either structural or semantic, e.g. a
! [destination] that is not an IRI or a [relationship] to a [message id] that was never
! issued.</p>
! <p> [Code] a QName representing the value S:Sender</p>
! <p> [Subcode] a QName representing the value wsa:InvalidAddressingHeader</p>
! <p> [Reason] the string: "A header representing a Message Addressing Property is not valid
! and the message cannot be processed" </p>
! <p> [Detail] a <wsa:InvalidAddressingHeader> element</p>
! <p> The following describes the <wsa:InvalidAddressingHeader> element:</p>
! <glist>
! <gitem>
! <label>/wsa:InvalidAddressingHeader</label>
! <def>
! <p>A QName representing the name of the root element of the invalid header block</p>
! </def>
! </gitem>
! <gitem>
! <label>/wsa:InvalidAddressingHeader/@{any}</label>
! <def>
! <p>Optional extensibility attributes that do not affect processing.</p>
! </def>
! </gitem>
! </glist>
! </div3>
! <div3 id="missingmapfault">
! <head> Message Addressing Header Required</head>
! <p>A required header representing a Message Addressing Property is absent.</p>
! <p> [Code] a QName representing the value S:Sender</p>
! <p> [Subcode] a QName representing the value wsa:MessageAddressingHeaderRequired</p>
! <p> [Reason] the string: "A required header representing a Message Addressing Property is
! not present"</p>
! <p> [Detail] a <wsa:MessageAddressingHeaderRequired> element</p>
! <p> The following describes the <wsa:MessageAddressingHeaderRequired> element:</p>
! <glist>
! <gitem>
! <label>/wsa:MessageAddressingHeaderRequired</label>
! <def>
! <p>A QName representing the name of the missing header element</p>
! </def>
! </gitem>
! <gitem>
! <label>/wsa:MessageAddressingHeaderRequired/@{any}</label>
! <def>
! <p>Optional extensibility attributes that do not affect processing.</p>
! </def>
! </gitem>
! </glist>
! </div3>
! <div3 id="destinationfault">
! <head> Destination Unreachable</head>
! <p>The endpoint identified by the value of [destination] property cannot be reached.</p>
! <p> [Code] a QName representing the value S:Sender</p>
! <p> [Subcode] a QName representing the value wsa:DestinationUnreachable</p>
! <p> [Reason] the string: "No route can be determined to reach [destination]"</p>
! <p> [Detail] (empty)</p>
! </div3>
! <div3 id="actionfault">
! <head> Action Not Supported</head>
! <p>The [action] property in the message is not supported at this endpoint.</p>
! <p> [Code] a QName representing the value S:Sender</p>
! <p> [Subcode] a QName representing the value wsa:ActionNotSupported</p>
! <p> [Reason] the string: "The [action] cannot be processed at the receiver"</p>
! <p> [Detail] a <wsa:ActionNotSupported> element</p>
! <p> The following describes the <wsa:ActionNotSupported> element:</p>
! <glist>
! <gitem>
! <label>/wsa:ActionNotSupported</label>
! <def>
! <p>The value of the wsa:Action header block</p>
! </def>
! </gitem>
! <gitem>
! <label>/wsa:ActionNotSupported/@{any}</label>
! <def>
! <p>Optional extensibility attributes that do not affect processing.</p>
! </def>
! </gitem>
! </glist>
! </div3>
! <div3 id="unavailablefault">
! <head> Endpoint Unavailable</head>
! <p>The endpoint is unable to process the message at this time either due to some transient
! issue or a permanent failure. </p>
! <p>The endpoint may optionally include a RetryAfter parameter in the detail. The source
! SHOULD NOT retransmit the message until this duration has passed.</p>
! <p> [Code] a QName representing the value S:Receiver</p>
! <p> [Subcode] a QName representing the value wsa:EndpointUnavailable</p>
! <p> [Reason] the string "The endpoint is unable to process the message at this time"</p>
! <p> [Detail] a <wsa:RetryAfter> element</p>
! <p> The following describes the <wsa:RetryAfter> element:</p>
! <glist>
! <gitem>
! <label>/wsa:RetryAfter</label>
! <def>
! <p>This element (whose content is of type xs:unsignedLong) is a suggested minimum
! duration in milliseconds to wait before retransmitting the message. Omission of this
! element indicates that a retry is never likely to succeed.</p>
! </def>
! </gitem>
! <gitem>
! <label>/wsa:RetryAfter/@{any}</label>
! <def>
! <p>Optional extensibility attributes that do not affect processing.</p>
! </def>
! </gitem>
! </glist>
! </div3>
</div2>
+
</div1>
<div1 id="securityconsiderations">
Received on Tuesday, 19 July 2005 20:08:24 UTC