RE: NEW ISSUE 3752: Clarify restrictions of ID type usage

This looks reasonable to me.  I propose that we assign this one over to the editors.

Daniel Roth

-----Original Message-----
From: public-ws-policy-request@w3.org [mailto:public-ws-policy-request@w3.org] On Behalf Of Fabian Ritzmann
Sent: Tuesday, September 19, 2006 7:48 AM
To: public-ws-policy@w3.org
Subject: NEW ISSUE 3752: Clarify restrictions of ID type usage


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

Title

Clarify restrictions of ID type usage


Description

With issue 3560 we added a new xml:id to the Policy element:
"/wsp:Policy/(@wsu:Id | @xml:id)"

Both wsu:Id and xml:id are assigned the ID type and must meet its
constraints.


Justification

It is not obvious to developers that are not intimately familiar with
XML what
the constraints of the ID type are and that they need to take it into
account.
A normative reference would be helpful.


Target

Web Services Policy Framework, section 2.1


Proposal

Extend this text in section 4.2:

/wsp:Policy/(@wsu:Id | @xml:id)

     The identity of the policy expression as an ID within the enclosing
XML document. If omitted, there is no implied value. To refer to this
policy expression, an IRI-reference MAY be formed using this value per
Section 4.2 of WS-Security [WS-Security 2004] when @wsu:Id is used.

with:

/wsp:Policy/(@wsu:Id | @xml:id)

     The identity of the policy expression as an ID within the enclosing
XML document. If omitted, there is no implied value.
The constraints of the [XML 1.0] ID type MUST be met.
To refer to this policy expression, an IRI-reference MAY be formed using
this value per Section 4.2 of WS-Security [WS-Security 2004] when
@wsu:Id is used.

Received on Friday, 22 September 2006 23:28:57 UTC