W3C home > Mailing lists > Public > public-ws-resource-access-notifications@w3.org > October 2009

WWW/2002/ws/ra/edcopies wsfrag.html,1.18,1.19 wsfrag.xml,1.19,1.20

From: Doug Davis via cvs-syncmail <cvsmail@w3.org>
Date: Mon, 05 Oct 2009 15:18:25 +0000
To: public-ws-resource-access-notifications@w3.org
Message-Id: <E1MupKT-000768-No@lionel-hutz.w3.org>
Update of /w3ccvs/WWW/2002/ws/ra/edcopies
In directory hutz:/tmp/cvs-serv27107

Modified Files:
	wsfrag.html wsfrag.xml 
Log Message:
6407, 6721


Index: wsfrag.html
===================================================================
RCS file: /w3ccvs/WWW/2002/ws/ra/edcopies/wsfrag.html,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -d -r1.18 -r1.19
--- wsfrag.html	2 Oct 2009 15:50:32 -0000	1.18
+++ wsfrag.html	5 Oct 2009 15:18:23 -0000	1.19
@@ -53,8 +53,8 @@
 &nbsp;&nbsp;&nbsp;3.2 <a href="#Put">Put</a><br/>
 &nbsp;&nbsp;&nbsp;3.3 <a href="#Delete">Delete</a><br/>
 &nbsp;&nbsp;&nbsp;3.4 <a href="#Create">Create</a><br/>
-4 <a href="#iddiv1_1_754">Examples</a><br/>
-&nbsp;&nbsp;&nbsp;4.1 <a href="#iddiv2_1_757">Examples</a><br/>
+4 <a href="#iddiv1_1_774">Examples</a><br/>
+&nbsp;&nbsp;&nbsp;4.1 <a href="#iddiv2_1_777">Examples</a><br/>
 5 <a href="#QName">QName Expression Language</a><br/>
 6 <a href="#XPathL1">XPath Level 1 Expression Language</a><br/>
 7 <a href="#XPath10">XPath 1.0 Expression Language</a><br/>
@@ -63,13 +63,15 @@
 &nbsp;&nbsp;&nbsp;8.2 <a href="#InvalidFragment">InvalidFragment</a><br/>
 &nbsp;&nbsp;&nbsp;8.3 <a href="#InvalidExpression">InvalidExpression</a><br/>
 &nbsp;&nbsp;&nbsp;8.4 <a href="#UnsupportedMode">UnsupportedMode</a><br/>
-9 <a href="#policy">WS-Fragment Policy Assertion(s)</a><br/>
+9 <a href="#metadata">WS-Fragment Metadata</a><br/>
+&nbsp;&nbsp;&nbsp;9.1 <a href="#iddiv2_1_1437">Fragment Assertion</a><br/>
 10 <a href="#acks">Acknowledgements</a><br/>
 11 <a href="#refs">References</a><br/>
-&nbsp;&nbsp;&nbsp;11.1 <a href="#iddiv2_1_1427">Normative References</a><br/>
+&nbsp;&nbsp;&nbsp;11.1 <a href="#iddiv2_1_1493">Normative References</a><br/>
 </p>
 <h3><a name="appendices" id="appendices"/>Appendices</h3><p class="toc">A <a href="#Appendix_I__E2_80_93_XSD">XML Schema</a><br/>
-B <a href="#ChangeLog">Change Log</a><br/>
+B <a href="#policyXSD">Fragment Policy Schema</a><br/>
+C <a href="#ChangeLog">Change Log</a><br/>
 </p></div><hr/><div class="body"><div class="div1">
 <h2><a name="intro" id="intro"/>1 Introduction</h2><p>
     This specification extends the WS-Transfer specification and defines
@@ -123,6 +125,8 @@
       Prefixes and XML Namespaces used in this specification.
      </caption><tbody><tr><th align="left"> Prefix </th><th align="left"> XML Namespace </th><th align="left"> Specification(s) </th></tr><tr><td> wsf </td><td><a href="http://www.w3.org/2009/09/ws-fra">http://www.w3.org/2009/09/ws-fra</a></td><td>
         This specification
