[Bug 11698] New: Eventing: Format@Name is ambiguous

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

           Summary: Eventing: Format@Name is ambiguous
           Product: WS-Resource Access
           Version: PR
          Platform: PC
        OS/Version: Windows XP
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Eventing
        AssignedTo: public-ws-resource-access-notifications@w3.org
        ReportedBy: dug@us.ibm.com
         QAContact: public-ws-resource-access-notifications@w3.org


Format is defined as:
----
 <wse:Format Name="xs:anyURI"? > xs:any* </wse:Format> ?

[Body]/wse:Subscribe/wse:Format
    This OPTIONAL element contains the delivery format to be used for
notification messages sent in relation to this subscription. Implied value is
"http://www.w3.org/2002/ws/ra/edcopies/ws-evt/DeliveryFormats/Unwrap", which
indicates that unwrapped delivery MUST be used. See Section 2.3 Notification
Formats for details.

    If the event source does not support the requested delivery format, the
request MUST generate a wse:DeliveryFormatRequestedUnavailable fault indicating
that the requested delivery format is not supported. 
----

Notice that "Name" is optional.
While we say that the default value for "Format" is "Unwrap", we never really
say what the default value for @Name is. By this I mean, I read the above text
to say "If Format is missing then use Unwrap".  But what's missing is the
text that says "If Format is present, but @Name is missing, then use Unwrap".
While I think its implies, I think we should clear this up.

Proposals:
1 - remove the optionality of @Name. So, if you go thru the trouble of
    putting in a Format element, then you must also add a Name. 

2 - Modify the Format section to be:
[Body]/wse:Subscribe/wse:Format
    This OPTIONAL element contains the delivery format to be used for
notification messages sent in relation to this subscription. Implied value is
"http://www.w3.org/2002/ws/ra/edcopies/ws-evt/DeliveryFormats/Unwrap", which
indicates that unwrapped delivery MUST be used. See Section 2.3 Notification
Formats for details. 

[Body]/wse:Subscribe/wse:Format/@Name
    Implied value is
"http://www.w3.org/2002/ws/ra/edcopies/ws-evt/DeliveryFormat/Unwrap". 

    If the event source does not support the requested delivery format, the
request MUST generate a wse:DeliveryFormatRequestedUnavailable fault indicating
that the requested delivery format is not supported.
<< existing para, just moved from wse:Format section >>

I prefer option 2 as that will align it with other elements, like Filter.

-- 
Configure bugmail: http://www.w3.org/Bugs/Public/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.
You are the assignee for the bug.

Received on Saturday, 8 January 2011 12:37:31 UTC