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

Протокол URL

  • Статья

Дата последнего изменения: 9 марта 2015 г.

Применимо к: SharePoint Foundation 2010

В следующей таблице перечислены методы протокола RPC Windows SharePoint Services (см. раздел Протокол SharePoint Foundation RPC, которые можно использовать в URL-адресе при формировании GET-запросов HTTP. Чтобы получить дополнительные сведения о методе RPC, щелкните в таблице его название.

ПримечаниеПримечание

Способность команд URL возвращать код HTML, например, Display в следующей таблице, была ограничена изменениями в системе безопасности Microsoft SharePoint Foundation. Если включены строгие правила обработки файлов в браузере, возвращаемые данные будут помечены как вложения и обязательные для загрузки. Это применяется к командам URL в целом, особенно к командам, которые предназначены для отображения результатов непосредственно в браузере.

Команда (Cmd=)

Описание

Параметры

dialogview

Специальный параметр, который используется в команде Cmd=Display для открытия на сайте представления библиотек документов, конкретной библиотеки документов или папки в библиотеке, которые используются в диалоговом окне открытия или сохранения файлов. Кроме того, возможно открытие формы свойств, используемой при сохранении файла.

dialogview, location, FileDialogFilterValue

Display

Выполняет запрос к базе данных для списка, указанного идентификатором GUID, и возвращает текст в формате XML или HTML.

List, XMLDATA, View, Query, Using, CacheControl, ID

ExportList

Экспортирует в формате CAML схему списка, указанного идентификатором GUID.

List

GetProjSchema

Запрашивает XML-схему веб-сайта.

SiteTemplate

GetUsageBlob

Возвращает сведения об использовании веб-сайта.

BlobType

HitCounter

Генерирует обращение к странице, содержащей счетчик посещений.

Page, Image, Custom, Digits

RenderView

Запрашивает содержимое представления для списка, указанного идентификатором GUID.

List, View, URLBase

В протоколе также можно использовать следующие параметры:

  • FileDialogFilterValue — установка фильтров для представления и получение списка всех файлов заданного типа из библиотеки документов по их расширениям (например, *.doc, *.ppt или *.xls).

  • FilterFieldn — указание имени поля в базе данных, где n — целое число, которое ограничено только количеством полей, доступных в таблице базы данных, или максимальной длиной поля URL-адреса.

  • FilterValuen — указание строкового значения, по которому следует фильтровать поле, где n — целое число, ограниченное только максимальной длиной поля URL-адреса.

  • SortField — задание имени поля, по которому выполняется сортировка.

  • SortDir — задание направления сортировки: по возрастанию (asc) или убыванию (desc).

  • Using — указание относительного URL-адреса виртуального файла, используемого при экспорте элемента или списка, который может принимать одно из следующих значений: vcard.vcf, event.ics, query.iqy или query.bqy.

Использование протокола URL

Внедрение запроса в URL-адрес является базовым механизмом для передачи имени метода и его параметров серверу, на котором работает SharePoint Foundation. Для этого используется следующий синтаксис:

http://Server_Name/[sites/][Site_Name/]_vti_bin/owssvr.dll?Cmd=
   Method_name[&Parameter1=Value1&Parameter2=Value2...]

В следующем примере экспортируется схема списка, указанного идентификатором GUID:

http://Server_Name/[sites/][Site_Name/]_vti_bin/owssvr.dll?Cmd=
   ExportList&List=GUID

Этот пример выводит список "Обсуждения" в виде CAML-файла:

http://Server_Name/[sites/][Site_Name/]_vti_bin/owssvr.dll?Cmd=
   Display&List=GUID&XMLDATA=TRUE

Следующий пример экспортирует список "Обсуждения" в лист Microsoft Excel. Обратите внимание, что GUID ассоциируемого представления должен быть задан через параметр View.

http://Server_Name/[sites/][Site_Name/]_vti_bin/owssvr.dll?CS=
   109&Using=_layouts/query.iqy&List=GUID&View=GUID&CacheControl=1

Дополнительные сведения об использовании протокола URL для передачи запросов см. в разделе Отправка методов RPC SharePoint Foundation.