+       </td></tr><tr><td> wsf </td><td><a href="http://www.w3.org/2009/09/ws-fra">http://www.w3.org/2009/09/ws-frp</a></td><td>
+        This specification
        </td></tr><tr><td> s </td><td> Either SOAP 1.1 or 1.2 </td><td> SOAP </td></tr><tr><td> s11 </td><td><a href="http://schemas.xmlsoap.org/soap/envelope/">http://schemas.xmlsoap.org/soap/envelope/</a></td><td><a href="#SOAP11">[SOAP11]</a></td></tr><tr><td> s12 </td><td><a href="http://www.w3.org/2003/05/soap-envelope">http://www.w3.org/2003/05/soap-envelope</a></td><td><a href="#SOAP121">[SOAP12]</a></td></tr><tr><td> wsa </td><td><a href="http://www.w3.org/2005/08/addressing">http://www.w3.org/2005/08/addressing</a></td><td><a href="#AddrCore">[WS-Addressing]</a></td></tr><tr><td> xs </td><td><a href="http://www.w3.org/2001/XMLSchema">http://www.w3.org/2001/XMLSchema</a></td><td> 
         XML Schema <a href="#XMLSchema1">[XMLSchema - Part 1]</a>, <a href="#XMLSchema2">[XMLSchema - Part 2]</a></td></tr><tr><td> wst </td><td><a href="http://www.w3.org/2009/09/ws-tra">http://www.w3.org/2009/09/ws-tra</a></td><td><a href="#WsTransfer">[WS-Transfer]</a></td></tr></tbody></table><p>
      The working group intends to update the value of the Web Services
@@ -405,8 +409,8 @@
      This specification does not extend the Create operation defined in
      WS-Transfer.
     </p></div></div><div class="div1">
-<h2><a name="iddiv1_1_754" id="iddiv1_1_754"/>4 Examples</h2><div class="div2">
-<h3><a name="iddiv2_1_757" id="iddiv2_1_757"/>4.1 Examples</h3><p>
+<h2><a name="iddiv1_1_774" id="iddiv1_1_774"/>4 Examples</h2><div class="div2">
+<h3><a name="iddiv2_1_777" id="iddiv2_1_777"/>4.1 Examples</h3><p>
      In the following examples, and Expression Language definitions,
      the following representation of a resource is used for
      informational purposes:
@@ -824,13 +828,57 @@
     </p><a name="Table6" id="Table6"/><table border="1" cellpadding="5"><tbody><tr><th align="left"><b>[Code]</b></th><td>s:Sender</td></tr><tr><th align="left"><b>[Subcode]</b></th><td>wst:UnsupportedMode</td></tr><tr><th align="left"><b>[Reason]</b></th><td>
         The specified mode is not supported.
        </td></tr><tr><th align="left"><b>[Detail]</b></th><td><em>The unsupported Mode.</em></td></tr></tbody></table></div></div><div class="div1">
-<h2><a name="policy" id="policy"/>9 WS-Fragment Policy Assertion(s)</h2><p>
+<h2><a name="metadata" id="metadata"/>9 WS-Fragment Metadata</h2><p>
     An endpoint MAY indicate that it supports WS-Fragment, or its features,
-    by including the WS-Fragment Policy assertion(s) within its WSDL. By
+    by including the WS-Fragment Policy assertion within its WSDL. By
     doing so the endpoint is indicating that the corresponding WS-Fragment
