Save Method

Adds or modifies an item in a list, or modifies properties for a folder or for a file in a document library.

Syntax

<Method ID="Text">
  <SetList Scope="Request">GUID</SetList>
  <SetVar Name="Cmd">Save</SetVar>
  <SetVar Name="ID">[New|Integer]</SetVar>
  <SetVar Name="NextUsing">URL</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#Column_1_Name">Value</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#Column_2_Name">Value</SetVar>
  .
  .
  .
  <SetVar Name="owsfileref">URL</SetVar>
  <SetVar Name="owsnewfileref">Name</SetVar>
  <SetVar Name="fileupload0">URL</SetVar>
</Method>

Parameters

ID = "Text"

Scope = "Request"

Name = "Cmd"

Name = "NextUsing"

Name = "ID"

Name = "urn:schemas-microsoft-com:office:office#Column_Name"

Name = "owsfileref"

Name = "owsnewfileref"

Name = "fileupload0"

Decoded

1. Add a reply to an item in a discussion board.

<Method ID="0,DiscSave">
  <SetList Scope="Request">D1292FB0-20C9-4270-B5D9-5F2ECC6C597D</SetList>
  <SetVar Name="Cmd">Save</SetVar>
  <SetVar Name="ID">New</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#ThreadID">20031212-0429-16B3-919B-E69D9248868B</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#Title">Text</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#Ordering">2003121120293620031211204403</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#Body">Text</SetVar>
</Method>

2. Create a new event that occurs between 10 a.m. and 12:30 p.m. on the second Tuesday of the month every two months during the year 2004.

<Method ID="0,Save">
  <SetList Scope="Request">c3fb93d0-2632-4b72-a0e2-1f571b869814</SetList>
  <SetVar Name="Cmd">Save</SetVar>
  <SetVar Name="ID">New</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#Title">Monthly Meeting</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#EventDate">2004-01-01T10:00:00Z</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#EndDate">2005-01-01T12:30:00Z</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#RecurrencePattern#Type:fRecurrence">4</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#RecurrencePattern#MonthlyRecurType:fRecurrence">1</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#RecurrencePattern#monthlyByDay_weekOfMonth:fRecurrence">1</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#RecurrencePattern#monthlyByDay_day:fRecurrence">2</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#RecurrencePattern#monthlyByDay_monthFrequency:fRecurrence">2</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#RecurrencePattern#EndDateRangeType:fRecurrence">2</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#RecurrencePattern#windowStart:fRecurrence">2004-01-01T00:00:00Z</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#RecurrencePattern#windowEnd:fRecurrence">2005-01-01T00:00:00Z</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#Description">Text</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#Location">Text</SetVar>
</Method>

3. Add a task to a tasks list.

<Method ID="0,Save">
<SetList Scope="Request">7DDA4B15-CFDE-4098-8288-EE139CC3796F</SetList>
  <SetVar Name="Cmd">Save</SetVar>
  <SetVar Name="ID">New</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#Title">Text</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#Status">In Progress</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#Priority">High</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#PercentComplete">.2</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#AssignedTo">17</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#Body">Text</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#StartDate">2004-01-01T00:00:00Z</SetVar>
  <SetVar Name="urn:schemas-microsoft-com:office:office#DueDate">2004-01-14T00:00:00Z</SetVar>
</Method>

Return Value

Success

Returns the code attribute, which is a signed-decimal representation of an HRESULT. If an item is modified, also returns the ID of the item, such as <Result ID="0,Save" Code="0"><ID>11</ID></Result>.

Error

Returns an XML-encoded Unicode (UTF-8) text string. For more information, see Error Message Format for Windows SharePoint Services.