Метод Save (RPC)
Дата последнего изменения: 9 марта 2015 г.
Применимо к: SharePoint Foundation 2010
Добавление или изменение элемента списка, а также изменение свойств папки или файла в библиотеке документов.
Метод веб-службы **UpdateListItems(String, XmlNode)**Этот метод относится к числу нерекомендуемых и может не поддерживаться в будущих версиях. Вместо него необходимо использовать следующий метод веб-службы:.
<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>
Параметры
Параметр |
Описание |
---|---|
ИД = "Text" |
Строка, относящаяся к приложению. В редакторе HTML, совместимом с Microsoft SharePoint Foundation 2010, таком как Microsoft SharePoint Designer 2010, эта строка представляет порядковый номер и имя метода. |
Scope = "Request" |
Когда установлено значение Request, атрибут Scope устанавливает переменную для области вложенного элемента Method, пока эта переменная не будет изменена другим тегом. |
Name = "Cmd" |
Должно быть задано Save. |
Name = "NextUsing" |
Необязательный. URL-адрес, на который перенаправляется пользователь после завершения операции. |
Name = "ID" |
Устанавливается равным New для создания нового элемента; устанавливается равным целочисленному ИД элемента для его изменения. |
Name = "urn:schemas-microsoft-com:office:office#Column_Name" |
Указывает имя столбца, в котором нужно добавить или изменить значение. В зависимости от выполняемой операции можно указывать разные столбцы. По умолчанию используются следующие столбцы. Создание и изменение элементов в списке извещений.
Создание и изменение элементов в списке контактов.
Создание и изменение элементов на доске обсуждений.
Изменение имени файла или папки.
Создание и изменение элементов событий. Общие параметры всех элементов событий.
Параметры повторяющихся событий.
Ежедневные повторяющиеся события.
Ежемесячные повторяющиеся события.
Еженедельные повторяющиеся события.
Создание и изменение элементов в списке вопросов.
Создание и изменение ссылки в списке ссылок.
Создание и изменение элементов в списке задач.
|
Name = "owsfileref" |
Необязательный параметр. Указывает относительный URL-адрес файла или папки, имя которых нужно изменить. Параметр owsnewfileref служит, чтобы указать новое имя. Идентификатор файла или папки нужно указывать с помощью параметра ID. |
Name = "owsnewfileref" |
Необязательный параметр. Указывает новое имя для файла или папки, указанных параметром owsfileref. |
Name = "fileupload0" |
Указывает путь для вложения, которое нужно добавить к элементу. |
Расшифровка
Добавление ответа на элемент на доске обсуждений.
<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>
Создание нового события, которое будет происходить между 10:00 и 12:30 во второй вторник каждые 2 месяца в течение 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>
Добавление задачи в список задач.
<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>