W3C home > Mailing lists > Public > www-ws-desc@w3.org > January 2007

Re: Proposal for CR145

From: Jacek Kopecky <jacek.kopecky@deri.org>
Date: Tue, 30 Jan 2007 14:36:21 +0100
To: Roberto Chinnici <Roberto.Chinnici@Sun.COM>
Cc: www-ws-desc@w3.org
Message-Id: <1170164181.28268.139.camel@localhost>

Roberto, in the last four parts, I think it would be useful to clarify
what the "and only those" part means to exclude. Let me suggest a
template (the last sentence) for the first part, easily reproducible to
the others:


[[
All element declaration schema components in the imported namespace, and
only those, MUST be included in the {element declarations} property of
the Description component corresponding to the importing WSDL 2.0
document. In other words, no imported element declaration components
will be included.
]]

Also, I'm not sure if your proposal clarifies the handling of XML Schema
components from imported WSDL files:

wsdl1:
<wsdl:description>
  <wsdl:import namespace="wsdl2"/>
</wsdl:description>

wsdl2:
<wsdl:description>
  <wsdl:types>
    <xs:schema>
      <xs:element name="foo"/>
    </xs:schema>
  </wsdl:types>
  ...
</wsdl:description>

I believe that the element declaration for "foo" should be among
{element declarations} of wsdl1 because some WSDL components imported
from wsdl2 might use it.

Best regards,
Jacek

On Mon, 2007-01-29 at 18:52 -0800, Roberto Chinnici wrote:
> I had a standing action to offer a detailed proposal for CR145 [1], 
> which I hereby discharge.
> 
> In section 2.1.1 [2], change
> 
> [[
> The set of top-level components contained in the Description component 
> associated with an initial WSDL 2.0 document consists of the components 
> defined in the initial document and the components associated with the 
> documents that the initial document includes and the namespaces that the 
> initial document imports.
> ]]
> 
> to
> 
> [[
> The set of top-level components contained in the Description component 
> associated with an initial WSDL 2.0 document consists of the components 
> defined in the initial document, plus the components associated with the 
> WSDL 2.0 documents that the initial document includes, plus the 
> components defined by other WSDL 2.0 documents in the namespaces that 
> the initial document imports.
> ]]
> 
> Ahead of the last paragraph in the same section (the one starting with 
> "In addition to WSDL 2.0 components..."), add this sentence:
> 
> [[
> When using the XML Schema language to describe type system components, 
> the inclusion of Element Declaration components and Type Definition 
> components in a Description component is governed by the rules in "3.1 
> Using W3C XML Schema Description Language".
> ]]
> 
> Jointly, these changes clarify that inclusion of type system components 
> is governed by its own set of rules, to avoid confusion with the 
> differences in semantics between wsdl:import/wsdl:include and 
> xs:import/xs:include.
> 
> In section 3.1.1 [3], add the following statements at the end of the 
> first paragraph (i.e. after "Only components in the imported namespace 
> are referenceable in the WSDL 2.0 document."):
> 
> [[
> All element declaration schema components in the imported namespace, and 
> only those, MUST be included in the {element declarations} property of 
> the Description component corresponding to the importing WSDL 2.0 document.
> 
> All type definition schema components in the imported namespace, and 
> only those, MUST be included in the {type definitions} property of the 
> Description component corresponding to the importing WSDL 2.0 document.
> ]]
> 
> In section 3.1.2 [4], add the following statements before the paragraph 
> which starts with "Note that components defined in an inlined XML schema":
> 
> [[
> All element declaration schema components in the target namespace of the 
> inlined schema document, and only those, MUST be included in the 
> {element declarations} property of the Description component 
> corresponding to the enclosing WSDL 2.0 document.
> 
> All type definition schema components in the target namespace of the 
> inlined schema document, and only those, MUST be included in the {type 
> definitions} property of the Description component corresponding to the 
> enclosing WSDL 2.0 document.
> ]]
> 
> [1] http://www.w3.org/2002/ws/desc/5/cr-issues/#CR145
> [2] 
> http://dev.w3.org/cvsweb/~checkout~/2002/ws/desc/wsdl20/wsdl20.html?content-type=text/html;%20charset=utf-8#Description_details
> [3] 
> http://dev.w3.org/cvsweb/~checkout~/2002/ws/desc/wsdl20/wsdl20.html?content-type=text/html;%20charset=utf-8#import-xsd
> [4] 
> http://dev.w3.org/cvsweb/~checkout~/2002/ws/desc/wsdl20/wsdl20.html?content-type=text/html;%20charset=utf-8#inlining-xsd
> 
> Thanks,
> Roberto
> 
Received on Tuesday, 30 January 2007 13:36:31 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Monday, 7 December 2009 10:58:45 GMT