- From: David Orchard via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 12 Dec 2006 19:13:33 +0000
- To: public-ws-policy-eds@w3.org
Update of /sources/public/2006/ws/policy
In directory hutz:/tmp/cvs-serv11890
Modified Files:
wsdl11eientitieswd.dtd wsdl11elementidentifiers.html
wsdl11elementidentifiers.xml
Log Message:
Updated per PaulC and Umit comments
Index: wsdl11elementidentifiers.html
===================================================================
RCS file: /sources/public/2006/ws/policy/wsdl11elementidentifiers.html,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -d -r1.7 -r1.8
--- wsdl11elementidentifiers.html 24 Nov 2006 23:55:53 -0000 1.7
+++ wsdl11elementidentifiers.html 12 Dec 2006 19:13:31 -0000 1.8
@@ -30,37 +30,45 @@
margin: 4px}
</style><link rel="stylesheet" type="text/css" href="http://www.w3.org/StyleSheets/TR/W3C-WD.css"></head><body><div class="head"><p><a href="http://www.w3.org/"><img src="http://www.w3.org/Icons/w3c_home" alt="W3C" height="48" width="72"></a></p>
<h1><a name="title" id="title"></a>WSDL 1.1 Element Identifiers</h1>
-<h2><a name="w3c-doctype" id="w3c-doctype"></a>W3C Note 24 November 2006</h2><dl><dt>This version:</dt><dd><a href="http://dev.w3.org/cvsweb/~checkout~/2006/ws/policy/wsdl11elementidentifiers.html">http://dev.w3.org/cvsweb/~checkout~/2006/ws/policy/wsdl11elementidentifiers.html</a></dd><dt>Previous version:</dt><dd>
+<h2><a name="w3c-doctype" id="w3c-doctype"></a>W3C Working Draft 12 December 2006</h2><dl><dt>This version:</dt><dd><a href="http://dev.w3.org/cvsweb/~checkout~/2006/ws/policy/wsdl11elementidentifiers.html">http://dev.w3.org/cvsweb/~checkout~/2006/ws/policy/wsdl11elementidentifiers.html</a></dd><dt>Previous version:</dt><dd>
</dd><dt>Editor:</dt><dd>David Orchard, BEA Systems</dd></dl><p class="copyright"><a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> © 2006 <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"></a>Abstract</h2><p>This document defines a syntax to identify individual elements in a WSDL 1.1 document.</p></div><div>
+<h2><a name="abstract" id="abstract"></a>Abstract</h2><p>WSDL 1.1 element identifiers defines a syntax to identify individual elements in a WSDL 1.1 document.</p></div><div>
<h2><a name="status" id="status"></a>Status of this Document</h2><p>
This section describes the status of this document at the time of its
publication. Other documents may supersede this document. A list of
current W3C publications and the latest revision of this technical report
-can be found in the W3C technical reports index at <a href="http://www.w3.org/TR/">http://www.w3.org/TR</a>.
-(say about version) It has been produced by the WS-Policy Working Group
-which is part of the Web Services Activity.
-The current intention of the Working Groups is to issue the final version
-of this specification as a Working Group Note.</p><p>
-Comments on this document are welcome. Please send them to the public
-mailing-list <a href="mailto:ws-policy-comments@w3.org">ws-policy-comments@w3.org</a> (<a href="http://lists.w3.org/Archives/Public/ws-policy-comments/">archive</a>). It is inappropriate to send
-discussion email to this address.
-Publication as a Note does not imply endorsement by the W3C
-Membership. This is a draft document and may be updated, replaced or
-obsoleted by other documents at any time. It is inappropriate to cite this
-document as other than work in progress.
-</p></div><div class="toc">
+can be found in the W3C technical reports index at <a href="http://www.w3.org/TR/">http://www.w3.org/TR</a>.</p><p>This is the <a href="http://www.w3.org/Consortium/Process/tr.html#first-wd">First Public
+Working Draft</a> of the Web Services Policy 1.5 - Framework specification.
+This Working Draft was produced by the members of the <a href="http://www.w3.org/2002/ws/policy/">Web Services Policy Working Group</a>.
+The Working Group expects to advance this Working Draft to Note Status when the
+content is stable. Note that this Working Draft does not necessarily represent
+a consensus of the Working Group. </p><p>Discussion of this document takes place on the
+public <a href="mailto:public-ws-policy@w3.org">public-ws-policy@w3.org</a>
+mailing list (<a href="http://lists.w3.org/Archives/Public/public-ws-policy/">public
+archive</a>) and within <a href="http://www.w3.org/Bugs/Public/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=WS-Policy&component=Framework&component=Framework%2BAttachment&component=Framework%2BAttachment%2BPrimer">Bugzilla</a>.
+Comments on this specification should be made following the <a href="http://www.w3.org/2002/ws/policy/#issues">Description for Issues</a> of
+the Working Group.</p><p>Publication as a Working Draft does not imply
+endorsement by the W3C Membership. This is a draft document and may be updated,
+replaced or obsoleted by other documents at any time. It is inappropriate to
+cite this document as other than work in progress.</p><p>This document was produced by a group operating
+under the <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/">5
+February 2004 W3C Patent Policy</a>. W3C maintains a <a href="http://www.w3.org/2004/01/pp-impl/39293/status">public list of any patent
+disclosures</a> made in connection with the deliverables of the group; that
+page also includes instructions for disclosing a patent. An individual who has
+actual knowledge of a patent which the individual believes contains <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/#def-essential">Essential
+Claim(s)</a> must disclose the information in accordance with <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/#sec-Disclosure">section
+6 of the W3C Patent Policy</a></p></div><div class="toc">
<h2><a name="contents" id="contents"></a>Table of Contents</h2><p class="toc">1 <a href="#intro">Introduction</a><br>
1.1 <a href="#notcon">Notational Conventions</a><br>
2 <a href="#frag-ids">Fragment Identifiers</a><br>
3 <a href="#wsdl-iri-references">IRI-References for WSDL 1.1 Elements</a><br>
3.1 <a href="#wsdl-iris">WSDL 1.1 IRIs</a><br>
3.2 <a href="#soap-binding-decl-fragid">IRI Identification Of SOAP Binding elements</a><br>
- 3.3 <a href="#Iri-ref-ex">Example</a><br>
+ 3.3 <a href="#element-designator-canonical-form">Canonical Form for WSDL 1.1 element identifiers</a><br>
+ 3.4 <a href="#Iri-ref-ex">Example</a><br>
4 <a href="#refs">References</a><br>
4.1 <a href="#refs-norm">Normative References</a><br>
- 4.2 <a href="#refs-inform">Informative References</a><br>
</p>
<h3><a name="appendices" id="appendices"></a>Appendix</h3><p class="toc">A <a href="#changelog">Change Log</a> (Non-Normative)<br>
</p></div><hr><div class="body"><div class="div1">
@@ -110,10 +118,10 @@
The fragment identifier in a WSDL 1.1 element IRI-reference
MUST resolve to some element as defined by the construction rules
in <b><a href="#frag-ids-table">???</a></b>.
- </p><a name="frag-ids-table" id="frag-ids-table"></a><table border="1"><caption>Rules for determining pointer parts for WSDL 1.1 elements</caption><col width="19%" span="1"><col width="12%" span="1"><col width="12%" span="1"><col width="12%" span="1"><col width="45%" span="1"><tbody><tr><th>element</th><th>1</th><th>2</th><th>3</th><th>Pointer Part</th></tr><tr><td>Definitions</td><td>n/a</td><td>n/a</td><td>n/a</td><td><code>wsdl11.definitions()</code></td></tr><tr><td>Type Definition</td><td><code>types</code> QName </td><td>n/a</td><td>n/a</td><td><code>wsdl11.types(<em>types</em>)</code></td></tr><tr><td>Element Declaration</td><td><code>element</code> QName </td><td>n/a</td><td>n/a</td><td><code>wsdl11.elementDeclaration(<em>elementDeclaration</em>)</code></td></tr><tr><td>Message</td><td><code>message</code> NCName</td><td>n/a</td><td>n/a</td><td><code>wsdl11.message(<em>message</em>)</code></td></tr><tr><td>Message Part</td><td><code>message</code> NCName</td><td><code>part</code> NCName</td><td>n/</td><td><code>wsdl11.messagePart(<em>message/part</em>)</code></td></tr><tr><td>portType</td><td><code>portType</code> NCName </td><td>n/a</td><td>n/a</td><td><code>wsdl11.portType(<em>portType</em>)</code></td></tr><tr><td>portType Operation</td><td><code>portType</code> NCName</td><td><code>operation</code> NCName</td><td>n/a</td><td><code>wsdl11.portTypeOperation(<em>portType/operation</em>)</code></td></tr><tr><td>portType Message Reference</td><td><code>portType</code> NCName</td><td><code>operation</code> NCName</td><td><code>message</code> NCName</td><td><code>wsdl11.portTypeMessageReference(<em>portType/operation/message</em>)</code></td></tr><tr><td>portType Operation Fault</td><td><code>portType</code> NCName</td><td><code>operation</code> NCName</td><td><code>fault</code> QName</td><td><code>wsdl11.portTypeOperationFault(<em>portType/operation/fault</em>)</code></td></tr><tr><td>Binding</td><td><code>binding</code> NCName</td><td>n/a</td><td>n/a</td><td><code>wsdl11.binding(<em>binding</em>)</coe></td></tr><tr><td>Binding Operation</td><td><code>binding</code> NCName</td><td><code>operation</code> QName</td><td>n/a</td><td><code>wsdl11.bindingOperation(<em>binding/operation</em>)</code></td></tr><tr><td>Binding Message Reference</td><td><code>binding</code> NCName</td><td><code>operation</code> QName</td><td><code>message</code> NCName</td><td><code>wsdl11.bindingMessageReference(<em>binding/operation/message</em>)</code></td></tr><tr><td>Binding Operation Fault</td><td><code>binding</code> NCName</td><td><code>operation</code> QName</td><td><code>fault</code> NCName</td><td><code>wsdl11.bindingOperationFault(<em>binding/operation/fault</em>)</code></td></tr><tr><td>Service</td><td><code>service</code> NCName</td><td>n/a</td><td>n/a</td><td><code>wsdl11.service(<em>service</em>)</code></td></tr><tr><td>port</td><td><code>service</code> NCName</td><td><code>port</code> NCName</td><td>n/a</td><td><code>wsdl11.port(<em>service/port</em>)</code></td></tr><tr><td>Extensions</td><td><code>namespace</cod> URI</td><td><code>identifier</code> extension-specific-syntax</td><td>n/a</td><td><code>wsdl11.extension(<em>namespace,identifier</em>)</code></td></tr></tbody></table></div><div class="div1">
+ </p><a name="frag-ids-table" id="frag-ids-table"></a><table border="1"><caption>Rules for determining pointer parts for WSDL 1.1 elements</caption><col width="19%" span="1"><col width="12%" span="1"><col width="12%" span="1"><col width="12%" span="1"><col width="45%" span="1"><tbody><tr><th>element</th><th>1</th><th>2</th><th>3</th><th>Pointer Part</th></tr><tr><td>Definitions</td><td>n/a</td><td>n/a</td><td>n/a</td><td><code>wsdl11.definitions()</code></td></tr><tr><td>Type Definition</td><td><code>types</code> QName </td><td>n/a</td><td>n/a</td><td><code>wsdl11.types(<em>types</em>)</code></td></tr><tr><td>Element Declaration</td><td><code>element</code> QName </td><td>n/a</td><td>n/a</td><td><code>wsdl11.elementDeclaration(<em>element</em>)</code></td></tr><tr><td>Message</td><td><code>message</code> NCName</td><td>n/a</td><td>n/a</td><td><code>wsdl11.message(<em>message</em>)</code></td></tr><tr><td>Message Part</td><td><code>message</code> NCName</td><td><code>part</code> NCName</td><td>n/a</td><td><ode>wsdl11.messagePart(<em>message/part</em>)</code></td></tr><tr><td>portType</td><td><code>portType</code> NCName </td><td>n/a</td><td>n/a</td><td><code>wsdl11.portType(<em>portType</em>)</code></td></tr><tr><td>portType Operation</td><td><code>portType</code> NCName</td><td><code>operation</code> NCName</td><td>n/a</td><td><code>wsdl11.portTypeOperation(<em>portType/operation</em>)</code></td></tr><tr><td>portType Message Reference</td><td><code>portType</code> NCName</td><td><code>operation</code> NCName</td><td><code>message</code> NCName</td><td><code>wsdl11.portTypeMessageReference(<em>portType/operation/message</em>)</code></td></tr><tr><td>portType Operation Fault</td><td><code>portType</code> NCName</td><td><code>operation</code> NCName</td><td><code>fault</code> QName</td><td><code>wsdl11.portTypeOperationFault(<em>portType/operation/fault</em>)</code></td></tr><tr><td>Binding</td><td><code>binding</code> NCName</td><td>n/a</td><td>n/a</td><td><code>wsdl11.binding(<em>binding</em>)</code></td></t><tr><td>Binding Operation</td><td><code>binding</code> NCName</td><td><code>operation</code> QName</td><td>n/a</td><td><code>wsdl11.bindingOperation(<em>binding/operation</em>)</code></td></tr><tr><td>Binding Message Reference</td><td><code>binding</code> NCName</td><td><code>operation</code> QName</td><td><code>message</code> NCName</td><td><code>wsdl11.bindingMessageReference(<em>binding/operation/message</em>)</code></td></tr><tr><td>Binding Operation Fault</td><td><code>binding</code> NCName</td><td><code>operation</code> QName</td><td><code>fault</code> NCName</td><td><code>wsdl11.bindingOperationFault(<em>binding/operation/fault</em>)</code></td></tr><tr><td>Service</td><td><code>service</code> NCName</td><td>n/a</td><td>n/a</td><td><code>wsdl11.service(<em>service</em>)</code></td></tr><tr><td>port</td><td><code>service</code> NCName</td><td><code>port</code> NCName</td><td>n/a</td><td><code>wsdl11.port(<em>service/port</em>)</code></td></tr><tr><td>Extensions</td><td><code>namespace</code> URI</td>td><code>identifier</code> extension-specific-syntax</td><td>n/a</td><td><code>wsdl11.extension(<em>namespace,identifier</em>)</code></td></tr></tbody></table></div><div class="div1">
<h2><a name="wsdl-iri-references" id="wsdl-iri-references"></a>3 IRI-References for WSDL 1.1 Elements</h2><p>
- This appendix provides a syntax for IRI-references for all
- elements found in a WSDL 1.1 document. The IRI-references are easy
+ This section provides a syntax for IRI-references for all
+ elements found in a <a href="#WSDL11">[WSDL 1.1]</a> document. The IRI-references are easy
to understand and compare, while imposing no burden on the WSDL 1.1
author.
</p><div class="div2">
@@ -121,12 +129,12 @@
The IRI of a WSDL 1.1 document can be dereferenced to give a
resource representation that contributes elements
to a single WSDL 1.1 namespace. If the media type is set to the WSDL 1.1
- media type, then the fragment identifiers can be used to
+ media type i.e. application/xml, then the fragment identifiers can be used to
identify the main elements that are defined in the document.
</p><p>
- In keeping with the WSDL 1.1, which has a recommendation that
+ In keeping with WSDL 1.1, which has a recommendation that
that the namespace URI be dereferencible to a WSDL 1.1 document,
- this appendix specifies the use of the namespace IRI with the
+ this section specifies the use of the namespace IRI with the
WSDL 1.1 fragment identifiers to form an IRI-reference.
</p><p>
The IRI in an IRI-reference for a WSDL 1.1 element is the
@@ -150,7 +158,7 @@
in
<a href="#XPTR">[XPointer Framework]</a>
) followed by a single WSDL 1.1 pointer part, following the same rules as defined for WSDL 1.1 fragment ids
- <b><a href="#WSDL-PART1">???</a></b>
+ <a href="#frag-ids"><b>2 Fragment Identifiers</b></a>
.
</p></div><div class="div2">
<h3><a name="soap-binding-decl-fragid" id="soap-binding-decl-fragid"></a>3.2 IRI Identification Of SOAP Binding elements</h3><p><code>SOAP Binding</code> elements (binding, operation, body, header, fault, headerfault, and address) can be identified using the
@@ -177,14 +185,56 @@
w11soap.address(<em>parent</em>))</code></p><ul><li><p><em><code>parent</code></em>
is the pointer part of the <code>SOAP Address's parent</code> element
</p></li></ul></div><div class="div2">
-<h3><a name="Iri-ref-ex" id="Iri-ref-ex"></a>3.3 Example</h3><p>Consider WSDL 1.1 document located at
+<h3><a name="element-designator-canonical-form" id="element-designator-canonical-form"></a>3.3 Canonical Form for WSDL 1.1 element identifiers</h3><p>
+ The IRI-references described above MAY be used as WSDL 1.1
+ element identifiers. For ease of comparison, the fragment
+ identifier of WSDL 1.1 element identifiers SHOULD conform
+ to the following canonicalization rules:
+ </p><ul><li><p>
+ The fragment identifier consists of a sequence
+ zero or more
+ <code>xmlns()</code>
+ pointer parts followed by exactly one
+ <code>wsd11.*()</code>
+ pointer part.
+ </p></li><li><p>
+ Each
+ <code>xmlns()</code>
+ pointer part that appears in the fragment
+ identifier defines a namespace that is
+ referenced by the
+ <code>wsd11.*()</code>
+ pointer part.
+ </p></li><li><p>
+ Each
+ <code>xmlns()</code>
+ pointer part defines a unique namespace.
+ </p></li><li><p>
+ The
+ <code>xmlns()</code>
+ pointer parts define namespaces in the same
+ order as they are referenced in the
+ <code>wsd11.*()</code>
+ pointer part.
+ </p></li><li><p>
+ The namespace prefixes defined by the
+ <code>xmlns()</code>
+ pointer parts are named
+ <code>ns1</code>
+ ,
+ <code>ns2</code>
+ , etc., in the order of their appearance.
+ </p></li><li><p>
+ The fragment identifier contains no optional
+ whitespace.
+ </p></li></ul></div><div class="div2">
+<h3><a name="Iri-ref-ex" id="Iri-ref-ex"></a>3.4 Example</h3><p>Consider WSDL 1.1 document located at
http://example.org/TicketAgent.wsdl. Each WSDL 1.1 Element Identifier is shown in comments above the WSDL 1.1 element
</p><div class="exampleOuter">
<div class="exampleHeader"><a name="iri-ref-example-wsdl" id="iri-ref-example-wsdl"></a>Example: IRI-References - Example WSDL 1.1 Document</div><div class="exampleInner"><pre>
<?xml version="1.0" encoding="UTF-8"?>
-<!-- http://example.org/TicketAgent.wsdl11#wsd11.definitions() -->
<wsdl:definitions
targetNamespace="http://example.org/TicketAgent.wsdl11"
xmlns:tns="http://example.org/TicketAgent.wsdl11"
@@ -193,16 +243,17 @@
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsTicketAgent="http://example.org/TicketAgent.xsd"
xsi:schemaLocation="http://schemas.xmlsoap.org/wsdl/ http://www.w3.org/TR/2001/NOTE-wsdl-20010315/wsdl11.xsd">
+<!-- http://example.org/TicketAgent.wsdl11#wsd11.definitions() -->
<wsdl:types>
<xs:schema xmlns:xsTicketAgent="http://example.org/TicketAgent.xsd"
targetNamespace="http://example.org/TicketAgent.xsd" >
- <!-- http://example.org/TicketAgent.wsdl11#
- xmlns(ns1=http://example.org/TicketAgent.xsd)
- wsdl11.elementDeclaration(ns1:listFlightsRequest) -->
<xs:element name="listFlightsRequest" type="xsTicketAgent:tListFlights"/>
-
+ <!-- Starting from here, http://example.org/TicketAgent.wsdl11 will be shortened to http://...
+ http://...#xmlns(ns1=http://example.org/TicketAgent.xsd)
+ wsdl11.elementDeclaration(ns1:listFlightsRequest) -->
+
<xs:complexType name="tListFlights">
<xs:sequence>
<xs:element name="travelDate" type="xs:date"/>
@@ -210,11 +261,10 @@
<xs:element name="endCity" type="xs:string"/>
</xs:sequence>
</xs:complexType>
-
- <!-- http://example.org/TicketAgent.wsdl11#
- xmlns(ns1=http://example.org/TicketAgent.xsd)
- wsdl11.elementDeclaration(ns1:listFlightsResponse) -->
+
<xs:element name="listFlightsResponse" type="xsTicketAgent:tFlightsResponse"/>
+ <!-- http://...#xmlns(ns1=http://example.org/TicketAgent.xsd)
+ wsdl11.elementDeclaration(ns1:listFlightsResponse) -->
<xs:complexType name="tFlightsResponse">
<xs:sequence>
@@ -224,78 +274,63 @@
</xs:schema>
- </wsdl:types>
+ </wsdl:types>
- <!-- http://example.org/TicketAgent.wsdl11#
- wsdl11.message(listFlightsRequest) -->
<wsdl:message name="listFlightsRequest">
+ <!-- http://...#wsdl11.message(listFlightsRequest) -->
- <!-- http://example.org/TicketAgent.wsdl11#
- wsdl11.messagePart(listFlightsRequest/body) -->
- <wsdl:part name="body" element="xsTicketAgent:listFlightsRequest"/>
+ <wsdl:part name="body" element="xsTicketAgent:listFlightsRequest"/>
+ <!-- http://...#wsdl11.messagePart(listFlightsRequest/body) -->
</wsdl:message>
- <!-- http://example.org/TicketAgent.wsdl11#
- wsdl11.message(listFlightsResponse) -->
- <wsdl:message name="listFlightsResponse">
+ <wsdl:message name="listFlightsResponse">
+ <!-- http://...#wsdl11.message(listFlightsResponse) -->
- <!-- http://example.org/TicketAgent.wsdl11#
- wsdl11.messagePart(listFlightsResponse/body) -->
<wsdl:part name="body" element="xsTicketAgent:listFlightsResponse"/>
+ <!-- http://...#wsdl11.messagePart(listFlightsResponse/body) -->
</wsdl:message>
- <!-- http://example.org/TicketAgent.wsdl11#
- wsdl11.portType(TicketAgent) -->
<wsdl:portType name="TicketAgent">
+ <!-- http://...#wsdl11.portType(TicketAgent) -->
- <!-- http://example.org/TicketAgent.wsdl11#
- wsdl11.portTypeOperation(TicketAgent/listFlights) -->
<wsdl:operation name="listFlights">
+ <!-- http://...#wsdl11.portTypeOperation(TicketAgent/listFlights) -->
- <!-- http://example.org/TicketAgent.wsdl11#
- wsdl11.portTypeMessageReference(TicketAgent/listFlights/In) -->
<wsdl:input message="tns:listFlightsRequest"/>
+ <!-- http://...#wsdl11.portTypeMessageReference(TicketAgent/listFlights/In) -->
- <!-- http://example.org/TicketAgent.wsdl11#
- wsdl11.portTypeMessageReference(TicketAgent/listFlights/Out) -->
<wsdl:output message="tns:listFlightsResponse"/>
+ <!-- http://...#wsdl11.portTypeMessageReference(TicketAgent/listFlights/Out) -->
</wsdl:operation>
</wsdl:portType>
- <!-- http://example.org/TicketAgent.wsdl11#
- wsdl11.binding(TicketAgentSoap) -->
<wsdl:binding name="TicketAgentSoap" type="tns:TicketAgent">
+ <!-- http://...#wsdl11.binding(TicketAgentSoap) -->
- <!-- http://example.org/TicketAgent.wsdl11#
- wsdl11.extension(http://schemas.xmlsoap.org/wsdl/soap/,
- w11soap.binding( wsdl11.binding(TicketAgentSoap)) -->
<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
-
- <!-- http://example.org/TicketAgent.wsdl11#
- wsdl11.bindingOperation(TicketAgentSoap/listFlights) -->
+ <!-- http://...#wsdl11.extension(http://schemas.xmlsoap.org/wsdl/soap/,
+ w11soap.binding( wsdl11.binding(TicketAgentSoap)) -->
+
<wsdl:operation name="listFlights">
+ <!-- http://...#wsdl11.bindingOperation(TicketAgentSoap/listFlights) -->
- <!-- http://example.org/TicketAgent.wsdl11#
- wsdl11.bindingOperationMessageReference(TicketAgentSoap/listFlights/In) -->
<wsdl:input>
+ <!-- http://...#wsdl11.bindingOperationMessageReference(TicketAgentSoap/listFlights/In) -->
- <!-- http://example.org/TicketAgent.wsdl11#
- wsdl11.extension(http://schemas.xmlsoap.org/wsdl/soap/,
- w11soap.body( wsdl11.bindingOperationMessageReference
- (TicketAgentSoap/listFlights/In)) -->
<soap:body parts="body" use="literal"/>
+ <!-- http://...#wsdl11.extension(http://schemas.xmlsoap.org/wsdl/soap/,
+ w11soap.body(wsdl11.bindingOperationMessageReference
+ (TicketAgentSoap/listFlights/In)) -->
</wsdl:input>
- <!-- http://example.org/TicketAgent.wsdl11#
- wsdl11.bindingOperationMessageReference(TicketAgentSoap/listFlights/Out) -->
<wsdl:output>
+ <!-- http://...#wsdl11.bindingOperationMessageReference(TicketAgentSoap/listFlights/Out) -->
- <!-- http://example.org/TicketAgent.wsdl11#
- wsdl11.extension(http://schemas.xmlsoap.org/wsdl/soap/,
- w11soap.body( wsdl11.bindingOperationMessageReference
- (TicketAgentSoap/listFlights/Out)) -->
<soap:body parts="body" use="literal"/>
+ <!-- http://...#wsdl11.extension(http://schemas.xmlsoap.org/wsdl/soap/,
+ w11soap.body(wsdl11.bindingOperationMessageReference
+ (TicketAgentSoap/listFlights/Out)) -->
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
@@ -332,7 +367,7 @@
(See <a href="http://www.w3.org/TR/2001/NOTE-wsdl-20010315">http://www.w3.org/TR/2001/NOTE-wsdl-20010315</a>)
</dd><dt xmlns:fo="http://www.w3.org/1999/XSL/Format" class="label"><a name="XPTR" id="XPTR"></a>XPointer Framework</dt><dd xmlns:fo="http://www.w3.org/1999/XSL/Format"><a href="http://www.w3.org/TR/2003/REC-xptr-framework-20030325/"><cite>XPointer Framework</cite></a>,Paul Grosso, Eve
Maler, Jonathan Marsh, Norman Walsh, Editors. World Wide Web
- Consortium, 22 November 2002. This version of the XPointer
+ Consortium, 25 March 2003. This version of the XPointer
Framework Proposed Recommendation is
http://www.w3.org/TR/2003/REC-xptr-framework-20030325/ The
<a href="http://www.w3.org/TR/xptr-framework/">latest
@@ -348,6 +383,5 @@
Uniform Resource Identifiers (URI): Generic Syntax",
T. Berners-Lee, R. Fielding, L. Masinter, January 2005.
(See <a href="http://www.ietf.org/rfc/rfc3986.txt">http://www.ietf.org/rfc/rfc3986.txt</a>)
- </dd></dl></div><div class="div2">
-<h3><a name="refs-inform" id="refs-inform"></a>4.2 Informative References</h3></div></div></div><div class="back"><div class="div1">
-<h2><a name="changelog" id="changelog"></a>A Change Log (Non-Normative)</h2><table border="1"><caption>Changes</caption><thead><tr><th>Who</th><th>When</th><th>What</th></tr></thead><tbody><tr><td>DBO</td><td>20061108</td><td>Initial Revision</td></tr></tbody></table></div></div></body></html>
\ No newline at end of file
+ </dd></dl></div></div></div><div class="back"><div class="div1">
+<h2><a name="changelog" id="changelog"></a>A Change Log (Non-Normative)</h2><table border="1"><caption>Changes</caption><thead><tr><th>Who</th><th>When</th><th>What</th></tr></thead><tbody><tr><td>DBO</td><td>20061108</td><td>Initial Revision</td></tr><tr><td>DBO</td><td>20061212</td><td>Uncommented canonical section, fixed editorial items</td></tr></tbody></table></div></div></body></html>
\ No newline at end of file
Index: wsdl11elementidentifiers.xml
===================================================================
RCS file: /sources/public/2006/ws/policy/wsdl11elementidentifiers.xml,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -d -r1.7 -r1.8
--- wsdl11elementidentifiers.xml 24 Nov 2006 23:55:53 -0000 1.7
+++ wsdl11elementidentifiers.xml 12 Dec 2006 19:13:31 -0000 1.8
@@ -6,7 +6,7 @@
<!ENTITY status "Editors Copy $Date$">
<!ENTITY wsdl-ns "http://schemas.xmlsoap.org/wsdl/">
]>
-<spec w3c-doctype="wd" role="Note">
+<spec w3c-doctype="wd">
<header>
<title>WSDL 1.1 Element Identifiers</title>
<w3c-designation>&w3c-designation;</w3c-designation>
@@ -32,27 +32,48 @@
</author>
</authlist>
<abstract>
- <p>This document defines a syntax to identify individual elements in a WSDL 1.1 document.</p>
+ <p>WSDL 1.1 element identifiers defines a syntax to identify individual elements in a WSDL 1.1 document.</p>
</abstract>
<status>
<p>
This section describes the status of this document at the time of its
publication. Other documents may supersede this document. A list of
current W3C publications and the latest revision of this technical report
-can be found in the W3C technical reports index at <loc href="http://www.w3.org/TR/">http://www.w3.org/TR</loc>.
-(say about version) It has been produced by the WS-Policy Working Group
-which is part of the Web Services Activity.
-The current intention of the Working Groups is to issue the final version
-of this specification as a Working Group Note.</p>
-<p>
-Comments on this document are welcome. Please send them to the public
-mailing-list <loc href="mailto:ws-policy-comments@w3.org">ws-policy-comments@w3.org</loc> (<loc href="http://lists.w3.org/Archives/Public/ws-policy-comments/">archive</loc>). It is inappropriate to send
-discussion email to this address.
-Publication as a Note does not imply endorsement by the W3C
-Membership. This is a draft document and may be updated, replaced or
-obsoleted by other documents at any time. It is inappropriate to cite this
-document as other than work in progress.
-</p>
+can be found in the W3C technical reports index at <loc href="http://www.w3.org/TR/">http://www.w3.org/TR</loc>.</p>
+<p>This is the <loc
+href="http://www.w3.org/Consortium/Process/tr.html#first-wd">First Public
+Working Draft</loc> of the Web Services Policy 1.5 - Framework specification.
+This Working Draft was produced by the members of the <loc
+href="http://www.w3.org/2002/ws/policy/">Web Services Policy Working Group</loc>.
+The Working Group expects to advance this Working Draft to Note Status when the
+content is stable. Note that this Working Draft does not necessarily represent
+a consensus of the Working Group. </p>
+
+<p>Discussion of this document takes place on the
+public <loc href="mailto:public-ws-policy@w3.org">public-ws-policy@w3.org</loc>
+mailing list (<loc href="http://lists.w3.org/Archives/Public/public-ws-policy/">public
+archive</loc>) and within <loc
+href="http://www.w3.org/Bugs/Public/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=WS-Policy&component=Framework&component=Framework%2BAttachment&component=Framework%2BAttachment%2BPrimer">Bugzilla</loc>.
+Comments on this specification should be made following the <loc
+href="http://www.w3.org/2002/ws/policy/#issues">Description for Issues</loc> of
+the Working Group.</p>
+
+<p>Publication as a Working Draft does not imply
+endorsement by the W3C Membership. This is a draft document and may be updated,
+replaced or obsoleted by other documents at any time. It is inappropriate to
+cite this document as other than work in progress.</p>
+
+<p>This document was produced by a group operating
+under the <loc href="http://www.w3.org/Consortium/Patent-Policy-20040205/">5
+February 2004 W3C Patent Policy</loc>. W3C maintains a <loc
+href="http://www.w3.org/2004/01/pp-impl/39293/status">public list of any patent
+disclosures</loc> made in connection with the deliverables of the group; that
+page also includes instructions for disclosing a patent. An individual who has
+actual knowledge of a patent which the individual believes contains <loc
+href="http://www.w3.org/Consortium/Patent-Policy-20040205/#def-essential">Essential
+Claim(s)</loc> must disclose the information in accordance with <loc
+href="http://www.w3.org/Consortium/Patent-Policy-20040205/#sec-Disclosure">section
+6 of the W3C Patent Policy</loc></p>
</status>
<langusage>
<language id="en">English</language>
@@ -157,7 +178,7 @@
<td><code>element</code> QName </td>
<td>n/a</td>
<td>n/a</td>
- <td><code>wsdl11.elementDeclaration(<emph>elementDeclaration</emph>)</code></td>
+ <td><code>wsdl11.elementDeclaration(<emph>element</emph>)</code></td>
</tr>
<tr>
<td>Message</td>
@@ -260,8 +281,8 @@
<head>IRI-References for WSDL 1.1 Elements</head>
<p>
- This appendix provides a syntax for IRI-references for all
- elements found in a WSDL 1.1 document. The IRI-references are easy
+ This section provides a syntax for IRI-references for all
+ elements found in a <bibref ref="WSDL11"/> document. The IRI-references are easy
to understand and compare, while imposing no burden on the WSDL 1.1
author.
</p>
@@ -277,14 +298,14 @@
The IRI of a WSDL 1.1 document can be dereferenced to give a
resource representation that contributes elements
to a single WSDL 1.1 namespace. If the media type is set to the WSDL 1.1
- media type, then the fragment identifiers can be used to
+ media type i.e. application/xml, then the fragment identifiers can be used to
identify the main elements that are defined in the document.
</p>
<p>
- In keeping with the WSDL 1.1, which has a recommendation that
+ In keeping with WSDL 1.1, which has a recommendation that
that the namespace URI be dereferencible to a WSDL 1.1 document,
- this appendix specifies the use of the namespace IRI with the
+ this section specifies the use of the namespace IRI with the
WSDL 1.1 fragment identifiers to form an IRI-reference.
</p>
@@ -310,7 +331,7 @@
in
<bibref ref="XPTR" />
) followed by a single WSDL 1.1 pointer part, following the same rules as defined for WSDL 1.1 fragment ids
- <specref ref="WSDL-PART1" />
+ <specref ref="frag-ids" />
.
</p>
@@ -408,33 +429,27 @@
</ulist>
</div2>
- <!--
<div2 id="element-designator-canonical-form">
- <head>Canonical Form for WSDL 1.1 element Designators</head>
+ <head>Canonical Form for WSDL 1.1 element identifiers</head>
<p>
The IRI-references described above MAY be used as WSDL 1.1
- element designators. For ease of comparison, the fragment
- identifier of WSDL 1.1 element designators SHOULD conform
+ element identifiers. For ease of comparison, the fragment
+ identifier of WSDL 1.1 element identifiers SHOULD conform
to the following canonicalization rules:
</p>
<ulist>
<item>
<p>
- <assert class="element"
- id="CanonFragId-1900002" required="false">
The fragment identifier consists of a sequence
zero or more
<code>xmlns()</code>
pointer parts followed by exactly one
<code>wsd11.*()</code>
pointer part.
- </assert>
</p>
</item>
<item>
<p>
- <assert class="element"
- id="CanonFragId-1900003" required="false">
Each
<code>xmlns()</code>
pointer part that appears in the fragment
@@ -442,36 +457,27 @@
referenced by the
<code>wsd11.*()</code>
pointer part.
- </assert>
</p>
</item>
<item>
<p>
- <assert class="element"
- id="CanonFragId-1900004" required="false">
Each
<code>xmlns()</code>
pointer part defines a unique namespace.
- </assert>
</p>
</item>
<item>
<p>
- <assert class="element"
- id="CanonFragId-1900005" required="false">
The
<code>xmlns()</code>
pointer parts define namespaces in the same
order as they are referenced in the
<code>wsd11.*()</code>
pointer part.
- </assert>
</p>
</item>
<item>
<p>
- <assert class="element"
- id="CanonFragId-1900006" required="false">
The namespace prefixes defined by the
<code>xmlns()</code>
pointer parts are named
@@ -479,21 +485,17 @@
,
<code>ns2</code>
, etc., in the order of their appearance.
- </assert>
</p>
</item>
<item>
<p>
- <assert class="element"
- id="CanonFragId-1900007" required="false">
The fragment identifier contains no optional
whitespace.
- </assert>
</p>
</item>
</ulist>
</div2>
--->
+
<div2 id="Iri-ref-ex">
<head>Example</head>
<p>Consider WSDL 1.1 document located at
@@ -505,7 +507,6 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- http://example.org/TicketAgent.wsdl11#wsd11.definitions() -->
<wsdl:definitions
targetNamespace="http://example.org/TicketAgent.wsdl11"
xmlns:tns="http://example.org/TicketAgent.wsdl11"
@@ -514,16 +515,17 @@
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsTicketAgent="http://example.org/TicketAgent.xsd"
xsi:schemaLocation="&wsdl-ns; http://www.w3.org/TR/2001/NOTE-wsdl-20010315/wsdl11.xsd">
+<!-- http://example.org/TicketAgent.wsdl11#wsd11.definitions() -->
<wsdl:types>
<xs:schema xmlns:xsTicketAgent="http://example.org/TicketAgent.xsd"
targetNamespace="http://example.org/TicketAgent.xsd" >
- <!-- http://example.org/TicketAgent.wsdl11#
- xmlns(ns1=http://example.org/TicketAgent.xsd)
- wsdl11.elementDeclaration(ns1:listFlightsRequest) -->
<xs:element name="listFlightsRequest" type="xsTicketAgent:tListFlights"/>
-
+ <!-- Starting from here, http://example.org/TicketAgent.wsdl11 will be shortened to http://...
+ http://...#xmlns(ns1=http://example.org/TicketAgent.xsd)
+ wsdl11.elementDeclaration(ns1:listFlightsRequest) -->
+
<xs:complexType name="tListFlights">
<xs:sequence>
<xs:element name="travelDate" type="xs:date"/>
@@ -531,11 +533,10 @@
<xs:element name="endCity" type="xs:string"/>
</xs:sequence>
</xs:complexType>
-
- <!-- http://example.org/TicketAgent.wsdl11#
- xmlns(ns1=http://example.org/TicketAgent.xsd)
- wsdl11.elementDeclaration(ns1:listFlightsResponse) -->
+
<xs:element name="listFlightsResponse" type="xsTicketAgent:tFlightsResponse"/>
+ <!-- http://...#xmlns(ns1=http://example.org/TicketAgent.xsd)
+ wsdl11.elementDeclaration(ns1:listFlightsResponse) -->
<xs:complexType name="tFlightsResponse">
<xs:sequence>
@@ -545,78 +546,63 @@
</xs:schema>
- </wsdl:types>
+ </wsdl:types>
- <!-- http://example.org/TicketAgent.wsdl11#
- wsdl11.message(listFlightsRequest) -->
<wsdl:message name="listFlightsRequest">
+ <!-- http://...#wsdl11.message(listFlightsRequest) -->
- <!-- http://example.org/TicketAgent.wsdl11#
- wsdl11.messagePart(listFlightsRequest/body) -->
- <wsdl:part name="body" element="xsTicketAgent:listFlightsRequest"/>
+ <wsdl:part name="body" element="xsTicketAgent:listFlightsRequest"/>
+ <!-- http://...#wsdl11.messagePart(listFlightsRequest/body) -->
</wsdl:message>
- <!-- http://example.org/TicketAgent.wsdl11#
- wsdl11.message(listFlightsResponse) -->
- <wsdl:message name="listFlightsResponse">
+ <wsdl:message name="listFlightsResponse">
+ <!-- http://...#wsdl11.message(listFlightsResponse) -->
- <!-- http://example.org/TicketAgent.wsdl11#
- wsdl11.messagePart(listFlightsResponse/body) -->
<wsdl:part name="body" element="xsTicketAgent:listFlightsResponse"/>
+ <!-- http://...#wsdl11.messagePart(listFlightsResponse/body) -->
</wsdl:message>
- <!-- http://example.org/TicketAgent.wsdl11#
- wsdl11.portType(TicketAgent) -->
<wsdl:portType name="TicketAgent">
+ <!-- http://...#wsdl11.portType(TicketAgent) -->
- <!-- http://example.org/TicketAgent.wsdl11#
- wsdl11.portTypeOperation(TicketAgent/listFlights) -->
<wsdl:operation name="listFlights">
+ <!-- http://...#wsdl11.portTypeOperation(TicketAgent/listFlights) -->
- <!-- http://example.org/TicketAgent.wsdl11#
- wsdl11.portTypeMessageReference(TicketAgent/listFlights/In) -->
<wsdl:input message="tns:listFlightsRequest"/>
+ <!-- http://...#wsdl11.portTypeMessageReference(TicketAgent/listFlights/In) -->
- <!-- http://example.org/TicketAgent.wsdl11#
- wsdl11.portTypeMessageReference(TicketAgent/listFlights/Out) -->
<wsdl:output message="tns:listFlightsResponse"/>
+ <!-- http://...#wsdl11.portTypeMessageReference(TicketAgent/listFlights/Out) -->
</wsdl:operation>
</wsdl:portType>
- <!-- http://example.org/TicketAgent.wsdl11#
- wsdl11.binding(TicketAgentSoap) -->
<wsdl:binding name="TicketAgentSoap" type="tns:TicketAgent">
+ <!-- http://...#wsdl11.binding(TicketAgentSoap) -->
- <!-- http://example.org/TicketAgent.wsdl11#
- wsdl11.extension(http://schemas.xmlsoap.org/wsdl/soap/,
- w11soap.binding( wsdl11.binding(TicketAgentSoap)) -->
<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
-
- <!-- http://example.org/TicketAgent.wsdl11#
- wsdl11.bindingOperation(TicketAgentSoap/listFlights) -->
+ <!-- http://...#wsdl11.extension(http://schemas.xmlsoap.org/wsdl/soap/,
+ w11soap.binding( wsdl11.binding(TicketAgentSoap)) -->
+
<wsdl:operation name="listFlights">
+ <!-- http://...#wsdl11.bindingOperation(TicketAgentSoap/listFlights) -->
- <!-- http://example.org/TicketAgent.wsdl11#
- wsdl11.bindingOperationMessageReference(TicketAgentSoap/listFlights/In) -->
<wsdl:input>
+ <!-- http://...#wsdl11.bindingOperationMessageReference(TicketAgentSoap/listFlights/In) -->
- <!-- http://example.org/TicketAgent.wsdl11#
- wsdl11.extension(http://schemas.xmlsoap.org/wsdl/soap/,
- w11soap.body( wsdl11.bindingOperationMessageReference
- (TicketAgentSoap/listFlights/In)) -->
<soap:body parts="body" use="literal"/>
+ <!-- http://...#wsdl11.extension(http://schemas.xmlsoap.org/wsdl/soap/,
+ w11soap.body(wsdl11.bindingOperationMessageReference
+ (TicketAgentSoap/listFlights/In)) -->
</wsdl:input>
- <!-- http://example.org/TicketAgent.wsdl11#
- wsdl11.bindingOperationMessageReference(TicketAgentSoap/listFlights/Out) -->
<wsdl:output>
+ <!-- http://...#wsdl11.bindingOperationMessageReference(TicketAgentSoap/listFlights/Out) -->
- <!-- http://example.org/TicketAgent.wsdl11#
- wsdl11.extension(http://schemas.xmlsoap.org/wsdl/soap/,
- w11soap.body( wsdl11.bindingOperationMessageReference
- (TicketAgentSoap/listFlights/Out)) -->
<soap:body parts="body" use="literal"/>
+ <!-- http://...#wsdl11.extension(http://schemas.xmlsoap.org/wsdl/soap/,
+ w11soap.body(wsdl11.bindingOperationMessageReference
+ (TicketAgentSoap/listFlights/Out)) -->
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
@@ -655,9 +641,7 @@
</bibl>
- <bibl
-
- key="WSDL 1.1"
+ <bibl key="WSDL 1.1"
href="http://www.w3.org/TR/2001/NOTE-wsdl-20010315"
id="WSDL11">
<titleref>Web Services definitions Language (WSDL)
@@ -675,7 +659,7 @@
id="XPTR">
<titleref>XPointer Framework</titleref>,Paul Grosso, Eve
Maler, Jonathan Marsh, Norman Walsh, Editors. World Wide Web
- Consortium, 22 November 2002. This version of the XPointer
+ Consortium, 25 March 2003. This version of the XPointer
Framework Proposed Recommendation is
http://www.w3.org/TR/2003/REC-xptr-framework-20030325/ The
<loc href='http://www.w3.org/TR/xptr-framework/'>latest
@@ -690,10 +674,10 @@
T. Berners-Lee, R. Fielding, L. Masinter, January 2005. </bibl>
</blist>
</div2>
- <div2 id="refs-inform">
+ <!--<div2 id="refs-inform">
<head>Informative References</head>
- </div2>
+ </div2> -->
</div1>
</body>
<back>
@@ -715,6 +699,12 @@
<td>Initial Revision</td>
</tr>
+ <tr>
+ <td>DBO</td>
+ <td>20061212</td>
+ <td>Uncommented canonical section, fixed editorial items</td>
+ </tr>
+
</tbody>
</table>
</inform-div1>
Index: wsdl11eientitieswd.dtd
===================================================================
RCS file: /sources/public/2006/ws/policy/wsdl11eientitieswd.dtd,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -d -r1.4 -r1.5
--- wsdl11eientitieswd.dtd 24 Nov 2006 23:55:53 -0000 1.4
+++ wsdl11eientitieswd.dtd 12 Dec 2006 19:13:31 -0000 1.5
@@ -4,10 +4,10 @@
Date parameters
-->
<!ENTITY draft.year "2006">
-<!ENTITY draft.month "November">
-<!ENTITY draft.mm "11">
-<!ENTITY draft.day "24">
-<!ENTITY draft.dd "24">
+<!ENTITY draft.month "December">
+<!ENTITY draft.mm "12">
+<!ENTITY draft.day "12">
+<!ENTITY draft.dd "12">
<!ENTITY draft.date "&draft.year;&draft.mm;&draft.dd;">
@@ -21,8 +21,8 @@
<!ENTITY document.role "public">
-<!ENTITY document.status "W3C Note">
-<!ENTITY status "W3C Note">
+<!ENTITY document.status "W3C Working Draft">
+<!ENTITY status "W3C Working Draft">
<!ENTITY w3c-designation
"&w3c.tr.latest;/&draft.year;/&status;-&wsdl11ei.prefix;-&draft.date;">
Received on Tuesday, 12 December 2006 19:13:49 UTC