- From: Arthur Ryman via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 09 Nov 2005 01:20:04 +0000
- To: public-ws-desc-eds@w3.org
Update of /sources/public/2002/ws/desc/wsdl20 In directory hutz:/tmp/cvs-serv11331/wsdl20 Modified Files: wsdl20.html wsdl20-adjuncts.html wsdl20.xml wsdl20.tex wsdl20-primer.html wsdl20-z-ie.html document-assertion-table.xml wsdl20-z.html Log Message: Added some assertions to Part 1. Index: wsdl20-adjuncts.html =================================================================== RCS file: /sources/public/2002/ws/desc/wsdl20/wsdl20-adjuncts.html,v retrieving revision 1.85 retrieving revision 1.86 diff -C2 -d -r1.85 -r1.86 *** wsdl20-adjuncts.html 3 Nov 2005 16:19:27 -0000 1.85 --- wsdl20-adjuncts.html 9 Nov 2005 01:19:59 -0000 1.86 *************** *** 2930,2934 **** {<a href="wsdl20-adjuncts.html#property-HTTPHeader.name">name</a>} property of the <a href="wsdl20-adjuncts.html#component-HTTPHeader">HTTP Header</a> component. If an HTTP ! header field corresponding to the value of {<a href="wsdl20-adjuncts.html#property-HTTPHeader.name">name</a>} property is set by a mechanism other than the HTTP binding, such as the HTTP stack or another feature, then an error MUST be --- 2930,2934 ---- {<a href="wsdl20-adjuncts.html#property-HTTPHeader.name">name</a>} property of the <a href="wsdl20-adjuncts.html#component-HTTPHeader">HTTP Header</a> component. If an HTTP ! header field corresponding to the value of the {<a href="wsdl20-adjuncts.html#property-HTTPHeader.name">name</a>} property is set by a mechanism other than the HTTP binding, such as the HTTP stack or another feature, then an error MUST be Index: wsdl20-z-ie.html =================================================================== RCS file: /sources/public/2002/ws/desc/wsdl20/wsdl20-z-ie.html,v retrieving revision 1.43 retrieving revision 1.44 diff -C2 -d -r1.43 -r1.44 *** wsdl20-z-ie.html 3 Nov 2005 16:19:27 -0000 1.43 --- wsdl20-z-ie.html 9 Nov 2005 01:20:00 -0000 1.44 *************** *** 77,81 **** <hr><div class="toc"> ! <h2><a name="shortcontents">Short Table of Contents</a></h2><p class="toc">1. <a href="#intro">Introduction</a><br>2. <a href="#component_model">Component Model</a><br>3. <a href="#eii-types">Types</a><br>4. <a href="#modularize">Modularizing WSDL 2.0 descriptions</a><br>5. <a href="#eii-documentation">Documentation</a><br>6. <a href="#language-extensibility">Language Extensibility</a><br>7. <a href="#wsdllocation">Locating WSDL 2.0 Documents</a><br>8. <a href="#conformance">Conformance</a><br>9. <a href="#Syntax-Summary">XML Syntax Summary (Non-Normative)</a><br>10. <a href="#References">References</a><br>A. <a href="#ietf-draft">The application/wsdl+xml Media Type</a><br>B. <a href="#acknowledgments">Acknowledgements</a> (Non-Normative)<br>C. <a href="#wsdl-iri-references">IRI References for WSDL 2.0 Components</a> (Non-Normative)<br>D. <a href="#N165E3">Component Summary</a> (Non-Normative)<br>E. <a href="#assertionsummary">Assertion Summary</a> (Non-Normative)<br>F. <a href="#changelog">Part 1 Change og</a> (Non-Normative)<br></p></div><hr><div class="toc"> <h2><a name="contents">Table of Contents</a></h2><p class="toc">1. <a href="#intro">Introduction</a><br> 1.1 <a href="#intro_ws">Web Service</a><br> 1.2 <a href="#markup">Document Conformance</a><br> 1.3 <a href="#meaning">The Meaning of a Service Description</a><br> 1.4 <a href="#notation">Notational Conventions</a><br> 1.4.1 <a href="#rfc2119keywords">RFC 2119 Keywords</a><br> 1.4.2 <a href="#rfc3986namespaces">RFC 3986 Namespaces</a><br> 1.4.3 <a href="#nsprefixes">Prefixes and Namespaces Used in This Specification</a><br> 1.4.4 <a href="#terminology">Terms Used in This Specification</a><br> 1.4.5 <a href="#xmlinfosetproperties">XML Information Set Properties</a><br> &nbp; 1.4.6 <a href="#wsdlcomponentmodelproperties">WSDL 2.0 Component Model Properties</a><br> 1.4.7 <a href="#znotation">Z Notation</a><br> 1.4.8 <a href="#bnfpseudoschemas">BNF Pseudo-Schemas</a><br> 1.4.9 <a href="#assertions">Assertions</a><br>2. <a href="#component_model">Component Model</a><br> 2.1 <a href="#Description">Description</a><br> 2.1.1 <a href="#Description_details">The Description Component</a><br> 2.1.2 <a href="#Description_XMLRep">XML Representation of Description Component</a><br> 2.1.2.1 <a href="#Description_targetnamespace_attribute">targetNamespace attribute information item</a><br> 2.13 <a href="#Description_Mapping">Mapping Description's XML Representation to Component Properties</a><br> 2.2 <a href="#Interface">Interface</a><br> 2.2.1 <a href="#Interface_details">The Interface Component</a><br> 2.2.2 <a href="#Interface_XMLRep">XML Representation of Interface Component</a><br> 2.2.2.1 <a href="#Interface_name_attribute">name attribute information item with interface [owner element]</a><br> 2.2.2.2 <a href="#Interface_extends_attribute">extends attribute information item</a><br> 2.2.2.3 <a href="#Interface_styleDefault_attribute">styleDefault attribute information item</a><br> 2.2.3 <a href="#Interface_Mapping">Mapping Interface's XML Representation to Component Properties</a><br> &nsp; 2.3 <a href="#InterfaceFault">Interface Fault</a><br> 2.3.1 <a href="#InterfaceFault_details">The Interface Fault Component</a><br> 2.3.2 <a href="#InterfaceFault_XMLRep">XML Representation of Interface Fault Component</a><br> 2.3.2.1 <a href="#Interfacefault_name_attribute">name attribute information item with fault [owner element]</a><br> 2.3.2.2 <a href="#Interface_element_attribute">element attribute information item with fault [owner element]</a><br> 2.3.3 <a href="#InterfaceFault_Mapping">Mapping Interface Fault's XML Representation to --- 77,81 ---- <hr><div class="toc"> ! <h2><a name="shortcontents">Short Table of Contents</a></h2><p class="toc">1. <a href="#intro">Introduction</a><br>2. <a href="#component_model">Component Model</a><br>3. <a href="#eii-types">Types</a><br>4. <a href="#modularize">Modularizing WSDL 2.0 descriptions</a><br>5. <a href="#eii-documentation">Documentation</a><br>6. <a href="#language-extensibility">Language Extensibility</a><br>7. <a href="#wsdllocation">Locating WSDL 2.0 Documents</a><br>8. <a href="#conformance">Conformance</a><br>9. <a href="#Syntax-Summary">XML Syntax Summary (Non-Normative)</a><br>10. <a href="#References">References</a><br>A. <a href="#ietf-draft">The application/wsdl+xml Media Type</a><br>B. <a href="#acknowledgments">Acknowledgements</a> (Non-Normative)<br>C. <a href="#wsdl-iri-references">IRI References for WSDL 2.0 Components</a> (Non-Normative)<br>D. <a href="#N1660B">Component Summary</a> (Non-Normative)<br>E. <a href="#assertionsummary">Assertion Summary</a> (Non-Normative)<br>F. <a href="#changelog">Part 1 Change og</a> (Non-Normative)<br></p></div><hr><div class="toc"> <h2><a name="contents">Table of Contents</a></h2><p class="toc">1. <a href="#intro">Introduction</a><br> 1.1 <a href="#intro_ws">Web Service</a><br> 1.2 <a href="#markup">Document Conformance</a><br> 1.3 <a href="#meaning">The Meaning of a Service Description</a><br> 1.4 <a href="#notation">Notational Conventions</a><br> 1.4.1 <a href="#rfc2119keywords">RFC 2119 Keywords</a><br> 1.4.2 <a href="#rfc3986namespaces">RFC 3986 Namespaces</a><br> 1.4.3 <a href="#nsprefixes">Prefixes and Namespaces Used in This Specification</a><br> 1.4.4 <a href="#terminology">Terms Used in This Specification</a><br> 1.4.5 <a href="#xmlinfosetproperties">XML Information Set Properties</a><br> &nbp; 1.4.6 <a href="#wsdlcomponentmodelproperties">WSDL 2.0 Component Model Properties</a><br> 1.4.7 <a href="#znotation">Z Notation</a><br> 1.4.8 <a href="#bnfpseudoschemas">BNF Pseudo-Schemas</a><br> 1.4.9 <a href="#assertions">Assertions</a><br>2. <a href="#component_model">Component Model</a><br> 2.1 <a href="#Description">Description</a><br> 2.1.1 <a href="#Description_details">The Description Component</a><br> 2.1.2 <a href="#Description_XMLRep">XML Representation of Description Component</a><br> 2.1.2.1 <a href="#Description_targetnamespace_attribute">targetNamespace attribute information item</a><br> 2.13 <a href="#Description_Mapping">Mapping Description's XML Representation to Component Properties</a><br> 2.2 <a href="#Interface">Interface</a><br> 2.2.1 <a href="#Interface_details">The Interface Component</a><br> 2.2.2 <a href="#Interface_XMLRep">XML Representation of Interface Component</a><br> 2.2.2.1 <a href="#Interface_name_attribute">name attribute information item with interface [owner element]</a><br> 2.2.2.2 <a href="#Interface_extends_attribute">extends attribute information item</a><br> 2.2.2.3 <a href="#Interface_styleDefault_attribute">styleDefault attribute information item</a><br> 2.2.3 <a href="#Interface_Mapping">Mapping Interface's XML Representation to Component Properties</a><br> &nsp; 2.3 <a href="#InterfaceFault">Interface Fault</a><br> 2.3.1 <a href="#InterfaceFault_details">The Interface Fault Component</a><br> 2.3.2 <a href="#InterfaceFault_XMLRep">XML Representation of Interface Fault Component</a><br> 2.3.2.1 <a href="#Interfacefault_name_attribute">name attribute information item with fault [owner element]</a><br> 2.3.2.2 <a href="#Interface_element_attribute">element attribute information item with fault [owner element]</a><br> 2.3.3 <a href="#InterfaceFault_Mapping">Mapping Interface Fault's XML Representation to *************** *** 102,106 **** attribute information item </a><br> 3.3.3 <a href="#wsdlx-consistency">wsdlx:interface and wsdlx:binding Consistency</a><br> 3.3.4 <a href="#wsdlx-xsanyuri">Use of wsdlx:interface and wsdlx:binding with xs:anyURI</a><br>4. <a href="#modularize">Modularizing WSDL 2.0 descriptions</a><br> 4.1 <a href="#includes">Including Descriptions</a><br> 4.1.1 <a href="#include_location_attribute">location attribute information item with include [owner element]</a><br> 4.2 <a href="#imports">Importing Descriptions</a><br> 4.2.1 <a href="#import_namespace_attribute">namespace attribute information item</a><br> 4.2.2 <a href="#import_location_attribute">location attribute information item with import [owner element]</a><br>5. <a href="#eii-documentation">Documentatin</a><br>6. <a href="#language-extensibility">Language Extensibility</a><br> 6.1 <a href="#eii-extensibility">Element based Extensibility</a><br> 6.1.1 <a href="#mandatoryext">Mandatory extensions</a><br> 6.1.2 <a href="#required-aii">required attribute information item</a><br> 6.2 <a href="#aii-extensibility">Attribute-based Extensibility</a><br> 6.3 <a href="#extensibility-semantics">Extensibility Semantics</a><br>7. <a href="#wsdllocation">Locating WSDL 2.0 Documents</a><br> 7.1 <a href="#wsdlLocation-aii">wsdli:wsdlLocation attribute information item</a><br>8. <a href="#conformance">Conformance</a><br> 8.1 <a href="#infoset">XML Information Set Conformance</a><br>9. <a href="#Syntax-Summary">XML Syntax Summary (Non-Normative)</a><br>10. <a href="#References">References</a><br> &nbs;10.1 <a href="#Normative-References">Normative References</a><br> 10.2 <a href="#Informative-References">Informative References</a><br></p> ! <h3><a id="appendix" name="appendix">Appendices</a></h3><p class="toc">A. <a href="#ietf-draft">The application/wsdl+xml Media Type</a><br> A.1 <a href="#ietf-reg">Registration</a><br> A.2 <a href="#frag-ids">Fragment Identifiers</a><br> A.2.1 <a href="#wsdl.description">The Description Component</a><br> A.2.2 <a href="#wsdl.elementDeclaration">The Element Declaration Component</a><br> A.2.3 <a href="#wsdl.typeDefinition">The Type Definition Component</a><br> A.2.4 <a href="#wsdl.interface">The Interface Component</a><br> A.2.5 <a href="#wsdl.interfaceFault">The Interface Fault Component</a><br> A.2.6 <a href="#wsdl.interfaceOperation">The Interface Operation Component</a><br> &bsp; A.2.7 <a href="#wsdl.interfaceMessageReference">The Interface Message Reference Component</a><br> A.2.8 <a href="#wsdl.interfaceFaultReference">The Interface Fault Reference Component</a><br> A.2.9 <a href="#wsdl.binding">The Binding Component</a><br> A.2.10 <a href="#wsdl.bindingFault">The Binding Fault Component</a><br> A.2.11 <a href="#wsdl.bindingOperation">The Binding Operation Component</a><br> A.2.12 <a href="#wsdl.bindingMessageReference">The Binding Message Reference Component</a><br> A.2.13 <a href="#wsdl.bindingFaultReference">The Binding Fault Reference Component</a><br> A.2.14 <a href="#wsdl.service">The Service Component</a><br>&nbp; A.2.15 <a href="#wsdl.endpoint">The Endpoint Component</a><br> A.2.16 <a href="#wsdl.feature">The Feature Component</a><br> A.2.17 <a href="#wsdl.property">The Property Component</a><br> A.2.18 <a href="#wsdl.extension">Extension Components</a><br> A.3 <a href="#ietf-sec">Security considerations</a><br>B. <a href="#acknowledgments">Acknowledgements</a> (Non-Normative)<br>C. <a href="#wsdl-iri-references">IRI References for WSDL 2.0 Components</a> (Non-Normative)<br> C.1 <a href="#wsdl-iris">WSDL 2.0 IRIs</a><br> C.2 <a href="#Iri-ref-ex">Example</a><br>D. <a href="#N165E3">Component Summary</a> (Non-Normative)<br>E. <a href="#assertionsummary">Assertion Summary</a> (Non-Normative)<br>F. <a href="#changelog">Part 1 Change Log</a> (Non-Normative)<br> &nbs; F.1 <a href="#wsdl-changelog">WSDL 2.0 Specification Changes</a><br></p></div><hr><div class="body"> <div class="div1"> --- 102,106 ---- attribute information item </a><br> 3.3.3 <a href="#wsdlx-consistency">wsdlx:interface and wsdlx:binding Consistency</a><br> 3.3.4 <a href="#wsdlx-xsanyuri">Use of wsdlx:interface and wsdlx:binding with xs:anyURI</a><br>4. <a href="#modularize">Modularizing WSDL 2.0 descriptions</a><br> 4.1 <a href="#includes">Including Descriptions</a><br> 4.1.1 <a href="#include_location_attribute">location attribute information item with include [owner element]</a><br> 4.2 <a href="#imports">Importing Descriptions</a><br> 4.2.1 <a href="#import_namespace_attribute">namespace attribute information item</a><br> 4.2.2 <a href="#import_location_attribute">location attribute information item with import [owner element]</a><br>5. <a href="#eii-documentation">Documentatin</a><br>6. <a href="#language-extensibility">Language Extensibility</a><br> 6.1 <a href="#eii-extensibility">Element based Extensibility</a><br> 6.1.1 <a href="#mandatoryext">Mandatory extensions</a><br> 6.1.2 <a href="#required-aii">required attribute information item</a><br> 6.2 <a href="#aii-extensibility">Attribute-based Extensibility</a><br> 6.3 <a href="#extensibility-semantics">Extensibility Semantics</a><br>7. <a href="#wsdllocation">Locating WSDL 2.0 Documents</a><br> 7.1 <a href="#wsdlLocation-aii">wsdli:wsdlLocation attribute information item</a><br>8. <a href="#conformance">Conformance</a><br> 8.1 <a href="#infoset">XML Information Set Conformance</a><br>9. <a href="#Syntax-Summary">XML Syntax Summary (Non-Normative)</a><br>10. <a href="#References">References</a><br> &nbs;10.1 <a href="#Normative-References">Normative References</a><br> 10.2 <a href="#Informative-References">Informative References</a><br></p> ! <h3><a id="appendix" name="appendix">Appendices</a></h3><p class="toc">A. <a href="#ietf-draft">The application/wsdl+xml Media Type</a><br> A.1 <a href="#ietf-reg">Registration</a><br> A.2 <a href="#frag-ids">Fragment Identifiers</a><br> A.2.1 <a href="#wsdl.description">The Description Component</a><br> A.2.2 <a href="#wsdl.elementDeclaration">The Element Declaration Component</a><br> A.2.3 <a href="#wsdl.typeDefinition">The Type Definition Component</a><br> A.2.4 <a href="#wsdl.interface">The Interface Component</a><br> A.2.5 <a href="#wsdl.interfaceFault">The Interface Fault Component</a><br> A.2.6 <a href="#wsdl.interfaceOperation">The Interface Operation Component</a><br> &bsp; A.2.7 <a href="#wsdl.interfaceMessageReference">The Interface Message Reference Component</a><br> A.2.8 <a href="#wsdl.interfaceFaultReference">The Interface Fault Reference Component</a><br> A.2.9 <a href="#wsdl.binding">The Binding Component</a><br> A.2.10 <a href="#wsdl.bindingFault">The Binding Fault Component</a><br> A.2.11 <a href="#wsdl.bindingOperation">The Binding Operation Component</a><br> A.2.12 <a href="#wsdl.bindingMessageReference">The Binding Message Reference Component</a><br> A.2.13 <a href="#wsdl.bindingFaultReference">The Binding Fault Reference Component</a><br> A.2.14 <a href="#wsdl.service">The Service Component</a><br>&nbp; A.2.15 <a href="#wsdl.endpoint">The Endpoint Component</a><br> A.2.16 <a href="#wsdl.feature">The Feature Component</a><br> A.2.17 <a href="#wsdl.property">The Property Component</a><br> A.2.18 <a href="#wsdl.extension">Extension Components</a><br> A.3 <a href="#ietf-sec">Security considerations</a><br>B. <a href="#acknowledgments">Acknowledgements</a> (Non-Normative)<br>C. <a href="#wsdl-iri-references">IRI References for WSDL 2.0 Components</a> (Non-Normative)<br> C.1 <a href="#wsdl-iris">WSDL 2.0 IRIs</a><br> C.2 <a href="#Iri-ref-ex">Example</a><br>D. <a href="#N1660B">Component Summary</a> (Non-Normative)<br>E. <a href="#assertionsummary">Assertion Summary</a> (Non-Normative)<br>F. <a href="#changelog">Part 1 Change Log</a> (Non-Normative)<br> &nbs; F.1 <a href="#wsdl-changelog">WSDL 2.0 Specification Changes</a><br></p></div><hr><div class="body"> <div class="div1"> *************** *** 3624,3643 **** The <code>messageLabel</code> ! <em>attribute information item</em> of an interface message reference <em>element information item</em> ! MUST be present if the message exchange pattern has ! more than one placeholder message with {direction} equal to the message direction. <a href="#MessageLabel-0004">†</a> </p> ! <p> ! If the <code>messageLabel</code> <em>attribute information item</em> of an interface message reference <em>element information item</em> is present then its actual value ! MUST match the {message label} of some placeholder message with {direction} equal to the message direction. </p> ! <p> ! If the <code>messageLabel</code> <em>attribute information item</em> of an interface message reference <em>element information item</em> is absent then there MUST be a unique ! placeholder message with {direction} equal to the message direction. </p> ! <p> Define the <em>effective message label</em> of an interface message reference <em>element information item</em> --- 3624,3661 ---- The <code>messageLabel</code> ! <em>attribute information item</em> ! of an interface message reference ! <em>element information item</em> ! MUST be present if the message exchange pattern has more ! than one placeholder message with {direction} equal to the ! message direction. <a href="#MessageLabel-0004">†</a> </p> ! <p> ! <a name="MessageLabel-0008-src"></a> ! If the ! <code>messageLabel</code> ! <em>attribute information item</em> ! of an interface message reference ! <em>element information item</em> ! is present then its actual value MUST match the {message ! label} of some placeholder message with {direction} equal ! to the message direction. ! <a href="#MessageLabel-0008">†</a> </p> ! <p> ! <a name="MessageLabel-0012-src"></a> ! If the ! <code>messageLabel</code> ! <em>attribute information item</em> ! of an interface message reference ! <em>element information item</em> ! is absent then there MUST be a unique placeholder message ! with {direction} equal to the message direction. ! <a href="#MessageLabel-0012">†</a> </p> ! <p> Define the <em>effective message label</em> of an interface message reference <em>element information item</em> *************** *** 4101,4120 **** The <code>messageLabel</code> ! <em>attribute information item</em> of an interface fault reference <em>element information item</em> ! MUST be present if the message exchange pattern has ! more than one placeholder message with {direction} equal to the message direction. <a href="#MessageLabel-0005">†</a> </p> ! <p> ! If the <code>messageLabel</code> <em>attribute information item</em> of an interface fault reference <em>element information item</em> is present then its actual value ! MUST match the {message label} of some placeholder message with {direction} equal to the message direction. </p> ! <p> ! If the <code>messageLabel</code> <em>attribute information item</em> of an interface fault reference <em>element information item</em> is absent then there MUST be a unique ! placeholder message with {direction} equal to the message direction. </p> ! <p> Define the <em>effective message label</em> of an interface fault reference <em>element information item</em> --- 4119,4156 ---- The <code>messageLabel</code> ! <em>attribute information item</em> ! of an interface fault reference ! <em>element information item</em> ! MUST be present if the message exchange pattern has more ! than one placeholder message with {direction} equal to the ! message direction. <a href="#MessageLabel-0005">†</a> </p> ! <p> ! <a name="MessageLabel-0009-src"></a> ! If the ! <code>messageLabel</code> ! <em>attribute information item</em> ! of an interface fault reference ! <em>element information item</em> ! is present then its actual value MUST match the {message ! label} of some placeholder message with {direction} equal ! to the message direction. ! <a href="#MessageLabel-0009">†</a> </p> ! <p> ! <a name="MessageLabel-0013-src"></a> ! If the ! <code>messageLabel</code> ! <em>attribute information item</em> ! of an interface fault reference ! <em>element information item</em> ! is absent then there MUST be a unique placeholder message ! with {direction} equal to the message direction. ! <a href="#MessageLabel-0013">†</a> </p> ! <p> Define the <em>effective message label</em> of an interface fault reference <em>element information item</em> *************** *** 7086,7105 **** The <code>messageLabel</code> ! <em>attribute information item</em> of a binding message reference <em>element information item</em> ! MUST be present if the message exchange pattern has ! more than one placeholder message with {direction} equal to the message direction. <a href="#MessageLabel-0006">†</a> </p> ! <p> ! If the <code>messageLabel</code> <em>attribute information item</em> of a binding message reference <em>element information item</em> is present then its actual value ! MUST match the {message label} of some placeholder message with {direction} equal to the message direction. </p> ! <p> ! If the <code>messageLabel</code> <em>attribute information item</em> of a binding message reference <em>element information item</em> is absent then there MUST be a unique ! placeholder message with {direction} equal to the message direction. </p> ! <p> Define the <em>effective message label</em> of a binding message reference <em>element information item</em> --- 7122,7159 ---- The <code>messageLabel</code> ! <em>attribute information item</em> ! of a binding message reference ! <em>element information item</em> ! MUST be present if the message exchange pattern has more ! than one placeholder message with {direction} equal to the ! message direction. <a href="#MessageLabel-0006">†</a> </p> ! <p> ! <a name="MessageLabel-0010-src"></a> ! If the ! <code>messageLabel</code> ! <em>attribute information item</em> ! of a binding message reference ! <em>element information item</em> ! is present then its actual value MUST match the {message ! label} of some placeholder message with {direction} equal ! to the message direction. ! <a href="#MessageLabel-0010">†</a> </p> ! <p> ! <a name="MessageLabel-0014-src"></a> ! If the ! <code>messageLabel</code> ! <em>attribute information item</em> ! of a binding message reference ! <em>element information item</em> ! is absent then there MUST be a unique placeholder message ! with {direction} equal to the message direction. ! <a href="#MessageLabel-0014">†</a> </p> ! <p> Define the <em>effective message label</em> of a binding message reference <em>element information item</em> *************** *** 7522,7541 **** The <code>messageLabel</code> ! <em>attribute information item</em> of a binding fault reference <em>element information item</em> ! MUST be present if the message exchange pattern has ! more than one placeholder message with {direction} equal to the message direction. <a href="#MessageLabel-0007">†</a> </p> ! <p> ! If the <code>messageLabel</code> <em>attribute information item</em> of a binding fault reference <em>element information item</em> is present then its actual value ! MUST match the {message label} of some placeholder message with {direction} equal to the message direction. </p> ! <p> ! If the <code>messageLabel</code> <em>attribute information item</em> of a binding fault reference <em>element information item</em> is absent then there MUST be a unique ! placeholder message with {direction} equal to the message direction. </p> ! <p> Define the <em>effective message label</em> of a binding fault reference <em>element information item</em> --- 7576,7613 ---- The <code>messageLabel</code> ! <em>attribute information item</em> ! of a binding fault reference ! <em>element information item</em> ! MUST be present if the message exchange pattern has more ! than one placeholder message with {direction} equal to the ! message direction. <a href="#MessageLabel-0007">†</a> </p> ! <p> ! <a name="MessageLabel-0011-src"></a> ! If the ! <code>messageLabel</code> ! <em>attribute information item</em> ! of a binding fault reference ! <em>element information item</em> ! is present then its actual value MUST match the {message ! label} of some placeholder message with {direction} equal ! to the message direction. ! <a href="#MessageLabel-0011">†</a> </p> ! <p> ! <a name="MessageLabel-0015-src"></a> ! If the ! <code>messageLabel</code> ! <em>attribute information item</em> ! of a binding fault reference ! <em>element information item</em> ! is absent then there MUST be a unique placeholder message ! with {direction} equal to the message direction. ! <a href="#MessageLabel-0015">†</a> </p> ! <p> Define the <em>effective message label</em> of a binding fault reference <em>element information item</em> *************** *** 7619,7623 **** </div> - <div class="div2"> --- 7691,7694 ---- *************** *** 10739,10743 **** property of the <a href="wsdl20.html#component-InterfaceFault">Interface Fault</a> - component. </p> --- 10810,10813 ---- *************** *** 11468,11472 **** <div class="div1"> ! <h2><a name="N165E3"></a>D. Component Summary (Non-Normative)</h2> <p> <a href="#component-summary">Table D-1</a> --- 11538,11542 ---- <div class="div1"> ! <h2><a name="N1660B"></a>D. Component Summary (Non-Normative)</h2> <p> <a href="#component-summary">Table D-1</a> *************** *** 11845,11848 **** --- 11915,12094 ---- WSDL 2.0 document that is importing them.</td> </tr> + <tr> + <td rowspan="1" colspan="1"> + <a href="#MessageLabel-0004-src" name="MessageLabel-0004">MessageLabel-0004</a> + </td> + <td rowspan="1" colspan="1"> + The + <code>messageLabel</code> + <em>attribute information item</em> + of an interface message reference + <em>element information item</em> + MUST be present if the message exchange pattern has more + than one placeholder message with {direction} equal to the + message direction. + </td> + </tr> + <tr> + <td rowspan="1" colspan="1"> + <a href="#MessageLabel-0005-src" name="MessageLabel-0005">MessageLabel-0005</a> + </td> + <td rowspan="1" colspan="1"> + The + <code>messageLabel</code> + <em>attribute information item</em> + of an interface fault reference + <em>element information item</em> + MUST be present if the message exchange pattern has more + than one placeholder message with {direction} equal to the + message direction. + </td> + </tr> + <tr> + <td rowspan="1" colspan="1"> + <a href="#MessageLabel-0006-src" name="MessageLabel-0006">MessageLabel-0006</a> + </td> + <td rowspan="1" colspan="1"> + The + <code>messageLabel</code> + <em>attribute information item</em> + of a binding message reference + <em>element information item</em> + MUST be present if the message exchange pattern has more + than one placeholder message with {direction} equal to the + message direction. + </td> + </tr> + <tr> + <td rowspan="1" colspan="1"> + <a href="#MessageLabel-0007-src" name="MessageLabel-0007">MessageLabel-0007</a> + </td> + <td rowspan="1" colspan="1"> + The + <code>messageLabel</code> + <em>attribute information item</em> + of a binding fault reference + <em>element information item</em> + MUST be present if the message exchange pattern has more + than one placeholder message with {direction} equal to the + message direction. + </td> + </tr> + <tr> + <td rowspan="1" colspan="1"> + <a href="#MessageLabel-0008-src" name="MessageLabel-0008">MessageLabel-0008</a> + </td> + <td rowspan="1" colspan="1"> + If the + <code>messageLabel</code> + <em>attribute information item</em> + of an interface message reference + <em>element information item</em> + is present then its actual value MUST match the {message + label} of some placeholder message with {direction} equal + to the message direction. + </td> + </tr> + <tr> + <td rowspan="1" colspan="1"> + <a href="#MessageLabel-0009-src" name="MessageLabel-0009">MessageLabel-0009</a> + </td> + <td rowspan="1" colspan="1"> + If the + <code>messageLabel</code> + <em>attribute information item</em> + of an interface fault reference + <em>element information item</em> + is present then its actual value MUST match the {message + label} of some placeholder message with {direction} equal + to the message direction. + </td> + </tr> + <tr> + <td rowspan="1" colspan="1"> + <a href="#MessageLabel-0010-src" name="MessageLabel-0010">MessageLabel-0010</a> + </td> + <td rowspan="1" colspan="1"> + If the + <code>messageLabel</code> + <em>attribute information item</em> + of a binding message reference + <em>element information item</em> + is present then its actual value MUST match the {message + label} of some placeholder message with {direction} equal + to the message direction. + </td> + </tr> + <tr> + <td rowspan="1" colspan="1"> + <a href="#MessageLabel-0011-src" name="MessageLabel-0011">MessageLabel-0011</a> + </td> + <td rowspan="1" colspan="1"> + If the + <code>messageLabel</code> + <em>attribute information item</em> + of a binding fault reference + <em>element information item</em> + is present then its actual value MUST match the {message + label} of some placeholder message with {direction} equal + to the message direction. + </td> + </tr> + <tr> + <td rowspan="1" colspan="1"> + <a href="#MessageLabel-0012-src" name="MessageLabel-0012">MessageLabel-0012</a> + </td> + <td rowspan="1" colspan="1"> + If the + <code>messageLabel</code> + <em>attribute information item</em> + of an interface message reference + <em>element information item</em> + is absent then there MUST be a unique placeholder message + with {direction} equal to the message direction. + </td> + </tr> + <tr> + <td rowspan="1" colspan="1"> + <a href="#MessageLabel-0013-src" name="MessageLabel-0013">MessageLabel-0013</a> + </td> + <td rowspan="1" colspan="1"> + If the + <code>messageLabel</code> + <em>attribute information item</em> + of an interface fault reference + <em>element information item</em> + is absent then there MUST be a unique placeholder message + with {direction} equal to the message direction. + </td> + </tr> + <tr> + <td rowspan="1" colspan="1"> + <a href="#MessageLabel-0014-src" name="MessageLabel-0014">MessageLabel-0014</a> + </td> + <td rowspan="1" colspan="1"> + If the + <code>messageLabel</code> + <em>attribute information item</em> + of a binding message reference + <em>element information item</em> + is absent then there MUST be a unique placeholder message + with {direction} equal to the message direction. + </td> + </tr> + <tr> + <td rowspan="1" colspan="1"> + <a href="#MessageLabel-0015-src" name="MessageLabel-0015">MessageLabel-0015</a> + </td> + <td rowspan="1" colspan="1"> + If the + <code>messageLabel</code> + <em>attribute information item</em> + of a binding fault reference + <em>element information item</em> + is absent then there MUST be a unique placeholder message + with {direction} equal to the message direction. + </td> + </tr> </tbody> Index: wsdl20.tex =================================================================== RCS file: /sources/public/2002/ws/desc/wsdl20/wsdl20.tex,v retrieving revision 1.78 retrieving revision 1.79 diff -C2 -d -r1.78 -r1.79 *** wsdl20.tex 3 Nov 2005 16:19:27 -0000 1.78 --- wsdl20.tex 9 Nov 2005 01:20:00 -0000 1.79 *************** *** 4174,4193 **** The \texttt{messageLabel} ! \textit{attribute information item} of an interface message reference \textit{element information item} ! MUST be present if the message exchange pattern has ! more than one placeholder message with \{direction\} equal to the message direction. ! If the \texttt{messageLabel} \textit{attribute information item} of an interface message reference \textit{element information item} is present then its actual value ! MUST match the \{message label\} of some placeholder message with \{direction\} equal to the message direction. ! ! ! ! If the \texttt{messageLabel} \textit{attribute information item} of an interface message reference \textit{element information item} is absent then there MUST be a unique ! placeholder message with \{direction\} equal to the message direction. Define the \textit{effective message label} of an interface message reference \textit{element information item} --- 4174,4211 ---- The \texttt{messageLabel} ! \textit{attribute information item} ! of an interface message reference ! \textit{element information item} ! MUST be present if the message exchange pattern has more ! than one placeholder message with \{direction\} equal to the ! message direction. + + + If the + \texttt{messageLabel} + \textit{attribute information item} + of an interface message reference + \textit{element information item} + is present then its actual value MUST match the \{message + label\} of some placeholder message with \{direction\} equal + to the message direction. + ! + + If the + \texttt{messageLabel} + \textit{attribute information item} + of an interface message reference + \textit{element information item} + is absent then there MUST be a unique placeholder message + with \{direction\} equal to the message direction. + + Define the \textit{effective message label} of an interface message reference \textit{element information item} *************** *** 4691,4710 **** The \texttt{messageLabel} ! \textit{attribute information item} of an interface fault reference \textit{element information item} ! MUST be present if the message exchange pattern has ! more than one placeholder message with \{direction\} equal to the message direction. ! If the \texttt{messageLabel} \textit{attribute information item} of an interface fault reference \textit{element information item} is present then its actual value ! MUST match the \{message label\} of some placeholder message with \{direction\} equal to the message direction. ! ! ! ! If the \texttt{messageLabel} \textit{attribute information item} of an interface fault reference \textit{element information item} is absent then there MUST be a unique ! placeholder message with \{direction\} equal to the message direction. Define the \textit{effective message label} of an interface fault reference \textit{element information item} --- 4709,4746 ---- The \texttt{messageLabel} ! \textit{attribute information item} ! of an interface fault reference ! \textit{element information item} ! MUST be present if the message exchange pattern has more ! than one placeholder message with \{direction\} equal to the ! message direction. + + + If the + \texttt{messageLabel} + \textit{attribute information item} + of an interface fault reference + \textit{element information item} + is present then its actual value MUST match the \{message + label\} of some placeholder message with \{direction\} equal + to the message direction. + ! + + If the + \texttt{messageLabel} + \textit{attribute information item} + of an interface fault reference + \textit{element information item} + is absent then there MUST be a unique placeholder message + with \{direction\} equal to the message direction. + + Define the \textit{effective message label} of an interface fault reference \textit{element information item} *************** *** 7970,7989 **** The \texttt{messageLabel} ! \textit{attribute information item} of a binding message reference \textit{element information item} ! MUST be present if the message exchange pattern has ! more than one placeholder message with \{direction\} equal to the message direction. ! If the \texttt{messageLabel} \textit{attribute information item} of a binding message reference \textit{element information item} is present then its actual value ! MUST match the \{message label\} of some placeholder message with \{direction\} equal to the message direction. ! ! ! ! If the \texttt{messageLabel} \textit{attribute information item} of a binding message reference \textit{element information item} is absent then there MUST be a unique ! placeholder message with \{direction\} equal to the message direction. Define the \textit{effective message label} of a binding message reference \textit{element information item} --- 8006,8043 ---- The \texttt{messageLabel} ! \textit{attribute information item} ! of a binding message reference ! \textit{element information item} ! MUST be present if the message exchange pattern has more ! than one placeholder message with \{direction\} equal to the ! message direction. + + + If the + \texttt{messageLabel} + \textit{attribute information item} + of a binding message reference + \textit{element information item} + is present then its actual value MUST match the \{message + label\} of some placeholder message with \{direction\} equal + to the message direction. + ! + + If the + \texttt{messageLabel} + \textit{attribute information item} + of a binding message reference + \textit{element information item} + is absent then there MUST be a unique placeholder message + with \{direction\} equal to the message direction. + + Define the \textit{effective message label} of a binding message reference \textit{element information item} *************** *** 8461,8480 **** The \texttt{messageLabel} ! \textit{attribute information item} of a binding fault reference \textit{element information item} ! MUST be present if the message exchange pattern has ! more than one placeholder message with \{direction\} equal to the message direction. ! If the \texttt{messageLabel} \textit{attribute information item} of a binding fault reference \textit{element information item} is present then its actual value ! MUST match the \{message label\} of some placeholder message with \{direction\} equal to the message direction. ! ! ! ! If the \texttt{messageLabel} \textit{attribute information item} of a binding fault reference \textit{element information item} is absent then there MUST be a unique ! placeholder message with \{direction\} equal to the message direction. Define the \textit{effective message label} of a binding fault reference \textit{element information item} --- 8515,8552 ---- The \texttt{messageLabel} ! \textit{attribute information item} ! of a binding fault reference ! \textit{element information item} ! MUST be present if the message exchange pattern has more ! than one placeholder message with \{direction\} equal to the ! message direction. + + + If the + \texttt{messageLabel} + \textit{attribute information item} + of a binding fault reference + \textit{element information item} + is present then its actual value MUST match the \{message + label\} of some placeholder message with \{direction\} equal + to the message direction. + ! + + If the + \texttt{messageLabel} + \textit{attribute information item} + of a binding fault reference + \textit{element information item} + is absent then there MUST be a unique placeholder message + with \{direction\} equal to the message direction. + + Define the \textit{effective message label} of a binding fault reference \textit{element information item} *************** *** 8558,8562 **** - \hypertarget{Service}{} \section{Service}\label{Service} --- 8630,8633 ---- *************** *** 11829,11833 **** property of the Interface Fault - component. --- 11900,11903 ---- *************** *** 13011,13014 **** --- 13081,13260 ---- WSDL 2.0 document that is importing them. \\ \hline + + + + & + + The + \texttt{messageLabel} + \textit{attribute information item} + of an interface message reference + \textit{element information item} + MUST be present if the message exchange pattern has more + than one placeholder message with \{direction\} equal to the + message direction. + + \\ \hline + + + + & + + The + \texttt{messageLabel} + \textit{attribute information item} + of an interface fault reference + \textit{element information item} + MUST be present if the message exchange pattern has more + than one placeholder message with \{direction\} equal to the + message direction. + + \\ \hline + + + + & + + The + \texttt{messageLabel} + \textit{attribute information item} + of a binding message reference + \textit{element information item} + MUST be present if the message exchange pattern has more + than one placeholder message with \{direction\} equal to the + message direction. + + \\ \hline + + + + & + + The + \texttt{messageLabel} + \textit{attribute information item} + of a binding fault reference + \textit{element information item} + MUST be present if the message exchange pattern has more + than one placeholder message with \{direction\} equal to the + message direction. + + \\ \hline + + + + & + + If the + \texttt{messageLabel} + \textit{attribute information item} + of an interface message reference + \textit{element information item} + is present then its actual value MUST match the \{message + label\} of some placeholder message with \{direction\} equal + to the message direction. + + \\ \hline + + + + & + + If the + \texttt{messageLabel} + \textit{attribute information item} + of an interface fault reference + \textit{element information item} + is present then its actual value MUST match the \{message + label\} of some placeholder message with \{direction\} equal + to the message direction. + + \\ \hline + + + + & + + If the + \texttt{messageLabel} + \textit{attribute information item} + of a binding message reference + \textit{element information item} + is present then its actual value MUST match the \{message + label\} of some placeholder message with \{direction\} equal + to the message direction. + + \\ \hline + + + + & + + If the + \texttt{messageLabel} + \textit{attribute information item} + of a binding fault reference + \textit{element information item} + is present then its actual value MUST match the \{message + label\} of some placeholder message with \{direction\} equal + to the message direction. + + \\ \hline + + + + & + + If the + \texttt{messageLabel} + \textit{attribute information item} + of an interface message reference + \textit{element information item} + is absent then there MUST be a unique placeholder message + with \{direction\} equal to the message direction. + + \\ \hline + + + + & + + If the + \texttt{messageLabel} + \textit{attribute information item} + of an interface fault reference + \textit{element information item} + is absent then there MUST be a unique placeholder message + with \{direction\} equal to the message direction. + + \\ \hline + + + + & + + If the + \texttt{messageLabel} + \textit{attribute information item} + of a binding message reference + \textit{element information item} + is absent then there MUST be a unique placeholder message + with \{direction\} equal to the message direction. + + \\ \hline + + + + & + + If the + \texttt{messageLabel} + \textit{attribute information item} + of a binding fault reference + \textit{element information item} + is absent then there MUST be a unique placeholder message + with \{direction\} equal to the message direction. + + \\ \hline \end{longtable} Index: wsdl20.xml =================================================================== RCS file: /sources/public/2002/ws/desc/wsdl20/wsdl20.xml,v retrieving revision 1.345 retrieving revision 1.346 diff -C2 -d -r1.345 -r1.346 *** wsdl20.xml 3 Nov 2005 16:19:27 -0000 1.345 --- wsdl20.xml 9 Nov 2005 01:20:00 -0000 1.346 *************** *** 4110,4132 **** <p> ! <assert class="model" id="MessageLabel-0004"> The <att>messageLabel</att> ! &AII; of an interface message reference &EII; ! MUST be present if the message exchange pattern has ! more than one placeholder message with {direction} equal to the message direction. </assert> </p> ! <p> ! If the <att>messageLabel</att> &AII; of an interface message reference &EII; is present then its actual value ! MUST match the {message label} of some placeholder message with {direction} equal to the message direction. </p> ! <p> ! If the <att>messageLabel</att> &AII; of an interface message reference &EII; is absent then there MUST be a unique ! placeholder message with {direction} equal to the message direction. </p> ! <p> Define the <emph>effective message label</emph> of an interface message reference &EII; --- 4110,4150 ---- <p> ! <assert class="document" id="MessageLabel-0004"> The <att>messageLabel</att> ! &AII; ! of an interface message reference ! &EII; ! MUST be present if the message exchange pattern has more ! than one placeholder message with {direction} equal to the ! message direction. </assert> </p> ! <p> ! <assert class="document" id="MessageLabel-0008"> ! If the ! <att>messageLabel</att> ! &AII; ! of an interface message reference ! &EII; ! is present then its actual value MUST match the {message ! label} of some placeholder message with {direction} equal ! to the message direction. ! </assert> </p> ! <p> ! <assert class="document" id="MessageLabel-0012"> ! If the ! <att>messageLabel</att> ! &AII; ! of an interface message reference ! &EII; ! is absent then there MUST be a unique placeholder message ! with {direction} equal to the message direction. ! </assert> </p> ! <p> Define the <emph>effective message label</emph> of an interface message reference &EII; *************** *** 4613,4635 **** <p> ! <assert class="model" id="MessageLabel-0005"> The <att>messageLabel</att> ! &AII; of an interface fault reference &EII; ! MUST be present if the message exchange pattern has ! more than one placeholder message with {direction} equal to the message direction. </assert> </p> ! <p> ! If the <att>messageLabel</att> &AII; of an interface fault reference &EII; is present then its actual value ! MUST match the {message label} of some placeholder message with {direction} equal to the message direction. </p> ! <p> ! If the <att>messageLabel</att> &AII; of an interface fault reference &EII; is absent then there MUST be a unique ! placeholder message with {direction} equal to the message direction. </p> ! <p> Define the <emph>effective message label</emph> of an interface fault reference &EII; --- 4631,4671 ---- <p> ! <assert class="document" id="MessageLabel-0005"> The <att>messageLabel</att> ! &AII; ! of an interface fault reference ! &EII; ! MUST be present if the message exchange pattern has more ! than one placeholder message with {direction} equal to the ! message direction. </assert> </p> ! <p> ! <assert class="document" id="MessageLabel-0009"> ! If the ! <att>messageLabel</att> ! &AII; ! of an interface fault reference ! &EII; ! is present then its actual value MUST match the {message ! label} of some placeholder message with {direction} equal ! to the message direction. ! </assert> </p> ! <p> ! <assert class="document" id="MessageLabel-0013"> ! If the ! <att>messageLabel</att> ! &AII; ! of an interface fault reference ! &EII; ! is absent then there MUST be a unique placeholder message ! with {direction} equal to the message direction. ! </assert> </p> ! <p> Define the <emph>effective message label</emph> of an interface fault reference &EII; *************** *** 7830,7852 **** <p> ! <assert class="model" id="MessageLabel-0006"> The <att>messageLabel</att> ! &AII; of a binding message reference &EII; ! MUST be present if the message exchange pattern has ! more than one placeholder message with {direction} equal to the message direction. </assert> </p> ! <p> ! If the <att>messageLabel</att> &AII; of a binding message reference &EII; is present then its actual value ! MUST match the {message label} of some placeholder message with {direction} equal to the message direction. </p> ! <p> ! If the <att>messageLabel</att> &AII; of a binding message reference &EII; is absent then there MUST be a unique ! placeholder message with {direction} equal to the message direction. </p> ! <p> Define the <emph>effective message label</emph> of a binding message reference &EII; --- 7866,7906 ---- <p> ! <assert class="document" id="MessageLabel-0006"> The <att>messageLabel</att> ! &AII; ! of a binding message reference ! &EII; ! MUST be present if the message exchange pattern has more ! than one placeholder message with {direction} equal to the ! message direction. </assert> </p> ! <p> ! <assert class="document" id="MessageLabel-0010"> ! If the ! <att>messageLabel</att> ! &AII; ! of a binding message reference ! &EII; ! is present then its actual value MUST match the {message ! label} of some placeholder message with {direction} equal ! to the message direction. ! </assert> </p> ! <p> ! <assert class="document" id="MessageLabel-0014"> ! If the ! <att>messageLabel</att> ! &AII; ! of a binding message reference ! &EII; ! is absent then there MUST be a unique placeholder message ! with {direction} equal to the message direction. ! </assert> </p> ! <p> Define the <emph>effective message label</emph> of a binding message reference &EII; *************** *** 8306,8328 **** <p> ! <assert class="model" id="MessageLabel-0007"> The <att>messageLabel</att> ! &AII; of a binding fault reference &EII; ! MUST be present if the message exchange pattern has ! more than one placeholder message with {direction} equal to the message direction. </assert> </p> ! <p> ! If the <att>messageLabel</att> &AII; of a binding fault reference &EII; is present then its actual value ! MUST match the {message label} of some placeholder message with {direction} equal to the message direction. </p> ! <p> ! If the <att>messageLabel</att> &AII; of a binding fault reference &EII; is absent then there MUST be a unique ! placeholder message with {direction} equal to the message direction. </p> ! <p> Define the <emph>effective message label</emph> of a binding fault reference &EII; --- 8360,8400 ---- <p> ! <assert class="document" id="MessageLabel-0007"> The <att>messageLabel</att> ! &AII; ! of a binding fault reference ! &EII; ! MUST be present if the message exchange pattern has more ! than one placeholder message with {direction} equal to the ! message direction. </assert> </p> ! <p> ! <assert class="document" id="MessageLabel-0011"> ! If the ! <att>messageLabel</att> ! &AII; ! of a binding fault reference ! &EII; ! is present then its actual value MUST match the {message ! label} of some placeholder message with {direction} equal ! to the message direction. ! </assert> </p> ! <p> ! <assert class="document" id="MessageLabel-0015"> ! If the ! <att>messageLabel</att> ! &AII; ! of a binding fault reference ! &EII; ! is absent then there MUST be a unique placeholder message ! with {direction} equal to the message direction. ! </assert> </p> ! <p> Define the <emph>effective message label</emph> of a binding fault reference &EII; Index: document-assertion-table.xml =================================================================== RCS file: /sources/public/2002/ws/desc/wsdl20/document-assertion-table.xml,v retrieving revision 1.4 retrieving revision 1.5 diff -C2 -d -r1.4 -r1.5 *** document-assertion-table.xml 27 Oct 2005 18:07:59 -0000 1.4 --- document-assertion-table.xml 9 Nov 2005 01:20:00 -0000 1.5 *************** *** 28,30 **** --- 28,206 ---- WSDL 2.0 document that is importing them.</td> </tr> + <tr> + <td> + <assert-summary ref="MessageLabel-0004"/> + </td> + <td> + The + <att>messageLabel</att> + <emph>attribute information item</emph> + of an interface message reference + <emph>element information item</emph> + MUST be present if the message exchange pattern has more + than one placeholder message with {direction} equal to the + message direction. + </td> + </tr> + <tr> + <td> + <assert-summary ref="MessageLabel-0005"/> + </td> + <td> + The + <att>messageLabel</att> + <emph>attribute information item</emph> + of an interface fault reference + <emph>element information item</emph> + MUST be present if the message exchange pattern has more + than one placeholder message with {direction} equal to the + message direction. + </td> + </tr> + <tr> + <td> + <assert-summary ref="MessageLabel-0006"/> + </td> + <td> + The + <att>messageLabel</att> + <emph>attribute information item</emph> + of a binding message reference + <emph>element information item</emph> + MUST be present if the message exchange pattern has more + than one placeholder message with {direction} equal to the + message direction. + </td> + </tr> + <tr> + <td> + <assert-summary ref="MessageLabel-0007"/> + </td> + <td> + The + <att>messageLabel</att> + <emph>attribute information item</emph> + of a binding fault reference + <emph>element information item</emph> + MUST be present if the message exchange pattern has more + than one placeholder message with {direction} equal to the + message direction. + </td> + </tr> + <tr> + <td> + <assert-summary ref="MessageLabel-0008"/> + </td> + <td> + If the + <att>messageLabel</att> + <emph>attribute information item</emph> + of an interface message reference + <emph>element information item</emph> + is present then its actual value MUST match the {message + label} of some placeholder message with {direction} equal + to the message direction. + </td> + </tr> + <tr> + <td> + <assert-summary ref="MessageLabel-0009"/> + </td> + <td> + If the + <att>messageLabel</att> + <emph>attribute information item</emph> + of an interface fault reference + <emph>element information item</emph> + is present then its actual value MUST match the {message + label} of some placeholder message with {direction} equal + to the message direction. + </td> + </tr> + <tr> + <td> + <assert-summary ref="MessageLabel-0010"/> + </td> + <td> + If the + <att>messageLabel</att> + <emph>attribute information item</emph> + of a binding message reference + <emph>element information item</emph> + is present then its actual value MUST match the {message + label} of some placeholder message with {direction} equal + to the message direction. + </td> + </tr> + <tr> + <td> + <assert-summary ref="MessageLabel-0011"/> + </td> + <td> + If the + <att>messageLabel</att> + <emph>attribute information item</emph> + of a binding fault reference + <emph>element information item</emph> + is present then its actual value MUST match the {message + label} of some placeholder message with {direction} equal + to the message direction. + </td> + </tr> + <tr> + <td> + <assert-summary ref="MessageLabel-0012"/> + </td> + <td> + If the + <att>messageLabel</att> + <emph>attribute information item</emph> + of an interface message reference + <emph>element information item</emph> + is absent then there MUST be a unique placeholder message + with {direction} equal to the message direction. + </td> + </tr> + <tr> + <td> + <assert-summary ref="MessageLabel-0013"/> + </td> + <td> + If the + <att>messageLabel</att> + <emph>attribute information item</emph> + of an interface fault reference + <emph>element information item</emph> + is absent then there MUST be a unique placeholder message + with {direction} equal to the message direction. + </td> + </tr> + <tr> + <td> + <assert-summary ref="MessageLabel-0014"/> + </td> + <td> + If the + <att>messageLabel</att> + <emph>attribute information item</emph> + of a binding message reference + <emph>element information item</emph> + is absent then there MUST be a unique placeholder message + with {direction} equal to the message direction. + </td> + </tr> + <tr> + <td> + <assert-summary ref="MessageLabel-0015"/> + </td> + <td> + If the + <att>messageLabel</att> + <emph>attribute information item</emph> + of a binding fault reference + <emph>element information item</emph> + is absent then there MUST be a unique placeholder message + with {direction} equal to the message direction. + </td> + </tr> </tbody> Index: wsdl20-z.html =================================================================== RCS file: /sources/public/2002/ws/desc/wsdl20/wsdl20-z.html,v retrieving revision 1.66 retrieving revision 1.67 diff -C2 -d -r1.66 -r1.67 *** wsdl20-z.html 3 Nov 2005 16:19:28 -0000 1.66 --- wsdl20-z.html 9 Nov 2005 01:20:00 -0000 1.67 *************** *** 77,81 **** <hr><div class="toc"> ! <h2><a name="shortcontents">Short Table of Contents</a></h2><p class="toc">1. <a href="#intro">Introduction</a><br>2. <a href="#component_model">Component Model</a><br>3. <a href="#eii-types">Types</a><br>4. <a href="#modularize">Modularizing WSDL 2.0 descriptions</a><br>5. <a href="#eii-documentation">Documentation</a><br>6. <a href="#language-extensibility">Language Extensibility</a><br>7. <a href="#wsdllocation">Locating WSDL 2.0 Documents</a><br>8. <a href="#conformance">Conformance</a><br>9. <a href="#Syntax-Summary">XML Syntax Summary (Non-Normative)</a><br>10. <a href="#References">References</a><br>A. <a href="#ietf-draft">The application/wsdl+xml Media Type</a><br>B. <a href="#acknowledgments">Acknowledgements</a> (Non-Normative)<br>C. <a href="#wsdl-iri-references">IRI References for WSDL 2.0 Components</a> (Non-Normative)<br>D. <a href="#N165E3">Component Summary</a> (Non-Normative)<br>E. <a href="#assertionsummary">Assertion Summary</a> (Non-Normative)<br>F. <a href="#changelog">Part 1 Change og</a> (Non-Normative)<br></p></div><hr><div class="toc"> <h2><a name="contents">Table of Contents</a></h2><p class="toc">1. <a href="#intro">Introduction</a><br> 1.1 <a href="#intro_ws">Web Service</a><br> 1.2 <a href="#markup">Document Conformance</a><br> 1.3 <a href="#meaning">The Meaning of a Service Description</a><br> 1.4 <a href="#notation">Notational Conventions</a><br> 1.4.1 <a href="#rfc2119keywords">RFC 2119 Keywords</a><br> 1.4.2 <a href="#rfc3986namespaces">RFC 3986 Namespaces</a><br> 1.4.3 <a href="#nsprefixes">Prefixes and Namespaces Used in This Specification</a><br> 1.4.4 <a href="#terminology">Terms Used in This Specification</a><br> 1.4.5 <a href="#xmlinfosetproperties">XML Information Set Properties</a><br> &nbp; 1.4.6 <a href="#wsdlcomponentmodelproperties">WSDL 2.0 Component Model Properties</a><br> 1.4.7 <a href="#znotation">Z Notation</a><br> 1.4.8 <a href="#bnfpseudoschemas">BNF Pseudo-Schemas</a><br> 1.4.9 <a href="#assertions">Assertions</a><br>2. <a href="#component_model">Component Model</a><br> 2.1 <a href="#Description">Description</a><br> 2.1.1 <a href="#Description_details">The Description Component</a><br> 2.1.2 <a href="#Description_XMLRep">XML Representation of Description Component</a><br> 2.1.2.1 <a href="#Description_targetnamespace_attribute">targetNamespace attribute information item</a><br> 2.13 <a href="#Description_Mapping">Mapping Description's XML Representation to Component Properties</a><br> 2.2 <a href="#Interface">Interface</a><br> 2.2.1 <a href="#Interface_details">The Interface Component</a><br> 2.2.2 <a href="#Interface_XMLRep">XML Representation of Interface Component</a><br> 2.2.2.1 <a href="#Interface_name_attribute">name attribute information item with interface [owner element]</a><br> 2.2.2.2 <a href="#Interface_extends_attribute">extends attribute information item</a><br> 2.2.2.3 <a href="#Interface_styleDefault_attribute">styleDefault attribute information item</a><br> 2.2.3 <a href="#Interface_Mapping">Mapping Interface's XML Representation to Component Properties</a><br> &nsp; 2.3 <a href="#InterfaceFault">Interface Fault</a><br> 2.3.1 <a href="#InterfaceFault_details">The Interface Fault Component</a><br> 2.3.2 <a href="#InterfaceFault_XMLRep">XML Representation of Interface Fault Component</a><br> 2.3.2.1 <a href="#Interfacefault_name_attribute">name attribute information item with fault [owner element]</a><br> 2.3.2.2 <a href="#Interface_element_attribute">element attribute information item with fault [owner element]</a><br> 2.3.3 <a href="#InterfaceFault_Mapping">Mapping Interface Fault's XML Representation to --- 77,81 ---- <hr><div class="toc"> ! <h2><a name="shortcontents">Short Table of Contents</a></h2><p class="toc">1. <a href="#intro">Introduction</a><br>2. <a href="#component_model">Component Model</a><br>3. <a href="#eii-types">Types</a><br>4. <a href="#modularize">Modularizing WSDL 2.0 descriptions</a><br>5. <a href="#eii-documentation">Documentation</a><br>6. <a href="#language-extensibility">Language Extensibility</a><br>7. <a href="#wsdllocation">Locating WSDL 2.0 Documents</a><br>8. <a href="#conformance">Conformance</a><br>9. <a href="#Syntax-Summary">XML Syntax Summary (Non-Normative)</a><br>10. <a href="#References">References</a><br>A. <a href="#ietf-draft">The application/wsdl+xml Media Type</a><br>B. <a href="#acknowledgments">Acknowledgements</a> (Non-Normative)<br>C. <a href="#wsdl-iri-references">IRI References for WSDL 2.0 Components</a> (Non-Normative)<br>D. <a href="#N1660B">Component Summary</a> (Non-Normative)<br>E. <a href="#assertionsummary">Assertion Summary</a> (Non-Normative)<br>F. <a href="#changelog">Part 1 Change og</a> (Non-Normative)<br></p></div><hr><div class="toc"> <h2><a name="contents">Table of Contents</a></h2><p class="toc">1. <a href="#intro">Introduction</a><br> 1.1 <a href="#intro_ws">Web Service</a><br> 1.2 <a href="#markup">Document Conformance</a><br> 1.3 <a href="#meaning">The Meaning of a Service Description</a><br> 1.4 <a href="#notation">Notational Conventions</a><br> 1.4.1 <a href="#rfc2119keywords">RFC 2119 Keywords</a><br> 1.4.2 <a href="#rfc3986namespaces">RFC 3986 Namespaces</a><br> 1.4.3 <a href="#nsprefixes">Prefixes and Namespaces Used in This Specification</a><br> 1.4.4 <a href="#terminology">Terms Used in This Specification</a><br> 1.4.5 <a href="#xmlinfosetproperties">XML Information Set Properties</a><br> &nbp; 1.4.6 <a href="#wsdlcomponentmodelproperties">WSDL 2.0 Component Model Properties</a><br> 1.4.7 <a href="#znotation">Z Notation</a><br> 1.4.8 <a href="#bnfpseudoschemas">BNF Pseudo-Schemas</a><br> 1.4.9 <a href="#assertions">Assertions</a><br>2. <a href="#component_model">Component Model</a><br> 2.1 <a href="#Description">Description</a><br> 2.1.1 <a href="#Description_details">The Description Component</a><br> 2.1.2 <a href="#Description_XMLRep">XML Representation of Description Component</a><br> 2.1.2.1 <a href="#Description_targetnamespace_attribute">targetNamespace attribute information item</a><br> 2.13 <a href="#Description_Mapping">Mapping Description's XML Representation to Component Properties</a><br> 2.2 <a href="#Interface">Interface</a><br> 2.2.1 <a href="#Interface_details">The Interface Component</a><br> 2.2.2 <a href="#Interface_XMLRep">XML Representation of Interface Component</a><br> 2.2.2.1 <a href="#Interface_name_attribute">name attribute information item with interface [owner element]</a><br> 2.2.2.2 <a href="#Interface_extends_attribute">extends attribute information item</a><br> 2.2.2.3 <a href="#Interface_styleDefault_attribute">styleDefault attribute information item</a><br> 2.2.3 <a href="#Interface_Mapping">Mapping Interface's XML Representation to Component Properties</a><br> &nsp; 2.3 <a href="#InterfaceFault">Interface Fault</a><br> 2.3.1 <a href="#InterfaceFault_details">The Interface Fault Component</a><br> 2.3.2 <a href="#InterfaceFault_XMLRep">XML Representation of Interface Fault Component</a><br> 2.3.2.1 <a href="#Interfacefault_name_attribute">name attribute information item with fault [owner element]</a><br> 2.3.2.2 <a href="#Interface_element_attribute">element attribute information item with fault [owner element]</a><br> 2.3.3 <a href="#InterfaceFault_Mapping">Mapping Interface Fault's XML Representation to *************** *** 102,106 **** attribute information item </a><br> 3.3.3 <a href="#wsdlx-consistency">wsdlx:interface and wsdlx:binding Consistency</a><br> 3.3.4 <a href="#wsdlx-xsanyuri">Use of wsdlx:interface and wsdlx:binding with xs:anyURI</a><br>4. <a href="#modularize">Modularizing WSDL 2.0 descriptions</a><br> 4.1 <a href="#includes">Including Descriptions</a><br> 4.1.1 <a href="#include_location_attribute">location attribute information item with include [owner element]</a><br> 4.2 <a href="#imports">Importing Descriptions</a><br> 4.2.1 <a href="#import_namespace_attribute">namespace attribute information item</a><br> 4.2.2 <a href="#import_location_attribute">location attribute information item with import [owner element]</a><br>5. <a href="#eii-documentation">Documentatin</a><br>6. <a href="#language-extensibility">Language Extensibility</a><br> 6.1 <a href="#eii-extensibility">Element based Extensibility</a><br> 6.1.1 <a href="#mandatoryext">Mandatory extensions</a><br> 6.1.2 <a href="#required-aii">required attribute information item</a><br> 6.2 <a href="#aii-extensibility">Attribute-based Extensibility</a><br> 6.3 <a href="#extensibility-semantics">Extensibility Semantics</a><br>7. <a href="#wsdllocation">Locating WSDL 2.0 Documents</a><br> 7.1 <a href="#wsdlLocation-aii">wsdli:wsdlLocation attribute information item</a><br>8. <a href="#conformance">Conformance</a><br> 8.1 <a href="#infoset">XML Information Set Conformance</a><br>9. <a href="#Syntax-Summary">XML Syntax Summary (Non-Normative)</a><br>10. <a href="#References">References</a><br> &nbs;10.1 <a href="#Normative-References">Normative References</a><br> 10.2 <a href="#Informative-References">Informative References</a><br></p> ! <h3><a id="appendix" name="appendix">Appendices</a></h3><p class="toc">A. <a href="#ietf-draft">The application/wsdl+xml Media Type</a><br> A.1 <a href="#ietf-reg">Registration</a><br> A.2 <a href="#frag-ids">Fragment Identifiers</a><br> A.2.1 <a href="#wsdl.description">The Description Component</a><br> A.2.2 <a href="#wsdl.elementDeclaration">The Element Declaration Component</a><br> A.2.3 <a href="#wsdl.typeDefinition">The Type Definition Component</a><br> A.2.4 <a href="#wsdl.interface">The Interface Component</a><br> A.2.5 <a href="#wsdl.interfaceFault">The Interface Fault Component</a><br> A.2.6 <a href="#wsdl.interfaceOperation">The Interface Operation Component</a><br> &bsp; A.2.7 <a href="#wsdl.interfaceMessageReference">The Interface Message Reference Component</a><br> A.2.8 <a href="#wsdl.interfaceFaultReference">The Interface Fault Reference Component</a><br> A.2.9 <a href="#wsdl.binding">The Binding Component</a><br> A.2.10 <a href="#wsdl.bindingFault">The Binding Fault Component</a><br> A.2.11 <a href="#wsdl.bindingOperation">The Binding Operation Component</a><br> A.2.12 <a href="#wsdl.bindingMessageReference">The Binding Message Reference Component</a><br> A.2.13 <a href="#wsdl.bindingFaultReference">The Binding Fault Reference Component</a><br> A.2.14 <a href="#wsdl.service">The Service Component</a><br>&nbp; A.2.15 <a href="#wsdl.endpoint">The Endpoint Component</a><br> A.2.16 <a href="#wsdl.feature">The Feature Component</a><br> A.2.17 <a href="#wsdl.property">The Property Component</a><br> A.2.18 <a href="#wsdl.extension">Extension Components</a><br> A.3 <a href="#ietf-sec">Security considerations</a><br>B. <a href="#acknowledgments">Acknowledgements</a> (Non-Normative)<br>C. <a href="#wsdl-iri-references">IRI References for WSDL 2.0 Components</a> (Non-Normative)<br> C.1 <a href="#wsdl-iris">WSDL 2.0 IRIs</a><br> C.2 <a href="#Iri-ref-ex">Example</a><br>D. <a href="#N165E3">Component Summary</a> (Non-Normative)<br>E. <a href="#assertionsummary">Assertion Summary</a> (Non-Normative)<br>F. <a href="#changelog">Part 1 Change Log</a> (Non-Normative)<br> &nbs; F.1 <a href="#wsdl-changelog">WSDL 2.0 Specification Changes</a><br></p></div><hr><div class="body"> <div class="div1"> --- 102,106 ---- attribute information item </a><br> 3.3.3 <a href="#wsdlx-consistency">wsdlx:interface and wsdlx:binding Consistency</a><br> 3.3.4 <a href="#wsdlx-xsanyuri">Use of wsdlx:interface and wsdlx:binding with xs:anyURI</a><br>4. <a href="#modularize">Modularizing WSDL 2.0 descriptions</a><br> 4.1 <a href="#includes">Including Descriptions</a><br> 4.1.1 <a href="#include_location_attribute">location attribute information item with include [owner element]</a><br> 4.2 <a href="#imports">Importing Descriptions</a><br> 4.2.1 <a href="#import_namespace_attribute">namespace attribute information item</a><br> 4.2.2 <a href="#import_location_attribute">location attribute information item with import [owner element]</a><br>5. <a href="#eii-documentation">Documentatin</a><br>6. <a href="#language-extensibility">Language Extensibility</a><br> 6.1 <a href="#eii-extensibility">Element based Extensibility</a><br> 6.1.1 <a href="#mandatoryext">Mandatory extensions</a><br> 6.1.2 <a href="#required-aii">required attribute information item</a><br> 6.2 <a href="#aii-extensibility">Attribute-based Extensibility</a><br> 6.3 <a href="#extensibility-semantics">Extensibility Semantics</a><br>7. <a href="#wsdllocation">Locating WSDL 2.0 Documents</a><br> 7.1 <a href="#wsdlLocation-aii">wsdli:wsdlLocation attribute information item</a><br>8. <a href="#conformance">Conformance</a><br> 8.1 <a href="#infoset">XML Information Set Conformance</a><br>9. <a href="#Syntax-Summary">XML Syntax Summary (Non-Normative)</a><br>10. <a href="#References">References</a><br> &nbs;10.1 <a href="#Normative-References">Normative References</a><br> 10.2 <a href="#Informative-References">Informative References</a><br></p> ! <h3><a id="appendix" name="appendix">Appendices</a></h3><p class="toc">A. <a href="#ietf-draft">The application/wsdl+xml Media Type</a><br> A.1 <a href="#ietf-reg">Registration</a><br> A.2 <a href="#frag-ids">Fragment Identifiers</a><br> A.2.1 <a href="#wsdl.description">The Description Component</a><br> A.2.2 <a href="#wsdl.elementDeclaration">The Element Declaration Component</a><br> A.2.3 <a href="#wsdl.typeDefinition">The Type Definition Component</a><br> A.2.4 <a href="#wsdl.interface">The Interface Component</a><br> A.2.5 <a href="#wsdl.interfaceFault">The Interface Fault Component</a><br> A.2.6 <a href="#wsdl.interfaceOperation">The Interface Operation Component</a><br> &bsp; A.2.7 <a href="#wsdl.interfaceMessageReference">The Interface Message Reference Component</a><br> A.2.8 <a href="#wsdl.interfaceFaultReference">The Interface Fault Reference Component</a><br> A.2.9 <a href="#wsdl.binding">The Binding Component</a><br> A.2.10 <a href="#wsdl.bindingFault">The Binding Fault Component</a><br> A.2.11 <a href="#wsdl.bindingOperation">The Binding Operation Component</a><br> A.2.12 <a href="#wsdl.bindingMessageReference">The Binding Message Reference Component</a><br> A.2.13 <a href="#wsdl.bindingFaultReference">The Binding Fault Reference Component</a><br> A.2.14 <a href="#wsdl.service">The Service Component</a><br>&nbp; A.2.15 <a href="#wsdl.endpoint">The Endpoint Component</a><br> A.2.16 <a href="#wsdl.feature">The Feature Component</a><br> A.2.17 <a href="#wsdl.property">The Property Component</a><br> A.2.18 <a href="#wsdl.extension">Extension Components</a><br> A.3 <a href="#ietf-sec">Security considerations</a><br>B. <a href="#acknowledgments">Acknowledgements</a> (Non-Normative)<br>C. <a href="#wsdl-iri-references">IRI References for WSDL 2.0 Components</a> (Non-Normative)<br> C.1 <a href="#wsdl-iris">WSDL 2.0 IRIs</a><br> C.2 <a href="#Iri-ref-ex">Example</a><br>D. <a href="#N1660B">Component Summary</a> (Non-Normative)<br>E. <a href="#assertionsummary">Assertion Summary</a> (Non-Normative)<br>F. <a href="#changelog">Part 1 Change Log</a> (Non-Normative)<br> &nbs; F.1 <a href="#wsdl-changelog">WSDL 2.0 Specification Changes</a><br></p></div><hr><div class="body"> <div class="div1"> *************** *** 3614,3633 **** The <code>messageLabel</code> ! <em>attribute information item</em> of an interface message reference <em>element information item</em> ! MUST be present if the message exchange pattern has ! more than one placeholder message with {direction} equal to the message direction. <a href="#MessageLabel-0004">†</a> </p> ! <p> ! If the <code>messageLabel</code> <em>attribute information item</em> of an interface message reference <em>element information item</em> is present then its actual value ! MUST match the {message label} of some placeholder message with {direction} equal to the message direction. </p> ! <p> ! If the <code>messageLabel</code> <em>attribute information item</em> of an interface message reference <em>element information item</em> is absent then there MUST be a unique ! placeholder message with {direction} equal to the message direction. </p> ! <p> Define the <em>effective message label</em> of an interface message reference <em>element information item</em> --- 3614,3651 ---- The <code>messageLabel</code> ! <em>attribute information item</em> ! of an interface message reference ! <em>element information item</em> ! MUST be present if the message exchange pattern has more ! than one placeholder message with {direction} equal to the ! message direction. <a href="#MessageLabel-0004">†</a> </p> ! <p> ! <a name="MessageLabel-0008-src"></a> ! If the ! <code>messageLabel</code> ! <em>attribute information item</em> ! of an interface message reference ! <em>element information item</em> ! is present then its actual value MUST match the {message ! label} of some placeholder message with {direction} equal ! to the message direction. ! <a href="#MessageLabel-0008">†</a> </p> ! <p> ! <a name="MessageLabel-0012-src"></a> ! If the ! <code>messageLabel</code> ! <em>attribute information item</em> ! of an interface message reference ! <em>element information item</em> ! is absent then there MUST be a unique placeholder message ! with {direction} equal to the message direction. ! <a href="#MessageLabel-0012">†</a> </p> ! <p> Define the <em>effective message label</em> of an interface message reference <em>element information item</em> *************** *** 4089,4108 **** The <code>messageLabel</code> ! <em>attribute information item</em> of an interface fault reference <em>element information item</em> ! MUST be present if the message exchange pattern has ! more than one placeholder message with {direction} equal to the message direction. <a href="#MessageLabel-0005">†</a> </p> ! <p> ! If the <code>messageLabel</code> <em>attribute information item</em> of an interface fault reference <em>element information item</em> is present then its actual value ! MUST match the {message label} of some placeholder message with {direction} equal to the message direction. </p> ! <p> ! If the <code>messageLabel</code> <em>attribute information item</em> of an interface fault reference <em>element information item</em> is absent then there MUST be a unique ! placeholder message with {direction} equal to the message direction. </p> ! <p> Define the <em>effective message label</em> of an interface fault reference <em>element information item</em> --- 4107,4144 ---- The <code>messageLabel</code> ! <em>attribute information item</em> ! of an interface fault reference ! <em>element information item</em> ! MUST be present if the message exchange pattern has more ! than one placeholder message with {direction} equal to the ! message direction. <a href="#MessageLabel-0005">†</a> </p> ! <p> ! <a name="MessageLabel-0009-src"></a> ! If the ! <code>messageLabel</code> ! <em>attribute information item</em> ! of an interface fault reference ! <em>element information item</em> ! is present then its actual value MUST match the {message ! label} of some placeholder message with {direction} equal ! to the message direction. ! <a href="#MessageLabel-0009">†</a> </p> ! <p> ! <a name="MessageLabel-0013-src"></a> ! If the ! <code>messageLabel</code> ! <em>attribute information item</em> ! of an interface fault reference ! <em>element information item</em> ! is absent then there MUST be a unique placeholder message ! with {direction} equal to the message direction. ! <a href="#MessageLabel-0013">†</a> </p> ! <p> Define the <em>effective message label</em> of an interface fault reference <em>element information item</em> *************** *** 7062,7081 **** The <code>messageLabel</code> ! <em>attribute information item</em> of a binding message reference <em>element information item</em> ! MUST be present if the message exchange pattern has ! more than one placeholder message with {direction} equal to the message direction. <a href="#MessageLabel-0006">†</a> </p> ! <p> ! If the <code>messageLabel</code> <em>attribute information item</em> of a binding message reference <em>element information item</em> is present then its actual value ! MUST match the {message label} of some placeholder message with {direction} equal to the message direction. </p> ! <p> ! If the <code>messageLabel</code> <em>attribute information item</em> of a binding message reference <em>element information item</em> is absent then there MUST be a unique ! placeholder message with {direction} equal to the message direction. </p> ! <p> Define the <em>effective message label</em> of a binding message reference <em>element information item</em> --- 7098,7135 ---- The <code>messageLabel</code> ! <em>attribute information item</em> ! of a binding message reference ! <em>element information item</em> ! MUST be present if the message exchange pattern has more ! than one placeholder message with {direction} equal to the ! message direction. <a href="#MessageLabel-0006">†</a> </p> ! <p> ! <a name="MessageLabel-0010-src"></a> ! If the ! <code>messageLabel</code> ! <em>attribute information item</em> ! of a binding message reference ! <em>element information item</em> ! is present then its actual value MUST match the {message ! label} of some placeholder message with {direction} equal ! to the message direction. ! <a href="#MessageLabel-0010">†</a> </p> ! <p> ! <a name="MessageLabel-0014-src"></a> ! If the ! <code>messageLabel</code> ! <em>attribute information item</em> ! of a binding message reference ! <em>element information item</em> ! is absent then there MUST be a unique placeholder message ! with {direction} equal to the message direction. ! <a href="#MessageLabel-0014">†</a> </p> ! <p> Define the <em>effective message label</em> of a binding message reference <em>element information item</em> *************** *** 7496,7515 **** The <code>messageLabel</code> ! <em>attribute information item</em> of a binding fault reference <em>element information item</em> ! MUST be present if the message exchange pattern has ! more than one placeholder message with {direction} equal to the message direction. <a href="#MessageLabel-0007">†</a> </p> ! <p> ! If the <code>messageLabel</code> <em>attribute information item</em> of a binding fault reference <em>element information item</em> is present then its actual value ! MUST match the {message label} of some placeholder message with {direction} equal to the message direction. </p> ! <p> ! If the <code>messageLabel</code> <em>attribute information item</em> of a binding fault reference <em>element information item</em> is absent then there MUST be a unique ! placeholder message with {direction} equal to the message direction. </p> ! <p> Define the <em>effective message label</em> of a binding fault reference <em>element information item</em> --- 7550,7587 ---- The <code>messageLabel</code> ! <em>attribute information item</em> ! of a binding fault reference ! <em>element information item</em> ! MUST be present if the message exchange pattern has more ! than one placeholder message with {direction} equal to the ! message direction. <a href="#MessageLabel-0007">†</a> </p> ! <p> ! <a name="MessageLabel-0011-src"></a> ! If the ! <code>messageLabel</code> ! <em>attribute information item</em> ! of a binding fault reference ! <em>element information item</em> ! is present then its actual value MUST match the {message ! label} of some placeholder message with {direction} equal ! to the message direction. ! <a href="#MessageLabel-0011">†</a> </p> ! <p> ! <a name="MessageLabel-0015-src"></a> ! If the ! <code>messageLabel</code> ! <em>attribute information item</em> ! of a binding fault reference ! <em>element information item</em> ! is absent then there MUST be a unique placeholder message ! with {direction} equal to the message direction. ! <a href="#MessageLabel-0015">†</a> </p> ! <p> Define the <em>effective message label</em> of a binding fault reference <em>element information item</em> *************** *** 7593,7597 **** </div> - <div class="div2"> --- 7665,7668 ---- *************** *** 10709,10713 **** property of the <a href="wsdl20.html#component-InterfaceFault">Interface Fault</a> - component. </p> --- 10780,10783 ---- *************** *** 11438,11442 **** <div class="div1"> ! <h2><a name="N165E3"></a>D. Component Summary (Non-Normative)</h2> <p> <a href="#component-summary">Table D-1</a> --- 11508,11512 ---- <div class="div1"> ! <h2><a name="N1660B"></a>D. Component Summary (Non-Normative)</h2> <p> <a href="#component-summary">Table D-1</a> *************** *** 11815,11818 **** --- 11885,12064 ---- WSDL 2.0 document that is importing them.</td> </tr> + <tr> + <td rowspan="1" colspan="1"> + <a href="#MessageLabel-0004-src" name="MessageLabel-0004">MessageLabel-0004</a> + </td> + <td rowspan="1" colspan="1"> + The + <code>messageLabel</code> + <em>attribute information item</em> + of an interface message reference + <em>element information item</em> + MUST be present if the message exchange pattern has more + than one placeholder message with {direction} equal to the + message direction. + </td> + </tr> + <tr> + <td rowspan="1" colspan="1"> + <a href="#MessageLabel-0005-src" name="MessageLabel-0005">MessageLabel-0005</a> + </td> + <td rowspan="1" colspan="1"> + The + <code>messageLabel</code> + <em>attribute information item</em> + of an interface fault reference + <em>element information item</em> + MUST be present if the message exchange pattern has more + than one placeholder message with {direction} equal to the + message direction. + </td> + </tr> + <tr> + <td rowspan="1" colspan="1"> + <a href="#MessageLabel-0006-src" name="MessageLabel-0006">MessageLabel-0006</a> + </td> + <td rowspan="1" colspan="1"> + The + <code>messageLabel</code> + <em>attribute information item</em> + of a binding message reference + <em>element information item</em> + MUST be present if the message exchange pattern has more + than one placeholder message with {direction} equal to the + message direction. + </td> + </tr> + <tr> + <td rowspan="1" colspan="1"> + <a href="#MessageLabel-0007-src" name="MessageLabel-0007">MessageLabel-0007</a> + </td> + <td rowspan="1" colspan="1"> + The + <code>messageLabel</code> + <em>attribute information item</em> + of a binding fault reference + <em>element information item</em> + MUST be present if the message exchange pattern has more + than one placeholder message with {direction} equal to the + message direction. + </td> + </tr> + <tr> + <td rowspan="1" colspan="1"> + <a href="#MessageLabel-0008-src" name="MessageLabel-0008">MessageLabel-0008</a> + </td> + <td rowspan="1" colspan="1"> + If the + <code>messageLabel</code> + <em>attribute information item</em> + of an interface message reference + <em>element information item</em> + is present then its actual value MUST match the {message + label} of some placeholder message with {direction} equal + to the message direction. + </td> + </tr> + <tr> + <td rowspan="1" colspan="1"> + <a href="#MessageLabel-0009-src" name="MessageLabel-0009">MessageLabel-0009</a> + </td> + <td rowspan="1" colspan="1"> + If the + <code>messageLabel</code> + <em>attribute information item</em> + of an interface fault reference + <em>element information item</em> + is present then its actual value MUST match the {message + label} of some placeholder message with {direction} equal + to the message direction. + </td> + </tr> + <tr> + <td rowspan="1" colspan="1"> + <a href="#MessageLabel-0010-src" name="MessageLabel-0010">MessageLabel-0010</a> + </td> + <td rowspan="1" colspan="1"> + If the + <code>messageLabel</code> + <em>attribute information item</em> + of a binding message reference + <em>element information item</em> + is present then its actual value MUST match the {message + label} of some placeholder message with {direction} equal + to the message direction. + </td> + </tr> + <tr> + <td rowspan="1" colspan="1"> + <a href="#MessageLabel-0011-src" name="MessageLabel-0011">MessageLabel-0011</a> + </td> + <td rowspan="1" colspan="1"> + If the + <code>messageLabel</code> + <em>attribute information item</em> + of a binding fault reference + <em>element information item</em> + is present then its actual value MUST match the {message + label} of some placeholder message with {direction} equal + to the message direction. + </td> + </tr> + <tr> + <td rowspan="1" colspan="1"> + <a href="#MessageLabel-0012-src" name="MessageLabel-0012">MessageLabel-0012</a> + </td> + <td rowspan="1" colspan="1"> + If the + <code>messageLabel</code> + <em>attribute information item</em> + of an interface message reference + <em>element information item</em> + is absent then there MUST be a unique placeholder message + with {direction} equal to the message direction. + </td> + </tr> + <tr> + <td rowspan="1" colspan="1"> + <a href="#MessageLabel-0013-src" name="MessageLabel-0013">MessageLabel-0013</a> + </td> + <td rowspan="1" colspan="1"> + If the + <code>messageLabel</code> + <em>attribute information item</em> + of an interface fault reference + <em>element information item</em> + is absent then there MUST be a unique placeholder message + with {direction} equal to the message direction. + </td> + </tr> + <tr> + <td rowspan="1" colspan="1"> + <a href="#MessageLabel-0014-src" name="MessageLabel-0014">MessageLabel-0014</a> + </td> + <td rowspan="1" colspan="1"> + If the + <code>messageLabel</code> + <em>attribute information item</em> + of a binding message reference + <em>element information item</em> + is absent then there MUST be a unique placeholder message + with {direction} equal to the message direction. + </td> + </tr> + <tr> + <td rowspan="1" colspan="1"> + <a href="#MessageLabel-0015-src" name="MessageLabel-0015">MessageLabel-0015</a> + </td> + <td rowspan="1" colspan="1"> + If the + <code>messageLabel</code> + <em>attribute information item</em> + of a binding fault reference + <em>element information item</em> + is absent then there MUST be a unique placeholder message + with {direction} equal to the message direction. + </td> + </tr> </tbody> Index: wsdl20.html =================================================================== RCS file: /sources/public/2002/ws/desc/wsdl20/wsdl20.html,v retrieving revision 1.233 retrieving revision 1.234 diff -C2 -d -r1.233 -r1.234 *** wsdl20.html 3 Nov 2005 16:19:27 -0000 1.233 --- wsdl20.html 9 Nov 2005 01:19:58 -0000 1.234 *************** *** 77,81 **** <hr><div class="toc"> ! <h2><a name="shortcontents">Short Table of Contents</a></h2><p class="toc">1. <a href="#intro">Introduction</a><br>2. <a href="#component_model">Component Model</a><br>3. <a href="#eii-types">Types</a><br>4. <a href="#modularize">Modularizing WSDL 2.0 descriptions</a><br>5. <a href="#eii-documentation">Documentation</a><br>6. <a href="#language-extensibility">Language Extensibility</a><br>7. <a href="#wsdllocation">Locating WSDL 2.0 Documents</a><br>8. <a href="#conformance">Conformance</a><br>9. <a href="#Syntax-Summary">XML Syntax Summary (Non-Normative)</a><br>10. <a href="#References">References</a><br>A. <a href="#ietf-draft">The application/wsdl+xml Media Type</a><br>B. <a href="#acknowledgments">Acknowledgements</a> (Non-Normative)<br>C. <a href="#wsdl-iri-references">IRI References for WSDL 2.0 Components</a> (Non-Normative)<br>D. <a href="#N165E3">Component Summary</a> (Non-Normative)<br>E. <a href="#assertionsummary">Assertion Summary</a> (Non-Normative)<br>F. <a href="#changelog">Part 1 Change og</a> (Non-Normative)<br></p></div><hr><div class="toc"> <h2><a name="contents">Table of Contents</a></h2><p class="toc">1. <a href="#intro">Introduction</a><br> 1.1 <a href="#intro_ws">Web Service</a><br> 1.2 <a href="#markup">Document Conformance</a><br> 1.3 <a href="#meaning">The Meaning of a Service Description</a><br> 1.4 <a href="#notation">Notational Conventions</a><br> 1.4.1 <a href="#rfc2119keywords">RFC 2119 Keywords</a><br> 1.4.2 <a href="#rfc3986namespaces">RFC 3986 Namespaces</a><br> 1.4.3 <a href="#nsprefixes">Prefixes and Namespaces Used in This Specification</a><br> 1.4.4 <a href="#terminology">Terms Used in This Specification</a><br> 1.4.5 <a href="#xmlinfosetproperties">XML Information Set Properties</a><br> &nbp; 1.4.6 <a href="#wsdlcomponentmodelproperties">WSDL 2.0 Component Model Properties</a><br> 1.4.7 <a href="#znotation">Z Notation</a><br> 1.4.8 <a href="#bnfpseudoschemas">BNF Pseudo-Schemas</a><br> 1.4.9 <a href="#assertions">Assertions</a><br>2. <a href="#component_model">Component Model</a><br> 2.1 <a href="#Description">Description</a><br> 2.1.1 <a href="#Description_details">The Description Component</a><br> 2.1.2 <a href="#Description_XMLRep">XML Representation of Description Component</a><br> 2.1.2.1 <a href="#Description_targetnamespace_attribute">targetNamespace attribute information item</a><br> 2.13 <a href="#Description_Mapping">Mapping Description's XML Representation to Component Properties</a><br> 2.2 <a href="#Interface">Interface</a><br> 2.2.1 <a href="#Interface_details">The Interface Component</a><br> 2.2.2 <a href="#Interface_XMLRep">XML Representation of Interface Component</a><br> 2.2.2.1 <a href="#Interface_name_attribute">name attribute information item with interface [owner element]</a><br> 2.2.2.2 <a href="#Interface_extends_attribute">extends attribute information item</a><br> 2.2.2.3 <a href="#Interface_styleDefault_attribute">styleDefault attribute information item</a><br> 2.2.3 <a href="#Interface_Mapping">Mapping Interface's XML Representation to Component Properties</a><br> &nsp; 2.3 <a href="#InterfaceFault">Interface Fault</a><br> 2.3.1 <a href="#InterfaceFault_details">The Interface Fault Component</a><br> 2.3.2 <a href="#InterfaceFault_XMLRep">XML Representation of Interface Fault Component</a><br> 2.3.2.1 <a href="#Interfacefault_name_attribute">name attribute information item with fault [owner element]</a><br> 2.3.2.2 <a href="#Interface_element_attribute">element attribute information item with fault [owner element]</a><br> 2.3.3 <a href="#InterfaceFault_Mapping">Mapping Interface Fault's XML Representation to --- 77,81 ---- <hr><div class="toc"> ! <h2><a name="shortcontents">Short Table of Contents</a></h2><p class="toc">1. <a href="#intro">Introduction</a><br>2. <a href="#component_model">Component Model</a><br>3. <a href="#eii-types">Types</a><br>4. <a href="#modularize">Modularizing WSDL 2.0 descriptions</a><br>5. <a href="#eii-documentation">Documentation</a><br>6. <a href="#language-extensibility">Language Extensibility</a><br>7. <a href="#wsdllocation">Locating WSDL 2.0 Documents</a><br>8. <a href="#conformance">Conformance</a><br>9. <a href="#Syntax-Summary">XML Syntax Summary (Non-Normative)</a><br>10. <a href="#References">References</a><br>A. <a href="#ietf-draft">The application/wsdl+xml Media Type</a><br>B. <a href="#acknowledgments">Acknowledgements</a> (Non-Normative)<br>C. <a href="#wsdl-iri-references">IRI References for WSDL 2.0 Components</a> (Non-Normative)<br>D. <a href="#N1660B">Component Summary</a> (Non-Normative)<br>E. <a href="#assertionsummary">Assertion Summary</a> (Non-Normative)<br>F. <a href="#changelog">Part 1 Change og</a> (Non-Normative)<br></p></div><hr><div class="toc"> <h2><a name="contents">Table of Contents</a></h2><p class="toc">1. <a href="#intro">Introduction</a><br> 1.1 <a href="#intro_ws">Web Service</a><br> 1.2 <a href="#markup">Document Conformance</a><br> 1.3 <a href="#meaning">The Meaning of a Service Description</a><br> 1.4 <a href="#notation">Notational Conventions</a><br> 1.4.1 <a href="#rfc2119keywords">RFC 2119 Keywords</a><br> 1.4.2 <a href="#rfc3986namespaces">RFC 3986 Namespaces</a><br> 1.4.3 <a href="#nsprefixes">Prefixes and Namespaces Used in This Specification</a><br> 1.4.4 <a href="#terminology">Terms Used in This Specification</a><br> 1.4.5 <a href="#xmlinfosetproperties">XML Information Set Properties</a><br> &nbp; 1.4.6 <a href="#wsdlcomponentmodelproperties">WSDL 2.0 Component Model Properties</a><br> 1.4.7 <a href="#znotation">Z Notation</a><br> 1.4.8 <a href="#bnfpseudoschemas">BNF Pseudo-Schemas</a><br> 1.4.9 <a href="#assertions">Assertions</a><br>2. <a href="#component_model">Component Model</a><br> 2.1 <a href="#Description">Description</a><br> 2.1.1 <a href="#Description_details">The Description Component</a><br> 2.1.2 <a href="#Description_XMLRep">XML Representation of Description Component</a><br> 2.1.2.1 <a href="#Description_targetnamespace_attribute">targetNamespace attribute information item</a><br> 2.13 <a href="#Description_Mapping">Mapping Description's XML Representation to Component Properties</a><br> 2.2 <a href="#Interface">Interface</a><br> 2.2.1 <a href="#Interface_details">The Interface Component</a><br> 2.2.2 <a href="#Interface_XMLRep">XML Representation of Interface Component</a><br> 2.2.2.1 <a href="#Interface_name_attribute">name attribute information item with interface [owner element]</a><br> 2.2.2.2 <a href="#Interface_extends_attribute">extends attribute information item</a><br> 2.2.2.3 <a href="#Interface_styleDefault_attribute">styleDefault attribute information item</a><br> 2.2.3 <a href="#Interface_Mapping">Mapping Interface's XML Representation to Component Properties</a><br> &nsp; 2.3 <a href="#InterfaceFault">Interface Fault</a><br> 2.3.1 <a href="#InterfaceFault_details">The Interface Fault Component</a><br> 2.3.2 <a href="#InterfaceFault_XMLRep">XML Representation of Interface Fault Component</a><br> 2.3.2.1 <a href="#Interfacefault_name_attribute">name attribute information item with fault [owner element]</a><br> 2.3.2.2 <a href="#Interface_element_attribute">element attribute information item with fault [owner element]</a><br> 2.3.3 <a href="#InterfaceFault_Mapping">Mapping Interface Fault's XML Representation to *************** *** 102,106 **** attribute information item </a><br> 3.3.3 <a href="#wsdlx-consistency">wsdlx:interface and wsdlx:binding Consistency</a><br> 3.3.4 <a href="#wsdlx-xsanyuri">Use of wsdlx:interface and wsdlx:binding with xs:anyURI</a><br>4. <a href="#modularize">Modularizing WSDL 2.0 descriptions</a><br> 4.1 <a href="#includes">Including Descriptions</a><br> 4.1.1 <a href="#include_location_attribute">location attribute information item with include [owner element]</a><br> 4.2 <a href="#imports">Importing Descriptions</a><br> 4.2.1 <a href="#import_namespace_attribute">namespace attribute information item</a><br> 4.2.2 <a href="#import_location_attribute">location attribute information item with import [owner element]</a><br>5. <a href="#eii-documentation">Documentatin</a><br>6. <a href="#language-extensibility">Language Extensibility</a><br> 6.1 <a href="#eii-extensibility">Element based Extensibility</a><br> 6.1.1 <a href="#mandatoryext">Mandatory extensions</a><br> 6.1.2 <a href="#required-aii">required attribute information item</a><br> 6.2 <a href="#aii-extensibility">Attribute-based Extensibility</a><br> 6.3 <a href="#extensibility-semantics">Extensibility Semantics</a><br>7. <a href="#wsdllocation">Locating WSDL 2.0 Documents</a><br> 7.1 <a href="#wsdlLocation-aii">wsdli:wsdlLocation attribute information item</a><br>8. <a href="#conformance">Conformance</a><br> 8.1 <a href="#infoset">XML Information Set Conformance</a><br>9. <a href="#Syntax-Summary">XML Syntax Summary (Non-Normative)</a><br>10. <a href="#References">References</a><br> &nbs;10.1 <a href="#Normative-References">Normative References</a><br> 10.2 <a href="#Informative-References">Informative References</a><br></p> ! <h3><a id="appendix" name="appendix">Appendices</a></h3><p class="toc">A. <a href="#ietf-draft">The application/wsdl+xml Media Type</a><br> A.1 <a href="#ietf-reg">Registration</a><br> A.2 <a href="#frag-ids">Fragment Identifiers</a><br> A.2.1 <a href="#wsdl.description">The Description Component</a><br> A.2.2 <a href="#wsdl.elementDeclaration">The Element Declaration Component</a><br> A.2.3 <a href="#wsdl.typeDefinition">The Type Definition Component</a><br> A.2.4 <a href="#wsdl.interface">The Interface Component</a><br> A.2.5 <a href="#wsdl.interfaceFault">The Interface Fault Component</a><br> A.2.6 <a href="#wsdl.interfaceOperation">The Interface Operation Component</a><br> &bsp; A.2.7 <a href="#wsdl.interfaceMessageReference">The Interface Message Reference Component</a><br> A.2.8 <a href="#wsdl.interfaceFaultReference">The Interface Fault Reference Component</a><br> A.2.9 <a href="#wsdl.binding">The Binding Component</a><br> A.2.10 <a href="#wsdl.bindingFault">The Binding Fault Component</a><br> A.2.11 <a href="#wsdl.bindingOperation">The Binding Operation Component</a><br> A.2.12 <a href="#wsdl.bindingMessageReference">The Binding Message Reference Component</a><br> A.2.13 <a href="#wsdl.bindingFaultReference">The Binding Fault Reference Component</a><br> A.2.14 <a href="#wsdl.service">The Service Component</a><br>&nbp; A.2.15 <a href="#wsdl.endpoint">The Endpoint Component</a><br> A.2.16 <a href="#wsdl.feature">The Feature Component</a><br> A.2.17 <a href="#wsdl.property">The Property Component</a><br> A.2.18 <a href="#wsdl.extension">Extension Components</a><br> A.3 <a href="#ietf-sec">Security considerations</a><br>B. <a href="#acknowledgments">Acknowledgements</a> (Non-Normative)<br>C. <a href="#wsdl-iri-references">IRI References for WSDL 2.0 Components</a> (Non-Normative)<br> C.1 <a href="#wsdl-iris">WSDL 2.0 IRIs</a><br> C.2 <a href="#Iri-ref-ex">Example</a><br>D. <a href="#N165E3">Component Summary</a> (Non-Normative)<br>E. <a href="#assertionsummary">Assertion Summary</a> (Non-Normative)<br>F. <a href="#changelog">Part 1 Change Log</a> (Non-Normative)<br> &nbs; F.1 <a href="#wsdl-changelog">WSDL 2.0 Specification Changes</a><br></p></div><hr><div class="body"> <div class="div1"> --- 102,106 ---- attribute information item </a><br> 3.3.3 <a href="#wsdlx-consistency">wsdlx:interface and wsdlx:binding Consistency</a><br> 3.3.4 <a href="#wsdlx-xsanyuri">Use of wsdlx:interface and wsdlx:binding with xs:anyURI</a><br>4. <a href="#modularize">Modularizing WSDL 2.0 descriptions</a><br> 4.1 <a href="#includes">Including Descriptions</a><br> 4.1.1 <a href="#include_location_attribute">location attribute information item with include [owner element]</a><br> 4.2 <a href="#imports">Importing Descriptions</a><br> 4.2.1 <a href="#import_namespace_attribute">namespace attribute information item</a><br> 4.2.2 <a href="#import_location_attribute">location attribute information item with import [owner element]</a><br>5. <a href="#eii-documentation">Documentatin</a><br>6. <a href="#language-extensibility">Language Extensibility</a><br> 6.1 <a href="#eii-extensibility">Element based Extensibility</a><br> 6.1.1 <a href="#mandatoryext">Mandatory extensions</a><br> 6.1.2 <a href="#required-aii">required attribute information item</a><br> 6.2 <a href="#aii-extensibility">Attribute-based Extensibility</a><br> 6.3 <a href="#extensibility-semantics">Extensibility Semantics</a><br>7. <a href="#wsdllocation">Locating WSDL 2.0 Documents</a><br> 7.1 <a href="#wsdlLocation-aii">wsdli:wsdlLocation attribute information item</a><br>8. <a href="#conformance">Conformance</a><br> 8.1 <a href="#infoset">XML Information Set Conformance</a><br>9. <a href="#Syntax-Summary">XML Syntax Summary (Non-Normative)</a><br>10. <a href="#References">References</a><br> &nbs;10.1 <a href="#Normative-References">Normative References</a><br> 10.2 <a href="#Informative-References">Informative References</a><br></p> ! <h3><a id="appendix" name="appendix">Appendices</a></h3><p class="toc">A. <a href="#ietf-draft">The application/wsdl+xml Media Type</a><br> A.1 <a href="#ietf-reg">Registration</a><br> A.2 <a href="#frag-ids">Fragment Identifiers</a><br> A.2.1 <a href="#wsdl.description">The Description Component</a><br> A.2.2 <a href="#wsdl.elementDeclaration">The Element Declaration Component</a><br> A.2.3 <a href="#wsdl.typeDefinition">The Type Definition Component</a><br> A.2.4 <a href="#wsdl.interface">The Interface Component</a><br> A.2.5 <a href="#wsdl.interfaceFault">The Interface Fault Component</a><br> A.2.6 <a href="#wsdl.interfaceOperation">The Interface Operation Component</a><br> &bsp; A.2.7 <a href="#wsdl.interfaceMessageReference">The Interface Message Reference Component</a><br> A.2.8 <a href="#wsdl.interfaceFaultReference">The Interface Fault Reference Component</a><br> A.2.9 <a href="#wsdl.binding">The Binding Component</a><br> A.2.10 <a href="#wsdl.bindingFault">The Binding Fault Component</a><br> A.2.11 <a href="#wsdl.bindingOperation">The Binding Operation Component</a><br> A.2.12 <a href="#wsdl.bindingMessageReference">The Binding Message Reference Component</a><br> A.2.13 <a href="#wsdl.bindingFaultReference">The Binding Fault Reference Component</a><br> A.2.14 <a href="#wsdl.service">The Service Component</a><br>&nbp; A.2.15 <a href="#wsdl.endpoint">The Endpoint Component</a><br> A.2.16 <a href="#wsdl.feature">The Feature Component</a><br> A.2.17 <a href="#wsdl.property">The Property Component</a><br> A.2.18 <a href="#wsdl.extension">Extension Components</a><br> A.3 <a href="#ietf-sec">Security considerations</a><br>B. <a href="#acknowledgments">Acknowledgements</a> (Non-Normative)<br>C. <a href="#wsdl-iri-references">IRI References for WSDL 2.0 Components</a> (Non-Normative)<br> C.1 <a href="#wsdl-iris">WSDL 2.0 IRIs</a><br> C.2 <a href="#Iri-ref-ex">Example</a><br>D. <a href="#N1660B">Component Summary</a> (Non-Normative)<br>E. <a href="#assertionsummary">Assertion Summary</a> (Non-Normative)<br>F. <a href="#changelog">Part 1 Change Log</a> (Non-Normative)<br> &nbs; F.1 <a href="#wsdl-changelog">WSDL 2.0 Specification Changes</a><br></p></div><hr><div class="body"> <div class="div1"> *************** *** 2496,2515 **** The <code>messageLabel</code> ! <em>attribute information item</em> of an interface message reference <em>element information item</em> ! MUST be present if the message exchange pattern has ! more than one placeholder message with {direction} equal to the message direction. <a href="#MessageLabel-0004">†</a> </p> ! <p> ! If the <code>messageLabel</code> <em>attribute information item</em> of an interface message reference <em>element information item</em> is present then its actual value ! MUST match the {message label} of some placeholder message with {direction} equal to the message direction. </p> ! <p> ! If the <code>messageLabel</code> <em>attribute information item</em> of an interface message reference <em>element information item</em> is absent then there MUST be a unique ! placeholder message with {direction} equal to the message direction. </p> ! <p> Define the <em>effective message label</em> of an interface message reference <em>element information item</em> --- 2496,2533 ---- The <code>messageLabel</code> ! <em>attribute information item</em> ! of an interface message reference ! <em>element information item</em> ! MUST be present if the message exchange pattern has more ! than one placeholder message with {direction} equal to the ! message direction. <a href="#MessageLabel-0004">†</a> </p> ! <p> ! <a name="MessageLabel-0008-src"></a> ! If the ! <code>messageLabel</code> ! <em>attribute information item</em> ! of an interface message reference ! <em>element information item</em> ! is present then its actual value MUST match the {message ! label} of some placeholder message with {direction} equal ! to the message direction. ! <a href="#MessageLabel-0008">†</a> </p> ! <p> ! <a name="MessageLabel-0012-src"></a> ! If the ! <code>messageLabel</code> ! <em>attribute information item</em> ! of an interface message reference ! <em>element information item</em> ! is absent then there MUST be a unique placeholder message ! with {direction} equal to the message direction. ! <a href="#MessageLabel-0012">†</a> </p> ! <p> Define the <em>effective message label</em> of an interface message reference <em>element information item</em> *************** *** 2876,2895 **** The <code>messageLabel</code> ! <em>attribute information item</em> of an interface fault reference <em>element information item</em> ! MUST be present if the message exchange pattern has ! more than one placeholder message with {direction} equal to the message direction. <a href="#MessageLabel-0005">†</a> </p> ! <p> ! If the <code>messageLabel</code> <em>attribute information item</em> of an interface fault reference <em>element information item</em> is present then its actual value ! MUST match the {message label} of some placeholder message with {direction} equal to the message direction. </p> ! <p> ! If the <code>messageLabel</code> <em>attribute information item</em> of an interface fault reference <em>element information item</em> is absent then there MUST be a unique ! placeholder message with {direction} equal to the message direction. </p> ! <p> Define the <em>effective message label</em> of an interface fault reference <em>element information item</em> --- 2894,2931 ---- The <code>messageLabel</code> ! <em>attribute information item</em> ! of an interface fault reference ! <em>element information item</em> ! MUST be present if the message exchange pattern has more ! than one placeholder message with {direction} equal to the ! message direction. <a href="#MessageLabel-0005">†</a> </p> ! <p> ! <a name="MessageLabel-0009-src"></a> ! If the ! <code>messageLabel</code> ! <em>attribute information item</em> ! of an interface fault reference ! <em>element information item</em> ! is present then its actual value MUST match the {message ! label} of some placeholder message with {direction} equal ! to the message direction. ! <a href="#MessageLabel-0009">†</a> </p> ! <p> ! <a name="MessageLabel-0013-src"></a> ! If the ! <code>messageLabel</code> ! <em>attribute information item</em> ! of an interface fault reference ! <em>element information item</em> ! is absent then there MUST be a unique placeholder message ! with {direction} equal to the message direction. ! <a href="#MessageLabel-0013">†</a> </p> ! <p> Define the <em>effective message label</em> of an interface fault reference <em>element information item</em> *************** *** 5134,5153 **** The <code>messageLabel</code> ! <em>attribute information item</em> of a binding message reference <em>element information item</em> ! MUST be present if the message exchange pattern has ! more than one placeholder message with {direction} equal to the message direction. <a href="#MessageLabel-0006">†</a> </p> ! <p> ! If the <code>messageLabel</code> <em>attribute information item</em> of a binding message reference <em>element information item</em> is present then its actual value ! MUST match the {message label} of some placeholder message with {direction} equal to the message direction. </p> ! <p> ! If the <code>messageLabel</code> <em>attribute information item</em> of a binding message reference <em>element information item</em> is absent then there MUST be a unique ! placeholder message with {direction} equal to the message direction. </p> ! <p> Define the <em>effective message label</em> of a binding message reference <em>element information item</em> --- 5170,5207 ---- The <code>messageLabel</code> ! <em>attribute information item</em> ! of a binding message reference ! <em>element information item</em> ! MUST be present if the message exchange pattern has more ! than one placeholder message with {direction} equal to the ! message direction. <a href="#MessageLabel-0006">†</a> </p> ! <p> ! <a name="MessageLabel-0010-src"></a> ! If the ! <code>messageLabel</code> ! <em>attribute information item</em> ! of a binding message reference ! <em>element information item</em> ! is present then its actual value MUST match the {message ! label} of some placeholder message with {direction} equal ! to the message direction. ! <a href="#MessageLabel-0010">†</a> </p> ! <p> ! <a name="MessageLabel-0014-src"></a> ! If the ! <code>messageLabel</code> ! <em>attribute information item</em> ! of a binding message reference ! <em>element information item</em> ! is absent then there MUST be a unique placeholder message ! with {direction} equal to the message direction. ! <a href="#MessageLabel-0014">†</a> </p> ! <p> Define the <em>effective message label</em> of a binding message reference <em>element information item</em> *************** *** 5465,5484 **** The <code>messageLabel</code> ! <em>attribute information item</em> of a binding fault reference <em>element information item</em> ! MUST be present if the message exchange pattern has ! more than one placeholder message with {direction} equal to the message direction. <a href="#MessageLabel-0007">†</a> </p> ! <p> ! If the <code>messageLabel</code> <em>attribute information item</em> of a binding fault reference <em>element information item</em> is present then its actual value ! MUST match the {message label} of some placeholder message with {direction} equal to the message direction. </p> ! <p> ! If the <code>messageLabel</code> <em>attribute information item</em> of a binding fault reference <em>element information item</em> is absent then there MUST be a unique ! placeholder message with {direction} equal to the message direction. </p> ! <p> Define the <em>effective message label</em> of a binding fault reference <em>element information item</em> --- 5519,5556 ---- The <code>messageLabel</code> ! <em>attribute information item</em> ! of a binding fault reference ! <em>element information item</em> ! MUST be present if the message exchange pattern has more ! than one placeholder message with {direction} equal to the ! message direction. <a href="#MessageLabel-0007">†</a> </p> ! <p> ! <a name="MessageLabel-0011-src"></a> ! If the ! <code>messageLabel</code> ! <em>attribute information item</em> ! of a binding fault reference ! <em>element information item</em> ! is present then its actual value MUST match the {message ! label} of some placeholder message with {direction} equal ! to the message direction. ! <a href="#MessageLabel-0011">†</a> </p> ! <p> ! <a name="MessageLabel-0015-src"></a> ! If the ! <code>messageLabel</code> ! <em>attribute information item</em> ! of a binding fault reference ! <em>element information item</em> ! is absent then there MUST be a unique placeholder message ! with {direction} equal to the message direction. ! <a href="#MessageLabel-0015">†</a> </p> ! <p> Define the <em>effective message label</em> of a binding fault reference <em>element information item</em> *************** *** 5562,5566 **** </div> - <div class="div2"> --- 5634,5637 ---- *************** *** 8437,8441 **** property of the <a href="wsdl20.html#component-InterfaceFault">Interface Fault</a> - component. </p> --- 8508,8511 ---- *************** *** 9166,9170 **** <div class="div1"> ! <h2><a name="N165E3"></a>D. Component Summary (Non-Normative)</h2> <p> <a href="#component-summary">Table D-1</a> --- 9236,9240 ---- <div class="div1"> ! <h2><a name="N1660B"></a>D. Component Summary (Non-Normative)</h2> <p> <a href="#component-summary">Table D-1</a> *************** *** 9543,9546 **** --- 9613,9792 ---- WSDL 2.0 document that is importing them.</td> </tr> + <tr> + <td rowspan="1" colspan="1"> + <a href="#MessageLabel-0004-src" name="MessageLabel-0004">MessageLabel-0004</a> + </td> + <td rowspan="1" colspan="1"> + The + <code>messageLabel</code> + <em>attribute information item</em> + of an interface message reference + <em>element information item</em> + MUST be present if the message exchange pattern has more + than one placeholder message with {direction} equal to the + message direction. + </td> + </tr> + <tr> + <td rowspan="1" colspan="1"> + <a href="#MessageLabel-0005-src" name="MessageLabel-0005">MessageLabel-0005</a> + </td> + <td rowspan="1" colspan="1"> + The + <code>messageLabel</code> + <em>attribute information item</em> + of an interface fault reference + <em>element information item</em> + MUST be present if the message exchange pattern has more + than one placeholder message with {direction} equal to the + message direction. + </td> + </tr> + <tr> + <td rowspan="1" colspan="1"> + <a href="#MessageLabel-0006-src" name="MessageLabel-0006">MessageLabel-0006</a> + </td> + <td rowspan="1" colspan="1"> + The + <code>messageLabel</code> + <em>attribute information item</em> + of a binding message reference + <em>element information item</em> + MUST be present if the message exchange pattern has more + than one placeholder message with {direction} equal to the + message direction. + </td> + </tr> + <tr> + <td rowspan="1" colspan="1"> + <a href="#MessageLabel-0007-src" name="MessageLabel-0007">MessageLabel-0007</a> + </td> + <td rowspan="1" colspan="1"> + The + <code>messageLabel</code> + <em>attribute information item</em> + of a binding fault reference + <em>element information item</em> + MUST be present if the message exchange pattern has more + than one placeholder message with {direction} equal to the + message direction. + </td> + </tr> + <tr> + <td rowspan="1" colspan="1"> + <a href="#MessageLabel-0008-src" name="MessageLabel-0008">MessageLabel-0008</a> + </td> + <td rowspan="1" colspan="1"> + If the + <code>messageLabel</code> + <em>attribute information item</em> + of an interface message reference + <em>element information item</em> + is present then its actual value MUST match the {message + label} of some placeholder message with {direction} equal + to the message direction. + </td> + </tr> + <tr> + <td rowspan="1" colspan="1"> + <a href="#MessageLabel-0009-src" name="MessageLabel-0009">MessageLabel-0009</a> + </td> + <td rowspan="1" colspan="1"> + If the + <code>messageLabel</code> + <em>attribute information item</em> + of an interface fault reference + <em>element information item</em> + is present then its actual value MUST match the {message + label} of some placeholder message with {direction} equal + to the message direction. + </td> + </tr> + <tr> + <td rowspan="1" colspan="1"> + <a href="#MessageLabel-0010-src" name="MessageLabel-0010">MessageLabel-0010</a> + </td> + <td rowspan="1" colspan="1"> + If the + <code>messageLabel</code> + <em>attribute information item</em> + of a binding message reference + <em>element information item</em> + is present then its actual value MUST match the {message + label} of some placeholder message with {direction} equal + to the message direction. + </td> + </tr> + <tr> + <td rowspan="1" colspan="1"> + <a href="#MessageLabel-0011-src" name="MessageLabel-0011">MessageLabel-0011</a> + </td> + <td rowspan="1" colspan="1"> + If the + <code>messageLabel</code> + <em>attribute information item</em> + of a binding fault reference + <em>element information item</em> + is present then its actual value MUST match the {message + label} of some placeholder message with {direction} equal + to the message direction. + </td> + </tr> + <tr> + <td rowspan="1" colspan="1"> + <a href="#MessageLabel-0012-src" name="MessageLabel-0012">MessageLabel-0012</a> + </td> + <td rowspan="1" colspan="1"> + If the + <code>messageLabel</code> + <em>attribute information item</em> + of an interface message reference + <em>element information item</em> + is absent then there MUST be a unique placeholder message + with {direction} equal to the message direction. + </td> + </tr> + <tr> + <td rowspan="1" colspan="1"> + <a href="#MessageLabel-0013-src" name="MessageLabel-0013">MessageLabel-0013</a> + </td> + <td rowspan="1" colspan="1"> + If the + <code>messageLabel</code> + <em>attribute information item</em> + of an interface fault reference + <em>element information item</em> + is absent then there MUST be a unique placeholder message + with {direction} equal to the message direction. + </td> + </tr> + <tr> + <td rowspan="1" colspan="1"> + <a href="#MessageLabel-0014-src" name="MessageLabel-0014">MessageLabel-0014</a> + </td> + <td rowspan="1" colspan="1"> + If the + <code>messageLabel</code> + <em>attribute information item</em> + of a binding message reference + <em>element information item</em> + is absent then there MUST be a unique placeholder message + with {direction} equal to the message direction. + </td> + </tr> + <tr> + <td rowspan="1" colspan="1"> + <a href="#MessageLabel-0015-src" name="MessageLabel-0015">MessageLabel-0015</a> + </td> + <td rowspan="1" colspan="1"> + If the + <code>messageLabel</code> + <em>attribute information item</em> + of a binding fault reference + <em>element information item</em> + is absent then there MUST be a unique placeholder message + with {direction} equal to the message direction. + </td> + </tr> </tbody> Index: wsdl20-primer.html =================================================================== RCS file: /sources/public/2002/ws/desc/wsdl20/wsdl20-primer.html,v retrieving revision 1.109 retrieving revision 1.110 diff -C2 -d -r1.109 -r1.110 *** wsdl20-primer.html 3 Nov 2005 23:22:31 -0000 1.109 --- wsdl20-primer.html 9 Nov 2005 01:20:00 -0000 1.110 *************** *** 1,3 **** ! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> <html lang="en"><head><META http-equiv="Content-Type" content="text/html; charset=utf-8"><title>Web Services Description Language (WSDL) Version 2.0 Part 0: Primer</title><style type="text/css"> code { font-family: monospace; } --- 1,3 ---- ! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html lang="en"><head><META http-equiv="Content-Type" content="text/html; charset=utf-8"><title>Web Services Description Language (WSDL) Version 2.0 Part 0: Primer</title><style type="text/css"> code { font-family: monospace; } *************** *** 45,49 **** div.exampleHeader { font-weight: bold; margin: 4px} ! </style><link rel="stylesheet" type="text/css" href="http://www.w3.org/StyleSheets/TR/base.css"><link rel="alternate" title="" href="" type=""><link rel="contents" href="#contents"></head><body> <div class="head"> <h1>Web Services Description Language (WSDL) Version 2.0 Part 0: Primer</h1> --- 45,49 ---- div.exampleHeader { font-weight: bold; margin: 4px} ! </style><link type="text/css" rel="stylesheet" href="http://www.w3.org/StyleSheets/TR/base.css"><link type="" href="" title="" rel="alternate"><link href="#contents" rel="contents"></head><body> <div class="head"> <h1>Web Services Description Language (WSDL) Version 2.0 Part 0: Primer</h1> *************** *** 87,93 **** <hr><div class="toc"> <h2><a name="shortcontents">Short Table of Contents</a></h2><p class="toc">1. <a href="#Introduction">Introduction</a><br>2. <a href="#basics">WSDL 2.0 Basics</a><br>3. <a href="#advanced-topic_ii">Advanced Topics I: Importing Mechanisms</a><br>4. <a href="#advanced-topic_iii">Advanced Topics II: Extensibility and Predefined Extensions</a><br>5. <a href="#advanced-topic_iv">Advanced Topics III: Miscellaneous</a><br>6. <a href="#References">References</a><br>A. <a href="#acknowledgments">Acknowledgements</a> (Non-Normative)<br></p></div><hr><div class="toc"> ! <h2><a name="contents">Table of Contents</a></h2><p class="toc">1. <a href="#Introduction">Introduction</a><br> 1.1 <a href="#Prerequisites">Prerequisites</a><br> 1.2 <a href="#PrimerStructure">Structure of this Primer</a><br> 1.3 <a href="#UseIRI">Use of URI and IRI</a><br> 1.4 <a href="#notation">Notational Conventions</a><br>2. <a href="#basics">WSDL 2.0 Basics</a><br> 2.1 <a href="#basic-example">Getting Started: The GreatH Hotel Example</a><br> 2.1.1 <a href="#basics-greath-scenario">Example Scenario: The GreatH Hotel Reservation Service</a><br> 2.1.2 <a href="#basics-getting-started">Defining a WSDL 2.0 Target Namespace</a><br> 2.1.2.1 <a href="#example-empty-shell-explanation">Explanation of Example</a><br>   2.1.3 <a href="#basics-types">Defining Message Types</a><br> 2.1.3.1 <a href="#example-initial-types-explanation">Explanation of Example</a><br> 2.1.4 <a href="#basics-interface">Defining an Interface</a><br> 2.1.4.1 <a href="#example-initial-interface-explanation">Explanation of Example</a><br> 2.1.5 <a href="#basics-binding">Defining a Binding</a><br> 2.1.5.1 <a href="#example-initial-binding-explanation">Explanation of Example</a><br> 2.1.6 <a href="#basics-service">Defining a Service</a><br> 2.1.6.1 <a href="#example-initial-service-explanation">Explanationof Example</a><br> 2.1.7 <a href="#basics-documentation">Documenting the Service</a><br> 2.1.7.1 <a href="#example-initial-documentation-explanation">Explanation of Example</a><br> 2.2 <a href="#wsdl-xml-representation">WSDL 2.0 Infoset, Schema and Component Model</a><br> 2.2.1 <a href="#wsdl-infoset-diagram">WSDL 2.0 Infoset</a><br> 2.2.2 <a href="#wsdl-schema">WSDL 2.0 Schema</a><br> 2.2.2.1 <a href="#element-order">WSDL 2.0 Element Ordering</a><br> 2.2.3 <a href="#component-model">WSDL 2.0 Component Model</a><br> 2.2.3.1 <a href="#import-component">WSDL 2.0 Import and Include</a><br>  2.3 <a href="#more-types">More on Message Types</a><br> 2.3.1 <a href="#more-types-schema-inline">Inlining XML Schema</a><br> 2.3.2 <a href="#more-types-schema-import">Importing XML Schema</a><br> 2.3.3 <a href="#more-types-import-include-summary">Summary of Import and Include Mechanisms</a><br> 2.4 <a href="#more-interfaces">More on Interfaces</a><br> 2.4.1 <a href="#more-interfaces-interfaces">Interface Syntax </a><br> 2.4.2 <a href="#more-interfaces-inheritance">Interface Inheritance</a><br> 2.4.3 <a href="#more-interfaces-faults">Interface Faults</a><br> 2.4.4 <a href="#more-interfaces-operations">Interface Operations</a><br> &nbp; 2.4.4.1 <a href="#more-interfaces-op-attr">Operation Attributes</a><br> 2.4.4.2 <a href="#N68048">Operation Message References</a><br> 2.4.4.2.1 <a href="#N68077">The messageLabel Attribute</a><br> 2.4.4.2.2 <a href="#N68101">The element Attribute</a><br> 2.4.4.2.3 <a href="#N68182">Multiple infault or outfault Elements</a><br> 2.4.4.3 <a href="#more-interfaces-meps">Understanding Message Exchange Patterns (MEPs)</a><br> 2.5 <a href="#more-bindings">More on Bindings</a><br> &nsp; 2.5.1 <a href="#more-bindings-wsdl">Syntax Summary for Bindings</a><br> 2.5.2 <a href="#more-bindings-reusable">Reusable Bindings</a><br> 2.5.3 <a href="#more-bindings-faults">Binding Faults</a><br> 2.5.4 <a href="#bindingOperations">Binding Operations</a><br> 2.5.5 <a href="#more-bindings-soap">The SOAP Binding Extension</a><br> 2.5.5.1 <a href="#more-bindings-soap-example-explanation">Explanation of Example</a><br> 2.5.6 <a href="#more-bindings-http">The HTTP Binding Extension</a><br> 2.5.6.1 <a href="#N68644">Explanation of ! Example</a><br> 2.5.7 <a href="#adv-get-vs-post">HTTP GET Versus POST: Which to Use?</a><br>3. <a href="#advanced-topic_ii">Advanced Topics I: Importing Mechanisms</a><br> 3.1 <a href="#adv-import-and-authoring">Importing WSDL</a><br> 3.2 <a href="#adv-multiple-inline-schemas">Importing Schemas</a><br> 3.2.1 <a href="#N68980">Schemas in Imported Documents</a><br> 3.2.2 <a href="#N69119">Multiple Inline Schemas in One Document</a><br> 3.2.3 <a href="#adv-schema-location">The schemaLocation Attribute</a><br> 3.2.3.1 <a href="#N69215">Using the id Attribute to Identify Inline ! Schemas</a><br>4. <a href="#advanced-topic_iii">Advanced Topics II: Extensibility and Predefined Extensions</a><br> 4.1 <a href="#adv-extensibility">Extensibility</a><br> 4.1.1 <a href="#adv-optional-versus-required">Optional Versus Required Extensions</a><br> 4.2 <a href="#adv-FP">Features and Properties</a><br> 4.2.1 <a href="#adv-FP-soap-modules">SOAP Modules</a><br> 4.2.2 <a href="#adv-FP-abstract-features">Abstract Features</a><br> 4.2.3 <a href="#adv-fp-properties">Properties</a><br> 4.3 <a href="#adv-MEP">Defining New MEPs</a><br> 4.3.1 <a href="#challenge-confirm">Confirmed Challenge</a><br> 4.4 <a href="#adv-RPCstyle">RPC Style</a><br> 4.5 <a href"#adv-MTOM">MTOM and Attachments Support</a><br>5. <a href="#advanced-topic_iv">Advanced Topics III: Miscellaneous</a><br> 5.1 <a href="#adv-message-dispatch">Enabling Easy Message Dispatch</a><br> 5.2 <a href="#adv-versioning">Web Service Versioning</a><br> 5.2.1 <a href="#adv-versioning-compatible-evolution">Compatible Evolution</a><br> 5.2.2 <a href="#adv-versioning-big-bang">Big Bang</a><br> 5.2.3 <a href="#ad-versioing-migration">Evolving a Service</a><br> 5.2.4 <a href="#adv-versioning-combined">Combined Approaches</a><br> 5.2.5 <a href="#adv-versioning-examples">Examples of Versioning and Extending a Service</a><br> 5.2.5.1 <a href="#N70207">Additional Opional Elements Added in Content</a><br> 5.2.5.2 <a href="#N70230">Additional Optional Elements Added to a Header</a><br> 5.2.5.3 <a href="#N70253">Additional Mandatory Elements in Content</a><br> 5.2.5.4 <a href="#N70276">Additional Optional Operation Added to Interface</a><br> 5.2.5.5 <a href="#N70288">Additional Mandatory Operation Added to Interface</a><br> 5.2.5.6 <a href="#N70314">Indicating Incompatibility by Changing the Endpoint URI</a><br> 5.2.5.7 <a href="#N70323">Indicating Incompatibility by Changing the SOAP Action</a><br> &bsp; 5.2.5.8 <a href="#N70346">Indicating Incompatibility by Changing the Element Content</a><br> 5.3 <a href="#adv-service-references"> Describing Web Service Messages That Refer to Other Web Services --- 87,93 ---- <hr><div class="toc"> <h2><a name="shortcontents">Short Table of Contents</a></h2><p class="toc">1. <a href="#Introduction">Introduction</a><br>2. <a href="#basics">WSDL 2.0 Basics</a><br>3. <a href="#advanced-topic_ii">Advanced Topics I: Importing Mechanisms</a><br>4. <a href="#advanced-topic_iii">Advanced Topics II: Extensibility and Predefined Extensions</a><br>5. <a href="#advanced-topic_iv">Advanced Topics III: Miscellaneous</a><br>6. <a href="#References">References</a><br>A. <a href="#acknowledgments">Acknowledgements</a> (Non-Normative)<br></p></div><hr><div class="toc"> ! <h2><a name="contents">Table of Contents</a></h2><p class="toc">1. <a href="#Introduction">Introduction</a><br> 1.1 <a href="#Prerequisites">Prerequisites</a><br> 1.2 <a href="#PrimerStructure">Structure of this Primer</a><br> 1.3 <a href="#UseIRI">Use of URI and IRI</a><br> 1.4 <a href="#notation">Notational Conventions</a><br>2. <a href="#basics">WSDL 2.0 Basics</a><br> 2.1 <a href="#basic-example">Getting Started: The GreatH Hotel Example</a><br> 2.1.1 <a href="#basics-greath-scenario">Example Scenario: The GreatH Hotel Reservation Service</a><br> 2.1.2 <a href="#basics-getting-started">Defining a WSDL 2.0 Target Namespace</a><br> 2.1.2.1 <a href="#example-empty-shell-explanation">Explanation of Example</a><br>   2.1.3 <a href="#basics-types">Defining Message Types</a><br> 2.1.3.1 <a href="#example-initial-types-explanation">Explanation of Example</a><br> 2.1.4 <a href="#basics-interface">Defining an Interface</a><br> 2.1.4.1 <a href="#example-initial-interface-explanation">Explanation of Example</a><br> 2.1.5 <a href="#basics-binding">Defining a Binding</a><br> 2.1.5.1 <a href="#example-initial-binding-explanation">Explanation of Example</a><br> 2.1.6 <a href="#basics-service">Defining a Service</a><br> 2.1.6.1 <a href="#example-initial-service-explanation">Explanationof Example</a><br> 2.1.7 <a href="#basics-documentation">Documenting the Service</a><br> 2.1.7.1 <a href="#example-initial-documentation-explanation">Explanation of Example</a><br> 2.2 <a href="#wsdl-xml-representation">WSDL 2.0 Infoset, Schema and Component Model</a><br> 2.2.1 <a href="#wsdl-infoset-diagram">WSDL 2.0 Infoset</a><br> 2.2.2 <a href="#wsdl-schema">WSDL 2.0 Schema</a><br> 2.2.2.1 <a href="#element-order">WSDL 2.0 Element Ordering</a><br> 2.2.3 <a href="#component-model">WSDL 2.0 Component Model</a><br> 2.2.3.1 <a href="#import-component">WSDL 2.0 Import and Include</a><br>  2.3 <a href="#more-types">More on Message Types</a><br> 2.3.1 <a href="#more-types-schema-inline">Inlining XML Schema</a><br> 2.3.2 <a href="#more-types-schema-import">Importing XML Schema</a><br> 2.3.3 <a href="#more-types-import-include-summary">Summary of Import and Include Mechanisms</a><br> 2.4 <a href="#more-interfaces">More on Interfaces</a><br> 2.4.1 <a href="#more-interfaces-interfaces">Interface Syntax </a><br> 2.4.2 <a href="#more-interfaces-inheritance">Interface Inheritance</a><br> 2.4.3 <a href="#more-interfaces-faults">Interface Faults</a><br> 2.4.4 <a href="#more-interfaces-operations">Interface Operations</a><br> &nbp; 2.4.4.1 <a href="#more-interfaces-op-attr">Operation Attributes</a><br> 2.4.4.2 <a href="#N109D0">Operation Message References</a><br> 2.4.4.2.1 <a href="#N109ED">The messageLabel Attribute</a><br> 2.4.4.2.2 <a href="#N10A05">The element Attribute</a><br> 2.4.4.2.3 <a href="#N10A56">Multiple infault or outfault Elements</a><br> 2.4.4.3 <a href="#more-interfaces-meps">Understanding Message Exchange Patterns (MEPs)</a><br> 2.5 <a href="#more-bindings">More on Bindings</a><br> &nsp; 2.5.1 <a href="#more-bindings-wsdl">Syntax Summary for Bindings</a><br> 2.5.2 <a href="#more-bindings-reusable">Reusable Bindings</a><br> 2.5.3 <a href="#more-bindings-faults">Binding Faults</a><br> 2.5.4 <a href="#bindingOperations">Binding Operations</a><br> 2.5.5 <a href="#more-bindings-soap">The SOAP Binding Extension</a><br> 2.5.5.1 <a href="#more-bindings-soap-example-explanation">Explanation of Example</a><br> 2.5.6 <a href="#more-bindings-http">The HTTP Binding Extension</a><br> 2.5.6.1 <a href="#N10C24">Explanation of ! Example</a><br> 2.5.7 <a href="#adv-get-vs-post">HTTP GET Versus POST: Which to Use?</a><br>3. <a href="#advanced-topic_ii">Advanced Topics I: Importing Mechanisms</a><br> 3.1 <a href="#adv-import-and-authoring">Importing WSDL</a><br> 3.2 <a href="#adv-multiple-inline-schemas">Importing Schemas</a><br> 3.2.1 <a href="#N10D74">Schemas in Imported Documents</a><br> 3.2.2 <a href="#N10DFF">Multiple Inline Schemas in One Document</a><br> 3.2.3 <a href="#adv-schema-location">The schemaLocation Attribute</a><br> 3.2.3.1 <a href="#N10E5F">Using the id Attribute to Identify Inline ! Schemas</a><br>4. <a href="#advanced-topic_iii">Advanced Topics II: Extensibility and Predefined Extensions</a><br> 4.1 <a href="#adv-extensibility">Extensibility</a><br> 4.1.1 <a href="#adv-optional-versus-required">Optional Versus Required Extensions</a><br> 4.2 <a href="#adv-FP">Features and Properties</a><br> 4.2.1 <a href="#adv-FP-soap-modules">SOAP Modules</a><br> 4.2.2 <a href="#adv-FP-abstract-features">Abstract Features</a><br> 4.2.3 <a href="#adv-fp-properties">Properties</a><br> 4.3 <a href="#adv-MEP">Defining New MEPs</a><br> 4.3.1 <a href="#challenge-confirm">Confirmed Challenge</a><br> 4.4 <a href="#adv-RPCstyle">RPC Style</a><br> 4.5 <a href"#adv-MTOM">MTOM and Attachments Support</a><br>5. <a href="#advanced-topic_iv">Advanced Topics III: Miscellaneous</a><br> 5.1 <a href="#adv-message-dispatch">Enabling Easy Message Dispatch</a><br> 5.2 <a href="#adv-versioning">Web Service Versioning</a><br> 5.2.1 <a href="#adv-versioning-compatible-evolution">Compatible Evolution</a><br> 5.2.2 <a href="#adv-versioning-big-bang">Big Bang</a><br> 5.2.3 <a href="#ad-versioing-migration">Evolving a Service</a><br> 5.2.4 <a href="#adv-versioning-combined">Combined Approaches</a><br> 5.2.5 <a href="#adv-versioning-examples">Examples of Versioning and Extending a Service</a><br> 5.2.5.1 <a href="#N1123F">Additional Opional Elements Added in Content</a><br> 5.2.5.2 <a href="#N11256">Additional Optional Elements Added to a Header</a><br> 5.2.5.3 <a href="#N1126D">Additional Mandatory Elements in Content</a><br> 5.2.5.4 <a href="#N11284">Additional Optional Operation Added to Interface</a><br> 5.2.5.5 <a href="#N11290">Additional Mandatory Operation Added to Interface</a><br> 5.2.5.6 <a href="#N112AA">Indicating Incompatibility by Changing the Endpoint URI</a><br> 5.2.5.7 <a href="#N112B3">Indicating Incompatibility by Changing the SOAP Action</a><br> &bsp; 5.2.5.8 <a href="#N112CA">Indicating Incompatibility by Changing the Element Content</a><br> 5.3 <a href="#adv-service-references"> Describing Web Service Messages That Refer to Other Web Services *************** *** 95,99 **** Reservation Details Web Service Using HTTP Transfer </a><br> 5.3.4 <a href="#reservationList_HTTP_GET">Reservation List Web Service Using HTTP GET</a><br> 5.4 <a href="#adv-multiple-docs-describing-same-service">Multiple Interfaces for the Same Service</a><br> 5.5 <a href="#adv-rdf-mapping">Mapping to RDF and Semantic Web</a><br> 5.5.1 <a href="#adv-rdf-rep-wsdl">RDF Representation of WSDL 2.0</a><br> 5.6 <a href="#adv-notes-on-uris">Notes on URIs</a><br> 5.6.1 <a href="#adv-namespaces-and-schema-locations">XML Namespaces and Schema Locations</a><br> 5.6.2 <a href="#adv-relative-uris">Relative URIs</a><br> 5.6.3 <a href="#adv-generating-uris">Generating Temporary URIs</a><br>6. <a href="#References">References</a><br> 6.1 <a href="#ormative-References">Normative References</a><br> 6.2 <a href="#Informative-References">Informative References</a><br></p> ! <h3><a name="appendix" id="appendix">Appendix</a></h3><p class="toc">A. <a href="#acknowledgments">Acknowledgements</a> (Non-Normative)<br></p></div><hr><div class="body"> <div class="div1"> --- 95,99 ---- Reservation Details Web Service Using HTTP Transfer </a><br> 5.3.4 <a href="#reservationList_HTTP_GET">Reservation List Web Service Using HTTP GET</a><br> 5.4 <a href="#adv-multiple-docs-describing-same-service">Multiple Interfaces for the Same Service</a><br> 5.5 <a href="#adv-rdf-mapping">Mapping to RDF and Semantic Web</a><br> 5.5.1 <a href="#adv-rdf-rep-wsdl">RDF Representation of WSDL 2.0</a><br> 5.6 <a href="#adv-notes-on-uris">Notes on URIs</a><br> 5.6.1 <a href="#adv-namespaces-and-schema-locations">XML Namespaces and Schema Locations</a><br> 5.6.2 <a href="#adv-relative-uris">Relative URIs</a><br> 5.6.3 <a href="#adv-generating-uris">Generating Temporary URIs</a><br>6. <a href="#References">References</a><br> 6.1 <a href="#ormative-References">Normative References</a><br> 6.2 <a href="#Informative-References">Informative References</a><br></p> ! <h3><a id="appendix" name="appendix">Appendix</a></h3><p class="toc">A. <a href="#acknowledgments">Acknowledgements</a> (Non-Normative)<br></p></div><hr><div class="body"> <div class="div1"> *************** *** 174,178 **** <div class="div3"> <h4><a name="basics-greath-scenario"></a>2.1.1 Example Scenario: The GreatH Hotel Reservation Service</h4><p>Hotel GreatH (a fictional hotel)) is located in a remote island. It has been relying on fax and phone to provide room reservations. Even though the facilities and prices at GreatH are better than what its competitor offers, GreatH notices that its competitor is getting more customers than GreatH. After research, GreatH realizes that this is because the competitor offers a Web service that permits travel agent reservation systems to reserve rooms directly over the Internet. GreatH then hires us to build a reservation Web service with the following functionality: <ul><li><p><em>CheckAvailability</em>. To check availability, the client must specify a check-in date, a check-out date, and room type. The Web service will return a room rate (a floating point number in USD$) if such a room is available, or a zero room rate if not. If any input data is invalid, the service should return an error. Thu, the service will accept a <code>checkAvailability</code> message and return a <code>checkAvailabilityResponse</code> or <code>invalidDataFault</code> message.</p> </li><li><p><em>MakeReservation</em>. To make a reservation, a client must provide a name, address, and credit card information, and the service will return a confirmation number if the reservation is successful. The service will return an error message if the credit card number or any other data field is invalid. Thus, the service will accept a <code>makeReservation</code> message and return a <code>makeReservationResponse</code> or <code>invalidCreditCardFault</code> message.</p></li></ul> We know that we will later need to build a complete system that supports transactions and secured transmission, but initially we will implement only minimal functionality. In fact, to simplify our first example, we will implement only the <em>CheckAvailability</em> operation. </p><p>The next several sections proceed step-by-step through the process of eveloping a WSDL 2.0 document that describes the desired Web service. However, for those who can't wait to see a complete example, here is the WSDL 2.0 document that we'll be creating.</p><div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="example-initial"></a><i><span>Example 2-1. </span>WSDL 2.0 Document for the GreatH Web Service (Initial Example)</i></p> <div class="exampleInner"><pre> <?xml version="1.0" encoding="utf-8" ?> --- 174,178 ---- <div class="div3"> <h4><a name="basics-greath-scenario"></a>2.1.1 Example Scenario: The GreatH Hotel Reservation Service</h4><p>Hotel GreatH (a fictional hotel)) is located in a remote island. It has been relying on fax and phone to provide room reservations. Even though the facilities and prices at GreatH are better than what its competitor offers, GreatH notices that its competitor is getting more customers than GreatH. After research, GreatH realizes that this is because the competitor offers a Web service that permits travel agent reservation systems to reserve rooms directly over the Internet. GreatH then hires us to build a reservation Web service with the following functionality: <ul><li><p><em>CheckAvailability</em>. To check availability, the client must specify a check-in date, a check-out date, and room type. The Web service will return a room rate (a floating point number in USD$) if such a room is available, or a zero room rate if not. If any input data is invalid, the service should return an error. Thu, the service will accept a <code>checkAvailability</code> message and return a <code>checkAvailabilityResponse</code> or <code>invalidDataFault</code> message.</p> </li><li><p><em>MakeReservation</em>. To make a reservation, a client must provide a name, address, and credit card information, and the service will return a confirmation number if the reservation is successful. The service will return an error message if the credit card number or any other data field is invalid. Thus, the service will accept a <code>makeReservation</code> message and return a <code>makeReservationResponse</code> or <code>invalidCreditCardFault</code> message.</p></li></ul> We know that we will later need to build a complete system that supports transactions and secured transmission, but initially we will implement only minimal functionality. In fact, to simplify our first example, we will implement only the <em>CheckAvailability</em> operation. </p><p>The next several sections proceed step-by-step through the process of eveloping a WSDL 2.0 document that describes the desired Web service. However, for those who can't wait to see a complete example, here is the WSDL 2.0 document that we'll be creating.</p><div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="example-initial"></a><i><span>Example 2-1. </span>WSDL 2.0 Document for the GreatH Web Service (Initial Example)</i></p> <div class="exampleInner"><pre> <?xml version="1.0" encoding="utf-8" ?> *************** *** 263,267 **** <div class="div3"> <h4><a name="basics-getting-started"></a>2.1.2 Defining a WSDL 2.0 Target Namespace</h4><p>Before writing our WSDL 2.0 document, we need to decide on a <em>WSDL 2.0 target namespace</em> URI for it. The WSDL 2.0 target namespace is analogous to an XML Schema target namespace. Interface, binding and service names that we define in our WSDL 2.0 document will be associated with the WSDL 2.0 target namespace, and thus will be distinguishable from similar names in a different WSDL 2.0 target namespace. (This will become important if using WSDL 2.0's import or interface inheritance mechanisms.) </p><p>The value of the WSDL 2.0 target namespace must be an absolute URI. Furthermore, it should be dereferenceable to a WSDL 2.0 document that describes the Web service that the WSDL 2.0 target namespace is used to describe. For example, the GreatH owners should make the WSDL 2.0 document available from this URI. (And if a WSDL 2.0 description is split into multiple documents, then the WSDL 2.0 target namespaceshould resolve to a master document that includes all the WSDL 2.0 documents needed for that service description.) However, there is no absolute requirement for this URI to be dereferenceable, so a WSDL 2.0 processor must not depend on it being dereferenceable. </p><p>This recommendation may sound circular, but bear in mind that the client might have obtained the WSDL 2.0 document from anywhere -- not necessarily an authoritative source. But by dereferencing the WSDL 2.0 target namespace URI, a user should be able to obtain an authoritative version. Since GreatH will be the owner of the service, the WSDL 2.0 target namespace URI should refer to a location on the GreatH Web site or otherwise within its control.</p><p>Once we have decided on a WSDL 2.0 target namespace URI, we can begin our WSDL 2.0 document as the following empty shell.</p><div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="example-empty-shell"></a><i><span>Example 2-2. </span>An Initial Empty WSDL 2.0 Document</i></p> <div class="exampleInner"><pre><?xml version="1.0" encoding="utf-8" ?> <description --- 263,267 ---- <div class="div3"> <h4><a name="basics-getting-started"></a>2.1.2 Defining a WSDL 2.0 Target Namespace</h4><p>Before writing our WSDL 2.0 document, we need to decide on a <em>WSDL 2.0 target namespace</em> URI for it. The WSDL 2.0 target namespace is analogous to an XML Schema target namespace. Interface, binding and service names that we define in our WSDL 2.0 document will be associated with the WSDL 2.0 target namespace, and thus will be distinguishable from similar names in a different WSDL 2.0 target namespace. (This will become important if using WSDL 2.0's import or interface inheritance mechanisms.) </p><p>The value of the WSDL 2.0 target namespace must be an absolute URI. Furthermore, it should be dereferenceable to a WSDL 2.0 document that describes the Web service that the WSDL 2.0 target namespace is used to describe. For example, the GreatH owners should make the WSDL 2.0 document available from this URI. (And if a WSDL 2.0 description is split into multiple documents, then the WSDL 2.0 target namespaceshould resolve to a master document that includes all the WSDL 2.0 documents needed for that service description.) However, there is no absolute requirement for this URI to be dereferenceable, so a WSDL 2.0 processor must not depend on it being dereferenceable. </p><p>This recommendation may sound circular, but bear in mind that the client might have obtained the WSDL 2.0 document from anywhere -- not necessarily an authoritative source. But by dereferencing the WSDL 2.0 target namespace URI, a user should be able to obtain an authoritative version. Since GreatH will be the owner of the service, the WSDL 2.0 target namespace URI should refer to a location on the GreatH Web site or otherwise within its control.</p><p>Once we have decided on a WSDL 2.0 target namespace URI, we can begin our WSDL 2.0 document as the following empty shell.</p><div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="example-empty-shell"></a><i><span>Example 2-2. </span>An Initial Empty WSDL 2.0 Document</i></p> <div class="exampleInner"><pre><?xml version="1.0" encoding="utf-8" ?> <description *************** *** 284,288 **** <div class="div3"> <h4><a name="basics-types"></a>2.1.3 Defining Message Types</h4><p>We know that the GreatH service will be sending and receiving messages, so a good starting point in describing the service is to define the message types that the service will use. We'll use XML Schema to do so, because WSDL 2.0 processors are likely to support XML Schema at a minimum. However, WSDL 2.0 does not prohibit the use of some other schema definition language.</p><p>WSDL 2.0 allows message types to be defined directly within the WSDL 2.0 document, inside the <code>types</code> element, which is a child of the <code>description</code> element. (Later we'll see how we can provide the type definitions in a separate document, using XML Schema's <code>import</code> mechanism.) The following schema defines <code>checkAvailability</code>, <code>checkAvailabilityResponse</code> and <code>invalidDataError</code> message types that we'll need. </p><p>In WSDL 2.0, all normal and fault message types must be defined as single <em>elemnts</em> at the topmost level (though of course each element may have any amount of substructure inside it). Thus, a message type must not directly consist of a sequence of elements or other complex type. </p><div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="example-initial-types"></a><i><span>Example 2-3. </span>GreatH Message Types</i></p> <div class="exampleInner"><pre> <?xml version="1.0" encoding="utf-8" ?> --- 284,288 ---- <div class="div3"> <h4><a name="basics-types"></a>2.1.3 Defining Message Types</h4><p>We know that the GreatH service will be sending and receiving messages, so a good starting point in describing the service is to define the message types that the service will use. We'll use XML Schema to do so, because WSDL 2.0 processors are likely to support XML Schema at a minimum. However, WSDL 2.0 does not prohibit the use of some other schema definition language.</p><p>WSDL 2.0 allows message types to be defined directly within the WSDL 2.0 document, inside the <code>types</code> element, which is a child of the <code>description</code> element. (Later we'll see how we can provide the type definitions in a separate document, using XML Schema's <code>import</code> mechanism.) The following schema defines <code>checkAvailability</code>, <code>checkAvailabilityResponse</code> and <code>invalidDataError</code> message types that we'll need. </p><p>In WSDL 2.0, all normal and fault message types must be defined as single <em>elemnts</em> at the topmost level (though of course each element may have any amount of substructure inside it). Thus, a message type must not directly consist of a sequence of elements or other complex type. </p><div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="example-initial-types"></a><i><span>Example 2-3. </span>GreatH Message Types</i></p> <div class="exampleInner"><pre> <?xml version="1.0" encoding="utf-8" ?> *************** *** 326,330 **** <p>For the GreatH service, we will (initially) define an interface containing a single operation, <code>opCheckAvailability</code>, using the <code>checkAvailability</code> and <code>checkAvailabilityResponse</code> message types that we defined in the <code>types</code> section. We'll use the <a href="wsdl20-adjuncts.html#in-out">in-out</a> pattern for this operation, because this is the most natural way to represent a simple request-response interaction. We could have instead (for example) defined two separate operations using the <a href="wsdl20-adjuncts.html#in-out">in-only</a> and <a href="wsdl20-adjuncts.html#out-only">out-only</a> patterns (see <em>WSDL 2.0 Predefined Extensions</em> [<cite><a href="#WSDL-PART2">WSDL 2.0 Adjuncts</a></cite>] section 2.2.1 <a href="wsdl20-adjuncts.html#in-only">In-Only</a> and section 2.2.5 <a href="wsdl20-adjuncts.html#out-only">Out-Only</a>), but that would just complicate matters for the client, because we would then have to separately indicate to the cient developer that the two operations should be used together as a request-response pair.</p><p>In addition to the normal input and output messages, we also need to specify the fault message that we wish to use in the event of an error. WSDL 2.0 permits fault messages to be declared within the <code>interface</code> element in order to facilitate reuse of faults across operations. If a fault occurs, it terminates whatever message sequence was indicated by the message exchange pattern of the operation. </p><p>Let's add these to our WSDL 2.0 document.</p><div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="example-initial-interface"></a><i><span>Example 2-4. </span>GreatH Interface Definition</i></p> <div class="exampleInner"><pre><?xml version="1.0" encoding="utf-8" ?> --- 326,330 ---- <p>For the GreatH service, we will (initially) define an interface containing a single operation, <code>opCheckAvailability</code>, using the <code>checkAvailability</code> and <code>checkAvailabilityResponse</code> message types that we defined in the <code>types</code> section. We'll use the <a href="wsdl20-adjuncts.html#in-out">in-out</a> pattern for this operation, because this is the most natural way to represent a simple request-response interaction. We could have instead (for example) defined two separate operations using the <a href="wsdl20-adjuncts.html#in-out">in-only</a> and <a href="wsdl20-adjuncts.html#out-only">out-only</a> patterns (see <em>WSDL 2.0 Predefined Extensions</em> [<cite><a href="#WSDL-PART2">WSDL 2.0 Adjuncts</a></cite>] section 2.2.1 <a href="wsdl20-adjuncts.html#in-only">In-Only</a> and section 2.2.5 <a href="wsdl20-adjuncts.html#out-only">Out-Only</a>), but that would just complicate matters for the client, because we would then have to separately indicate to the cient developer that the two operations should be used together as a request-response pair.</p><p>In addition to the normal input and output messages, we also need to specify the fault message that we wish to use in the event of an error. WSDL 2.0 permits fault messages to be declared within the <code>interface</code> element in order to facilitate reuse of faults across operations. If a fault occurs, it terminates whatever message sequence was indicated by the message exchange pattern of the operation. </p><p>Let's add these to our WSDL 2.0 document.</p><div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="example-initial-interface"></a><i><span>Example 2-4. </span>GreatH Interface Definition</i></p> <div class="exampleInner"><pre><?xml version="1.0" encoding="utf-8" ?> *************** *** 428,432 **** </p> <p>For the GreatH service, we will use SOAP 1.2 as our concrete message format and HTTP as our underlying transmission protocol, as shown below. </p><div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="example-initial-binding"></a><i><span>Example 2-5. </span>GreatH Binding Definition</i></p> <div class="exampleInner"><pre><?xml version="1.0" encoding="utf-8" ?> <description --- 428,432 ---- </p> <p>For the GreatH service, we will use SOAP 1.2 as our concrete message format and HTTP as our underlying transmission protocol, as shown below. </p><div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="example-initial-binding"></a><i><span>Example 2-5. </span>GreatH Binding Definition</i></p> <div class="exampleInner"><pre><?xml version="1.0" encoding="utf-8" ?> <description *************** *** 483,487 **** <div class="div3"> <h4><a name="basics-service"></a>2.1.6 Defining a Service</h4><p>Now that our binding has specified <em>how</em> messages will be transmitted, we are ready to specify <em>where</em> the service can be accessed, by use of the <code>service</code> element. </p><p>A WSDL 2.0 <em>service</em> specifies a single interface that the service will support, and a list of <em>endpoint</em> locations where that service can be accessed. Each endpoint must also reference a previously defined binding to indicate what protocols and transmission formats are to be used at that endpoint. A service is only permitted to have one interface. (See <a href="#adv-multiple-docs-describing-same-service"><b>5.4 Multiple Interfaces for the Same Service</b></a> for further discussion of this limitation.) </p><p>Here is a definition for our GreatH service.</p><div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="example-initial-service"></a><i><span>Example 2-6. </span>GreatH Service Definition</i></p> <div class="exampleInner"><pre><?xml version="1.0" encoding="utf-8" ?> <description --- 483,487 ---- <div class="div3"> <h4><a name="basics-service"></a>2.1.6 Defining a Service</h4><p>Now that our binding has specified <em>how</em> messages will be transmitted, we are ready to specify <em>where</em> the service can be accessed, by use of the <code>service</code> element. </p><p>A WSDL 2.0 <em>service</em> specifies a single interface that the service will support, and a list of <em>endpoint</em> locations where that service can be accessed. Each endpoint must also reference a previously defined binding to indicate what protocols and transmission formats are to be used at that endpoint. A service is only permitted to have one interface. (See <a href="#adv-multiple-docs-describing-same-service"><b>5.4 Multiple Interfaces for the Same Service</b></a> for further discussion of this limitation.) </p><p>Here is a definition for our GreatH service.</p><div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="example-initial-service"></a><i><span>Example 2-6. </span>GreatH Service Definition</i></p> <div class="exampleInner"><pre><?xml version="1.0" encoding="utf-8" ?> <description *************** *** 523,527 **** <div class="div3"> <h4><a name="basics-documentation"></a>2.1.7 Documenting the Service</h4><p>As we have seen, a WSDL 2.0 document is inherently only a <em>partial</em> description of a service. Although it captures the basic mechanics of interacting with the service -- the message types, transmission protocols, service location, etc. -- in general, additional documentation will need to explain other application-level requirements for its use. For example, such documentation should explain the purpose and use of the service, the meanings of all messages, constraints on their use, and the sequence in which operations should be invoked.</p><p>The <code>documentation</code> element allows the WSDL 2.0 author to include some human-readable documentation inside a WSDL 2.0 document. It is also a convenient place to reference any additional external documentation that a client developer may need in order to use the service. It can appear in a number of places in a WSDL 2.0 document (see <a href="#wsdl-infoset-diagram"><b>2..1 WSDL 2.0 Infoset</b></a>), though in this example we have only demonstrated its use at the beginning.</p><div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="example-initial-documentation"></a><i><span>Example 2-7. </span>Documenting the GreatH Service</i></p> <div class="exampleInner"><pre><?xml version="1.0" encoding="utf-8" ?> <description --- 523,527 ---- <div class="div3"> <h4><a name="basics-documentation"></a>2.1.7 Documenting the Service</h4><p>As we have seen, a WSDL 2.0 document is inherently only a <em>partial</em> description of a service. Although it captures the basic mechanics of interacting with the service -- the message types, transmission protocols, service location, etc. -- in general, additional documentation will need to explain other application-level requirements for its use. For example, such documentation should explain the purpose and use of the service, the meanings of all messages, constraints on their use, and the sequence in which operations should be invoked.</p><p>The <code>documentation</code> element allows the WSDL 2.0 author to include some human-readable documentation inside a WSDL 2.0 document. It is also a convenient place to reference any additional external documentation that a client developer may need in order to use the service. It can appear in a number of places in a WSDL 2.0 document (see <a href="#wsdl-infoset-diagram"><b>2..1 WSDL 2.0 Infoset</b></a>), though in this example we have only demonstrated its use at the beginning.</p><div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="example-initial-documentation"></a><i><span>Example 2-7. </span>Documenting the GreatH Service</i></p> <div class="exampleInner"><pre><?xml version="1.0" encoding="utf-8" ?> <description *************** *** 557,561 **** <p>The following diagram gives an overview of the XML Infoset for a WSDL 2.0 document. ! <div class="figure" style="text-align: center"><br><img src="images/WSDL20InfosetModel.png" alt="WSDL 2.0 Infoset Diagram"><p style="text-align:left"><i><span>Figure 2-1. </span>WSDL 2.0 Infoset Diagram</i></p><br></div> </p> --- 557,561 ---- <p>The following diagram gives an overview of the XML Infoset for a WSDL 2.0 document. ! <div style="text-align: center" class="figure"><br><img src="images/WSDL20InfosetModel.png" alt="WSDL 2.0 Infoset Diagram"><p style="text-align:left"><i><span>Figure 2-1. </span>WSDL 2.0 Infoset Diagram</i></p><br></div> </p> *************** *** 662,666 **** <p>The WSDL 2.0 Infoset model above illustrates the required structure of a WSDL 2.0 document, using the XML Infoset. However, the WSDL 2.0 language also imposes many semantic constraints over and above structural conformance to this XML Infoset. In order to precisely describe these constraints, and as an aid in precisely defining the meaning of each WSDL 2.0 document, the WSDL 2.0 specification defines a <em>component model</em> as an additional layer of abstraction above the XML Infoset. Constraints and meaning are defined in terms of this component model, and the definition of each component includes a mapping that specifies how values in the component model are derived from corresponding items in the XML Infoset. The following diagram gives an overview of the WSDL 2.0 components and their containment hierarchy. ! <div class="figure" style="text-align: center"><br><img src="images/WSDL20Components.png" alt="WSDL 2.0 Components Containment hierarchy"><p style="text-align:left"><i><span>Figure 2-2. </span>WSDL 2.0 Components Containment hierarchy</i></p><br></div></p> --- 662,666 ---- <p>The WSDL 2.0 Infoset model above illustrates the required structure of a WSDL 2.0 document, using the XML Infoset. However, the WSDL 2.0 language also imposes many semantic constraints over and above structural conformance to this XML Infoset. In order to precisely describe these constraints, and as an aid in precisely defining the meaning of each WSDL 2.0 document, the WSDL 2.0 specification defines a <em>component model</em> as an additional layer of abstraction above the XML Infoset. Constraints and meaning are defined in terms of this component model, and the definition of each component includes a mapping that specifies how values in the component model are derived from corresponding items in the XML Infoset. The following diagram gives an overview of the WSDL 2.0 components and their containment hierarchy. ! <div style="text-align: center" class="figure"><br><img src="images/WSDL20Components.png" alt="WSDL 2.0 Components Containment hierarchy"><p style="text-align:left"><i><span>Figure 2-2. </span>WSDL 2.0 Components Containment hierarchy</i></p><br></div></p> *************** *** 774,778 **** <div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="example-schema-import"></a><i><span>Example 2-8. </span> <code>xs:import</code>ed Message Definitions that Are Visible to the Containing WSDL 2.0 Description</i></p> <div class="exampleInner"><pre><?xml version="1.0" encoding="utf-8" ?> <description xmlns="http://www.w3.org/@@@@/@@/wsdl" --- 774,778 ---- <div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="example-schema-import"></a><i><span>Example 2-8. </span> <code>xs:import</code>ed Message Definitions that Are Visible to the Containing WSDL 2.0 Description</i></p> <div class="exampleInner"><pre><?xml version="1.0" encoding="utf-8" ?> <description xmlns="http://www.w3.org/@@@@/@@/wsdl" *************** *** 798,802 **** <div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="example-schema-import1"></a><i><span>Example 2-9. </span><code>xs:import</code>ed Message Definitions in Inlined Schema Are Not Visible to the Containing WSDL 2.0 Description</i></p> <div class="exampleInner"><pre><?xml version="1.0" encoding="utf-8" ?> <description xmlns="http://www.w3.org/@@@@/@@/wsdl" --- 798,802 ---- <div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="example-schema-import1"></a><i><span>Example 2-9. </span><code>xs:import</code>ed Message Definitions in Inlined Schema Are Not Visible to the Containing WSDL 2.0 Description</i></p> <div class="exampleInner"><pre><?xml version="1.0" encoding="utf-8" ?> <description xmlns="http://www.w3.org/@@@@/@@/wsdl" *************** *** 824,828 **** <div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="example-schema-import2"></a><i><span>Example 2-10. </span><code>xs:included</code> Message Definitions in Inlined Schema Are Visible to the Containing WSDL 2.0 Description</i></p> <div class="exampleInner"><pre><?xml version="1.0" encoding="utf-8" ?> <description xmlns="http://www.w3.org/@@@@/@@/wsdl" --- 824,828 ---- <div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="example-schema-import2"></a><i><span>Example 2-10. </span><code>xs:included</code> Message Definitions in Inlined Schema Are Visible to the Containing WSDL 2.0 Description</i></p> <div class="exampleInner"><pre><?xml version="1.0" encoding="utf-8" ?> <description xmlns="http://www.w3.org/@@@@/@@/wsdl" *************** *** 1057,1061 **** <div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="example-faults"></a><i><span>Example 2-11. </span>Interface Inheritance</i></p> <div class="exampleInner"><pre> --- 1057,1061 ---- <div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="example-faults"></a><i><span>Example 2-11. </span>Interface Inheritance</i></p> <div class="exampleInner"><pre> *************** *** 1169,1176 **** </div><div class="div4"> ! <h5><a name="N68048"></a>2.4.4.2 Operation Message References</h5><p>An <code>operation</code> will also have <code>input</code>, <code>output</code>,<code>infault</code>, and/or <code>outfault</code> element children that specify the ordinary and fault message types to be used by that operation. The MEP specified by the <code>pattern</code> attribute determines which of these elements should be included, since each MEP has placeholders for the message types involved in its pattern. </p><p>Since operations were already discussed in <a href="#basics-interface"><b>2.1.4 Defining an Interface</b></a>, this section will merely comment on additional capabilities that were not previously explained.</p> <div class="div5"> ! <h6><a name="N68077"></a>2.4.4.2.1 The messageLabel Attribute</h6> <p> The --- 1169,1176 ---- </div><div class="div4"> ! <h5><a name="N109D0"></a>2.4.4.2 Operation Message References</h5><p>An <code>operation</code> will also have <code>input</code>, <code>output</code>,<code>infault</code>, and/or <code>outfault</code> element children that specify the ordinary and fault message types to be used by that operation. The MEP specified by the <code>pattern</code> attribute determines which of these elements should be included, since each MEP has placeholders for the message types involved in its pattern. </p><p>Since operations were already discussed in <a href="#basics-interface"><b>2.1.4 Defining an Interface</b></a>, this section will merely comment on additional capabilities that were not previously explained.</p> <div class="div5"> ! <h6><a name="N109ED"></a>2.4.4.2.1 The messageLabel Attribute</h6> <p> The *************** *** 1192,1196 **** <div class="div5"> ! <h6><a name="N68101"></a>2.4.4.2.2 The element Attribute</h6> <p> The --- 1192,1196 ---- <div class="div5"> ! <h6><a name="N10A05"></a>2.4.4.2.2 The element Attribute</h6> <p> The *************** *** 1253,1257 **** </div> <div class="div5"> ! <h6><a name="N68182"></a>2.4.4.2.3 Multiple infault or outfault Elements</h6><p>When <code>infault</code> and/or <code>outfault</code> occur multiple times within an <code>operation</code>, they define alternative fault messages. </p></div></div> --- 1253,1257 ---- </div> <div class="div5"> ! <h6><a name="N10A56"></a>2.4.4.2.3 Multiple infault or outfault Elements</h6><p>When <code>infault</code> and/or <code>outfault</code> occur multiple times within an <code>operation</code>, they define alternative fault messages. </p></div></div> *************** *** 1272,1276 **** <div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="example-outbound-operation"></a><i><span>Example 2-12. </span>Use of outbound MEPs</i></p> <div class="exampleInner"><pre> --- 1272,1276 ---- <div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="example-outbound-operation"></a><i><span>Example 2-12. </span>Use of outbound MEPs</i></p> <div class="exampleInner"><pre> *************** *** 1366,1370 **** <p>The WSDL 2.0 SOAP Binding Extension (see WSDL 2.0 Part 2 [<cite><a href="#WSDL-PART2">WSDL 2.0 Adjuncts</a></cite>]) was primarily designed to support the features of SOAP 1.2 [<cite><a href="#SOAP12-PART1">SOAP 1.2 Part 1: Messaging Framework</a></cite>]. However, for backwards compatibility, it also provides some support for SOAP 1.1 [<cite><a href="#SOAP11">SOAP 1.1</a></cite>]. </p><p>An example using the WSDL 2.0 SOAP binding extension was already presented in <a href="#basics-binding"><b>2.1.5 Defining a Binding</b></a>, but some additional points are worth mentioning:<ul><li><p>Because the same binding extension is used for both SOAP 1.2 and SOAP 1.1, a <code>wsoap:version</code> attribute is provided to allow you to indicate which version of SOAP you want. If this attribute is not specified, it defaults to SOAP 1.2.</p></li><li><p>The WSDL 2.0 SOAP binding extension defines a set of default rules, so that bindings can be specified at the interface level or at the operation level (orboth), with the operation level taking precedence. However, it does not define default binding rules for faults. Thus, if a given interface defines any faults, then corresponding binding information must be explicitly provided for each such fault.</p></li><li><p>If HTTP is used as the underlying protocol, then the binding can (and should) control whether each operation will use HTTP GET or POST. (See <a href="#adv-get-vs-post"><b>2.5.7 HTTP GET Versus POST: Which to Use?</b></a>.)</p></li></ul></p><p>Here is an example that illustrates both a SOAP 1.2 binding (as seen before) and a SOAP 1.1 binding.</p><div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="example-binding-soap"></a><i><span>Example 2-13. </span>SOAP 1.2 and SOAP 1.1 Bindings</i></p> <div class="exampleInner"><pre> --- 1366,1370 ---- <p>The WSDL 2.0 SOAP Binding Extension (see WSDL 2.0 Part 2 [<cite><a href="#WSDL-PART2">WSDL 2.0 Adjuncts</a></cite>]) was primarily designed to support the features of SOAP 1.2 [<cite><a href="#SOAP12-PART1">SOAP 1.2 Part 1: Messaging Framework</a></cite>]. However, for backwards compatibility, it also provides some support for SOAP 1.1 [<cite><a href="#SOAP11">SOAP 1.1</a></cite>]. </p><p>An example using the WSDL 2.0 SOAP binding extension was already presented in <a href="#basics-binding"><b>2.1.5 Defining a Binding</b></a>, but some additional points are worth mentioning:<ul><li><p>Because the same binding extension is used for both SOAP 1.2 and SOAP 1.1, a <code>wsoap:version</code> attribute is provided to allow you to indicate which version of SOAP you want. If this attribute is not specified, it defaults to SOAP 1.2.</p></li><li><p>The WSDL 2.0 SOAP binding extension defines a set of default rules, so that bindings can be specified at the interface level or at the operation level (orboth), with the operation level taking precedence. However, it does not define default binding rules for faults. Thus, if a given interface defines any faults, then corresponding binding information must be explicitly provided for each such fault.</p></li><li><p>If HTTP is used as the underlying protocol, then the binding can (and should) control whether each operation will use HTTP GET or POST. (See <a href="#adv-get-vs-post"><b>2.5.7 HTTP GET Versus POST: Which to Use?</b></a>.)</p></li></ul></p><p>Here is an example that illustrates both a SOAP 1.2 binding (as seen before) and a SOAP 1.1 binding.</p><div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="example-binding-soap"></a><i><span>Example 2-13. </span>SOAP 1.2 and SOAP 1.1 Bindings</i></p> <div class="exampleInner"><pre> *************** *** 1445,1449 **** <p>In addition to the WSDL 2.0 SOAP binding extension described above, WSDL 2.0 Part 2 [<cite><a href="#WSDL-PART2">WSDL 2.0 Adjuncts</a></cite>] defines a binding extension for HTTP 1.1 [<cite><a href="#RFC2616">IETF RFC 2616</a></cite>] and HTTPS [<cite><a href="#RFC2818">IETF RFC 2818</a></cite>], so that these protocols can be used natively to send and receive messages, without first encoding them in SOAP.</p><p>The HTTP binding extension provides many features to control:<ul><li><p> Which HTTP operation will be used. (GET, PUT, POST, DELETE, and other HTTP operations are supported.)</p></li><li><p>Input, output and fault serialization</p></li><li><p>Transfer codings</p></li><li><p>Authentication requirements</p></li><li><p>Cookies</p></li><li><p>HTTP over TLS (https)</p></li></ul></p><p>As with the WSDL 2.0 SOAP binding extension, the HTTP binding extension also provides defaulting rules to permit binding information to be specified at the interface level and used by default for each operation n the affected interface, however, defaulting rules are not provided for binding faults.</p><p>Here is an example of using the HTTP binding extension to check hotel room availability at GreatH.</p><div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="example-bindings-http"></a><i><span>Example 2-14. </span>HTTP Binding Extension</i></p> <div class="exampleInner"><pre> <?xml version="1.0" encoding="utf-8" ?> --- 1445,1449 ---- <p>In addition to the WSDL 2.0 SOAP binding extension described above, WSDL 2.0 Part 2 [<cite><a href="#WSDL-PART2">WSDL 2.0 Adjuncts</a></cite>] defines a binding extension for HTTP 1.1 [<cite><a href="#RFC2616">IETF RFC 2616</a></cite>] and HTTPS [<cite><a href="#RFC2818">IETF RFC 2818</a></cite>], so that these protocols can be used natively to send and receive messages, without first encoding them in SOAP.</p><p>The HTTP binding extension provides many features to control:<ul><li><p> Which HTTP operation will be used. (GET, PUT, POST, DELETE, and other HTTP operations are supported.)</p></li><li><p>Input, output and fault serialization</p></li><li><p>Transfer codings</p></li><li><p>Authentication requirements</p></li><li><p>Cookies</p></li><li><p>HTTP over TLS (https)</p></li></ul></p><p>As with the WSDL 2.0 SOAP binding extension, the HTTP binding extension also provides defaulting rules to permit binding information to be specified at the interface level and used by default for each operation n the affected interface, however, defaulting rules are not provided for binding faults.</p><p>Here is an example of using the HTTP binding extension to check hotel room availability at GreatH.</p><div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="example-bindings-http"></a><i><span>Example 2-14. </span>HTTP Binding Extension</i></p> <div class="exampleInner"><pre> <?xml version="1.0" encoding="utf-8" ?> *************** *** 1475,1479 **** </div> <div class="div4"> ! <h5><a name="N68644"></a>2.5.6.1 Explanation of Example</h5> --- 1475,1479 ---- </div> <div class="div4"> ! <h5><a name="N10C24"></a>2.5.6.1 Explanation of Example</h5> *************** *** 1499,1503 **** <p>Here is an alternate example that appends "/" to the type name in order to serialize the remaining instance data into the message body:</p><div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="example-bindings-http-path-subsset"></a><i><span>Example 2-15. </span>Serializing a Subset of Types in the Path</i></p> <div class="exampleInner"><pre> --- 1499,1503 ---- <p>Here is an alternate example that appends "/" to the type name in order to serialize the remaining instance data into the message body:</p><div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="example-bindings-http-path-subsset"></a><i><span>Example 2-15. </span>Serializing a Subset of Types in the Path</i></p> <div class="exampleInner"><pre> *************** *** 1526,1530 **** <div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="example-binding-safety"></a><i><span>Example 2-16. </span>Safety and HTTP Binding</i></p> <div class="exampleInner"><pre> --- 1526,1530 ---- <div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="example-binding-safety"></a><i><span>Example 2-16. </span>Safety and HTTP Binding</i></p> <div class="exampleInner"><pre> *************** *** 1583,1587 **** <div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="credit-card-faults"></a><i><span>Example 3-1. </span>Standard Credit Card Validation Faults (credit-card-faults.wsdl)</i></p> <div class="exampleInner"><pre><?xml version="1.0" encoding="utf-8" ?> <description xmlns="http://www.w3.org/@@@@/@@/wsdl" --- 1583,1587 ---- <div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="credit-card-faults"></a><i><span>Example 3-1. </span>Standard Credit Card Validation Faults (credit-card-faults.wsdl)</i></p> <div class="exampleInner"><pre><?xml version="1.0" encoding="utf-8" ?> <description xmlns="http://www.w3.org/@@@@/@@/wsdl" *************** *** 1634,1638 **** <div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="use-credit-card-faults"></a><i><span>Example 3-2. </span>Using the Standard Credit Card Validation Faults (use-credit-card-faults.wsdl)</i></p> <div class="exampleInner"><pre><?xml version="1.0"?> <description --- 1634,1638 ---- <div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="use-credit-card-faults"></a><i><span>Example 3-2. </span>Using the Standard Credit Card Validation Faults (use-credit-card-faults.wsdl)</i></p> <div class="exampleInner"><pre><?xml version="1.0"?> <description *************** *** 1721,1725 **** <div class="div3"> ! <h4><a name="N68980"></a>3.2.1 Schemas in Imported Documents</h4> <p> In this example, we consider some GreatH Hotel --- 1721,1725 ---- <div class="div3"> ! <h4><a name="N10D74"></a>3.2.1 Schemas in Imported Documents</h4> <p> In this example, we consider some GreatH Hotel *************** *** 1758,1762 **** <div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="retrieveDetails.wsdl"></a><i><span>Example 3-3. </span> The Retrieve Reservation Details Web Service: retrieveDetails.wsdl --- 1758,1762 ---- <div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="retrieveDetails.wsdl"></a><i><span>Example 3-3. </span> The Retrieve Reservation Details Web Service: retrieveDetails.wsdl *************** *** 1885,1889 **** <div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="updateDetails.wsdl"></a><i><span>Example 3-4. </span>The Update Reservation Details Web Service: updateDetails.wsdl</i></p> <div class="exampleInner"><pre><?xml version="1.0" encoding="utf-8" ?> <description xmlns="http://www.w3.org/@@@@/@@/wsdl" --- 1885,1889 ---- <div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="updateDetails.wsdl"></a><i><span>Example 3-4. </span>The Update Reservation Details Web Service: updateDetails.wsdl</i></p> <div class="exampleInner"><pre><?xml version="1.0" encoding="utf-8" ?> <description xmlns="http://www.w3.org/@@@@/@@/wsdl" *************** *** 1928,1932 **** <div class="div3"> ! <h4><a name="N69119"></a>3.2.2 Multiple Inline Schemas in One Document</h4> <p> A WSDL 2.0 document may define multiple inline --- 1928,1932 ---- <div class="div3"> ! <h4><a name="N10DFF"></a>3.2.2 Multiple Inline Schemas in One Document</h4> <p> A WSDL 2.0 document may define multiple inline *************** *** 1984,1988 **** <div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="retrieveItems.wsdl"></a><i><span>Example 3-5. </span> Multiple Inline Schemas: retrieveItems.wsdl </i></p> --- 1984,1988 ---- <div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="retrieveItems.wsdl"></a><i><span>Example 3-5. </span> Multiple Inline Schemas: retrieveItems.wsdl </i></p> *************** *** 2062,2066 **** the <code>schema</code> element. The simplest way to accomplish this is to use the <code>id</code> attribute, however XPointer (see [<cite><a href="#XPTR">XPointer Framework</a></cite>]) can also be used. </p><div class="div4"> ! <h5><a name="N69215"></a>3.2.3.1 Using the id Attribute to Identify Inline Schemas</h5><p> <a href="#schemaIds.wsdl">Example 3-6</a> --- 2062,2066 ---- the <code>schema</code> element. The simplest way to accomplish this is to use the <code>id</code> attribute, however XPointer (see [<cite><a href="#XPTR">XPointer Framework</a></cite>]) can also be used. </p><div class="div4"> ! <h5><a name="N10E5F"></a>3.2.3.1 Using the id Attribute to Identify Inline Schemas</h5><p> <a href="#schemaIds.wsdl">Example 3-6</a> *************** *** 2079,2083 **** attribute, i.e. <code>#items</code>. </p> ! <div class="exampleOuter"><p style="text-align: left" class="exampleHead"><a name="schemaIds.wsdl"></a><i><span>Example 3-6. </span>Using Ids in Inline Schemas: schemaIds.wsdl</i></p> <div class="exampleInner"><pre><?xml version="1.0" encoding="utf-8" ?> <description xmlns="http://www.w3.org/@@@@/@@/wsdl" --- 2079,2083 ---- attribute, i.e. <code>#items</code>. </p> ! <div class="exampleOuter"><p class="exampleHead" style="text-align: left"><a name="schemaIds.wsdl"></a><i><span>Example 3-6. </span>Using Ids in Inline Schemas: schemaIds.wsdl</i></p> <div class="exampleInner"><pre><?xml version="1.0" encoding="utf-8" ?> <description xmlns="http://www.w3.org/@@@@/@@/wsdl" *************** *** 2162,2166 **** <h3><a name="adv-FP"></a>4.2 Features and Properties</h3> ! <table border="1" summary="Editorial note: KevinL"><tr><td align="left" valign="top" width="50%"><b>Editorial note: KevinL</b></td><td align="right" valign="top" width="50%">20050519</td></tr><tr><td colspan="2" align="left" valign="top"> The section is subject to change. Pending on the resolution of the minority opinions filed about Feature and Property. </td></tr></table> --- 2162,2166 ---- <h3><a name="adv-FP"></a>4.2 Features and Properties</h3> ! <table border="1" summary="Editorial note: KevinL"><tr><td width="50%" valign="top" align="left"><b>Editorial note: KevinL</b></td><td width="50%" valign="top" align="right">20050519</td></tr><tr><td valign="top" align="left" colspan="2"> The section is subject to change. Pending on the resolution of the minority opinions filed about Feature and Property. </td></tr></table> *************** *** 2169,2173 **** <div class="div3"> <h4><a name="adv-FP-soap-modules"></a>4.2.1 SOAP Modules</h4><p>The first step GreatH takes is to require the usage of the SOAP module in their normal SOAP/HTTP endpoint, which looks like this:</p><div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="example-fp-requiring-soap-module"></a><i><span>Example 4-1. </span>Requiring a SOAP Module in an Endpoint</i></p> <div class="exampleInner"><pre> --- 2169,2173 ---- <div class="div3"> <h4><a name="adv-FP-soap-modules"></a>4.2.1 SOAP Modules</h4><p>The first step GreatH takes is to require the usage of the SOAP module in their normal SOAP/HTTP endpoint, which looks like this:</p><div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="example-fp-requiring-soap-module"></a><i><span>Example 4-1. </span>Requiring a SOAP Module in an Endpoint</i></p> <div class="exampleInner"><pre> *************** *** 2190,2194 **** </p><p>If the "required" attribute was not present, or if it was set to "<code>false</code>", then the <code><wsoap:module></code> syntax would indicate optional the availability of the referenced module, rather than a requirement to engage it, as explained in <a href="#adv-optional-versus-required"><b>4.1.1 Optional Versus Required Extensions</b></a>.</p></div><div class="div3"> <h4><a name="adv-FP-abstract-features"></a>4.2.2 Abstract Features</h4><p>Since GreatH began the web service improvements, they have been talking to several travel agents. The possibility of making their simple hotel interface an industry standard amongst a consortium of hotels has come up, and as such they would like to enable specifying the requirement for the "makeReservation" operation to be secure at the interface level – in other words indicating that the operation must be secure, but without specifying exactly how that should concretely be achieved (to enable maximal reuse of the interface). The next example uses the WSDL 2.0 Feature element to indicate this.</p><div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="example-fp-declaring-abstract-feature"></a><i><span>Example 4-2. </span>Declaring an Abstract Feature Requirement</i></p> <div class="exampleInner"><pre> . . . --- 2190,2194 ---- </p><p>If the "required" attribute was not present, or if it was set to "<code>false</code>", then the <code><wsoap:module></code> syntax would indicate optional the availability of the referenced module, rather than a requirement to engage it, as explained in <a href="#adv-optional-versus-required"><b>4.1.1 Optional Versus Required Extensions</b></a>.</p></div><div class="div3"> <h4><a name="adv-FP-abstract-features"></a>4.2.2 Abstract Features</h4><p>Since GreatH began the web service improvements, they have been talking to several travel agents. The possibility of making their simple hotel interface an industry standard amongst a consortium of hotels has come up, and as such they would like to enable specifying the requirement for the "makeReservation" operation to be secure at the interface level – in other words indicating that the operation must be secure, but without specifying exactly how that should concretely be achieved (to enable maximal reuse of the interface). The next example uses the WSDL 2.0 Feature element to indicate this.</p><div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="example-fp-declaring-abstract-feature"></a><i><span>Example 4-2. </span>Declaring an Abstract Feature Requirement</i></p> <div class="exampleInner"><pre> . . . *************** *** 2202,2206 **** . . .</pre></div> </div><p>This declaration indicates that understanding of, and compliance with, the specified security feature is required for all uses of the "makeReservation" operation. The security feature is <em>abstract</em>, which means that although it defines semantics and a level of detail about its general operation, it expects a concrete component (like a SOAP module or binding) to actually realize the functionality.</p><p>By definition, if you understand a SOAP module, you understand which (if any) abstract features it implements. Therefore, since the security module in this example is defined as an implementation of the abstract security feature, we know that the use of this module satisfies the requirement to implement the feature. Therefore users of the HTTP endpoint shown above (with the required SOAP module) will be able to make use of it. GreatH also defines a new endpoint:</p><div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="example-fp-soap-over-shttp"></a><i><span>Example 4-3. </span>A SOAP Binding Over a Secure HTTP Protocol</i></p> <div class="exampleInner"><pre> . . . --- 2202,2206 ---- . . .</pre></div> </div><p>This declaration indicates that understanding of, and compliance with, the specified security feature is required for all uses of the "makeReservation" operation. The security feature is <em>abstract</em>, which means that although it defines semantics and a level of detail about its general operation, it expects a concrete component (like a SOAP module or binding) to actually realize the functionality.</p><p>By definition, if you understand a SOAP module, you understand which (if any) abstract features it implements. Therefore, since the security module in this example is defined as an implementation of the abstract security feature, we know that the use of this module satisfies the requirement to implement the feature. Therefore users of the HTTP endpoint shown above (with the required SOAP module) will be able to make use of it. GreatH also defines a new endpoint:</p><div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="example-fp-soap-over-shttp"></a><i><span>Example 4-3. </span>A SOAP Binding Over a Secure HTTP Protocol</i></p> <div class="exampleInner"><pre> . . . *************** *** 2221,2225 **** </div><p>The user will have a choice as to which of the endpoints, and therefore which binding, is to be used, but they both satisfy the abstract feature requirement specified in the interface.</p><p>Note that it is not necessary to declare the abstract feature in order to use/require the SOAP module, or in order to use/require the secure binding. Abstract feature declarations serve purely to indicate requirements which must be fulfilled by more concrete components such as modules or bindings. In other words, the abstract feature declaration allows components such as interfaces to be reused without caring exactly which SOAP modules or bindings satisfy the feature.</p></div><div class="div3"> <h4><a name="adv-fp-properties"></a>4.2.3 Properties</h4><p>So far we've discussed how to indicate the availability or the "requiredness" of features and modules. Often it is not enough to indicate that a particular extension is available/required: you also need some way to control or parameterize aspects of its behavior. This is achieved by the use of WSDL 2.0 <em>properties</em>. Each feature, SOAP module, or SOAP binding may express a variety of <em>properties</em> in its specification. These properties are very much like variables in a programming language. If GreatH would like to indicate that the <code>securityLevel</code> property should be 5 for the "makeReservation" operation, it would look like this:</p><div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="example-fp-def-prop"></a><i><span>Example 4-4. </span>Defining a Property</i></p> <div class="exampleInner"><pre> . . . --- 2221,2225 ---- </div><p>The user will have a choice as to which of the endpoints, and therefore which binding, is to be used, but they both satisfy the abstract feature requirement specified in the interface.</p><p>Note that it is not necessary to declare the abstract feature in order to use/require the SOAP module, or in order to use/require the secure binding. Abstract feature declarations serve purely to indicate requirements which must be fulfilled by more concrete components such as modules or bindings. In other words, the abstract feature declaration allows components such as interfaces to be reused without caring exactly which SOAP modules or bindings satisfy the feature.</p></div><div class="div3"> <h4><a name="adv-fp-properties"></a>4.2.3 Properties</h4><p>So far we've discussed how to indicate the availability or the "requiredness" of features and modules. Often it is not enough to indicate that a particular extension is available/required: you also need some way to control or parameterize aspects of its behavior. This is achieved by the use of WSDL 2.0 <em>properties</em>. Each feature, SOAP module, or SOAP binding may express a variety of <em>properties</em> in its specification. These properties are very much like variables in a programming language. If GreatH would like to indicate that the <code>securityLevel</code> property should be 5 for the "makeReservation" operation, it would look like this:</p><div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="example-fp-def-prop"></a><i><span>Example 4-4. </span>Defining a Property</i></p> <div class="exampleInner"><pre> . . . *************** *** 2236,2240 **** </div><p>The <code>property</code> element specifies which property is to be set. By setting the <code>value</code> element, a toolkit processing this WSDL 2.0 document is informed that the securityLevel property must be set to 5. The particular meanings of any such values are up to the implementations of the modules/bindings that use them. The <code>property</code> element can be placed at many different levels in a WSDL 2.0 document (see "Property Composition Model" section in WSDL 2.0 Part 1 [<cite><a href="#WSDL-PART1">WSDL 2.0 Core</a></cite>]). </p><p>It is also possible to provide a <em>constraint</em> on the value space for a given property. This allows the author of the WSDL 2.0 document to indicate that several valid values for the property are possible for a given scope, limiting the value space already described in the specification that defined the property. Let's extend our example to make this clearer.</p><p>The security feature specification defines securityLevel as an integer with values between 1 and 10, each of which indicates, according to the spec, a progressively higher level of security. The GreatH service authors, having read the relevant specifications, have decided that any security level between 3 and 7 will be supported by their infrastructure. Levels less than 3 are deemed unsafe for GreatH's purposes, and levels greater than 7 require too much in the way of resources to make it worthwhile. We can express this in WSDL 2.0 as follows:</p><div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="example-fp-def-prop-constraints"></a><i><span>Example 4-5. </span>Defining Property Constraints</i></p> <div class="exampleInner"><pre> . . . --- 2236,2240 ---- </div><p>The <code>property</code> element specifies which property is to be set. By setting the <code>value</code> element, a toolkit processing this WSDL 2.0 document is informed that the securityLevel property must be set to 5. The particular meanings of any such values are up to the implementations of the modules/bindings that use them. The <code>property</code> element can be placed at many different levels in a WSDL 2.0 document (see "Property Composition Model" section in WSDL 2.0 Part 1 [<cite><a href="#WSDL-PART1">WSDL 2.0 Core</a></cite>]). </p><p>It is also possible to provide a <em>constraint</em> on the value space for a given property. This allows the author of the WSDL 2.0 document to indicate that several valid values for the property are possible for a given scope, limiting the value space already described in the specification that defined the property. Let's extend our example to make this clearer.</p><p>The security feature specification defines securityLevel as an integer with values between 1 and 10, each of which indicates, according to the spec, a progressively higher level of security. The GreatH service authors, having read the relevant specifications, have decided that any security level between 3 and 7 will be supported by their infrastructure. Levels less than 3 are deemed unsafe for GreatH's purposes, and levels greater than 7 require too much in the way of resources to make it worthwhile. We can express this in WSDL 2.0 as follows:</p><div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="example-fp-def-prop-constraints"></a><i><span>Example 4-5. </span>Defining Property Constraints</i></p> <div class="exampleInner"><pre> . . . *************** *** 2290,2294 **** <div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="weather-not-initial"></a><i><span>Example 4-6. </span>Weather Notification Service (Initial)</i></p> <div class="exampleInner"><pre><?xml version="1.0" encoding="utf-8" ?> <description xmlns="http://www.w3.org/@@@@/@@/wsdl" --- 2290,2294 ---- <div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="weather-not-initial"></a><i><span>Example 4-6. </span>Weather Notification Service (Initial)</i></p> <div class="exampleInner"><pre><?xml version="1.0" encoding="utf-8" ?> <description xmlns="http://www.w3.org/@@@@/@@/wsdl" *************** *** 2399,2403 **** <div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="weather-not-final"></a><i><span>Example 4-7. </span>Weather Notification Service (Revised)</i></p> <div class="exampleInner"><pre><?xml version="1.0" encoding="utf-8" ?> <description xmlns="http://www.w3.org/@@@@/@@/wsdl" --- 2399,2403 ---- <div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="weather-not-final"></a><i><span>Example 4-7. </span>Weather Notification Service (Revised)</i></p> <div class="exampleInner"><pre><?xml version="1.0" encoding="utf-8" ?> <description xmlns="http://www.w3.org/@@@@/@@/wsdl" *************** *** 2449,2453 **** signature. This example is a modified version of the GreatH reservation service. In particular, the <code>interface</code> and <code>types</code> sections have been modified to specify and conform to the RPC Style.</p><div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="example-rpc-style"></a><i><span>Example 4-8. </span>Specifying RPC Style </i></p> <div class="exampleInner"><pre>. . . --- 2449,2453 ---- signature. This example is a modified version of the GreatH reservation service. In particular, the <code>interface</code> and <code>types</code> sections have been modified to specify and conform to the RPC Style.</p><div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="example-rpc-style"></a><i><span>Example 4-8. </span>Specifying RPC Style </i></p> <div class="exampleInner"><pre>. . . *************** *** 2508,2512 **** for mapping simple types to Java types and designated inout and output parameters by using Holder classes.</p><div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="example-rpc-style-java-sig"></a><i><span>Example 4-9. </span>Sample Java(TM) Signature for RPC Style</i></p> <div class="exampleInner"><pre>public interface reservationInterface extends Remote{ --- 2508,2512 ---- for mapping simple types to Java types and designated inout and output parameters by using Holder classes.</p><div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="example-rpc-style-java-sig"></a><i><span>Example 4-9. </span>Sample Java(TM) Signature for RPC Style</i></p> <div class="exampleInner"><pre>public interface reservationInterface extends Remote{ *************** *** 2534,2538 **** <div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="example-MTOM-schema"></a><i><span>Example 4-10. </span>XML Schema with Optimizable Elements </i></p> <div class="exampleInner"><pre>. . . --- 2534,2538 ---- <div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="example-MTOM-schema"></a><i><span>Example 4-10. </span>XML Schema with Optimizable Elements </i></p> <div class="exampleInner"><pre>. . . *************** *** 2583,2587 **** <div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="example-MTOM-soap-message"></a><i><span>Example 4-11. </span>Non-optimized SOAP Message with Embedded Binary Data </i></p> <div class="exampleInner"><pre> --- 2583,2587 ---- <div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="example-MTOM-soap-message"></a><i><span>Example 4-11. </span>Non-optimized SOAP Message with Embedded Binary Data </i></p> <div class="exampleInner"><pre> *************** *** 2608,2612 **** <div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="example-MTOM-soap-binding"></a><i><span>Example 4-12. </span>Specifying MTOM in a WSDL 2.0 Binding</i></p> <div class="exampleInner"><pre> --- 2608,2612 ---- <div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="example-MTOM-soap-binding"></a><i><span>Example 4-12. </span>Specifying MTOM in a WSDL 2.0 Binding</i></p> <div class="exampleInner"><pre> *************** *** 2743,2747 **** for schema versioning as a part of the Schema 1.1 activity. See XML Schema Versioning Use Cases [<cite><a href="#xsd-versioning">XML Schema: Versioning Use-Cases</a></cite>].</p></li><li><p>The <a href="http://www.w3.org/2001/sw/BestPractices/">Semantic Web Best Practices and Deployments Working Group</a> is examining how vocabularies may evolve. See [<cite><a href="#sw-vocabulary">SW VocabManagementNote</a></cite>]</p></li></ul> ! <table border="1" summary="Editorial note: PaulD"><tr><td align="left" valign="top" width="50%"><b>Editorial note: PaulD</b></td><td align="right" valign="top" width="50%">20050706</td></tr><tr><td colspan="2" align="left" valign="top">This section may be subject to change dependent upon the outcome of the WSDL Last Call Issue LC124, which discusses support compatible evolution of messages described using XML Schema 1.0.</td></tr></table> <p>While incomplete, these activities all agree in one important --- 2743,2747 ---- for schema versioning as a part of the Schema 1.1 activity. See XML Schema Versioning Use Cases [<cite><a href="#xsd-versioning">XML Schema: Versioning Use-Cases</a></cite>].</p></li><li><p>The <a href="http://www.w3.org/2001/sw/BestPractices/">Semantic Web Best Practices and Deployments Working Group</a> is examining how vocabularies may evolve. See [<cite><a href="#sw-vocabulary">SW VocabManagementNote</a></cite>]</p></li></ul> ! <table border="1" summary="Editorial note: PaulD"><tr><td width="50%" valign="top" align="left"><b>Editorial note: PaulD</b></td><td width="50%" valign="top" align="right">20050706</td></tr><tr><td valign="top" align="left" colspan="2">This section may be subject to change dependent upon the outcome of the WSDL Last Call Issue LC124, which discusses support compatible evolution of messages described using XML Schema 1.0.</td></tr></table> <p>While incomplete, these activities all agree in one important *************** *** 2839,2843 **** <div class="div4"> ! <h5><a name="N70207"></a>5.2.5.1 Additional Optional Elements Added in Content</h5> <p> The following example demonstrates how content may be extended with additional content. The reservation service is changed to a newer version that can accept an optional --- 2839,2843 ---- <div class="div4"> ! <h5><a name="N1123F"></a>5.2.5.1 Additional Optional Elements Added in Content</h5> <p> The following example demonstrates how content may be extended with additional content. The reservation service is changed to a newer version that can accept an optional *************** *** 2846,2850 **** into the schema as an optional element. </p> <div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="example-versioning-additional-elements"></a><i><span>Example 5-1. </span>XML Schema with Optional Elements</i></p> <div class="exampleInner"><pre> <xs:complexType name="tCheckAvailability"> --- 2846,2850 ---- into the schema as an optional element. </p> <div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="example-versioning-additional-elements"></a><i><span>Example 5-1. </span>XML Schema with Optional Elements</i></p> <div class="exampleInner"><pre> <xs:complexType name="tCheckAvailability"> *************** *** 2868,2872 **** <div class="div4"> ! <h5><a name="N70230"></a>5.2.5.2 Additional Optional Elements Added to a Header</h5> <p> Another option is to add the extension as a header block. This is accomplished by defining an element for the extension and adding a --- 2868,2872 ---- <div class="div4"> ! <h5><a name="N11256"></a>5.2.5.2 Additional Optional Elements Added to a Header</h5> <p> Another option is to add the extension as a header block. This is accomplished by defining an element for the extension and adding a *************** *** 2874,2878 **** child of the input. </p> <div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="example-versioning-additional-header-elements"></a><i><span>Example 5-2. </span>Additional optional elements added to a SOAP header</i></p> <div class="exampleInner"><pre> <xs:element name="NumberOfGuests" type="tNumberOfGuests"/> --- 2874,2878 ---- child of the input. </p> <div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="example-versioning-additional-header-elements"></a><i><span>Example 5-2. </span>Additional optional elements added to a SOAP header</i></p> <div class="exampleInner"><pre> <xs:element name="NumberOfGuests" type="tNumberOfGuests"/> *************** *** 2903,2907 **** <div class="div4"> ! <h5><a name="N70253"></a>5.2.5.3 Additional Mandatory Elements in Content</h5> <p> This following example demonstrates an extension with additional content. The reservation service requires a number of guests parameter. --- 2903,2907 ---- <div class="div4"> ! <h5><a name="N1126D"></a>5.2.5.3 Additional Mandatory Elements in Content</h5> <p> This following example demonstrates an extension with additional content. The reservation service requires a number of guests parameter. *************** *** 2910,2914 **** element.</p> <div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="example-versioning-additional-mandatory-elements"></a><i><span>Example 5-3. </span>Additional Mandatory Elements in Content</i></p> <div class="exampleInner"><pre> <xs:complexType name="tCheckAvailabilityV2"> --- 2910,2914 ---- element.</p> <div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="example-versioning-additional-mandatory-elements"></a><i><span>Example 5-3. </span>Additional Mandatory Elements in Content</i></p> <div class="exampleInner"><pre> <xs:complexType name="tCheckAvailabilityV2"> *************** *** 2931,2935 **** <div class="div4"> ! <h5><a name="N70276"></a>5.2.5.4 Additional Optional Operation Added to Interface</h5> <p> Section <a href="#more-interfaces-inheritance"><b>2.4.2 Interface Inheritance</b></a> shows another type of versioning or extension, where the reservationInterface extends the --- 2931,2935 ---- <div class="div4"> ! <h5><a name="N11284"></a>5.2.5.4 Additional Optional Operation Added to Interface</h5> <p> Section <a href="#more-interfaces-inheritance"><b>2.4.2 Interface Inheritance</b></a> shows another type of versioning or extension, where the reservationInterface extends the *************** *** 2940,2944 **** <div class="div4"> ! <h5><a name="N70288"></a>5.2.5.5 Additional Mandatory Operation Added to Interface</h5> <p> Often mandatory operations are added to an interface. The Hotel service decides to add an operation to the reservation service which is a --- 2940,2944 ---- <div class="div4"> ! <h5><a name="N11290"></a>5.2.5.5 Additional Mandatory Operation Added to Interface</h5> <p> Often mandatory operations are added to an interface. The Hotel service decides to add an operation to the reservation service which is a *************** *** 2949,2953 **** inheritance for defining the extension.</p> <div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="example-versioning-additional-mandatory-operation"></a><i><span>Example 5-4. </span>Additional Mandatory Operation Added to the Interface</i></p> <div class="exampleInner"><pre> <interface name="reservationWithConfirmation" extends="cc:creditCardFaults"> --- 2949,2953 ---- inheritance for defining the extension.</p> <div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="example-versioning-additional-mandatory-operation"></a><i><span>Example 5-4. </span>Additional Mandatory Operation Added to the Interface</i></p> <div class="exampleInner"><pre> <interface name="reservationWithConfirmation" extends="cc:creditCardFaults"> *************** *** 2983,2987 **** <div class="div4"> ! <h5><a name="N70314"></a>5.2.5.6 Indicating Incompatibility by Changing the Endpoint URI</h5> <p> To indicate incompatibility, the URI of the Hotel Endpoint can be changed and messages send to the old Endpoint return a Fault.</p> --- 2983,2987 ---- <div class="div4"> ! <h5><a name="N112AA"></a>5.2.5.6 Indicating Incompatibility by Changing the Endpoint URI</h5> <p> To indicate incompatibility, the URI of the Hotel Endpoint can be changed and messages send to the old Endpoint return a Fault.</p> *************** *** 2989,2997 **** <div class="div4"> ! <h5><a name="N70323"></a>5.2.5.7 Indicating Incompatibility by Changing the SOAP Action</h5> <p> The SOAP Action can be set for the makeReservation request, and making it different than the earlier version should indicate incompatibility.</p> <div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="example-versioning-SOAP-Action"></a><i><span>Example 5-5. </span>Indicating Incompatibility by changing the SOAP Action</i></p> <div class="exampleInner"><pre> <binding name="reservationSOAPBinding" --- 2989,2997 ---- <div class="div4"> ! <h5><a name="N112B3"></a>5.2.5.7 Indicating Incompatibility by Changing the SOAP Action</h5> <p> The SOAP Action can be set for the makeReservation request, and making it different than the earlier version should indicate incompatibility.</p> <div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="example-versioning-SOAP-Action"></a><i><span>Example 5-5. </span>Indicating Incompatibility by changing the SOAP Action</i></p> <div class="exampleInner"><pre> <binding name="reservationSOAPBinding" *************** *** 3010,3014 **** <div class="div4"> ! <h5><a name="N70346"></a>5.2.5.8 Indicating Incompatibility by Changing the Element Content</h5> <p> The namespace or name of the makeReservation element can be changed, and then the interface and bindings changed. To indicate incompatibility, --- 3010,3014 ---- <div class="div4"> ! <h5><a name="N112CA"></a>5.2.5.8 Indicating Incompatibility by Changing the Element Content</h5> <p> The namespace or name of the makeReservation element can be changed, and then the interface and bindings changed. To indicate incompatibility, *************** *** 3016,3020 **** fault. The new interface, with a changed makeReservation, is:</p> <div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="example-versioning-changing-element-content"></a><i><span>Example 5-6. </span>Indicating incompatibility by changing the element content</i></p> <div class="exampleInner"><pre> <xs:element name="ghns2:makeReservation" type="ghns:tmakeReservation"/> --- 3016,3020 ---- fault. The new interface, with a changed makeReservation, is:</p> <div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="example-versioning-changing-element-content"></a><i><span>Example 5-6. </span>Indicating incompatibility by changing the element content</i></p> <div class="exampleInner"><pre> <xs:element name="ghns2:makeReservation" type="ghns:tmakeReservation"/> *************** *** 3110,3114 **** <div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="reservationDetails-OMX736.xml"></a><i><span>Example 5-7. </span>Detail for Reservation OMX736</i></p> <div class="exampleInner"><pre><?xml version="1.0" encoding="UTF-8"?> <reservationDetails --- 3110,3114 ---- <div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="reservationDetails-OMX736.xml"></a><i><span>Example 5-7. </span>Detail for Reservation OMX736</i></p> <div class="exampleInner"><pre><?xml version="1.0" encoding="UTF-8"?> <reservationDetails *************** *** 3139,3143 **** <div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="reservationDetails.wsdl"></a><i><span>Example 5-8. </span> The Reservation Details Web Service Description: reservationDetails.wsdl --- 3139,3143 ---- <div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="reservationDetails.wsdl"></a><i><span>Example 5-8. </span> The Reservation Details Web Service Description: reservationDetails.wsdl *************** *** 3210,3214 **** <div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="reservationDetails.xsd"></a><i><span>Example 5-9. </span> The Reservation Details Web Service XML Schema: reservationDetails.xsd --- 3210,3214 ---- <div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="reservationDetails.xsd"></a><i><span>Example 5-9. </span> The Reservation Details Web Service XML Schema: reservationDetails.xsd *************** *** 3321,3325 **** </p> <div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="reservationList-all.xml"></a><i><span>Example 5-10. </span> Response from the Reservation List Web Service </i></p> --- 3321,3325 ---- </p> <div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="reservationList-all.xml"></a><i><span>Example 5-10. </span> Response from the Reservation List Web Service </i></p> *************** *** 3380,3384 **** <div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="reservationList.wsdl"></a><i><span>Example 5-11. </span> The Reservation List Web Service Description: reservationList.wsdl --- 3380,3384 ---- <div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="reservationList.wsdl"></a><i><span>Example 5-11. </span> The Reservation List Web Service Description: reservationList.wsdl *************** *** 3475,3479 **** </p> <div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="reservationList.xsd"></a><i><span>Example 5-12. </span> The Reservation List Schema: reservationList.xsd </i></p> --- 3475,3479 ---- </p> <div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="reservationList.xsd"></a><i><span>Example 5-12. </span> The Reservation List Schema: reservationList.xsd </i></p> *************** *** 3561,3565 **** <div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="reservationServiceReferences-HSG635.xml"></a><i><span>Example 5-13. </span> A Reference to the Reservation Details Web Service </i></p> --- 3561,3565 ---- <div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="reservationServiceReferences-HSG635.xml"></a><i><span>Example 5-13. </span> A Reference to the Reservation Details Web Service </i></p> *************** *** 3606,3610 **** </p> <div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="reservationDetails_HTTP_example"></a><i><span>Example 5-14. </span> Reservation Details Web Service Using HTTP Transfer </i></p> --- 3606,3610 ---- </p> <div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="reservationDetails_HTTP_example"></a><i><span>Example 5-14. </span> Reservation Details Web Service Using HTTP Transfer </i></p> *************** *** 3649,3653 **** </p> <div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="example_reservationList_HTTP_GET"></a><i><span>Example 5-15. </span>Reservation List Web Service Using HTTP GET</i></p> <div class="exampleInner"><pre>. . . <binding name="reservationListHTTPBinding" --- 3649,3653 ---- </p> <div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="example_reservationList_HTTP_GET"></a><i><span>Example 5-15. </span>Reservation List Web Service Using HTTP GET</i></p> <div class="exampleInner"><pre>. . . <binding name="reservationListHTTPBinding" *************** *** 3693,3697 **** </p> <div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="example_reservationList_HTTP_GET_single"></a><i><span>Example 5-16. </span>Query Sequence Using a Single Query Type</i></p> <div class="exampleInner"><pre><element name="reservationQuery"> <annotation> --- 3693,3697 ---- </p> <div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="example_reservationList_HTTP_GET_single"></a><i><span>Example 5-16. </span>Query Sequence Using a Single Query Type</i></p> <div class="exampleInner"><pre><element name="reservationQuery"> <annotation> *************** *** 3717,3721 **** </p> <div class="exampleOuter"> ! <p style="text-align: left" class="exampleHead"><a name="example_reservationList_HTTP_GET_single_wsdl"></a><i><span>Example 5-17. </span>WSDL 2.0 for Using a Single Query Type</i></p> <div class="exampleInner"><pre>. . . <interface name="reservationListInterfaceWithQuery"> --- 3717,3721 ---- </p> <div class="exampleOuter"> ! <p class="exampleHead" style="text-align: left"><a name="example_reservationList_HTTP_GET_single_wsdl"></a><i><span>Example 5-17. </span>WSDL 2.0 for Using a Single Query Type</i></p> <div class="exampleInner"><pre>. . . <interface name="reservationListInterfaceWithQuery"> *************** *** 3783,3787 **** <h3><a name="adv-rdf-mapping"></a>5.5 Mapping to RDF and Semantic Web</h3> ! <table border="1" summary="Editorial note: KevinL"><tr><td align="left" valign="top" width="50%"><b>Editorial note: KevinL</b></td><td align="right" valign="top" width="50%">20050429</td></tr><tr><td colspan="2" align="left" valign="top"> This section might be removed - pending on the availability of the RDF mapping note. </td></tr></table> --- 3783,3787 ---- <h3><a name="adv-rdf-mapping"></a>5.5 Mapping to RDF and Semantic Web</h3> ! <table border="1" summary="Editorial note: KevinL"><tr><td width="50%" valign="top" align="left"><b>Editorial note: KevinL</b></td><td width="50%" valign="top" align="right">20050429</td></tr><tr><td valign="top" align="left" colspan="2"> This section might be removed - pending on the availability of the RDF mapping note. </td></tr></table> *************** *** 3822,3825 **** --- 3822,3826 ---- created according to @@Appendix C@@.</p></li><li><p>Further, things are represented as resources:<ol><li><p>Element declarations gathered from XML Schema (or similarly, other components from other type systems)</p></li><li><p>Message content models</p></li><li><p>Message exchange patterns (the URI identifying the MEP + is the URI of the resource)</p></li><li><p>Operation styles (similarly to MEPs, the URI of an operation style is the URI of the resource)</p></li></ol></p></li><li><p>All the resources above are given the appropriate types using
Received on Wednesday, 9 November 2005 01:20:39 UTC