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 7486 - Transfer: clear up confusion around missing Put values
Summary: Transfer: clear up confusion around missing Put values
Status: CLOSED REMIND
Alias: None
Product: WS-Resource Access
Classification: Unclassified
Component: Transfer (show other bugs)
Version: FPWD
Hardware: PC Windows XP
: P2 normal
Target Milestone: ---
Assignee: Doug Davis
QA Contact: notifications mailing list for WS Resource Access
URL:
Whiteboard:
Keywords: hasProposal
Depends on:
Blocks:
 
Reported: 2009-09-03 13:58 UTC by Doug Davis
Modified: 2009-12-09 09:43 UTC (History)
0 users

See Also:


Attachments

Description Doug Davis 2009-09-03 13:58:01 UTC
There's an ongoing discussion in WSMan about what to do during a
Put when there are optional properties of a resource.  Here's the
scenario:
- do a T.Create() that includes some optional (minOccurs=0) elements in the XML.
- do a T.Put() but this time do not include those optional elements.

Question: are those optional elements reset to their default values (eg. null)
or do they retain the values specified during the t.Create()?

The Transfer spec currently says things like:
"This specification defines one Web service operation (Put) for updating a resource by providing a replacement representation."
and
"A Put request MUST be targeted at the resource whose representation is desired to be replaced, ..."

These, to me, seem to push for a total replacement - meaning the values
would go back to their defaults.

The WSMan spec added some text that reinforces this notion:
"To delete individual property values within an object that, itself, is not to be deleted, either the client can perform a Put operation with those properties removed, or the service can support fragment-level access."

The Transfer spec itself should make this clear by being more explicit about it.

Proposal:
To the end of the first paragraph of the Put section, add the following text:

This operation will replace the entire XML representation of the resource. Any optional values (elements or attributes) not specified in the Put request message will be set to some resource specific default value.
Comment 1 Robert Freund 2009-09-16 08:51:19 UTC
2009-09-15 proposal accepted