W3C home > Mailing lists > Public > public-ws-policy@w3.org > December 2006

Re: New Issue 4069: Updating References for Use of xml:id

From: Monica J. Martin <Monica.Martin@Sun.COM>
Date: Tue, 12 Dec 2006 11:05:44 -0800
To: Asir Vedamuthu <asirveda@microsoft.com>
Cc: public-ws-policy@w3.org
Message-id: <457EFD88.4040801@sun.com>


>>mm1: ...Currently, no example using xml:id exists in the Framework and its use 
>>is missing in the Primer....
>>    
>>
>Asir Vedamuthu wrote: Hi Monica, My recollection is .. there is a reason why examples are missing. WG's
>plan of record on issue 3560 is:
>
>"RESOLUTION: 3560 closed with the proposal in Umit's proposal in
>http://lists.w3.org/Archives/Public/public-ws-policy/2006Jul/0099.html
>as amended by http://lists.w3.org/Archives/Public/public-ws-policy/2006Aug/0074.html
>and http://lists.w3.org/Archives/Public/public-ws-policy/2006Aug/0099.html" [1].
>
>The second amendment [2] is to remove the proposed example. 
>[1] http://www.w3.org/2006/08/16-ws-policy-minutes.html#item026 
>[2] http://lists.w3.org/Archives/Public/public-ws-policy/2006Aug/0099.html  
>  
>
mm2: Asir, the Framework document provides constraints on the use of 
xml:id to guide its use [a] so a brief example is beneficial and 
warranted.  A lesser option is a forward reference to the Primer and 
provide an example there. This is similar to the path taken for 
resolution of Issue 3965 [b].

Thanks.

[a] 
http://dev.w3.org/cvsweb/~checkout~/2006/ws/policy/ws-policy-framework.html?content-type=text/html;%20charset=utf-8#Policy_Identification
[b] http://www.w3.org/Bugs/Public/show_bug.cgi?id=3965

>-----Original Message-----
>From: public-ws-policy-request@w3.org
>[mailto:public-ws-policy-request@w3.org] On Behalf Of Monica J. Martin
>Sent: Monday, December 11, 2006 9:08 AM
>To: public-ws-policy@w3.org
>Subject: New Issue 4069: Updating References for Use of xml:id
>
>see: http://www.w3.org/Bugs/Public/show_bug.cgi?id=4069
>
>=============
>Title: Updating References for Use of xml:id
>Target: Primer, Framework
>Description and Justification:
>Issue #3752 and #3560 [1] introduced and clarified the use of xml:id. 
>However, a few more areas exist where xml:id is available for use. This 
>should be clarified in the Framework and Primer documents. Currently, no
>
>example using xml:id exists in the Framework and its use is missing in 
>the Primer. With the addition of xml:id, its use should be described and
>
>exemplified.
>
>Proposal:
>1. Framework, Section 4.2 Policy Identification
>[amend to end of this section]
>
>The following example illustrates how to associate a policy expression 
>with the IRI-reference |"#P1"| using xml:id:
>
>  (01) <wsp:Policy
>         xml:id="P1"
>         xmlns:wsp="http://www.w3.org/@@@@/@@/ws-policy"
>         xmlns:xml="|http://www.w3.org/XML/1998/namespace|" >
>  (02)   <!-- Details omitted for readability -->
>  (03) </wsp:Policy>
>
>2. Primer
>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: Example 2-14
>
>Change to:
>[new paragraph under Example 2-14]
>In the examples 2-12, 2-13, and 2-14 Contoso could have used either the 
>xml:id or wsu:Id.
>
>Note: There are no changes to Example 2-14 or the existing paragraph 
>that follows: The |Name| attribute is an alternate mechanism to identify
>
>a policy expression....
>
>Section 3.2 Normal Form for Policy Expressions (now Section 3.6)
>[Note: As Issue 3965 was accepted, this text would be updated in new 
>Section 3.6, Primer.]
>
>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: No changes are proposed for Guidelines, Section 5.1 although they 
>may be considered in the future.
>
>References:
>[1] Issues list: http://www.w3.org/Bugs/Public/show_bug.cgi?id=3752, 
>http://www.w3.org/Bugs/Public/show_bug.cgi?id=3560
>[2] Primer, Framework (5 December 2006)
>http://dev.w3.org/cvsweb/~checkout~/2006/ws/policy/ws-policy-framework.h
>tml?content-type=text/html;%20charset=utf-8 
>
>http://dev.w3.org/cvsweb/~checkout~/2006/ws/policy/ws-policy-primer.html
>?content-type=text/html;%20charset=utf-8 
>
>
>
>
>
>  
>
Received on Tuesday, 12 December 2006 19:06:01 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 8 January 2008 14:20:43 GMT