- From: Doug Davis via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 07 Apr 2009 13:09:19 +0000
- To: public-ws-resource-access-notifications@w3.org
Update of /w3ccvs/WWW/2002/ws/ra/edcopies
In directory hutz:/tmp/cvs-serv27500
Modified Files:
wsenum.html wsenum.xml
Log Message:
6499
Index: wsenum.html
===================================================================
RCS file: /w3ccvs/WWW/2002/ws/ra/edcopies/wsenum.html,v
retrieving revision 1.29
retrieving revision 1.30
diff -u -d -r1.29 -r1.30
--- wsenum.html 24 Mar 2009 21:19:38 -0000 1.29
+++ wsenum.html 7 Apr 2009 13:09:16 -0000 1.30
@@ -55,9 +55,18 @@
3.4 <a href="#GetStatus">GetStatus</a><br/>
3.5 <a href="#Release">Release</a><br/>
3.6 <a href="#EnumerationEnd">EnumerationEnd</a><br/>
-4 <a href="#Security">Security Considerations</a><br/>
-5 <a href="#acks">Acknowledgements</a><br/>
-6 <a href="#refs">References</a><br/>
+4 <a href="#Faults">Faults</a><br/>
+ 4.1 <a href="#InvalidExpirationTime">InvalidExpirationTime</a><br/>
+ 4.2 <a href="#UnsupportedExpirationTime">UnsupportedExpirationTime</a><br/>
+ 4.3 <a href="#FilteringNotSupported">FilteringNotSupported</a><br/>
+ 4.4 <a href="#FilterDialectRequestedUnavailable">FilterDialectRequestedUnavailable</a><br/>
+ 4.5 <a href="#CannotProcessFilter">CannotProcessFilter</a><br/>
+ 4.6 <a href="#InvalidEnumerationContext">InvalidEnumerationContext</a><br/>
+ 4.7 <a href="#TimedOut">TimedOut</a><br/>
+ 4.8 <a href="#UnableToRenew">UnableToRenew</a><br/>
+5 <a href="#Security">Security Considerations</a><br/>
+6 <a href="#acks">Acknowledgements</a><br/>
+7 <a href="#refs">References</a><br/>
</p>
<h3><a name="appendices" id="appendices"/>Appendices</h3><p class="toc">A <a href="#schema">XML Schema</a><br/>
B <a href="#WSDL">WSDL</a><br/>
@@ -365,45 +374,17 @@
If the expiration time is either a zero
duration or a specific time that occurs in the past according to
the data source, then the request MUST fail, and the data source
- MAY generate a fault indicating that an invalid expiration time was
- requested.
+ MAY generate a wsen:InvalidExpirationTime fault indicating that an
+ invalid expiration time was requested.
</p><p>
- The SOAP 1.1 binding of this fault
- is:
- </p><ul><li><p>
- faultcode = s11:Client
- </p></li><li><p>
- faultstring = e.g., "invalid expiration time"
- </p></li><li><p>
- The SOAP 1.2 binding of this fault is:
- </p><p>
- s12:Code/s12:Value = s12:Sender
- </p></li><li><p>
- s12:Code/s12:Subcode/s12:Value = wsen:InvalidExpirationTime
- </p></li><li><p>
- s12:Reason/s12:Text = e.g., "invalid expiration time"
- </p></li></ul><p>
Some data sources may not have a "wall time"
clock available, and so are able only to accept durations as
expirations. If such a source receives an Enumerate request
containing a specific time expiration, then the request MUST fail;
- if so, the data source SHOULD generate a fault indicating that an
+ if so, the data source SHOULD generate a
+ wsen:UnsupportedExpirationTime fault indicating that an
unsupported expiration type was requested.
- </p><p>
- The SOAP 1.1 binding of this fault is:
- </p><ul><li><p>
- faultcode = s11:Client
- </p></li><li><p>
- faultstring = e.g., "unsupported expiration type"
- </p></li><li><p>
- The SOAP 1.2 binding of this fault is:
- </p></li><li><p>
- s12:Code/s12:Value = s12:Sender
- </p></li><li><p>
- s12:Code/s12:Subcode/s12:Value = wsen:UnsupportedExpirationType
- </p></li><li><p>
- s12:Reason/s12:Text = e.g., "unsupported expiration type"
- </p></li></ul></dd><dt class="label"><b>[Body]</b>/wsen:Enumerate/wsen:Filter </dt><dd><p>
+ </p></dd><dt class="label"><b>[Body]</b>/wsen:Enumerate/wsen:Filter </dt><dd><p>
This optional element contains a Boolean
predicate in some dialect (see <b>[<a href="#Dialect">[Body]/wsen:Enumerate/wsen:Filter/@Dialect </a>]</b>)
that all elements of
@@ -415,57 +396,18 @@
</p><p>
If the data source does not support
filtering, the request MUST fail, and the data source MAY generate
- a SOAP fault as follows:
- </p><p> SOAP 1.1: </p><ul><li><p>
- faultcode = s11:Client
- </p></li><li><p>
- faultstring = e.g., "filtering not supported"
- </p></li></ul><p> SOAP 1.2: </p><ul><li><p>
- s12:Code/s12:Value = s12:Sender
- </p></li><li><p>
- s12:Code/s12:Subcode/s12:Value = wsen:FilteringNotSupported
- </p></li><li><p>
- s12:Reason/s12:Text = e.g., "filtering not supported"
- </p></li></ul><p>
+ a wsen:FilteringNotSupported fault.
+ </p><p>
If the data source supports filtering but
cannot honor the requested filter dialect, the request MUST fail,
- and the data source MAY generate a SOAP fault as
- follows:
- </p><p> SOAP 1.1: </p><ul><li><p>
- faultcode = s11:Client
- </p></li><li><p>
- faultstring = e.g., "filter dialect requested unavailable"
- </p></li><li><p>
- [optional]
- detail/wsen:SupportedDialect = repeating; one per filter dialect
- supported by the container
- </p></li></ul><p> SOAP 1.2: </p><ul><li><p>
- s12:Code/s12:Value = s12:Sender
- </p></li><li><p>
- s12:Code/s12:Subcode/s12:Value =
- wsen:FilterDialectRequestedUnavailable
- </p></li><li><p>
- s12:Reason/s12:Text = e.g., "filter dialect requested unavailable"
- </p></li><li><p>
- [optional]
- s12:Detail/wsen:SupportedDialect = repeating; one per filter
- dialect supported by the container
- </p></li></ul><p>
+ and the data source MAY generate a
+ wsen:FilterDialectRequestUnavailable fault.
+ </p><p>
If the data source supports filtering and the
requested dialect but cannot process the requested filter content,
- the request MUST fail, and the data source MAY generate a SOAP
- fault as follows:
- </p><p> SOAP 1.1: </p><ul><li><p>
- faultcode = s11:Client
- </p></li><li><p>
- faultstring = e.g., "cannot filter as requested"
- </p></li></ul><p> SOAP 1.2: </p><ul><li><p>
- s12:Code/s12:Value = s12:Sender
- </p></li><li><p>
- s12:Code/s12:Subcode/s12:Value = wsen:CannotProcessFilter
- </p></li><li><p>
- s12:Reason/s12:Text = e.g., "cannot filter as requested"
- </p></li></ul></dd><dt class="label"><a name="Dialect" id="Dialect"/><b>[Body]</b>/wsen:Enumerate/wsen:Filter/@Dialect </dt><dd><p>
+ the request MUST fail, and the data source MAY generate a
+ wsen:CannotProcessFilter fault.
+ </p></dd><dt class="label"><a name="Dialect" id="Dialect"/><b>[Body]</b>/wsen:Enumerate/wsen:Filter/@Dialect </dt><dd><p>
Implied value is
"http://www.w3.org/TR/1999/REC-xpath-19991116".
</p><p><b>[Body]</b>/wsen:Enumerate/wsen:Filter/@Dialect="http://www.w3.org/TR/1999/REC-xpath-19991116"
@@ -624,20 +566,8 @@
returned in a Pull response), or because it has been Released, or
because it has expired, or because the data source has had to
invalidate the context, then the data source SHOULD fail the
- request, and MAY generate the following fault:
- </p><p> SOAP 1.1: </p><ul><li><p>
- faultcode = s11:Server
- </p></li><li><p>
- faultstring = <em>text explaining why the enumeration context is
- no longer valid, or</em> "Invalid enumeration context"
- <em>if no additional information is available</em></p></li></ul><p>SOAP 1.2:</p><ul><li><p>
- s:Code/s:Value = s:Receiver
- </p></li><li><p>
- s:Code/s:Subcode/s:Value = wsen:InvalidEnumerationContext
- </p></li><li><p>
- s:Reason/s:Text = <em>text explaining why the enumeration context
- is no longer valid, or</em> "Invalid enumeration context"
- <em>if no additional information is available</em></p></li></ul><p>
+ request, and MAY generate the a wsen:InvalidEnumerationContext fault.
+ </p><p>
Note that the data source may not be able to
determine that an enumeration context is not valid, especially if
all of the state associated with the enumeration is kept in the
@@ -701,20 +631,10 @@
data source may wait as long as it deems necessary (but not longer
than the value of the wsen:MaxTime element, if present) to produce
a message for delivery to the consumer. The data source MUST
- recognize the wsen:MaxTime element and return the following fault
- if no elements are available prior to the request message's
- deadline:
- </p><p> SOAP 1.1: </p><ul><li><p>
- faultcode = s11:Server
- </p></li><li><p>
- faultstring = e.g., "timeout"
- </p></li></ul><p>SOAP 1.2:</p><ul><li><p>
- s:Code/s:Value = s:Receiver
- </p></li><li><p>
- s:Code/s:Subcode/s:Value = wsen:TimedOut
- </p></li><li><p>
- s:Reason/s:Text = e.g., "timeout"
- </p></li></ul><p>
+ recognize the wsen:MaxTime element and return a
+ wsen:TimedOut fault if no elements are available prior to the
+ request message's deadline:
+ </p><p>
Note, however, that this fault SHOULD NOT cause
the enumeration context to become invalid (of course, the data
source may invalidate the enumeration context for other reasons).
@@ -842,7 +762,7 @@
If the consumer does issue a Pull or Release on
an invalid enumeration context, the result is undefined: the data
source MAY ignore the request or MAY return a
- wsen:InvalidEnumerationContext fault, as described above, or MAY
+ wsen:InvalidEnumerationContext fault or MAY
take some other action.
</p></div><div class="div2">
<h3><a name="Renew" id="Renew"/>3.3 Renew</h3><p>
@@ -874,25 +794,7 @@
returned in a Pull response), or because it has been Released, or
because it has expired, or because the data source has had to
invalidate the context, then the data source SHOULD fail the
- request, and MAY generate the following fault:
- </p><p> SOAP 1.1: </p><ul><li><p>
- faultcode = s11:Server
- </p></li><li><p>
- faultstring = <em>text explaining why the enumeration context is
- no longer valid, or</em> "Invalid enumeration context"
- <em>if no additional information is available</em></p></li></ul><p>SOAP 1.2:</p><ul><li><p>
- s:Code/s:Value = s:Receiver
- </p></li><li><p>
- s:Code/s:Subcode/s:Value = wsen:InvalidEnumerationContext
- </p></li><li><p>
- s:Reason/s:Text = <em>text explaining why the enumeration
- context is no longer valid, or</em> "Invalid enumeration
- context" <em>if no additional information is available</em></p></li></ul><p>
- Note that the data source may not be able to
- determine that an enumeration context is not valid, especially if
- all of the state associated with the enumeration is kept in the
- enumeration context and refreshed on every
- PullResponse.
+ request, and MAY generate a wsen:InvalidEnumerationContext fault.
</p></dd></dl><p>
Other components of the outline above are not
further constrained by this specification.
@@ -922,25 +824,9 @@
</p></dd></dl><p>
If the data source chooses not to renew this
enumeration, the request MUST fail, and the data source SHOULD
- generate a fault indicating that the renewal was not
- accepted.
+ generate a wsen:UnableToRenew fault indicating that the
+ renewal was not accepted.
</p><p>
- The SOAP 1.1 binding of this type of fault is:
- </p><ul><li><p>
- faultcode = s11:Server
- </p></li><li><p>
- faultstring = <em>text explaining why the enumeration context cannot
- be renewed, or</em> "data source unable to renew" <em>if no
- additional information is available</em></p></li></ul><p>
- The SOAP 1.2 binding of this type of fault is:
- </p><ul><li><p>
- s12:Code/s12:Value = s12:Receiver
- </p></li><li><p>
- s12:Code/s12:Subcode/s12:Value = wsen:UnableToRenew
- </p></li><li><p>
- s12:Reason/s12:Text = <em>text explaining why the enumeration
- context cannot be renewed, or</em> "data source unable to
- renew" <em>if no additional information is available</em></p></li></ul><p>
Other components of the outline above are not
further constrained by this specification.
</p></div><div class="div2">
@@ -1105,7 +991,115 @@
Other components of the outline above are not
further constrained by this specification.
</p></div></div><div class="div1">
-<h2><a name="Security" id="Security"/>4 Security Considerations</h2><p>
+<h2><a name="Faults" id="Faults"/>4 Faults</h2><p>
+ WS-Enumeration faults MUST include as the <b>[Action]</b> property
+ the following fault action URI:
+ </p><div class="exampleOuter"><div class="exampleInner"><pre>http://www.w3.org/2009/02/ws-enu/fault</pre></div></div><p>
+ The faults defined in this section are generated if the condition
+ stated in the preamble is met. Faults are targeted at a
+ destination endpoint according to the fault handling rules defined
+ in <a href="#AddrCore">[WS-Addressing]</a>.
+ </p><p>
+ The definitions of faults in this section use the following properties:
+ </p><p><b>[Code]</b> The fault code.<br/><b>[Subcode]</b> The fault subcode.<br/><b>[Reason]</b> The English language reason element.<br/><b>[Detail]</b> The detail element. If absent, no detail element
+ is defined for the fault.<br/></p><p>
+ For SOAP 1.2, the <b>[Code]</b> property MUST be either
+ "Sender" or "Receiver". These properties are serialized
+ into text XML as follows:
+ </p><a name="soapver" id="soapver"/><table border="1"><tbody><tr><th> SOAP Version </th><th> Sender </th><th> Receiver </th></tr><tr><td> SOAP 1.2 </td><td> s12:Sender </td><td> s12:Receiver </td></tr></tbody></table><p>The properties above bind to a SOAP 1.2 fault as follows:</p><div class="exampleOuter"><div class="exampleInner"><pre><s12:Envelope>
+ <s12:Header>
+ <wsa:Action>
+ http://www.w3.org/2009/02/ws-enu/fault
+ </wsa:Action>
+ <!-- Headers elided for clarity. -->
+ </s12:Header>
+ <s12:Body>
+ <s12:Fault>
+ <s12:Code>
+ <s12:Value><b>[Code]</b></s12:Value>
+ <s12:Subcode>
+ <s12:Value><b>[Subcode]</b></s12:Value>
+ </s12:Subcode>
+ </s12:Code>
+ <s12:Reason>
+ <s12:Text xml:lang="en"><b>[Reason]</b></s12:Text>
+ </s12:Reason>
+ <s12:Detail>
+ <b>[Detail]</b>
+ ...
+ </s12:Detail>
+ </s12:Fault>
+ </s12:Body>
+</s12:Envelope></pre></div></div><p>The properties bind to a SOAP 1.1 fault as follows:</p><div class="exampleOuter"><div class="exampleInner"><pre><s11:Envelope>
+ <s11:Body>
+ <s11:Fault>
+ <faultcode><b>[Subcode]</b></faultcode>
+ <faultstring xml:lang="en"><b>[Reason]</b></faultstring>
+ <detail>
+ <b>[Detail]</b>
+ ...
+ </detail>
+ </s11:Fault>
+ </s11:Body>
+</s11:Envelope></pre></div></div><div class="div2">
+<h3><a name="InvalidExpirationTime" id="InvalidExpirationTime"/>4.1 InvalidExpirationTime</h3><p>
+ This fault is generated if the Enumerate expiration time is either a
+ zero duration or a specific time that occurs in the past according to
+ the data source.
+ </p><table border="1"><tbody><tr><td><b>[Code]</b></td><td> s12:Sender </td></tr><tr><td><b>[Subcode]</b></td><td> wsen:InvalidExpirationTime </td></tr><tr><td><b>[Reason]</b></td><td>
+ Invalid expiration time.
+ </td></tr><tr><td><b>[Detail]</b></td><td/></tr></tbody></table></div><div class="div2">
+<h3><a name="UnsupportedExpirationTime" id="UnsupportedExpirationTime"/>4.2 UnsupportedExpirationTime</h3><p>
+ This fault is generated if the Enumerate expiration time is
+ specified not as a duration.
+ </p><table border="1"><tbody><tr><td><b>[Code]</b></td><td> s12:Sender </td></tr><tr><td><b>[Subcode]</b></td><td> wsen:UnsupportedExpirationTime </td></tr><tr><td><b>[Reason]</b></td><td>
+ Unsupported expiration time.
+ </td></tr><tr><td><b>[Detail]</b></td><td/></tr></tbody></table></div><div class="div2">
+<h3><a name="FilteringNotSupported" id="FilteringNotSupported"/>4.3 FilteringNotSupported</h3><p>
+ This fault is generated if the data source does not support
+ filters.
+ </p><table border="1"><tbody><tr><td><b>[Code]</b></td><td> s12:Sender </td></tr><tr><td><b>[Subcode]</b></td><td> wsen:FilteringNotSupported </td></tr><tr><td><b>[Reason]</b></td><td>
+ Filtering not supported.
+ </td></tr><tr><td><b>[Detail]</b></td><td/></tr></tbody></table></div><div class="div2">
+<h3><a name="FilterDialectRequestedUnavailable" id="FilterDialectRequestedUnavailable"/>4.4 FilterDialectRequestedUnavailable</h3><p>
+ This fault is generated if the data source does not support
+ the requested filter dialect.
+ </p><table border="1"><tbody><tr><td><b>[Code]</b></td><td> s12:Sender </td></tr><tr><td><b>[Subcode]</b></td><td> wsen:FilterDialectRequestedUnavailable </td></tr><tr><td><b>[Reason]</b></td><td>
+ Filer dialect requested unavailable.
+ </td></tr><tr><td><b>[Detail]</b></td><td>
+ <wsen:SupportedDialect> +
+ <br/><em>Optional; repeating; one per filter dialect supported by the
+ receiver</em></td></tr></tbody></table></div><div class="div2">
+<h3><a name="CannotProcessFilter" id="CannotProcessFilter"/>4.5 CannotProcessFilter</h3><p>
+ This fault is generated if the data source can not process the
+ filter content.
+ </p><table border="1"><tbody><tr><td><b>[Code]</b></td><td> s12:Sender </td></tr><tr><td><b>[Subcode]</b></td><td> wsen:CannotProcessFilter </td></tr><tr><td><b>[Reason]</b></td><td>
+ Cannot filter as requested.
+ </td></tr><tr><td><b>[Detail]</b></td><td/></tr></tbody></table></div><div class="div2">
+<h3><a name="InvalidEnumerationContext" id="InvalidEnumerationContext"/>4.6 InvalidEnumerationContext</h3><p>
+ This fault is generated if the enumeration context is invalid.
+ </p><table border="1"><tbody><tr><td><b>[Code]</b></td><td> s12:Receiver </td></tr><tr><td><b>[Subcode]</b></td><td> wsen:InvalidEnumerationContext </td></tr><tr><td><b>[Reason]</b></td><td><em>
+ Text explaining why the enumeration context is no longer valid, or
+ </em>
+ "Invalid enumeration context"
+ <em>
+ if no additional information is available.
+ </em></td></tr><tr><td><b>[Detail]</b></td><td/></tr></tbody></table></div><div class="div2">
+<h3><a name="TimedOut" id="TimedOut"/>4.7 TimedOut</h3><p>
+ This fault is generated if the data source times out is the
+ wsen:MaxTime is reached.
+ </p><table border="1"><tbody><tr><td><b>[Code]</b></td><td> s12:Receiver </td></tr><tr><td><b>[Subcode]</b></td><td> wsen:TimedOut </td></tr><tr><td><b>[Reason]</b></td><td> Timeout. </td></tr><tr><td><b>[Detail]</b></td><td/></tr></tbody></table></div><div class="div2">
+<h3><a name="UnableToRenew" id="UnableToRenew"/>4.8 UnableToRenew</h3><p>
+ This fault is generated if the data source is unable to
+ renew the enumeration.
+ </p><table border="1"><tbody><tr><td><b>[Code]</b></td><td> s12:Receiver </td></tr><tr><td><b>[Subcode]</b></td><td> wsen:UnableToRenew </td></tr><tr><td><b>[Reason]</b></td><td><em>
+ Text explaining why the enumeration context cannot be renewed, or
+ </em>
+ "data source unable to renew"
+ <em>
+ if no additional information is available.
+ </em></td></tr><tr><td><b>[Detail]</b></td><td/></tr></tbody></table></div></div><div class="div1">
+<h2><a name="Security" id="Security"/>5 Security Considerations</h2><p>
It is strongly recommended that the
communication between services be secured using the mechanisms
described in <a href="#WSSecurity">[WS-Security]</a>.
@@ -1197,7 +1191,7 @@
taken to ensure that minimal state is saved prior to any
authenticating sequences.
</p></li></ul></div><div class="div1">
-<h2><a name="acks" id="acks"/>5 Acknowledgements</h2><p>
+<h2><a name="acks" id="acks"/>6 Acknowledgements</h2><p>
This specification has been developed as a
result of joint work with many individuals and teams,
including:
@@ -1220,7 +1214,7 @@
Wu Chou (Avaya Communications),
Yves Lafon (W3C)
</p></div><div class="div1">
-<h2><a name="refs" id="refs"/>6 References</h2><dl><dt class="label"><a name="RFC2119" id="RFC2119"/>RFC2119</dt><dd><a href="http://www.ietf.org/rfc/rfc2119.txt"><cite>
+<h2><a name="refs" id="refs"/>7 References</h2><dl><dt class="label"><a name="RFC2119" id="RFC2119"/>RFC2119</dt><dd><a href="http://www.ietf.org/rfc/rfc2119.txt"><cite>
Key words for use in RFCs to Indicate Requirement Levels
</cite></a>
, S. Bradner, March 1997.
@@ -1629,4 +1623,5 @@
<a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6587">6587</a></td></tr><tr><td> 2009/03/17 </td><td> DD </td><td> Added resolution of issue
<a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6399">6399</a></td></tr><tr><td> 2009/03/23 </td><td> DD </td><td> Added resolution of issue
<a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6666">6666</a></td></tr><tr><td> 2009/03/24 </td><td> DD </td><td> Added resolution of issue
- <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6648">6648</a></td></tr></tbody></table></div></div></body></html>
\ No newline at end of file
+ <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6648">6648</a></td></tr><tr><td> 2009/04/07 </td><td> DD </td><td> Added resolution of issue
+ <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6499">6499</a></td></tr></tbody></table></div></div></body></html>
\ No newline at end of file
Index: wsenum.xml
===================================================================
RCS file: /w3ccvs/WWW/2002/ws/ra/edcopies/wsenum.xml,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -d -r1.20 -r1.21
--- wsenum.xml 24 Mar 2009 21:19:38 -0000 1.20
+++ wsenum.xml 7 Apr 2009 13:09:16 -0000 1.21
@@ -641,98 +641,20 @@
If the expiration time is either a zero
duration or a specific time that occurs in the past according to
the data source, then the request MUST fail, and the data source
- MAY generate a fault indicating that an invalid expiration time was
- requested.
- </p>
- <p>
- The SOAP 1.1 binding of this fault
- is:
+ MAY generate a wsen:InvalidExpirationTime fault indicating that an
+ invalid expiration time was requested.
</p>
- <ulist>
- <item>
- <p>
- faultcode = s11:Client
- </p>
- </item>
-
- <item>
- <p>
- faultstring = e.g., "invalid expiration time"
- </p>
- </item>
-
- <item>
- <p>
- The SOAP 1.2 binding of this fault is:
- </p>
- <p>
- s12:Code/s12:Value = s12:Sender
- </p>
- </item>
-
- <item>
- <p>
- s12:Code/s12:Subcode/s12:Value = wsen:InvalidExpirationTime
- </p>
- </item>
-
- <item>
- <p>
- s12:Reason/s12:Text = e.g., "invalid expiration time"
- </p>
- </item>
- </ulist>
<p>
Some data sources may not have a "wall time"
clock available, and so are able only to accept durations as
expirations. If such a source receives an Enumerate request
containing a specific time expiration, then the request MUST fail;
- if so, the data source SHOULD generate a fault indicating that an
+ if so, the data source SHOULD generate a
+ wsen:UnsupportedExpirationTime fault indicating that an
unsupported expiration type was requested.
</p>
- <p>
- The SOAP 1.1 binding of this fault is:
- </p>
-
- <ulist>
- <item>
- <p>
- faultcode = s11:Client
- </p>
- </item>
-
- <item>
- <p>
- faultstring = e.g., "unsupported expiration type"
- </p>
- </item>
-
- <item>
- <p>
- The SOAP 1.2 binding of this fault is:
- </p>
- </item>
-
- <item>
- <p>
- s12:Code/s12:Value = s12:Sender
- </p>
- </item>
-
- <item>
- <p>
- s12:Code/s12:Subcode/s12:Value = wsen:UnsupportedExpirationType
- </p>
- </item>
-
- <item>
- <p>
- s12:Reason/s12:Text = e.g., "unsupported expiration type"
- </p>
- </item>
- </ulist>
</def>
</gitem>
@@ -752,147 +674,23 @@
<p>
If the data source does not support
filtering, the request MUST fail, and the data source MAY generate
- a SOAP fault as follows:
+ a wsen:FilteringNotSupported fault.
</p>
- <p> SOAP 1.1: </p>
- <ulist>
- <item>
- <p>
- faultcode = s11:Client
- </p>
- </item>
-
- <item>
- <p>
- faultstring = e.g., "filtering not supported"
- </p>
- </item>
- </ulist>
-
- <p> SOAP 1.2: </p>
- <ulist>
- <item>
- <p>
- s12:Code/s12:Value = s12:Sender
- </p>
- </item>
-
- <item>
- <p>
- s12:Code/s12:Subcode/s12:Value = wsen:FilteringNotSupported
- </p>
- </item>
-
- <item>
- <p>
- s12:Reason/s12:Text = e.g., "filtering not supported"
- </p>
- </item>
- </ulist>
-
<p>
If the data source supports filtering but
cannot honor the requested filter dialect, the request MUST fail,
- and the data source MAY generate a SOAP fault as
- follows:
+ and the data source MAY generate a
+ wsen:FilterDialectRequestUnavailable fault.
</p>
- <p> SOAP 1.1: </p>
- <ulist>
- <item>
- <p>
- faultcode = s11:Client
- </p>
- </item>
-
- <item>
- <p>
- faultstring = e.g., "filter dialect requested unavailable"
- </p>
- </item>
-
- <item>
- <p>
- [optional]
- detail/wsen:SupportedDialect = repeating; one per filter dialect
- supported by the container
- </p>
- </item>
- </ulist>
-
- <p> SOAP 1.2: </p>
- <ulist>
- <item>
- <p>
- s12:Code/s12:Value = s12:Sender
- </p>
- </item>
-
- <item>
- <p>
- s12:Code/s12:Subcode/s12:Value =
- wsen:FilterDialectRequestedUnavailable
- </p>
- </item>
-
- <item>
- <p>
- s12:Reason/s12:Text = e.g., "filter dialect requested unavailable"
- </p>
- </item>
-
- <item>
- <p>
- [optional]
- s12:Detail/wsen:SupportedDialect = repeating; one per filter
- dialect supported by the container
- </p>
- </item>
- </ulist>
-
<p>
If the data source supports filtering and the
requested dialect but cannot process the requested filter content,
- the request MUST fail, and the data source MAY generate a SOAP
- fault as follows:
+ the request MUST fail, and the data source MAY generate a
+ wsen:CannotProcessFilter fault.
</p>
- <p> SOAP 1.1: </p>
- <ulist>
- <item>
- <p>
- faultcode = s11:Client
- </p>
- </item>
-
- <item>
- <p>
- faultstring = e.g., "cannot filter as requested"
- </p>
- </item>
- </ulist>
-
- <p> SOAP 1.2: </p>
- <ulist>
- <item>
- <p>
- s12:Code/s12:Value = s12:Sender
- </p>
- </item>
-
- <item>
- <p>
- s12:Code/s12:Subcode/s12:Value = wsen:CannotProcessFilter
- </p>
- </item>
-
- <item>
- <p>
- s12:Reason/s12:Text = e.g., "cannot filter as requested"
- </p>
- </item>
- </ulist>
</def>
</gitem>
@@ -1155,47 +953,9 @@
returned in a Pull response), or because it has been Released, or
because it has expired, or because the data source has had to
invalidate the context, then the data source SHOULD fail the
- request, and MAY generate the following fault:
+ request, and MAY generate the a wsen:InvalidEnumerationContext fault.
</p>
- <p> SOAP 1.1: </p>
- <ulist>
- <item>
- <p>
- faultcode = s11:Server
- </p>
- </item>
-
- <item>
- <p>
- faultstring = <emph>text explaining why the enumeration context is
- no longer valid, or</emph> "Invalid enumeration context"
- <emph>if no additional information is available</emph>
- </p>
- </item>
- </ulist>
-
- <p>SOAP 1.2:</p>
- <ulist>
- <item>
- <p>
- s:Code/s:Value = s:Receiver
- </p>
- </item>
- <item>
- <p>
- s:Code/s:Subcode/s:Value = wsen:InvalidEnumerationContext
- </p>
- </item>
- <item>
- <p>
- s:Reason/s:Text = <emph>text explaining why the enumeration context
- is no longer valid, or</emph> "Invalid enumeration context"
- <emph>if no additional information is available</emph>
- </p>
- </item>
- </ulist>
-
<p>
Note that the data source may not be able to
determine that an enumeration context is not valid, especially if
@@ -1291,47 +1051,11 @@
data source may wait as long as it deems necessary (but not longer
than the value of the wsen:MaxTime element, if present) to produce
a message for delivery to the consumer. The data source MUST
- recognize the wsen:MaxTime element and return the following fault
- if no elements are available prior to the request message's
- deadline:
+ recognize the wsen:MaxTime element and return a
+ wsen:TimedOut fault if no elements are available prior to the
+ request message's deadline:
</p>
- <p> SOAP 1.1: </p>
- <ulist>
- <item>
- <p>
- faultcode = s11:Server
- </p>
- </item>
-
- <item>
- <p>
- faultstring = e.g., "timeout"
- </p>
- </item>
- </ulist>
-
- <p>SOAP 1.2:</p>
- <ulist>
- <item>
- <p>
- s:Code/s:Value = s:Receiver
- </p>
- </item>
-
- <item>
- <p>
- s:Code/s:Subcode/s:Value = wsen:TimedOut
- </p>
- </item>
-
- <item>
- <p>
- s:Reason/s:Text = e.g., "timeout"
- </p>
- </item>
- </ulist>
-
<p>
Note, however, that this fault SHOULD NOT cause
the enumeration context to become invalid (of course, the data
@@ -1519,7 +1243,7 @@
If the consumer does issue a Pull or Release on
an invalid enumeration context, the result is undefined: the data
source MAY ignore the request or MAY return a
- wsen:InvalidEnumerationContext fault, as described above, or MAY
+ wsen:InvalidEnumerationContext fault or MAY
take some other action.
</p>
</div2>
@@ -1571,56 +1295,9 @@
returned in a Pull response), or because it has been Released, or
because it has expired, or because the data source has had to
invalidate the context, then the data source SHOULD fail the
- request, and MAY generate the following fault:
+ request, and MAY generate a wsen:InvalidEnumerationContext fault.
</p>
- <p> SOAP 1.1: </p>
- <ulist>
- <item>
- <p>
- faultcode = s11:Server
- </p>
- </item>
-
- <item>
- <p>
- faultstring = <emph>text explaining why the enumeration context is
- no longer valid, or</emph> "Invalid enumeration context"
- <emph>if no additional information is available</emph>
- </p>
- </item>
- </ulist>
-
- <p>SOAP 1.2:</p>
- <ulist>
- <item>
- <p>
- s:Code/s:Value = s:Receiver
- </p>
- </item>
-
- <item>
- <p>
- s:Code/s:Subcode/s:Value = wsen:InvalidEnumerationContext
- </p>
- </item>
-
- <item>
- <p>
- s:Reason/s:Text = <emph>text explaining why the enumeration
- context is no longer valid, or</emph> "Invalid enumeration
- context" <emph>if no additional information is available</emph>
- </p>
- </item>
- </ulist>
-
- <p>
- Note that the data source may not be able to
- determine that an enumeration context is not valid, especially if
- all of the state associated with the enumeration is kept in the
- enumeration context and refreshed on every
- PullResponse.
- </p>
</def>
</gitem>
</glist>
@@ -1681,56 +1358,10 @@
<p>
If the data source chooses not to renew this
enumeration, the request MUST fail, and the data source SHOULD
- generate a fault indicating that the renewal was not
- accepted.
- </p>
-
- <p>
- The SOAP 1.1 binding of this type of fault is:
- </p>
-
- <ulist>
- <item>
- <p>
- faultcode = s11:Server
- </p>
- </item>
-
- <item>
- <p>
- faultstring = <emph>text explaining why the enumeration context cannot
- be renewed, or</emph> "data source unable to renew" <emph>if no
- additional information is available</emph>
- </p>
- </item>
- </ulist>
-
- <p>
- The SOAP 1.2 binding of this type of fault is:
+ generate a wsen:UnableToRenew fault indicating that the
+ renewal was not accepted.
</p>
- <ulist>
- <item>
- <p>
- s12:Code/s12:Value = s12:Receiver
- </p>
- </item>
-
- <item>
- <p>
- s12:Code/s12:Subcode/s12:Value = wsen:UnableToRenew
- </p>
- </item>
-
- <item>
- <p>
- s12:Reason/s12:Text = <emph>text explaining why the enumeration
- context cannot be renewed, or</emph> "data source unable to
- renew" <emph>if no additional information is available</emph>
- </p>
- </item>
- </ulist>
-
<p>
Other components of the outline above are not
further constrained by this specification.
@@ -2024,6 +1655,376 @@
</div2>
</div1>
+ <div1 id="Faults">
+ <head>Faults</head>
+
+ <p>
+ WS-Enumeration faults MUST include as the <kw>[Action]</kw> property
+ the following fault action URI:
+ </p>
+
+ <example>
+ <eg>http://www.w3.org/2009/02/ws-enu/fault</eg>
+ </example>
+
+ <p>
+ The faults defined in this section are generated if the condition
+ stated in the preamble is met. Faults are targeted at a
+ destination endpoint according to the fault handling rules defined
+ in <bibref ref="AddrCore"/>.
+ </p>
+
+ <p>
+ The definitions of faults in this section use the following properties:
+ </p>
+
+ <p>
+ <kw>[Code]</kw> The fault code.<phrase/>
+ <kw>[Subcode]</kw> The fault subcode.<phrase/>
+ <kw>[Reason]</kw> The English language reason element.<phrase/>
+ <kw>[Detail]</kw> The detail element. If absent, no detail element
+ is defined for the fault.<phrase/>
+ </p>
+
+ <p>
+ For SOAP 1.2, the <kw>[Code]</kw> property MUST be either
+ "Sender" or "Receiver". These properties are serialized
+ into text XML as follows:
+ </p>
+
+ <table id="soapver" border="1">
+ <tbody>
+ <tr>
+ <th> SOAP Version </th>
+ <th> Sender </th>
+ <th> Receiver </th>
+ </tr>
+ <tr>
+ <td> SOAP 1.2 </td>
+ <td> s12:Sender </td>
+ <td> s12:Receiver </td>
+ </tr>
+ </tbody>
+ </table>
+
+ <p>The properties above bind to a SOAP 1.2 fault as follows:</p>
+ <example>
+ <eg><s12:Envelope>
+ <s12:Header>
+ <wsa:Action>
+ http://www.w3.org/2009/02/ws-enu/fault
+ </wsa:Action>
+ <!-- Headers elided for clarity. -->
+ </s12:Header>
+ <s12:Body>
+ <s12:Fault>
+ <s12:Code>
+ <s12:Value><kw>[Code]</kw></s12:Value>
+ <s12:Subcode>
+ <s12:Value><kw>[Subcode]</kw></s12:Value>
+ </s12:Subcode>
+ </s12:Code>
+ <s12:Reason>
+ <s12:Text xml:lang="en"><kw>[Reason]</kw></s12:Text>
+ </s12:Reason>
+ <s12:Detail>
+ <kw>[Detail]</kw>
+ ...
+ </s12:Detail>
+ </s12:Fault>
+ </s12:Body>
+</s12:Envelope></eg>
+ </example>
+
+ <p>The properties bind to a SOAP 1.1 fault as follows:</p>
+ <example>
+ <eg><s11:Envelope>
+ <s11:Body>
+ <s11:Fault>
+ <faultcode><kw>[Subcode]</kw></faultcode>
+ <faultstring xml:lang="en"><kw>[Reason]</kw></faultstring>
+ <detail>
+ <kw>[Detail]</kw>
+ ...
+ </detail>
+ </s11:Fault>
+ </s11:Body>
+</s11:Envelope></eg>
+ </example>
+
+ <div2 id="InvalidExpirationTime">
+ <head>InvalidExpirationTime</head>
+
+ <p>
+ This fault is generated if the Enumerate expiration time is either a
+ zero duration or a specific time that occurs in the past according to
+ the data source.
+ </p>
+
+ <table border="1">
+ <tbody>
+ <tr>
+ <td> <kw>[Code]</kw> </td>
+ <td> s12:Sender </td>
+ </tr>
+ <tr>
+ <td> <kw>[Subcode]</kw> </td>
+ <td> wsen:InvalidExpirationTime </td>
+ </tr>
+ <tr>
+ <td> <kw>[Reason]</kw> </td>
+ <td>
+ Invalid expiration time.
+ </td>
+ </tr>
+ <tr>
+ <td> <kw>[Detail]</kw> </td>
+ <td> </td>
+ </tr>
+ </tbody>
+ </table>
+ </div2>
+
+ <div2 id="UnsupportedExpirationTime">
+ <head>UnsupportedExpirationTime</head>
+
+ <p>
+ This fault is generated if the Enumerate expiration time is
+ specified not as a duration.
+ </p>
+
+ <table border="1">
+ <tbody>
+ <tr>
+ <td> <kw>[Code]</kw> </td>
+ <td> s12:Sender </td>
+ </tr>
+ <tr>
+ <td> <kw>[Subcode]</kw> </td>
+ <td> wsen:UnsupportedExpirationTime </td>
+ </tr>
+ <tr>
+ <td> <kw>[Reason]</kw> </td>
+ <td>
+ Unsupported expiration time.
+ </td>
+ </tr>
+ <tr>
+ <td> <kw>[Detail]</kw> </td>
+ <td> </td>
+ </tr>
+ </tbody>
+ </table>
+ </div2>
+
+ <div2 id="FilteringNotSupported">
+ <head>FilteringNotSupported</head>
+
+ <p>
+ This fault is generated if the data source does not support
+ filters.
+ </p>
+
+ <table border="1">
+ <tbody>
+ <tr>
+ <td> <kw>[Code]</kw> </td>
+ <td> s12:Sender </td>
+ </tr>
+ <tr>
+ <td> <kw>[Subcode]</kw> </td>
+ <td> wsen:FilteringNotSupported </td>
+ </tr>
+ <tr>
+ <td> <kw>[Reason]</kw> </td>
+ <td>
+ Filtering not supported.
+ </td>
+ </tr>
+ <tr>
+ <td> <kw>[Detail]</kw> </td>
+ <td> </td>
+ </tr>
+ </tbody>
+ </table>
+ </div2>
+
+ <div2 id="FilterDialectRequestedUnavailable">
+ <head>FilterDialectRequestedUnavailable</head>
+
+ <p>
+ This fault is generated if the data source does not support
+ the requested filter dialect.
+ </p>
+
+ <table border="1">
+ <tbody>
+ <tr>
+ <td> <kw>[Code]</kw> </td>
+ <td> s12:Sender </td>
+ </tr>
+ <tr>
+ <td> <kw>[Subcode]</kw> </td>
+ <td> wsen:FilterDialectRequestedUnavailable </td>
+ </tr>
+ <tr>
+ <td> <kw>[Reason]</kw> </td>
+ <td>
+ Filer dialect requested unavailable.
+ </td>
+ </tr>
+ <tr>
+ <td> <kw>[Detail]</kw> </td>
+ <td>
+ <wsen:SupportedDialect> +
+ <phrase/>
+ <emph>Optional; repeating; one per filter dialect supported by the
+ receiver</emph>
+ </td>
+ </tr>
+ </tbody>
+ </table>
+ </div2>
+
+ <div2 id="CannotProcessFilter">
+ <head>CannotProcessFilter</head>
+
+ <p>
+ This fault is generated if the data source can not process the
+ filter content.
+ </p>
+
+ <table border="1">
+ <tbody>
+ <tr>
+ <td> <kw>[Code]</kw> </td>
+ <td> s12:Sender </td>
+ </tr>
+ <tr>
+ <td> <kw>[Subcode]</kw> </td>
+ <td> wsen:CannotProcessFilter </td>
+ </tr>
+ <tr>
+ <td> <kw>[Reason]</kw> </td>
+ <td>
+ Cannot filter as requested.
+ </td>
+ </tr>
+ <tr>
+ <td> <kw>[Detail]</kw> </td>
+ <td> </td>
+ </tr>
+ </tbody>
+ </table>
+ </div2>
+
+ <div2 id="InvalidEnumerationContext">
+ <head>InvalidEnumerationContext</head>
+
+ <p>
+ This fault is generated if the enumeration context is invalid.
+ </p>
+
+ <table border="1">
+ <tbody>
+ <tr>
+ <td> <kw>[Code]</kw> </td>
+ <td> s12:Receiver </td>
+ </tr>
+ <tr>
+ <td> <kw>[Subcode]</kw> </td>
+ <td> wsen:InvalidEnumerationContext </td>
+ </tr>
+ <tr>
+ <td> <kw>[Reason]</kw> </td>
+ <td>
+ <emph>
+ Text explaining why the enumeration context is no longer valid, or
+ </emph>
+ "Invalid enumeration context"
+ <emph>
+ if no additional information is available.
+ </emph>
+ </td>
+ </tr>
+ <tr>
+ <td> <kw>[Detail]</kw> </td>
+ <td> </td>
+ </tr>
+ </tbody>
+ </table>
+ </div2>
+
+ <div2 id="TimedOut">
+ <head>TimedOut</head>
+
+ <p>
+ This fault is generated if the data source times out is the
+ wsen:MaxTime is reached.
+ </p>
+
+ <table border="1">
+ <tbody>
+ <tr>
+ <td> <kw>[Code]</kw> </td>
+ <td> s12:Receiver </td>
+ </tr>
+ <tr>
+ <td> <kw>[Subcode]</kw> </td>
+ <td> wsen:TimedOut </td>
+ </tr>
+ <tr>
+ <td> <kw>[Reason]</kw> </td>
+ <td> Timeout. </td>
+ </tr>
+ <tr>
+ <td> <kw>[Detail]</kw> </td>
+ <td> </td>
+ </tr>
+ </tbody>
+ </table>
+ </div2>
+
+ <div2 id="UnableToRenew">
+ <head>UnableToRenew</head>
+
+ <p>
+ This fault is generated if the data source is unable to
+ renew the enumeration.
+ </p>
+
+ <table border="1">
+ <tbody>
+ <tr>
+ <td> <kw>[Code]</kw> </td>
+ <td> s12:Receiver </td>
+ </tr>
+ <tr>
+ <td> <kw>[Subcode]</kw> </td>
+ <td> wsen:UnableToRenew </td>
+ </tr>
+ <tr>
+ <td> <kw>[Reason]</kw> </td>
+ <td>
+ <emph>
+ Text explaining why the enumeration context cannot be renewed, or
+ </emph>
+ "data source unable to renew"
+ <emph>
+ if no additional information is available.
+ </emph>
+ </td>
+ </tr>
+ <tr>
+ <td> <kw>[Detail]</kw> </td>
+ <td> </td>
+ </tr>
+ </tbody>
+ </table>
+ </div2>
+
+ </div1>
+
<div1 id="Security">
<head>Security Considerations</head>
@@ -2763,6 +2764,13 @@
<loc href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6648">6648</loc>
</td>
</tr>
+ <tr>
+ <td> 2009/04/07 </td>
+ <td> DD </td>
+ <td> Added resolution of issue
+ <loc href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6499">6499</loc>
+ </td>
+ </tr>
</tbody>
</table>
</div1>
Received on Tuesday, 7 April 2009 13:09:30 UTC