ws-policy 12/20/2006: Updated Issue and Proposal - Issue 4069

http://www.w3.org/Bugs/Public/show_bug.cgi?id=4069 (Original issue)

UPDATED ISSUE AND PROPOSAL
Note, the updated proposal only specifies changes in the Primer. This 
has also been updated in the issue at link above.

=============
Title: Updating References for Use of xml:id
Target: Primer [1]
Description and Justification:
Issue #3752 and #3560 [2] introduced and clarified the use of xml:id. 
Currently, no example using xml:id exists in any WG document, with only 
the reference in Framework, Section 4.2 Policy Identification. The use 
of xml:id could be clarified and properly constrained in the Primer 
document.  With the addition of xml:id, its use can be described there, 
and account for constraints and warnings. Any changes should taken into 
consideration expressed WG concerns raised in the resolution of #3560. [2]

Proposal:
Section 2.8 Referencing Policy Expressions

a. Change from:

    A policy expression may be identified by an IRI and referenced for
    re-use as a standalone policy or within another policy expression.
    There are two mechanisms to identify a policy expression: the wsu:Id
    and Name attributes. A PolicyReference element can be used to
    reference a policy expression identified using either of these
    mechanisms.


Change to:

    A policy expression may be identified by an IRI and referenced for
    re-use as a standalone policy or within another policy expression.
    There are three mechanisms to identify a policy expression: the
    wsu:Id, xml:id and Name attributes. A PolicyReference element can be
    used to reference a policy expression identified using either of
    these mechanisms.

b. Change from:

    See Example 2-12

Change to:
[Add new paragraph and example under Example 2-12 at the end of the 
sentence: "...|(|The absolute IRI is formed by combining the document 
IRI, |#| and the value of the |wsu:Id| attribute.)"]

    In addition in Example 2-12, Contoso could have used either the
    xml:id or wsu:Id. An example of the use of xml:id similar to that of
    wsu:Id is shown in Example 2-13.

       <Policy xml:id="common">
        <mtom:OptimizedMimeSerialization wsp:Optional="true"/>
        <wsap:UsingAddressing />
       </Policy>

    Conditions and constraints on the use of the |xml:id| attribute in
    conjunction with Canonical XML 1.0 are specified in Appendix C of
    xml:id Version 1.0 [XML ID
    <http://dev.w3.org/cvsweb/%7Echeckout%7E/2006/ws/policy/ws-policy-framework.html?content-type=text/html;%20charset=utf-8#XMLID>]
    and are further detailed in [C14N 1.0 Note
    <http://dev.w3.org/cvsweb/%7Echeckout%7E/2006/ws/policy/ws-policy-framework.html?content-type=text/html;%20charset=utf-8#C14NNOTE>].
    Significant care is suggested in the use of xml:id.

[Note: This new example would necessitate the renumbering of current 
Examples 2-13 to 2-16 in Section 2.8 to 2-14 to 2-17. There are no 
changes to any other examples in this section or the text other that 
specified above.]

Section 3.2 Normal Form for Policy Expressions (now Section 3.6)
Change from:

    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.

Change to:

    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 (XML ID) attribute and referenced using an IRI
    reference to this XML ID value.

Reason: This is really clean up from Issue 3752, 
http://www.w3.org/Bugs/Public/show_bug.cgi?id=3752. This is also 
consistent with text in Section 4.3.4 Policy References in the Framework 
("This attribute references a policy expression by an IRI. For a policy 
expression within the same XML Document, the reference
SHOULD be an IRI-reference to a policy expression identified by an |ID|.").

[Note: As Issue 3965 was accepted, this text would be updated in new 
Section 3.6, Primer.]

Guidelines Document
No changes are proposed for Guidelines, Section 5.1 although they may be 
considered in the future.

References:
[1] Primer
http://dev.w3.org/cvsweb/~checkout~/2006/ws/policy/ws-policy-primer.html?content-type=text/html;%20charset=utf-8#Referencing_Policy_Expressions
[2] Issues list: http://www.w3.org/Bugs/Public/show_bug.cgi?id=3752, 
http://www.w3.org/Bugs/Public/show_bug.cgi?id=3560

Received on Wednesday, 20 December 2006 22:35:39 UTC