- From: Doug Davis via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 16 Jun 2010 21:36:36 +0000
- To: public-ws-resource-access-notifications@w3.org
Update of /w3ccvs/WWW/2002/ws/ra/edcopies In directory hutz:/tmp/cvs-serv10113 Modified Files: wsenum.html wsenum.xml wseventing.html Log Message: typo in an example Index: wsenum.html =================================================================== RCS file: /w3ccvs/WWW/2002/ws/ra/edcopies/wsenum.html,v retrieving revision 1.139 retrieving revision 1.140 diff -u -d -r1.139 -r1.140 --- wsenum.html 13 May 2010 21:33:09 -0000 1.139 +++ wsenum.html 16 Jun 2010 21:36:34 -0000 1.140 @@ -31,7 +31,8 @@ </style><link rel="stylesheet" type="text/css" href="http://www.w3.org/StyleSheets/TR/base.css"/></head><body><div class="head"> <h1><a name="title" id="title"/>Web Services Enumeration (WS-Enumeration)</h1> <h2><a name="w3c-doctype" id="w3c-doctype"/>Editor's Draft $Date$</h2><dl><dt>Latest version:</dt><dd><a href="http://www.w3.org/TR/ws-enumeration">http://www.w3.org/TR/ws-enumeration - </a></dd><dt>Previous version:</dt><dd><a href="http://www.w3.org/TR/2009/WD-ws-enumeration-20090317">http://www.w3.org/TR/2009/WD-ws-enumeration-20090317</a></dd><dt>Editors:</dt><dd>Doug Davis, IBM</dd><dd>Ashok Malhotra, Oracle</dd><dd>Katy Warr, IBM</dd><dd>Wu Chou, Avaya</dd></dl><p class="copyright"><a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> © 2010 <a href="http://www.w3.org/"><acronym title="World Wide Web Consortium">W3C</acronym></a><sup>®</sup> (<a href="http://www.csail.mit.edu/"><acronym title="Massachusetts Institute of Technology">MIT</acronym></a>, <a href="http://www.ercim.org/"><acronym title="European Research Consortium for Informatics and Mathematics">ERCIM</acronym></a>, <a href="http://www.keio.ac.jp/">Keio</a>), All Rights Reserved. W3C <a href="http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>, <a href="http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a> and <a href="http://www.w3.or/Consortium/Legal/copyright-documents">document use</a> rules apply.</p></div><hr/><div> + </a></dd><dt>Previous version:</dt><dd><a href="http://www.w3.org/TR/2009/WD-ws-enumeration-20090317">http://www.w3.org/TR/2009/WD-ws-enumeration-20090317 + </a></dd><dt>Editors:</dt><dd>Doug Davis, IBM</dd><dd>Ashok Malhotra, Oracle</dd><dd>Katy Warr, IBM</dd><dd>Wu Chou, Avaya</dd></dl><p class="copyright"><a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> © 2010 <a href="http://www.w3.org/"><acronym title="World Wide Web Consortium">W3C</acronym></a><sup>®</sup> (<a href="http://www.csail.mit.edu/"><acronym title="Massachusetts Institute of Technology">MIT</acronym></a>, <a href="http://www.ercim.org/"><acronym title="European Research Consortium for Informatics and Mathematics">ERCIM</acronym></a>, <a href="http://www.keio.ac.jp/">Keio</a>), All Rights Reserved. W3C <a href="http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>, <a href="http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a> and <a href="http://www.w3.org/Consortium/Legal/copyright-documents">document use</a> rules apply.</p></div><hr/><div> <h2><a name="abstract" id="abstract"/>Abstract</h2><p> This specification describes a general SOAP-based protocol for enumerating a sequence of XML elements that @@ -69,15 +70,15 @@ 5.10 <a href="#EndToNotSupported">EndToNotSupported</a><br/> 5.11 <a href="#EmptyFilter">EmptyFilter</a><br/> 6 <a href="#Security">Security Considerations</a><br/> - 6.1 <a href="#iddiv2_1_1936">Creating Enumeration Contexts</a><br/> - 6.2 <a href="#iddiv2_1_1941">Protecting Enumeration Contexts</a><br/> - 6.3 <a href="#iddiv2_1_1948">Endpoint Verification</a><br/> + 6.1 <a href="#iddiv2x1x1936">Creating Enumeration Contexts</a><br/> + 6.2 <a href="#iddiv2x1x1941">Protecting Enumeration Contexts</a><br/> + 6.3 <a href="#iddiv2x1x1948">Endpoint Verification</a><br/> 7 <a href="#metadata">WS-Enumeration Metadata</a><br/> - 7.1 <a href="#iddiv2_1_1968">Enumeration Assertion</a><br/> + 7.1 <a href="#iddiv2x1x1968">Enumeration Assertion</a><br/> 8 <a href="#acks">Acknowledgements</a><br/> 9 <a href="#refs">References</a><br/> - 9.1 <a href="#iddiv2_1_2091">Normative References</a><br/> - 9.2 <a href="#iddiv2_1_2290">Informative References</a><br/> + 9.1 <a href="#iddiv2x1x2091">Normative References</a><br/> + 9.2 <a href="#iddiv2x1x2290">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/> @@ -658,7 +659,7 @@ (14) </s:Header> (15) <s:Body> (16) <wsen:EnumerateResponse> -(17) <wsen:Expires> PT10M </wsen:Expires> +(17) <wsen:GrantedExpires> PT10M </wsen:GrantedExpires> (18) <wsen:EnumerationContext> (19) 123 (20) </wsen:EnumerationContext> @@ -1146,24 +1147,24 @@ but the data source does not support Expires. </p><table border="1"><tbody><tr><td><b>[Code]</b></td><td> s12:Sender </td></tr><tr><td><b>[Subcode]</b></td><td> wsen:ExpiresNotSupported </td></tr><tr><td><b>[Reason]</b></td><td> The specification of an Expires element is not allowed. - </td></tr><tr><td><b>[Detail]</b></td><td/></tr></tbody></table></div><div class="div2"> + </td></tr><tr><td><b>[Detail]</b></td><td> </td></tr></tbody></table></div><div class="div2"> <h3><a name="UnsupportedExpirationValue" id="UnsupportedExpirationValue"/>5.2 UnsupportedExpirationValue</h3><p> This fault MUST be generated when a request specifies an expiration that is not within the min/max range. </p><table border="1"><tbody><tr><td><b>[Code]</b></td><td> s12:Sender </td></tr><tr><td><b>[Subcode]</b></td><td> wsen:UnsupportedExpirationValue </td></tr><tr><td><b>[Reason]</b></td><td> The expiration time requested is not within the min/max range. - </td></tr><tr><td><b>[Detail]</b></td><td/></tr></tbody></table></div><div class="div2"> + </td></tr><tr><td><b>[Detail]</b></td><td> </td></tr></tbody></table></div><div class="div2"> <h3><a name="UnsupportedExpirationTime" id="UnsupportedExpirationTime"/>5.3 UnsupportedExpirationTime</h3><p> This fault MUST be generated when the Enumerate expiration time that is specified is not 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"> + </td></tr><tr><td><b>[Detail]</b></td><td> </td></tr></tbody></table></div><div class="div2"> <h3><a name="FilteringNotSupported" id="FilteringNotSupported"/>5.4 FilteringNotSupported</h3><p> This fault MUST generated when 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"> + </td></tr><tr><td><b>[Detail]</b></td><td> </td></tr></tbody></table></div><div class="div2"> <h3><a name="FilterDialectRequestedUnavailable" id="FilterDialectRequestedUnavailable"/>5.5 FilterDialectRequestedUnavailable</h3><p> This fault MUST be generated when the data source does not support the requested filter dialect. @@ -1178,7 +1179,7 @@ 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"> + </td></tr><tr><td><b>[Detail]</b></td><td> </td></tr></tbody></table></div><div class="div2"> <h3><a name="InvalidEnumerationContext" id="InvalidEnumerationContext"/>5.7 InvalidEnumerationContext</h3><p> This fault MUST be generated when 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> @@ -1187,11 +1188,11 @@ "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"> + </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.8 TimedOut</h3><p> This fault MUST be generated when the data source times out during the processing of a Pull 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/></tr></tbody></table></div><div class="div2"> + </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.9 UnusableEPR</h3><p> This fault MUST be generated when a data source detects that the wsen:EndTo EPR is unusable. @@ -1225,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="iddiv2_1_1936" id="iddiv2_1_1936"/>6.1 Creating Enumeration Contexts</h3><p> +<h3><a name="iddiv2x1x1936" id="iddiv2x1x1936"/>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 @@ -1236,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="iddiv2_1_1941" id="iddiv2_1_1941"/>6.2 Protecting Enumeration Contexts</h3><p> +<h3><a name="iddiv2x1x1941" id="iddiv2x1x1941"/>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 @@ -1258,7 +1259,7 @@ Data Sources are advised to authenticate and authorize clients sending Pull requests. </p></div><div class="div2"> -<h3><a name="iddiv2_1_1948" id="iddiv2_1_1948"/>6.3 Endpoint Verification</h3><p> +<h3><a name="iddiv2x1x1948" id="iddiv2x1x1948"/>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 @@ -1300,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="iddiv2_1_1968" id="iddiv2_1_1968"/>7.1 Enumeration Assertion</h3><p> +<h3><a name="iddiv2x1x1968" id="iddiv2x1x1968"/>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 - @@ -1411,7 +1412,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="iddiv2_1_2091" id="iddiv2_1_2091"/>9.1 Normative References</h3><dl><dt class="label"><a name="RFC2119" id="RFC2119"/>RFC 2119</dt><dd><a href="http://www.ietf.org/rfc/rfc2119.txt"><cite> +<h3><a name="iddiv2x1x2091" id="iddiv2x1x2091"/>9.1 Normative References</h3><dl><dt class="label"><a name="RFC2119" id="RFC2119"/>RFC 2119</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, Author. @@ -1488,7 +1489,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="iddiv2_1_2290" id="iddiv2_1_2290"/>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="iddiv2x1x2290" id="iddiv2x1x2290"/>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> @@ -1980,9 +1981,9 @@ [msg] </code></td><td valign="top" nowrap="true"><code> Create new context <br/> Send EnumerateResponse <br/> - {<a href="#Enumerate"><b>4.1</b></a>}</code></td><td/><td/></tr><tr><td valign="top" nowrap="true"><code> + {<a href="#Enumerate"><b>4.1</b></a>}</code></td><td> </td><td> </td></tr><tr><td valign="top" nowrap="true"><code> Pull Request <br/> - [msg]</code></td><td/><td valign="top" nowrap="true"><code> + [msg]</code></td><td> </td><td valign="top" nowrap="true"><code> If (end of sequence) {<br/> include EndOfSequence <br/> invalidate context<br/> @@ -1994,7 +1995,7 @@ Fault<br/> {<a href="#EnumMsgs"><b>4</b></a>}</code></td></tr><tr><td valign="top" nowrap="true"><code> Renew Request <br/> - [msg] </code></td><td/><td valign="top" nowrap="true"><code> + [msg] </code></td><td> </td><td valign="top" nowrap="true"><code> Update expiration timer<br/> Send RenewReponse<br/> {<a href="#Renew"><b>4.3</b></a>}</code></td><td valign="top" nowrap="true"><code> @@ -2003,7 +2004,7 @@ Fault<br/> {<a href="#EnumMsgs"><b>4</b></a>}</code></td></tr><tr><td valign="top" nowrap="true"><code> GetStatus Request <br/> - [msg] </code></td><td/><td valign="top" nowrap="true"><code> + [msg] </code></td><td> </td><td valign="top" nowrap="true"><code> Send GetStatusResponse <br/> {<a href="#GetStatus"><b>4.4</b></a>}</code></td><td valign="top" nowrap="true"><code> Generate <br/> @@ -2011,7 +2012,7 @@ Fault<br/> {<a href="#EnumMsgs"><b>4</b></a>}</code></td></tr><tr><td valign="top" nowrap="true"><code> Release Request <br/> - [msg] </code></td><td/><td valign="top" nowrap="true"><code> + [msg] </code></td><td> </td><td valign="top" nowrap="true"><code> Send wse:ReleaseResponse<br/> Invalidate context<br/> {<a href="#Release"><b>4.5</b></a>}</code></td><td valign="top" nowrap="true"><code> @@ -2020,15 +2021,15 @@ Fault<br/> {<a href="#EnumMsgs"><b>4</b></a>}</code></td></tr><tr><td valign="top" nowrap="true"><code> Expiration <br/> - [timer] </code></td><td/><td valign="top" nowrap="true"><code> + [timer] </code></td><td> </td><td valign="top" nowrap="true"><code> Invalidate context<br/> - {<a href="#Enumerate"><b>4.1</b></a>}</code></td><td/></tr><tr><td valign="top" nowrap="true"><code> + {<a href="#Enumerate"><b>4.1</b></a>}</code></td><td> </td></tr><tr><td valign="top" nowrap="true"><code> Shutdown/Error <br/> - [app] </code></td><td/><td valign="top" nowrap="true"><code> + [app] </code></td><td> </td><td valign="top" nowrap="true"><code> if (EndTo engaged) <br/> send EnumerationEnd <br/> Invalidate context <br/> - {<a href="#EnumerationEnd"><b>4.6</b></a>}</code></td><td/></tr></tbody></table><p/><table border="1"><caption>Table C-2: Consumer Action Table</caption><tbody><tr><td valign="bottom"><b>Trigger</b></td><td align="center"><b>Action</b></td></tr><tr><td valign="top" nowrap="true"><code> + {<a href="#EnumerationEnd"><b>4.6</b></a>}</code></td><td> </td></tr></tbody></table><p/><table border="1"><caption>Table C-2: Consumer Action Table</caption><tbody><tr><td valign="bottom"><b>Trigger</b></td><td align="center"><b>Action</b></td></tr><tr><td valign="top" nowrap="true"><code> Expiration<br/> [timer] </code></td><td valign="top" nowrap="true"><code> Invalidate context<br/> Index: wsenum.xml =================================================================== RCS file: /w3ccvs/WWW/2002/ws/ra/edcopies/wsenum.xml,v retrieving revision 1.130 retrieving revision 1.131 diff -u -d -r1.130 -r1.131 --- wsenum.xml 13 May 2010 21:33:10 -0000 1.130 +++ wsenum.xml 16 Jun 2010 21:36:34 -0000 1.131 @@ -1093,7 +1093,7 @@ (14) </s:Header> (15) <s:Body> (16) <wsen:EnumerateResponse> -(17) <wsen:Expires> PT10M </wsen:Expires> +(17) <wsen:GrantedExpires> PT10M </wsen:GrantedExpires> (18) <wsen:EnumerationContext> (19) 123 (20) </wsen:EnumerationContext>
Received on Wednesday, 16 June 2010 21:36:39 UTC