[Bug 3965] Clarify text surrounding PolicyReference and for usage of wsp:Name attribute

http://www.w3.org/Bugs/Public/show_bug.cgi?id=3965

           Summary: Clarify text surrounding PolicyReference and for usage
                    of wsp:Name attribute
           Product: WS-Policy
           Version: FPWD
          Platform: Macintosh
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Primer
        AssignedTo: fsasaki@w3.org
        ReportedBy: fabian.ritzmann@sun.com
         QAContact: public-ws-policy-qa@w3.org


Title
Clarify text surrounding PolicyReference and for usage of wsp:Name attribute

      Description
See Justification and Proposal

      Justification
The usage of wsu:Id is addressed in the Primer. However, more description is
needed for the use of the Name attribute, particularly to accommodate when
wsdl:import applies.  wsdl:import is used frequently in real WSDL documents and
should be covered when the Name attribute is discussed. Secondarily the
explanations of PolicyReference should be collected in one section.

      Target
Primer
Note: At some point, if Section 5.9.1 or the Guidelines is extended, the
Guidelines may be affected.

      Proposal
1.a
Move the entire block text in Section 3.2 to Section 2.8: "Just as other
service metadata languages, Web Services Policy does not mandate any specific
policy retrieval mechanism....If the referenced policy expression is in the
same XML document as the reference, then the policy expression should be
identified using the wsu:Id (XML ID) attribute and referenced using an IRI
reference to this XML ID value."

1.b
Add a reference to the end of section 3.2: "See section 2.8 for more details
how to reference policy expressions."

2.a
Section 3.2: "If the referenced policy expression is in the same XML document
as the reference, then the policy expression should be identified using the
wsu:Id (XML ID) attribute and referenced using an IRI reference to this XML ID
value."

Add:
"If the referenced policy expression is in another XML document as the
reference, the wsp:Name attribute is used to identify the policy expression.

WSDL 1.1 and 2.0 allow to import a WSDL document into another WSDL document
with the wsdl:import statement. While the importing and imported WSDL documents
may be regarded as one logical WSDL document altogether, they constitute
separate XML documents. Therefore, the rules for policy references between
separate XML documents apply if policies are referenced across documents that
use wsdl:import."

2.b
Change from:
"Use the referenced IRI and retrieve an existing policy expression from the
containing XML document: a policy element with an XML ID."

Change from:
"Use the referenced IRI and retrieve an existing policy expression from the
containing XML document: a policy element identified with an XML ID or Name
attribute."

=======
If needed, reference: WSDL v1.1 specification, Section 2.1.1 and 2.1.2.

Received on Thursday, 9 November 2006 02:31:40 UTC