<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://www.w3.org/Bugs/Public/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.4"
          urlbase="https://www.w3.org/Bugs/Public/"
          
          maintainer="sysbot+bugzilla@w3.org"
>

    <bug>
          <bug_id>7486</bug_id>
          
          <creation_ts>2009-09-03 13:58:01 +0000</creation_ts>
          <short_desc>Transfer: clear up confusion around missing Put values</short_desc>
          <delta_ts>2009-12-09 09:43:07 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>WS-Resource Access</product>
          <component>Transfer</component>
          <version>FPWD</version>
          <rep_platform>PC</rep_platform>
          <op_sys>Windows XP</op_sys>
          <bug_status>CLOSED</bug_status>
          <resolution>REMIND</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords>hasProposal</keywords>
          <priority>P2</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>---</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Doug Davis">dug</reporter>
          <assigned_to name="Doug Davis">dug</assigned_to>
          
          
          <qa_contact name="notifications mailing list for WS Resource Access">public-ws-resource-access-notifications</qa_contact>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>26811</commentid>
    <comment_count>0</comment_count>
    <who name="Doug Davis">dug</who>
    <bug_when>2009-09-03 13:58:01 +0000</bug_when>
    <thetext>There&apos;s an ongoing discussion in WSMan about what to do during a
Put when there are optional properties of a resource.  Here&apos;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:
&quot;This specification defines one Web service operation (Put) for updating a resource by providing a replacement representation.&quot;
and
&quot;A Put request MUST be targeted at the resource whose representation is desired to be replaced, ...&quot;

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:
&quot;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.&quot;

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.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>27227</commentid>
    <comment_count>1</comment_count>
    <who name="Robert Freund">bob</who>
    <bug_when>2009-09-16 08:51:19 +0000</bug_when>
    <thetext>2009-09-15 proposal accepted</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>