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

Ассоциация возможности в модели надстроек SharePoint

  • Статья

Подход, который вы используете для запуска кода и развертывания артефактов при подготовке сайта SharePoint, в новой модели надстройки SharePoint отличается от подхода к работе с кодом полного доверия. В типичном сценарии с кодом полного доверия (FTC) или решением фермы стандартные определения сайтов были изменены с использованием скрепленных функций. Функции использовались для упаковки и развертывания артефактов, конфигураций и ресурсов фирменной символики, связанных с сайтом SharePoint, а функции были привязаны к определению сайта. Затем скрепленные компоненты автоматически устанавливались и активировались при подготовке сайта.

В сценарии модели надстройки SharePoint можно создавать и настраивать семейства веб-сайтов и дочерние сайты, а затем развертывать артефакты, конфигурации и ресурсы фирменной символики. Этот шаблон обычно называется шаблоном удаленной подготовки.

Руководящие принципы высокого уровня

Как правило, мы хотели бы предоставить следующие высокоуровневые рекомендации по созданию и настройке семейств веб-сайтов и дочерних сайтов, а затем развертывать артефакты, конфигурации и ресурсы фирменной символики для них.

  • Единственный способ по-прежнему использовать скобы функций — это при скреплении компонентов в семействах веб-сайтов и при использовании решений песочницы для развертывания определений сайтов и функций со сплетом.
  • Вы можете использовать модель скобок с развернутыми клиентами надстройками для реализации функций, аналогичных с привязкой компонентов.
  • Шаблон удаленной подготовки можно использовать для реализации функциональных возможностей, аналогичных скрепке признаков, путем активации дополнительных функций поверх встроенного определения сайта с помощью удаленных API.

Параметры для создания и настройки семейств веб-сайтов и дочерних сайтов, а затем развертывать в них артефакты, конфигурации и ресурсы фирменной символики

У вас есть несколько вариантов создания и настройки семейств веб-сайтов и дочерних сайтов, а затем развертывать в них артефакты, конфигурации и ресурсы фирменной символики.

  • Функции staple
  • Надстройки staple
  • Использование шаблона удаленной подготовки

Функции staple

В этом шаблоне вы будете добавлять компоненты в определения сайта.

  • Этот шаблон доступен только на уровне семейства веб-сайтов.
  • Невозможно добавлять компоненты на вложенные сайты.
  • Это не является оптимальным или рекомендуемым подходом, так как он использует устаревшие решения песочницы и не настраивает вас для обновлений.

Для каких случаев он подходит?

При переносе устаревшего кода в локальной среде SharePoint и у вас нет времени на его правильную запись.

Начало работы

В следующей статье описывается, как добавлять компоненты в определение сайта.

Надстройки staple

В этом шаблоне надстройки, хранящиеся в каталоге приложений, развертываются в определенных семействах веб-сайтов, управляемых путях и шаблонах сайтов.

  • Дополнительные сведения о модели скобок см. в статье Развертывание приложений SharePoint 2013 через App Stapling (статья блога MSDN — Ричард ДиЗерега).
  • Так как надстройка отправляется администратором, владельцы сайтов не смогут удалить надстройку с сайта, соответствующего условиям развертывания. Даже администратор семейства веб-сайтов не может удалить надстройку.
  • Это централизованное развертывание также использует те же ресурсы централизованных надстроек (веб-надстройки и удаленный веб-сайт). По сути, надстройка развертывается, но не устанавливается на сайтах. Все сайты будут использовать веб-надстройки и удаленный веб-сайт из экземпляра, установленного в каталоге приложений.
  • Из-за централизованного развертывания удаленные события, такие как "Обработка установленного приложения", "Обработка удаленного приложения" и "Обработка обновления приложения", срабатся только один раз (когда Add-In установлен в каталоге приложений).
    • Это может затруднить использование шаблона скобок надстройки для автоматического применения изменений к сайтам, на которых она развернута, так как эти события не срабаются при развертывании на сайтах.
  • Части надстроек не поддерживаются, если надстройки прикрепляются к сайтам.
  • Для этого шаблона требуются действия пользователя вручную для развертывания надстроек.

Использование шаблона удаленной подготовки

В этом шаблоне используется клиентская объектная модель SharePoint (CSOM) для создания и настройки семейств веб-сайтов и дочерних сайтов, а затем развертываются артефакты, конфигурации и ресурсы фирменной символики.

  • Этот шаблон не требует упаковки артефактов, конфигураций и ресурсов фирменной символики в отдельных компонентах или надстройках. Все может быть упаковано в одну надстройку.

  • При использовании этого шаблона для подготовки сайта обычно переопределяется готовая страница, чтобы создать новый сайт.

  • Дополнительные сведения об этом шаблоне см. в статье Подготовка сайта (рецепт надстройки SharePoint).

  • Если вы хотите развернуть надстройки на сайте SharePoint, это можно сделать с помощью CSOM. Ниже приведен пример, который загружает надстройку Office через файл манифеста приложения и устанавливает ее на сайте SharePoint.

    //Create a FileStream object to access the Mail Office Add-in .app file
using (FileStream fsSource = new FileStream(System.Web.Hosting.HostingEnvironment.ApplicationPhysicalPath + "Innovation.Management.AFO.app",
  FileMode.Open, FileAccess.Read))
  {
//Return the subweb where you want to install the Add-in
      var subweb = ctx.Web;
      ctx.Load(subweb);
      ctx.ExecuteQuery();

//Load and Install the Add-in on the subweb
      AppInstance appInstance = subweb.LoadAndInstallApp(fsSource);
      ctx.Load(appInstance);
      ctx.ExecuteQuery();
  }

Образцы PnP

Область применения

  • Office 365 Multi Tenant (MT)
  • Office 365 Dedicated (D)
  • Локальное развертывание SharePoint 2013