Определения/шаблоны списков в модели надстроек SharePoint
Подход, который вы используете для создания определений списков и шаблонов списков, в новой модели надстроек SharePoint отличается от подхода к коду полного доверия. В типичном сценарии с кодом полного доверия (FTC) или решением фермы настраиваемые определения списков и шаблоны списков были созданы с помощью декларативного кода и развернуты с помощью решений SharePoint.
В сценарии модели надстройки SharePoint невозможно создать пользовательские определения списков. Это просто невозможно сделать. Однако шаблон удаленной подготовки может использоваться для развертывания пользовательских шаблонов списков (STP-файлов) в Office 365.
Руководящие принципы высокого уровня
Как правило, мы хотели бы предоставить следующие высокоуровневые рекомендации по реализации определений списков и шаблонов списков.
- Используйте шаблон удаленной подготовки для развертывания шаблонов списков (STP-файлов) на сайтах SharePoint.
- Вы можете переопределить стандартное поведение создания списка, чтобы применить стандартные параметры ко всем спискам, созданным на сайте SharePoint. Дополнительные сведения об этом подходе см. ниже.
- Вы можете создать надстройку SharePoint для создания списков со стандартизированными параметрами. Дополнительные сведения об этом подходе см. ниже.
Параметры для обеспечения применения стандартизованных параметров (шаблонов) к спискам SharePoint при создании списка
У вас есть несколько вариантов, чтобы обеспечить применение стандартизированных параметров (шаблонов) к спискам SharePoint при создании списка.
- Переопределите поведение создания списка из коробки.
- Создайте надстройку SharePoint.
Переопределение поведения создания списка из коробки
В этом шаблоне вы изменяете поведение создания списка, добавляя приемник события в событие ListAdded. Затем в приемнике событий, настроенном для события ListAdded, используется шаблон удаленной подготовки для применения стандартизованных конфигураций к каждому создаваемому списку.
Эти стандартизированные конфигурации могут включать добавление типов контента, задание типа контента по умолчанию, добавление столбцов списка, настройку параметров версии и любые другие конфигурации типов списков, которые могут быть заданы.
- Такой подход позволяет применять стандартизированные параметры для всех списков.
- Такой подход позволяет применять стандартизированные параметры к разным типам списков.
- Например: при создании библиотеки документов и списка задач можно определить в приемнике событий ListAdded, какой тип созданного списка, и применить различные стандартизированные параметры в зависимости от типа списка. Возможно, всем библиотекам документов нужен один набор типов контента, применяемых к ним, тогда как для списка всех задач требуется другой набор типов контента, применяемых к ним.
- Этот подход не поддерживает применение нескольких различных параметров шаблона к спискам.
- Например: при создании библиотеки документов и списка задач можно определить в приемнике событий ListAdded, какой тип созданного списка, и применить различные стандартизированные параметры в зависимости от типа списка. Однако нельзя применять разные шаблоны к одной создаваемой библиотеке документов и другой библиотеке документов.
Для каких случаев он подходит?
Если необходимо применить стандартизированные глобальные параметры ко всем спискам или спискам определенного типа.
Когда это не подходит?
Если необходимо применить несколько различных вариантов шаблонов к спискам.
Начало работы
В следующем рецепте модели надстройки SharePoint описывается реализация приемников событий.
Создание надстройки SharePoint
В этом шаблоне вы создаете надстройку SharePoint для создания списков со стандартизированными параметрами и указываете пользователям использовать надстройку SharePoint для создания новых списков. По сути, надстройка SharePoint предоставляет пользователям выбор различных списков для создания. Различные списки, которые надстройка SharePoint позволяет создавать пользователям, определяются бизнесом и реализуются разработчиком. Пользователи заполняют форму в надстройке SharePoint, чтобы указать метаданные списка и выбрать список для создания из вариантов, которые предлагает надстройка. Надстройка использует шаблон удаленной подготовки для создания списка соответствующим образом.
- Такой подход позволяет применять стандартизированные параметры для всех списков.
- Такой подход позволяет применять стандартизированные параметры к разным типам списков.
- Такой подход позволяет применять к спискам несколько различных параметров шаблона.
Для каких случаев он подходит?
Если необходимо применить несколько различных вариантов шаблонов к спискам.
Приступая к работе
В следующем примере кода O365 PnP и видео показано, как создать надстройку SharePoint, которая предоставляет пользовательский интерфейс, позволяющий конечным пользователям создавать новые библиотеки документов. В нем также показано, как создать библиотеку документов с определенными конфигурациями, которые совместно представляют шаблон.
В следующем видео показано, как выполнить пример кода.
См. также
- Экземпляр списка (рецепт модели надстройки SharePoint)
- Приемники событий (рецепт модели надстройки SharePoint)
- Шаблоны документов и списков с моделью приложения (видео O365 PnP)
- Статьи руководства на https://aka.ms/OfficeDevPnPGuidance
- Ссылки в MSDN на https://aka.ms/OfficeDevPnPMSDN
- Видео на https://aka.ms/OfficeDevPnPVideos
Образцы PnP
- ECM. DocumentLibraries (пример кода O365 PnP)
- Примеры и содержимое на сайте https://github.com/SharePoint/PnP
Область применения
- Office 365 Multi Tenant (MT)
- Office 365 Dedicated (D) частично
- Локальная среда SharePoint 2013 — частично
Шаблоны для выделенных и локальных служб идентичны методам модели надстроек SharePoint с отличиями, связанными с возможностью применения технологий.