[Bug 3752] Clarify restrictions of ID type usage

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

           Summary: Clarify restrictions of ID type usage
           Product: WS-Policy
           Version: PR
          Platform: Macintosh
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Framework
        AssignedTo: ritzmann@sun.com
        ReportedBy: ritzmann@sun.com
         QAContact: public-ws-policy-qa@w3.org


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 Tuesday, 19 September 2006 14:44:58 UTC