- From: Doug Davis via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 16 Feb 2011 05:36:21 +0000
- To: public-ws-resource-access-notifications@w3.org
Update of /w3ccvs/WWW/2002/ws/ra/edcopies
In directory hutz:/tmp/cvs-serv7613
Modified Files:
wsenum.html wsenum.xml
Log Message:
11990
Index: wsenum.html
===================================================================
RCS file: /w3ccvs/WWW/2002/ws/ra/edcopies/wsenum.html,v
retrieving revision 1.161
retrieving revision 1.162
diff -u -d -r1.161 -r1.162
--- wsenum.html 16 Feb 2011 05:25:11 -0000 1.161
+++ wsenum.html 16 Feb 2011 05:36:19 -0000 1.162
@@ -62,21 +62,20 @@
5.4 <a href="#FilterDialectRequestedUnavailable">FilterDialectRequestedUnavailable</a><br/>
5.5 <a href="#CannotProcessFilter">CannotProcessFilter</a><br/>
5.6 <a href="#InvalidEnumerationContext">InvalidEnumerationContext</a><br/>
- 5.7 <a href="#TimedOut">TimedOut</a><br/>
- 5.8 <a href="#UnusableEPR">UnusableEPR</a><br/>
- 5.9 <a href="#EndToNotSupported">EndToNotSupported</a><br/>
- 5.10 <a href="#EmptyFilter">EmptyFilter</a><br/>
- 5.11 <a href="#MaxElementsMustBeZero">MaxElementsMustBeZero</a><br/>
+ 5.7 <a href="#UnusableEPR">UnusableEPR</a><br/>
+ 5.8 <a href="#EndToNotSupported">EndToNotSupported</a><br/>
+ 5.9 <a href="#EmptyFilter">EmptyFilter</a><br/>
+ 5.10 <a href="#MaxElementsMustBeZero">MaxElementsMustBeZero</a><br/>
6 <a href="#Security">Security Considerations</a><br/>
- 6.1 <a href="#iddiv2x1x1896">Creating Enumeration Contexts</a><br/>
- 6.2 <a href="#iddiv2x1x1901">Protecting Enumeration Contexts</a><br/>
- 6.3 <a href="#iddiv2x1x1908">Endpoint Verification</a><br/>
+ 6.1 <a href="#iddiv2x1x1872">Creating Enumeration Contexts</a><br/>
+ 6.2 <a href="#iddiv2x1x1877">Protecting Enumeration Contexts</a><br/>
+ 6.3 <a href="#iddiv2x1x1884">Endpoint Verification</a><br/>
7 <a href="#metadata">WS-Enumeration Metadata</a><br/>
- 7.1 <a href="#iddiv2x1x1928">Enumeration Assertion</a><br/>
+ 7.1 <a href="#iddiv2x1x1904">Enumeration Assertion</a><br/>
8 <a href="#acks">Acknowledgements</a><br/>
9 <a href="#refs">References</a><br/>
- 9.1 <a href="#iddiv2x1x2048">Normative References</a><br/>
- 9.2 <a href="#iddiv2x1x2260">Informative References</a><br/>
+ 9.1 <a href="#iddiv2x1x2024">Normative References</a><br/>
+ 9.2 <a href="#iddiv2x1x2236">Informative 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/>
@@ -583,11 +582,10 @@
element is absent, the data source is NOT REQUIRED to limit the
amount of time it takes to assemble the Enumerate
response. The data source MUST recognize the wsen:MaxTime
- element and return a wsen:TimedOut fault if no elements
- are available prior to the request message's deadline.
- However, this fault MUST NOT cause the enumeration context to
- become invalid and the consumer can issue additional Enumerate requests
- using this enumeration context after receiving this fault.
+ element. If no elements
+ are available prior to the request message's deadline,
+ the data source MUST return an EnumerationResponse message
+ that contains a wsen:Items element with no child elements present.
</p><p>
This is useful with data sources that
accumulate elements over time and package them into a single Enumerate
@@ -658,7 +656,7 @@
(<em>xs:dateTime</em> | <em>xs:duration</em>)
</wsen:GrantedExpires>
<wsen:EnumerationContext ...>...</wsen:EnumerationContext> ?
- <wsen:Items>
+ <wsen:Items Reason="<em>xs:anyURI</em>"?>
<xs:any> enumeration-specific element </xs:any> +
</wsen:Items> ?
<wsen:EndOfSequence/> ?
@@ -704,6 +702,18 @@
The OPTIONAL Items element contains one or
more enumeration-specific elements, one for each element being
returned.
+ </p></dd><dt class="label"><b>[Body]</b>/wsen:EnumerateResponse/wsen:Items/@Reason
+ </dt><dd><p>
+ Implied value is "http://www.w3.org/2002/ws/ra/edcopies/ws-enu/TimedOut".
+ </p><p>
+ The OPTIONAL Reason attribute indicates the reason that the
+ wsen:Items element has no child elements. Alternate Reason
+ values can be defined. The Reason attribute MUST NOT be present
+ if the wsen:Items element has one or more child elements.
+ </p></dd><dt class="label"><b>[Body]</b>/wsen:EnumerateResponse/wsen:Items/@Reason="http://www.w3.org/2002/ws/ra/edcopies/ws-enu/TimedOut"
+ </dt><dd><p>
+ This value MUST be used if no elements are available prior to the
+ Enumeration request message's deadline.
</p></dd><dt class="label"><b>[Body]</b>/wsen:EnumerateResponse/wsen:EndOfSequence </dt><dd><p>
This OPTIONAL element indicates that no more
elements are available from this enumeration and the enumeration
@@ -1178,25 +1188,21 @@
<em>
if no additional information is available.
</em></td></tr><tr><td><b>[Detail]</b></td><td> </td></tr></tbody></table></div><div class="div2">
-<h3><a name="TimedOut" id="TimedOut"/>5.7 TimedOut</h3><p>
- This fault MUST be generated when the data source times out during the
- processing of a Enumerate operation, if 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> </td></tr></tbody></table></div><div class="div2">
-<h3><a name="UnusableEPR" id="UnusableEPR"/>5.8 UnusableEPR</h3><p>
+<h3><a name="UnusableEPR" id="UnusableEPR"/>5.7 UnusableEPR</h3><p>
This fault MUST be generated when a data source detects
that the wsen:EndTo EPR is unusable.
</p><table border="1"><tbody><tr><td><b>[Code]</b></td><td>s12:Sender</td></tr><tr><td><b>[Subcode]</b></td><td>wsen:UnusableEPR</td></tr><tr><td><b>[Reason]</b></td><td>The wsen:EndTo EPR is unusable.</td></tr><tr><td><b>[Detail]</b></td><td><em> Details as to why the EPR is unusable. </em></td></tr></tbody></table></div><div class="div2">
-<h3><a name="EndToNotSupported" id="EndToNotSupported"/>5.9 EndToNotSupported</h3><p>
+<h3><a name="EndToNotSupported" id="EndToNotSupported"/>5.8 EndToNotSupported</h3><p>
This fault MUST be generated by a data source that does not support
/wsen:Enumerate/wsen:NewContext/wsen:EndTo semantics, in response to
a Enumerate request that contains a wsen:EndTo element.
</p><table border="1"><tbody><tr><td><b>[Code]</b></td><td>s12:Sender</td></tr><tr><td><b>[Subcode]</b></td><td>wsen:EndToNotSupported</td></tr><tr><td><b>[Reason]</b></td><td>wsen:EndTo semantics is not supported.</td></tr><tr><td><b>[Detail]</b></td><td><em>none</em></td></tr></tbody></table></div><div class="div2">
-<h3><a name="EmptyFilter" id="EmptyFilter"/>5.10 EmptyFilter</h3><p>
+<h3><a name="EmptyFilter" id="EmptyFilter"/>5.9 EmptyFilter</h3><p>
This fault MUST be generated when a data source detects a
Enumerate request containing a filter that, for whatever
reason, will never evaluate to true.
</p><table border="1"><tbody><tr><td><b>[Code]</b></td><td>s12:Sender</td></tr><tr><td><b>[Subcode]</b></td><td>wsen:EmptyFilter</td></tr><tr><td><b>[Reason]</b></td><td>The wsen:Filter would result in zero data items.</td></tr><tr><td><b>[Detail]</b></td><td><em> The wsen:Filter value. </em></td></tr></tbody></table></div><div class="div2">
-<h3><a name="MaxElementsMustBeZero" id="MaxElementsMustBeZero"/>5.11 MaxElementsMustBeZero</h3><p>
+<h3><a name="MaxElementsMustBeZero" id="MaxElementsMustBeZero"/>5.10 MaxElementsMustBeZero</h3><p>
This fault MUST be generated by a data source that does not support
returning items in a Enumerate response and the Enumerate request
did not include a wsen:MaxElements with a value of zero.
@@ -1220,7 +1226,7 @@
a security analysis to determine their particular threat profile and
the appropriate responses to those threats.
</p><div class="div2">
-<h3><a name="iddiv2x1x1896" id="iddiv2x1x1896"/>6.1 Creating Enumeration Contexts</h3><p>
+<h3><a name="iddiv2x1x1872" id="iddiv2x1x1872"/>6.1 Creating Enumeration Contexts</h3><p>
An enumeration represents a logical cursor through a sequence of
data items. If the information in these items is sensitive, it is
advisable to for Data Sources to authenticate and authorize Consumers
@@ -1231,7 +1237,7 @@
the time the Enumerate request is processed or varies during the
lifetime of the enumeration.
</p></div><div class="div2">
-<h3><a name="iddiv2x1x1901" id="iddiv2x1x1901"/>6.2 Protecting Enumeration Contexts</h3><p>
+<h3><a name="iddiv2x1x1877" id="iddiv2x1x1877"/>6.2 Protecting Enumeration Contexts</h3><p>
Once created, it is advisable to treat Enumeration Contexts as
protected resources. Renew, GetStatus, and Release requests ought to
be authenticated and authorized (for example, the identity of the
@@ -1253,7 +1259,7 @@
Data Sources are advised to authenticate and authorize clients
sending Enumerate requests.
</p></div><div class="div2">
-<h3><a name="iddiv2x1x1908" id="iddiv2x1x1908"/>6.3 Endpoint Verification</h3><p>
+<h3><a name="iddiv2x1x1884" id="iddiv2x1x1884"/>6.3 Endpoint Verification</h3><p>
Data Source implementations that perform validity checks on the
EndTo EPR used in the Enumerate request are advised that such checks
can be misused to obtain information about a target network. For
@@ -1295,7 +1301,7 @@
that indicate a particular security mechanism used to protect
the WS-Enumeration operations supported by this endpoint.
</p><div class="div2">
-<h3><a name="iddiv2x1x1928" id="iddiv2x1x1928"/>7.1 Enumeration Assertion</h3><p>
+<h3><a name="iddiv2x1x1904" id="iddiv2x1x1904"/>7.1 Enumeration Assertion</h3><p>
Services indicate support for the WS-Enumeration's definition of a
data source through the use of the Web Services
Policy - Framework <a href="#wspolicy">[WS-Policy]</a> and Web Services Policy -
@@ -1410,7 +1416,7 @@
Yves Lafon (W3C/ERCIM).
</p></div><div class="div1">
<h2><a name="refs" id="refs"/>9 References</h2><div class="div2">
-<h3><a name="iddiv2x1x2048" id="iddiv2x1x2048"/>9.1 Normative References</h3><dl><dt class="label"><a name="BP12" id="BP12"/>BP12</dt><dd><a href="http://ws-i.org/profiles/BasicProfile-1.2-2010-11-09.html"><cite>
+<h3><a name="iddiv2x1x2024" id="iddiv2x1x2024"/>9.1 Normative References</h3><dl><dt class="label"><a name="BP12" id="BP12"/>BP12</dt><dd><a href="http://ws-i.org/profiles/BasicProfile-1.2-2010-11-09.html"><cite>
WS-I Profile, Basic Profile Version 1.2
</cite></a>
, R. Chumbley, et al, Editors.
@@ -1492,7 +1498,7 @@
, A. Berglund, et al., Editors.
World Wide Web Consortium (W3C), 23 January 2007.
Available at <a href="http://www.w3.org/TR/xpath20/">http://www.w3.org/TR/xpath20/</a>.</dd></dl></div><div class="div2">
-<h3><a name="iddiv2x1x2260" id="iddiv2x1x2260"/>9.2 Informative References</h3><dl><dt class="label"><a name="MEX" id="MEX"/>WS-MetadataExchange</dt><dd><a href="http://www.w3.org/TR/ws-metadata-exchange"><cite>
+<h3><a name="iddiv2x1x2236" id="iddiv2x1x2236"/>9.2 Informative References</h3><dl><dt class="label"><a name="MEX" id="MEX"/>WS-MetadataExchange</dt><dd><a href="http://www.w3.org/TR/ws-metadata-exchange"><cite>
W3C Working Group Draft, "Web Services Metadata Exchange
(WS-MetadataExchange) 1.1"
</cite></a>
@@ -1580,6 +1586,7 @@
<xs:any namespace='##other' processContents='lax'
minOccurs='0' maxOccurs='unbounded' />
</xs:sequence>
+ <xs:attribute name='Reason' type='xs:anyURI' use='optional'/>
</xs:complexType>
<xs:complexType name='LanguageSpecificStringType'>
@@ -2089,4 +2096,5 @@
<a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=11899">11899</a></td></tr><tr><td> 2011/02/15 </td><td> DD </td><td> Added resolution of issue
<a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=12051">12051</a></td></tr><tr><td> 2011/02/15 </td><td> DD </td><td> Added resolution of issue
<a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=11894">11894</a></td></tr><tr><td> 2011/02/15 </td><td> DD </td><td> Added resolution of issue
- <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=12063">12063</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=12063">12063</a></td></tr><tr><td> 2011/02/15 </td><td> DD </td><td> Added resolution of issue
+ <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=11990">11990</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.152
retrieving revision 1.153
diff -u -d -r1.152 -r1.153
--- wsenum.xml 16 Feb 2011 05:25:11 -0000 1.152
+++ wsenum.xml 16 Feb 2011 05:36:19 -0000 1.153
@@ -998,11 +998,10 @@
element is absent, the data source is NOT REQUIRED to limit the
amount of time it takes to assemble the Enumerate
response. The data source MUST recognize the wsen:MaxTime
- element and return a wsen:TimedOut fault if no elements
- are available prior to the request message's deadline.
- However, this fault MUST NOT cause the enumeration context to
- become invalid and the consumer can issue additional Enumerate requests
- using this enumeration context after receiving this fault.
+ element. If no elements
+ are available prior to the request message's deadline,
+ the data source MUST return an EnumerationResponse message
+ that contains a wsen:Items element with no child elements present.
</p>
<p>
This is useful with data sources that
@@ -1105,7 +1104,7 @@
(<emph>xs:dateTime</emph> | <emph>xs:duration</emph>)
</wsen:GrantedExpires>
<wsen:EnumerationContext ...>...</wsen:EnumerationContext> ?
- <wsen:Items>
+ <wsen:Items Reason="<emph>xs:anyURI</emph>"?>
<xs:any> enumeration-specific element </xs:any> +
</wsen:Items> ?
<wsen:EndOfSequence/> ?
@@ -1189,6 +1188,36 @@
</gitem>
<gitem>
+ <label>
+ <kw>[Body]</kw>/wsen:EnumerateResponse/wsen:Items/@Reason
+ </label>
+ <def>
+ <p>
+ Implied value is "http://www.w3.org/&wsenu.nsprefix;/ws-enu/TimedOut".
+ </p>
+
+ <p>
+ The OPTIONAL Reason attribute indicates the reason that the
+ wsen:Items element has no child elements. Alternate Reason
+ values can be defined. The Reason attribute MUST NOT be present
+ if the wsen:Items element has one or more child elements.
+ </p>
+ </def>
+ </gitem>
+
+ <gitem>
+ <label>
+ <kw>[Body]</kw>/wsen:EnumerateResponse/wsen:Items/@Reason="http://www.w3.org/&wsenu.nsprefix;/ws-enu/TimedOut"
+ </label>
+ <def>
+ <p>
+ This value MUST be used if no elements are available prior to the
+ Enumeration request message's deadline.
+ </p>
+ </def>
+ </gitem>
+
+ <gitem>
<label> <kw>[Body]</kw>/wsen:EnumerateResponse/wsen:EndOfSequence </label>
<def>
<p>
@@ -2064,36 +2093,6 @@
</table>
</div2>
- <div2 id="TimedOut">
- <head>TimedOut</head>
-
- <p>
- This fault MUST be generated when the data source times out during the
- processing of a Enumerate operation, if 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="UnusableEPR">
<head>UnusableEPR</head>
@@ -2853,6 +2852,7 @@
<xs:any namespace='##other' processContents='lax'
minOccurs='0' maxOccurs='unbounded' />
</xs:sequence>
+ <xs:attribute name='Reason' type='xs:anyURI' use='optional'/>
</xs:complexType>
<xs:complexType name='LanguageSpecificStringType'>
@@ -4021,6 +4021,13 @@
<loc href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=12063">12063</loc>
</td>
</tr>
+ <tr>
+ <td> 2011/02/15 </td>
+ <td> DD </td>
+ <td> Added resolution of issue
+ <loc href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=11990">11990</loc>
+ </td>
+ </tr>
</tbody>
</table>
</div1>
Received on Wednesday, 16 February 2011 05:36:23 UTC