Метод Save (RPC)

Статья
04/21/2015

Дата последнего изменения: 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"	Указывает имя столбца, в котором нужно добавить или изменить значение. В зависимости от выполняемой операции можно указывать разные столбцы. По умолчанию используются следующие столбцы. Создание и изменение элементов в списке извещений. Title Название элемента. Body Основной текст элемента. Expires DateTime значение даты срока действия в формате ISO8601, например 2003-06-16T18:37:44Z. Создание и изменение элементов в списке контактов. Title Фамилия. FirstName Имя. Email Адрес электронной почты. Company Название организации. JobTitle Должность. WorkPhone Рабочий телефон. HomePhone Домашний телефон. CellPhone Мобильный телефон. WorkFax Рабочий факс. WorkAddress Рабочий адрес (улица, дом). WorkCity Город рабочего адреса. WorkState Область или край рабочего адреса. WorkZip Почтовый индекс рабочего адреса. WebPage URL-адрес веб-сайта. Comments Примечания. Создание и изменение элементов на доске обсуждений. ThreadID Идентификатор GUID, указывающий идентификатор ветви обсуждения. Ordering Штамп времени обсуждения. Для первого сообщения используется строка вида 20031211164930, для ответов на него используется строка, содержащая первоначальную последовательность, например 2003121116493020031211164951. Чтобы изменить существующий элемент обсуждения, нужно указать идентификатор элемента посредством параметра ID, идентификатор ветви с помощью параметра ThreadID и порядковое расположение элемента с помощью параметра Ordering. Чтобы создать ответ в существующем обсуждении, нужно указать New в качестве значения параметра ID, указать идентификатор ветви с помощью параметра ThreadID и использовать параметр Ordering, чтобы задать порядковое расположение сообщения, на которое нужно ответить. Чтобы создать новое обсуждение, нужно указать New в качестве значения параметра ID и передать пустой параметр Ordering. Title Тема элемента обсуждения. Body Текст элемента обсуждения. Изменение имени файла или папки. Title Имя файла или папки. С помощью параметра owsfileref указывается URL-адрес файла или папки, а с помощью параметра owsnewfileref — новое имя. Идентификатор папки или файла указывается с помощью параметра ID. Создание и изменение элементов событий. Общие параметры всех элементов событий. Title Название события. EventDate DateTime дата и время начала события в формате ISO8601, например 2004-06-15T09:00:00Z. EndDate DateTime дата и время окончания события в формате ISO8601, например 2004-06-30T10:00:00Z. Description Описание события. Location Расположение события. Параметры повторяющихся событий. RecurrencePattern#Type:fRecurrence Целое число, указывающее тип повторяющегося события. Допустимые значения: 0 — нет; 2 — ежедневное; 3 — еженедельное; 4 — ежемесячное; 5 — ежегодное. RecurrencePattern#windowStart:fRecurrence DateTime дата начала повторяющегося события в формате ISO8601, например 2004-06-15T09:00:00Z. RecurrencePattern#EndDateRangeType:fRecurrence Целое число, указывающее тип диапазона, определяющего дату окончания события. Допустимые значения. 0 — дата окончания не указана. 1 — событие оканчивается после указанного числа повторений. Нужно указать значение RecurrencePattern#repeatInstances:fRecurrence. 2 — событие оканчивается в указанную дату. Нужно указать значение RecurrencePattern#windowEnd:fRecurrence. RecurrencePattern#repeatInstances:fRecurrence Целое число, указывающее количество повторов события. RecurrencePattern#windowEnd:fRecurrence DateTime дата окончания повторяющегося события в формате ISO8601, например 2004-06-30T09:00:00Z. Ежедневные повторяющиеся события. RecurrencePattern#daily_dayFrequency:fRecurrence Целое число, указывающее количество дней между событиями. Например, если указать 2, событие будет повторяться каждые 2 дня. Ежемесячные повторяющиеся события. RecurrencePattern#MonthlyRecurType:fRecurrence Целое число, указывающее количество повторений события по месяцам. Допустимые значения: 0 — каждый номер день каждого номер месяца. Нужно указать значения RecurrencePattern#monthly_day:fRecurrence и RecurrencePattern#monthly_monthFrequency:fRecurrence. 1 — каждый [первый \| второй \| третий \| четвертый \| последний] [понедельник \| вторник \| среда \| четверг \| пятница \| суббота \| воскресенье] каждого номер месяца. Нужно указать значения RecurrencePattern#monthlyByDay_weekOfMonth:fRecurrence, RecurrencePattern#monthlyByDay_day:fRecurrence и RecurrencePattern#monthlyByDay_monthFrequency:fRecurrence. RecurrencePattern#monthly_day:fRecurrence Целое число, указывающее день месяца для каждого повтора события при RecurrencePattern#MonthlyRecurType:fRecurrence, равном 0. RecurrencePattern#monthly_monthFrequency:fRecurrence Целое число, указывающее количество месяцев между событиями при RecurrencePattern#MonthlyRecurType:fRecurrence, равном 0. Например, если указать 3, событие будет повторяться каждые 3 месяца. RecurrencePattern#monthlyByDay_weekOfMonth:fRecurrence Целое число, указывающее неделю при RecurrencePattern#MonthlyRecurType:fRecurrence, равном 1. Допустимые значения: 0 — первая; 1 — вторая; 2 — третья; 3 — четвертая; 4 — последняя. RecurrencePattern#monthlyByDay_day:fRecurrence Целое число, указывающее день недели при RecurrencePattern#MonthlyRecurType:fRecurrence, равном 1. Допустимые значения: 0 — воскресенье; 1 — понедельник; 2 — вторник; 3 — среда; 4 — четверг; 5 — пятница; 6 — суббота. RecurrencePattern#monthlyByDay_monthFrequency:fRecurrence Целое число, указывающее количество месяцев между событиями при RecurrencePattern#MonthlyRecurType:fRecurrence, равном 1. Например, если указать 4, событие будет повторяться каждые 4 месяца. Еженедельные повторяющиеся события. RecurrencePattern#weekly_weekFrequency:fRecurrence Целое число, указывающее количество недель между событиями. Например, если указать 2, событие будет повторяться каждые 2 недели. RecurrencePattern#weekly_multiDays:fRecurrence Целое число, указывающее день недели. Допустимые значения: 0 — воскресенье; 1 — понедельник; 2 — вторник; 3 — среда; 4 — четверг; 5 — пятница; 6 — суббота. Создание и изменение элементов в списке вопросов. Title Название элемента. Status Целое число, указывающее состояние вопроса. Допустимые значения: 1 — активен; 2 — разрешен; 3 — закрыт. Priority Целое число, указывающее важность вопроса. Допустимые значения: 1 — высокая; 2 — обычная; 3 — низкая. Category Целое число, указывающее категорию вопроса. Допустимые значения: 1 — категория 1; 2 — категория 2; 3 — категория 3. AssignedTo Целое число, указывающее идентификатор пользователя, которому назначен вопрос. Comment Примечание к вопросу. DueDate Дата и время срока вопроса в формате ISO8601, например 2004-06-30T09:00:00Z. RelatedIssue Целое число, указывающее идентификатор связанного вопроса. Создание и изменение ссылки в списке ссылок. URL Абсолютный URL-адрес ссылки, за которым следует запятая, пробел и текст, отображаемый для ссылки. Если отображаемый текст не указан, то отображается строка URL-адреса. Comments Примечания к ссылке. Создание и изменение элементов в списке задач. Title Название задачи. Status Текст, указывающий состояние задачи. Допустимые значения: Not Started In Progress Completed Deferred Waiting on someone else Priority Текст, указывающий важность задачи. Допустимые значения: High Normal Low PercentComplete Десятичное число, указывающее процент выполнения задачи. AssignedTo Целое число, указывающее идентификатор пользователя, которому назначена задача. Body Основной текст элемента задачи. StartDate Дата и время начала задачи в формате ISO8601, например 2004-05-30T09:00:00Z. DueDate Дата и время срока выполнения задачи в формате ISO8601, например 2004-06-30T09:00:00Z.
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>

Поделиться через

Метод Save (RPC)

Параметры

Расшифровка

Дополнительные ресурсы