- From: Doug Davis via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 10 Jun 2009 22:51:02 +0000
- To: public-ws-resource-access-notifications@w3.org
Update of /w3ccvs/WWW/2002/ws/ra/edcopies
In directory hutz:/tmp/cvs-serv10724
Modified Files:
wst.html wst.xml
Log Message:
6712
Index: wst.xml
===================================================================
RCS file: /w3ccvs/WWW/2002/ws/ra/edcopies/wst.xml,v
retrieving revision 1.37
retrieving revision 1.38
diff -u -d -r1.37 -r1.38
--- wst.xml 27 May 2009 22:36:17 -0000 1.37
+++ wst.xml 10 Jun 2009 22:51:00 -0000 1.38
@@ -899,7 +899,7 @@
http://www.w3.org/2009/02/ws-tra/Create
<kw>[Body]</kw>
- <wst:Create ...>
+ <wst:Create ContentDesrciption="<emph>xs:any</emph>"? ...>
<emph>xs:any</emph>*
</wst:Create></eg>
</example>
@@ -924,6 +924,24 @@
</p>
</def>
</gitem>
+
+ <gitem>
+ <label> <kw>[Body]</kw>/wst:Create@ContentDescription </label>
+ <def>
+ <p>
+ When this OPTIONAL attribute is present it conveys additional
+ information that can be used by the service to process this
+ message. If the service can determine how to process the
+ message it MAY choose to ignore this attribute, even if the
+ URI provided is not known. However, if the service needs this
+ information, for example to determine if the child elements
+ of the wst:Create are the literal resource representation or
+ an instruction, but the attribute is not present or the URI
+ is not known, then the service MUST generate an
+ invalidContentDescription fault. There is no default value.
+ </p>
+ </def>
+ </gitem>
</glist>
<p>A Create request MUST be targeted at a resource factory capable of
@@ -1091,6 +1109,7 @@
<example>
<eg><loc href="http://www.w3.org/2009/02/ws-tra/fault">http://www.w3.org/2009/02/ws-tra/fault</loc></eg>
</example>
+
<div2 id="InvalidRepresentation">
<head>InvalidRepresentation</head>
<p>This fault is returned when an incorrect representation is sent in a
@@ -1116,6 +1135,38 @@
</tbody>
</table>
</div2>
+
+ <div2 id="InvalidContentDescription">
+ <head>InvalidContentDescription</head>
+ <p>
+ This fault is generated when a service requires a ContentDescription
+ URI be included on the Create request to process the message, or
+ the specified URI is not known.
+ </p>
+ <table id="Table3" border="1" cellpadding="5">
+ <tbody>
+ <tr>
+ <th align="left"><kw>[Code]</kw></th>
+ <td>s:Sender</td>
+ </tr>
+ <tr>
+ <th align="left"><kw>[Subcode]</kw></th>
+ <td>wst:InvalidContentDescription</td>
+ </tr>
+ <tr>
+ <th align="left"><kw>[Reason]</kw></th>
+ <td>
+ The service requires a ContentDescription URI, or the
+ value specified is not known
+ </td>
+ </tr>
+ <tr>
+ <th align="left"><kw>[Detail]</kw></th>
+ <td><emph>The unknown URI if specified</emph></td>
+ </tr>
+ </tbody>
+ </table>
+ </div2>
</div1>
<div1 id="Security_Considerations">
<head>Security Considerations</head>
@@ -1662,6 +1713,13 @@
<loc href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6906">6906</loc>
</td>
</tr>
+ <tr>
+ <td> 2009/06/10 </td>
+ <td> DD </td>
+ <td> Added resolution of issue
+ <loc href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6712">6712</loc>
+ </td>
+ </tr>
</tbody>
</table>
</div1>
Index: wst.html
===================================================================
RCS file: /w3ccvs/WWW/2002/ws/ra/edcopies/wst.html,v
retrieving revision 1.41
retrieving revision 1.42
diff -u -d -r1.41 -r1.42
--- wst.html 27 May 2009 22:36:17 -0000 1.41
+++ wst.html 10 Jun 2009 22:51:00 -0000 1.42
@@ -54,6 +54,7 @@
4.1 <a href="#Factory_Create">Create</a><br/>
5 <a href="#Faults">Faults</a><br/>
5.1 <a href="#InvalidRepresentation">InvalidRepresentation</a><br/>
+ 5.2 <a href="#InvalidContentDescription">InvalidContentDescription</a><br/>
6 <a href="#Security_Considerations">Security Considerations</a><br/>
7 <a href="#acks">Acknowledgements</a><br/>
8 <a href="#refs">References</a><br/>
@@ -523,7 +524,7 @@
http://www.w3.org/2009/02/ws-tra/Create
<b>[Body]</b>
- <wst:Create ...>
+ <wst:Create ContentDesrciption="<em>xs:any</em>"? ...>
<em>xs:any</em>*
</wst:Create></pre></div></div><p>
The following describes additional, normative constraints on the
@@ -537,6 +538,17 @@
resource, or other instructions for creating the resource.
Additional extension elements MAY be included only after
the mandated first child element.
+ </p></dd><dt class="label"><b>[Body]</b>/wst:Create@ContentDescription </dt><dd><p>
+ When this OPTIONAL attribute is present it conveys additional
+ information that can be used by the service to process this
+ message. If the service can determine how to process the
+ message it MAY choose to ignore this attribute, even if the
+ URI provided is not known. However, if the service needs this
+ information, for example to determine if the child elements
+ of the wst:Create are the literal resource representation or
+ an instruction, but the attribute is not present or the URI
+ is not known, then the service MUST generate an
+ invalidContentDescription fault. There is no default value.
</p></dd></dl><p>A Create request MUST be targeted at a resource factory capable of
creating the desired new resource. This factory is distinct from the resource
being created (which by definition does not exist prior to the successful
@@ -658,7 +670,15 @@
The <b>[action]</b> property below SHOULD be used for faults
defined in this specification:</p><div class="exampleOuter"><div class="exampleInner"><pre><a href="http://www.w3.org/2009/02/ws-tra/fault">http://www.w3.org/2009/02/ws-tra/fault</a></pre></div></div><div class="div2">
<h3><a name="InvalidRepresentation" id="InvalidRepresentation"/>5.1 InvalidRepresentation</h3><p>This fault is returned when an incorrect representation is sent in a
- wst:Put or wst:Create message. </p><a name="Table2" id="Table2"/><table border="1" cellpadding="5"><tbody><tr><th align="left"><b>[Code]</b></th><td>s:Sender</td></tr><tr><th align="left"><b>[Subcode]</b></th><td>wst:InvalidRepresentation</td></tr><tr><th align="left"><b>[Reason]</b></th><td>The supplied representation is invalid</td></tr><tr><th align="left"><b>[Detail]</b></th><td>none</td></tr></tbody></table></div></div><div class="div1">
+ wst:Put or wst:Create message. </p><a name="Table2" id="Table2"/><table border="1" cellpadding="5"><tbody><tr><th align="left"><b>[Code]</b></th><td>s:Sender</td></tr><tr><th align="left"><b>[Subcode]</b></th><td>wst:InvalidRepresentation</td></tr><tr><th align="left"><b>[Reason]</b></th><td>The supplied representation is invalid</td></tr><tr><th align="left"><b>[Detail]</b></th><td>none</td></tr></tbody></table></div><div class="div2">
+<h3><a name="InvalidContentDescription" id="InvalidContentDescription"/>5.2 InvalidContentDescription</h3><p>
+ This fault is generated when a service requires a ContentDescription
+ URI be included on the Create request to process the message, or
+ the specified URI is not known.
+ </p><a name="Table3" id="Table3"/><table border="1" cellpadding="5"><tbody><tr><th align="left"><b>[Code]</b></th><td>s:Sender</td></tr><tr><th align="left"><b>[Subcode]</b></th><td>wst:InvalidContentDescription</td></tr><tr><th align="left"><b>[Reason]</b></th><td>
+ The service requires a ContentDescription URI, or the
+ value specified is not known
+ </td></tr><tr><th align="left"><b>[Detail]</b></th><td><em>The unknown URI if specified</em></td></tr></tbody></table></div></div><div class="div1">
<h2><a name="Security_Considerations" id="Security_Considerations"/>6 Security Considerations</h2><p>It is strongly recommended that the communication between services be
secured using the mechanisms described in <a href="#WsSec">[WS-Security]</a>.</p><p>In order to properly secure messages, the body (even if empty) and all
relevant headers need to be included in the signature. Specifically, the
@@ -985,4 +1005,5 @@
<a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6849">6849</a></td></tr><tr><td> 2009/05/19 </td><td> DD </td><td> Added resolution of issue
<a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6907">6907</a></td></tr><tr><td> 2009/05/21 </td><td> DD </td><td> Added resolution of issue
<a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6674">6674</a></td></tr><tr><td> 2009/05/27 </td><td> DD </td><td> Added resolution of issue
- <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6906">6906</a></td></tr></tbody></table></div></div></body></html>
\ No newline at end of file
+ <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6906">6906</a></td></tr><tr><td> 2009/06/10 </td><td> DD </td><td> Added resolution of issue
+ <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=6712">6712</a></td></tr></tbody></table></div></div></body></html>
\ No newline at end of file
Received on Wednesday, 10 June 2009 22:51:08 UTC