This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 11698 - Eventing: Format@Name is ambiguous
Summary: Eventing: Format@Name is ambiguous
Status: CLOSED REMIND
Alias: None
Product: WS-Resource Access
Classification: Unclassified
Component: Eventing (show other bugs)
Version: CR
Hardware: PC Windows XP
: P2 normal
Target Milestone: ---
Assignee: notifications mailing list for WS Resource Access
QA Contact: notifications mailing list for WS Resource Access
URL:
Whiteboard:
Keywords: hasProposal
Depends on:
Blocks:
 
Reported: 2011-01-08 12:37 UTC by Doug Davis
Modified: 2011-09-13 21:27 UTC (History)
0 users

See Also:


Attachments

Description Doug Davis 2011-01-08 12:37:29 UTC
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.
Comment 1 Robert Freund 2011-01-25 20:52:30 UTC
option 2 does not require a schema change
Comment 2 Doug Davis 2011-02-01 21:27:36 UTC
to be clear - the formal proposal is #2
Comment 3 Doug Davis 2011-02-15 18:10:49 UTC
tweak it like:
This OPTIONAL element contains the delivery format to be used for notification messages sent in relation to this subscription. The absence of this element is equivalent to its presence with a @Name value of "http: . . "

per Gil's suggestion
Comment 4 Robert Freund 2011-02-15 18:12:04 UTC
resolved with option 2 plus comment 3