11698 2011-01-08 12:37:29 +0000 Eventing: Format@Name is ambiguous 2011-09-13 21:27:25 +0000 1 1 1 Unclassified WS-Resource Access Eventing CR PC Windows XP CLOSED REMIND hasProposal P2 normal --- 1 dug public-ws-resource-access-notifications public-ws-resource-access-notifications oldest_to_newest 43941 0 dug 2011-01-08 12:37:29 +0000 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. 44727 1 bob 2011-01-25 20:52:30 +0000 option 2 does not require a schema change 44991 2 dug 2011-02-01 21:27:36 +0000 to be clear - the formal proposal is #2 45616 3 dug 2011-02-15 18:10:49 +0000 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 45617 4 bob 2011-02-15 18:12:04 +0000 resolved with option 2 plus comment 3