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


Метод 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"

Указывает имя столбца, в котором нужно добавить или изменить значение. В зависимости от выполняемой операции можно указывать разные столбцы.

По умолчанию используются следующие столбцы.

Создание и изменение элементов в списке извещений.

  • 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"

Указывает путь для вложения, которое нужно добавить к элементу.

Расшифровка

  1. Добавление ответа на элемент на доске обсуждений.

    <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. Создание нового события, которое будет происходить между 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>
    
  3. Добавление задачи в список задач.

    <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>