-    operations are supported by that endpoint even though they do not
-    explicitly appear in its WSDL.
-   </p></div><div class="div1">
+    features are supported by that endpoint.
+   </p><div class="div2">
+<h3><a name="iddiv2_1_1437" id="iddiv2_1_1437"/>9.1 Fragment Assertion</h3><p>
+     The mechanism for indicating that a binding or endpoint conforms to the
+     WS-Fragment specification is through the use of the Web Services
+     Policy - Framework <a href="#wspolicy">[WS-Policy]</a> and Web Services Policy -
+     Attachment <a href="#wspolicyattach">[WS-Policy Attachment]</a> specifications.
+    </p><p>
+     This specification defines a policy assertion (wsfrp:Fragment).  The
+     wsfrp:Fragment policy assertion applies to the endpoint policy subject.
+    </p><p>
+     For WSDL 1.1, these assertions may be attached to wsdl11:port or
+     wsdl11:binding. For WSDL 2.0, they may be attached to wsdl20:endpoint or
+     wsdl20:binding. A policy expression containing the wsfrp:Fragment
+     policy assertion MUST NOT be attached to a wsdl:portType or
+     wsdl20:interface.
+    </p><p>
+     The wsfrp:Fragment policy assertion is a nested policy container
+     assertion. The meaning of this assertion, when present in a policy
+     alternative, is that WS-Fragment is required to communicate with the
+     subject. In order to indicate that the subject supports WS-Fragment
+     but does not require its use, an additional policy alternative should
+     be provided which does not contain this assertion; the compact
+     authoring style for an optional policy assertion provided by WS-Policy
+     may be used. The wsp:Optional attribute, as a syntactic shortcut, can be
+     used with the wsfrp:Fragment assertion. This indicates two policy
+     alternatives, one which contains the policy assertion, and another
+     which does not.
+    </p><p>
+     The inclusion of this assertion implies support for the WS-Fragment
+     specification.
+    </p><p>
+     The normative outline of this assertion is:
+    </p><div class="exampleOuter"><div class="exampleInner"><pre>&lt;wsfrp:Fragment [wsp:Optional="<em>xs:boolean</em>"]? ...&gt;
+  &lt;wsfrp:Language ...&gt; <em>xs:anyURI</em> &lt;/wsfrp:Language&gt; * 
+  ... 
+&lt;/wsfrp:Fragment&gt;</pre></div></div><p>
+     The following describes additional, normative constraints on the
+     outline listed above:
+    </p><dl><dt class="label"> /wsfrp:Fragment </dt><dd><p>
+         A policy assertion that specifies that WS-Fragment protocol MUST
+         be used when communicating with this endpoint. This assertion has
+         Endpoint Policy Subject.
+        </p></dd><dt class="label"> /wsfrp:Fragment/wsfrp:Language </dt><dd><p>
+         When present, this parameter indicates support for the specified
+         Language IRI.
+        </p></dd></dl></div></div><div class="div1">
 <h2><a name="acks" id="acks"/>10 Acknowledgements</h2><p>
     This specification has been developed as a result of joint
     work with many individuals and teams, including: 
@@ -855,7 +903,7 @@
      Yves Lafon (W3C).
    </p></div><div class="div1">
 <h2><a name="refs" id="refs"/>11 References</h2><div class="div2">
-<h3><a name="iddiv2_1_1427" id="iddiv2_1_1427"/>11.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="iddiv2_1_1493" id="iddiv2_1_1493"/>11.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.
@@ -896,7 +944,12 @@
        </cite></a>
        , A. Vedamuthu, et al., Editors.
        World Wide Web Consortium (W3C), 4 September 2007.
-      Available at <a href="http://www.w3.org/TR/ws-policy/">http://www.w3.org/TR/ws-policy/</a>.</dd><dt class="label"><a name="WsTransfer" id="WsTransfer"/>WS-Transfer</dt><dd><a href="http://www.w3.org/TR/ws-transfer"><cite>
+      Available at <a href="http://www.w3.org/TR/ws-policy/">http://www.w3.org/TR/ws-policy/</a>.</dd><dt class="label"><a name="wspolicyattach" id="wspolicyattach"/>WS-Policy Attachment</dt><dd><a href="http://www.w3.org/TR/ws-policy-attach"><cite>
+        W3C Recommendation, "Web Services Policy (WS-Policy) 1.5 - Attachment"
+       </cite></a>
+       , A. Vedamuthu, et al., Editors.
+       World Wide Web Consortium (W3C), 4 September 2007.
+      Available at <a href="http://www.w3.org/TR/ws-policy-attach">http://www.w3.org/TR/ws-policy-attach</a>.</dd><dt class="label"><a name="WsTransfer" id="WsTransfer"/>WS-Transfer</dt><dd><a href="http://www.w3.org/TR/ws-transfer"><cite>
        W3C Working Group Draft, "Web Services Transfer (WS-Transfer)1.1"
       </cite></a>
       , D. Davis, et al., Editors.
@@ -969,7 +1022,16 @@
   &lt;/xs:element&gt;
 
 &lt;/xs:schema&gt;  </pre></div></div></div><div class="div1">
