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

Настраиваемое действие

  • Статья

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

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

Настраиваемое действие представляет собой сервера, меню или любую настройку ссылки, которые может видеть пользователь. Настраиваемые действия можно связать с типом списка, типом контента, типом файла или программным идентификатором (ProgID).

Допустимые области применения:

  • Ферма: да

  • Веб-приложение: да

  • Семейство сайтов: да

  • Веб-сайт: да

Определение настраиваемых действий для пользовательского интерфейса

С помощью настраиваемых действий пользовательский интерфейс можно изменить в различных местах. В их число входят сервера и другие меню в SharePoint Foundation.

Настраиваемые действия для ленты сервера

Использование элемента CustomAction позволяет добавлять на ленту такие элементы управления, как текстовые поля и раскрывающиеся списки. Но пользовательские элементы управления и веб-части на ленте не поддерживаются. Дополнительные сведения о ленте см. в статье Лента сервера в SharePoint Foundation.

Настраиваемые действия для других меню

Чтобы определить настраиваемое действие для конкретного меню, необходимо задать меню, определяя местоположение в соответствующем пространстве имен SharePoint Foundation и используя идентификатор, который в SharePoint Foundation применяется для определения конкретного местоположения.

Например, чтобы добавить настраиваемое действие на страницу "Параметры сайта", задайте для атрибута Location элемента CustomAction значение Microsoft.SharePoint.SiteSettings, а затем выберите конкретную область на странице с помощью атрибута GroupId.

Список идентификаторов по умолчанию для настраиваемых действий и местоположений, используемых в установленной системе SharePoint Foundation, см. в статье Расположения и идентификаторы пользовательского действия по умолчанию.

URL-маркеры для настраиваемых действий

SharePoint Foundation поддерживает следующие маркеры, с которых может начинаться относительный URL-адрес:

~site — ссылка относительно веб-сайта (SPWeb).

~sitecollection — ссылка относительно семейства веб-сайтов (SPSite).

Кроме того, в URL-адресе можно использовать следующие маркеры:

{ItemId} — целый идентификатор, представляющий элемент в списке.

{ItemUrl} — URL-адрес элемента, с которым выполняются действия. Работает только для документов в библиотеках.

{ListId} — GUID, представляющий список.

{SiteUrl} — URL-адрес веб-сайта (SPWeb).

{RecurrenceId} — индекс повторения. Этот маркер не поддерживается для контекстных меню элементов списков.

См. также

Концепции

Практическое руководство. Изменение пользовательского интерфейса с помощью настраиваемых действий

Схема определения пользовательских действий

Лента сервера в SharePoint Foundation

Расположения и идентификаторы пользовательского действия по умолчанию