-<h2><a name="ChangeLog" id="ChangeLog"/>B Change Log</h2><table border="1"><tbody><tr><th> Data </th><th> Author </th><th> Description </th></tr><tr><td> 2009/08/01 </td><td> DD </td><td> Initial draft </td></tr><tr><td> 2009/08/18 </td><td> DD </td><td> Added resolution of issue 
+<h2><a name="policyXSD" id="policyXSD"/>B Fragment Policy Schema</h2><p>
+    A normative copy of the XML Schema description for the Fragment
+    Policy assertion can be retrieved from the following address:
+   </p><div class="exampleOuter"><div class="exampleInner"><pre>http://www.w3.org/2009/09/ws-frp/FragmentPolicy.xsd</pre></div></div><p>
+    A non-normative copy of the XML schema is listed below for convenience.
+   </p><div class="exampleOuter"><div class="exampleInner"><pre>&lt;wsfrp:Fragment [wsp:Optional="xs:boolean"]? ...&gt; 
+  &lt;wsfrp:Language ...&gt; xs:anyURI &lt;/wsfrp:Language&gt; * 
+  ... 
+&lt;/wsfrp:Fragment&gt;</pre></div></div></div><div class="div1">
+<h2><a name="ChangeLog" id="ChangeLog"/>C Change Log</h2><table border="1"><tbody><tr><th> Data </th><th> Author </th><th> Description </th></tr><tr><td> 2009/08/01 </td><td> DD </td><td> Initial draft </td></tr><tr><td> 2009/08/18 </td><td> DD </td><td> Added resolution of issue 
        <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=7206">7206</a></td></tr><tr><td> 2009/08/18 </td><td> DD </td><td> Added resolution of issue 
        <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=7197">7197</a></td></tr><tr><td> 2009/08/18 </td><td> DD </td><td> Added resolution of issue 
        <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=7270">7270</a></td></tr><tr><td> 2009/09/01 </td><td> DD </td><td> Added resolution of issue 
@@ -977,4 +1039,6 @@
        <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6694">6694</a></td></tr><tr><td> 2009/09/30 </td><td> DD </td><td> Added resolution of issue 
        <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=7088">7088</a></td></tr><tr><td> 2009/10/02 </td><td> DD </td><td> Added resolution of issue 
        <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=7770">7770</a></td></tr><tr><td> 2009/10/02 </td><td> DD </td><td> Added resolution of issue 
-       <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=7426">7426</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=7426">7426</a></td></tr><tr><td> 2009/10/05 </td><td> DD </td><td> Added resolution of issue 
+       <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6407">6407</a>,
+       <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6721">6721</a></td></tr></tbody></table></div></div></body></html>
\ No newline at end of file

Index: wsfrag.xml
===================================================================
RCS file: /w3ccvs/WWW/2002/ws/ra/edcopies/wsfrag.xml,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -d -r1.19 -r1.20
--- wsfrag.xml	2 Oct 2009 15:50:32 -0000	1.19
+++ wsfrag.xml	5 Oct 2009 15:18:23 -0000	1.20
@@ -210,6 +210,15 @@
        </td>
       </tr>
       <tr>
+       <td> wsf </td>
+       <td>
+        <loc href="http://www.w3.org/&wsfra.nsprefix;/ws-fra">http://www.w3.org/&wsfra.nsprefix;/ws-frp</loc>
+       </td>
+       <td>
+        This specification
+       </td>
+      </tr>
+      <tr>
        <td> s </td>
        <td> Either SOAP 1.1 or 1.2 </td>
        <td> SOAP </td>
@@ -1609,16 +1618,100 @@
 
   </div1>
 
-  <div1 id="policy">
-   <head>WS-Fragment Policy Assertion(s)</head>
+  <div1 id="metadata">
+   <head>WS-Fragment Metadata</head>
 
    <p>
     An endpoint MAY indicate that it supports WS-Fragment, or its features,
-    by including the WS-Fragment Policy assertion(s) within its WSDL. By
+    by including the WS-Fragment Policy assertion within its WSDL. By
     doing so the endpoint is indicating that the corresponding WS-Fragment
-    operations are supported by that endpoint even though they do not
-    explicitly appear in its WSDL.
+    features are supported by that endpoint.
    </p>
+
+   <div2>
+    <head>Fragment Assertion</head>
+
+    <p>
+     The mechanism for indicating that a binding or endpoint conforms to the
+     WS-Fragment specification is through the use of the Web Services
+     Policy - Framework <bibref ref="wspolicy"/> and Web Services Policy -
+     Attachment <bibref ref="wspolicyattach"/> specifications.
+    </p>
+
+    <p>
+     This specification defines a policy assertion (wsfrp:Fragment).  The
+     wsfrp:Fragment policy assertion applies to the endpoint policy subject.
+    </p>
+
+    <p>
+     For WSDL 1.1, these assertions may be attached to wsdl11:port or
+     wsdl11:binding. For WSDL 2.0, they may be attached to wsdl20:endpoint or
+     wsdl20:binding. A policy expression containing the wsfrp:Fragment
+     policy assertion MUST NOT be attached to a wsdl:portType or
+     wsdl20:interface.
+    </p>
+
+    <p>
+     The wsfrp:Fragment policy assertion is a nested policy container
+     assertion. The meaning of this assertion, when present in a policy
+     alternative, is that WS-Fragment is required to communicate with the
+     subject. In order to indicate that the subject supports WS-Fragment
+     but does not require its use, an additional policy alternative should
+     be provided which does not contain this assertion; the compact
+     authoring style for an optional policy assertion provided by WS-Policy
+     may be used. The wsp:Optional attribute, as a syntactic shortcut, can be
+     used with the wsfrp:Fragment assertion. This indicates two policy
+     alternatives, one which contains the policy assertion, and another
+     which does not.
+    </p>
+
+    <p>
+     The inclusion of this assertion implies support for the WS-Fragment
+     specification.
+    </p>
+
+    <p>
+     The normative outline of this assertion is:
+    </p>
+
+    <example>
+     <eg>&lt;wsfrp:Fragment [wsp:Optional="<emph>xs:boolean</emph>"]? ...>
+  &lt;wsfrp:Language ...> <emph>xs:anyURI</emph> &lt;/wsfrp:Language> * 
+  ... 
+&lt;/wsfrp:Fragment></eg>
+    </example>
+
+    <p>
+     The following describes additional, normative constraints on the
+     outline listed above:
+    </p>
+
+    <glist>
+
+     <gitem>
+      <label> /wsfrp:Fragment </label>
+       <def>
+        <p>
+         A policy assertion that specifies that WS-Fragment protocol MUST
+         be used when communicating with this endpoint. This assertion has
+         Endpoint Policy Subject.
+        </p>
+       </def>
+     </gitem>
+
+     <gitem>
+      <label> /wsfrp:Fragment/wsfrp:Language </label>
+       <def>
+        <p>
+         When present, this parameter indicates support for the specified
+         Language IRI.
+        </p>
+       </def>
+     </gitem>
+
+    </glist>
+
+   </div2>
   </div1>
 
   <div1 id="acks">
@@ -1728,6 +1821,15 @@
        World Wide Web Consortium (W3C), 4 September 2007.
      </bibl>
 
+     <bibl key="WS-Policy Attachment" id="wspolicyattach"
+      href="http://www.w3.org/TR/ws-policy-attach">
+       <titleref>
+        W3C Recommendation, "Web Services Policy (WS-Policy) 1.5 - Attachment"
+       </titleref>
+       , A. Vedamuthu, et al., Editors.
+       World Wide Web Consortium (W3C), 4 September 2007.
+     </bibl>
+
      <bibl key="WS-Transfer" id="WsTransfer" 
            href="http://www.w3.org/TR/ws-transfer">
       <titleref>
@@ -1846,6 +1948,31 @@
    </example>
   </div1>
 
+  <div1 id="policyXSD">
+   <head>Fragment Policy Schema</head>
+
+   <p>
+    A normative copy of the XML Schema description for the Fragment
+    Policy assertion can be retrieved from the following address:
+   </p>
+
+   <example>
+    <eg>http://www.w3.org/2009/09/ws-frp/FragmentPolicy.xsd</eg>
+   </example>
+
+   <p>
+    A non-normative copy of the XML schema is listed below for convenience.
+   </p>
+
+   <example>
+    <eg>&lt;wsfrp:Fragment [wsp:Optional="xs:boolean"]? ...> 
+  &lt;wsfrp:Language ...> xs:anyURI &lt;/wsfrp:Language> * 
+  ... 
+&lt;/wsfrp:Fragment></eg>
+   </example>
+  </div1>
+
+
   <div1 id="ChangeLog">
    <head>Change Log</head>
  
@@ -1917,6 +2044,14 @@
        <loc href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=7426">7426</loc>
       </td>
      </tr>
+     <tr>
+      <td> 2009/10/05 </td>
+      <td> DD </td>
+      <td> Added resolution of issue 
+       <loc href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6407">6407</loc>,
+       <loc href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6721">6721</loc>
+      </td>
+     </tr>
     </tbody>
    </table>
   </div1>
Received on Monday, 5 October 2009 15:18:32 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Monday, 5 October 2009 15:18:33 GMT