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

Подготовка сайтов в модели надстроек SharePoint

  • Статья

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

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

На высоком уровне шаблон удаленной подготовки выглядит следующим образом:

1) Удаленное задание таймера, переходит к 2) Начальная подготовка на основе встроенного сайта. Обычно сайт группы или сайт публикации. Ресурсы отправляются из подсистемы подготовки с помощью CSOM/REST. 3) Примените необходимые изменения (конфигурации и т. д.) поверх готовых сайтов на основе выбора пользователем для создания сайта project, организационного сайта или сайта рабочей группы. Это часть специализации, но так как мы начинаем с сайта OOB, мы всегда получаем последние улучшения в качестве базовой линии.

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

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

  • Подготовка коллекций и дочерних сайтов на основе готовых шаблонов сайтов, поставляемых с SharePoint.
    • Используйте CSOM SharePoint для создания семейств веб-сайтов и дочерних сайтов.
  • Примените настройки и параметры к встроенным семействам веб-сайтов и дочерним сайтам в соответствии с вашими требованиями.
    • Используйте CSOM SharePoint для применения настроек и настроек.
  • Не рекомендуется использовать элементы платформы компонентов при создании коллекций и дочерних сайтов.
    • Единственным исключением из этого руководства является использование декларативной подготовки на основе XML для веб-сайта надстройки в надстройке SharePoint, размещенной в SharePoint. Это связано с тем, что CSOM недоступен в надстройке SharePoint, размещенной в SharePoint.

Проблемы при создании семейств веб-сайтов и дочерних сайтов

Создание в веб-браузере и создание с помощью кода

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

  • Создание через веб-браузер
    • В этом варианте пользователи получают доступ к сайту SharePoint через веб-браузер и используют административные страницы для создания семейств веб-сайтов и дочерних сайтов.
    • Как правило, единственный раз, когда вам нужно использовать веб-браузер, — это вручную создавать семейства веб-сайтов и дочерние сайты, когда вы создаете прототипы или изменяете один сайт SharePoint, который не планируется расти, чтобы включить другие семейства веб-сайтов или дочерние сайты.
  • Создание с помощью кода
    • В этом параметре вы будете выполнять код CSOM SharePoint для создания семейств веб-сайтов и дочерних сайтов.
    • Далее в этой статье вы узнаете о нескольких подходах, которые можно использовать для выполнения кода CSOM SharePoint.

При создании через веб-браузер учитывайте следующие моменты.

  • Создание семейств веб-сайтов и дочерних сайтов через веб-браузер обычно является сложным и трудоемким процессом.
    • Эти факторы делают создание семейств веб-сайтов и дочерних сайтов через веб-браузер подверженным ошибкам.
  • Повторно создавать семейства веб-сайтов и вложенные сайты (а также содержащиеся в них компоненты), созданные в веб-браузере, невозможно.
    • Это затрудняет быстрое и согласованное развертывание семейств веб-сайтов и дочерних сайтов в разных средах при переходе от разработки к тестированию в рабочую среду.

При создании кода учитывайте следующие моменты.

  • Создание семейств веб-сайтов и дочерних сайтов с кодом обычно включает использование пользовательских служебных библиотек для выполнения кода CSOM SharePoint.
    • Эти библиотеки доступны во многих проектах в репозитории OfficeDev PnP GitHub. Они упоминаются на протяжении всей статьи и в конце.
    • Благодаря этим факторам создание семейств веб-сайтов и дочерних сайтов с кодом может быть успешным.
  • Вы можете легко и согласованно реплицировать семейства веб-сайтов и вложенные сайты (а также содержащиеся в них компоненты), созданные с помощью кода в детализированном виде.
    • Вы можете легко развертывать семейства веб-сайтов и дочерние сайты в разных средах и ссылаться на них при переходе от разработки к тестированию в рабочую среду.

Должно произойти быстро!

Конечные пользователи не будут ждать несколько часов, пока новые сайты SharePoint будут подготовлены.

Должен быть постоянно совершенным!

Семейства веб-сайтов и дочерние сайты, а также различные компоненты, которые они включают, такие как столбцы сайтов, типы контента, списки, master страницы, файлы JavaScript, изображения и т. д., являются основой, определяющей архитектуру информации. Они должны быть совершенными.

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

Например, если у вас есть сайты SharePoint, используемые для управления проектами в вашей компании, скорее всего, вы создадите общую схему списка для всех них. Для этого потребуется создать столбцы сайта и типы контента. При поиске информации на этих сайтах с помощью страницы поиска SharePoint результаты фильтруется по типу контента или тегу (столбцу сайта). Если столбцы и типы контента сайта не полностью согласованы на всех сайтах проекта, вы не получите точные результаты поиска.

Этот пример также может применяться к веб-частям Content By Search, надстройкам SharePoint, мобильным приложениям и любым другим системам, которые получают доступ к информации на сайтах SharePoint.

Параметры для создания семейств веб-сайтов и дочерних сайтов

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

  • Переопределение ссылки на создание сайта
  • Переопределение ссылки на создание вложенного сайта
  • Использование надстройки SharePoint, размещенной у поставщика
  • Использование приложений .NET/Java/Objective-C или сценариев PowerShell

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

  • Шаблон используется только при создании семейства веб-сайтов. он не используется для создания дочерних сайтов.
  • URL-адрес переопределения настраивается в Центре администрирования SharePoint. Этот URL-адрес указывает на надстройку SharePoint, размещенную у поставщика.
  • Размещаемая у поставщика надстройка SharePoint использует API CSOM для создания семейств веб-сайтов.
    • CSOM/REST API также можно использовать для настройки других аспектов сайта в процессе подготовки.
  • Этот подход можно использовать в Office 365 клиентах и в локальной среде SharePoint.
  • Предоставляет огромную гибкость при создании и настройке семейств веб-сайтов SharePoint.
  • Простой и недорогой для реализации и обслуживания в краткосрочной и долгосрочной перспективе.

Конфигурация

Чтобы переопределить ссылку на создание сайта, откройте страницу параметров в Центре администрирования SharePoint (показано ниже).

Меню Центра администрирования SharePoint с выделенным параметром меню параметров.

Затем проверка флажок Использовать форму по этому URL-адресу и введите URL-адрес надстройки SharePoint, размещенной у поставщика, которая реализует функцию создания сайта (показано ниже).

Диалоговое окно

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

На этой странице стрелка указывает на поле проверка с заголовком Использовать форму по этому URL-адресу, который не установлен. Другой текст и элементы управления на этой странице: предоставьте пользователям ярлык для создания сайтов групп в определенном расположении. Переключатель Скрыть ссылку не выбран, переключатель Показать ссылку выбран. Поле классификации сайтов — Скрытое от пользователей. Дополнительное поле контакта не является обязательным.

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

Этот параметр хорошо подходит, если необходимо предоставить пользователям возможность самостоятельного создания семейств веб-сайтов SharePoint на основе пользовательских шаблонов.

Приступая к работе

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

В этом шаблоне ссылка на создание дополнительного сайта переопределяется ссылкой, указывающей на надстройку SharePoint, размещенную у поставщика. Код CSOM, выполняемый в размещаемой у поставщика надстройке SharePoint, выполняется с помощью шаблона удаленной подготовки в процессе создания сайта.

  • Шаблон используется только при создании дочерних сайтов; он не используется для создания семейств веб-сайтов.
  • URL-адрес переопределения настраивается с помощью пользовательского действия, которое использует JavaScript для изменения ссылки. Этот URL-адрес указывает на надстройку SharePoint, размещенную у поставщика.
  • Надстройка SharePoint, размещенная у поставщика, использует API CSOM для создания дочерних сайтов.
    • CSOM/REST API также можно использовать для настройки других аспектов сайта в процессе подготовки.
  • Этот подход можно использовать в Office 365 клиентах и в локальной среде SharePoint.
  • Предоставляет огромную гибкость при создании и настройке сайтов SharePoint.
  • Простой и недорогой для реализации и обслуживания в краткосрочной и долгосрочной перспективе.

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

Этот вариант подходит, если необходимо предоставить пользователям возможность самостоятельного создания дочерних сайтов SharePoint на основе пользовательских шаблонов.

Приступая к работе

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

  • Provisioning.Cloud.Sync (пример O365 PnP)
    • В этом решении показана модель предоставления синхронного семейства веб-сайтов или создания дочерних сайтов, чтобы внедрить модель для шаблонов сайтов без использования фактических решений песочницы или STP-файлов.
  • Provisioning.SubSiteCreationApp (пример O365 PnP)
    • В этом решении используется так называемый шаблон удаленной подготовки для предоставления как можно более гибкой системы шаблонов подсеть. Он также включает в себя сопроводиющее видео.

Использование надстройки SharePoint, размещенной у поставщика

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

  • Шаблон можно использовать для целевого семейства веб-сайтов и создания дочерних сайтов.
  • Надстройке, размещенной в SharePoint, должны быть предоставлены разрешения на полный доступ к среде SharePoint.
    • Этот шаблон нельзя использовать в Microsoft Marketplace, так как для него требуются разрешения на полный доступ.
  • Надстройка SharePoint, размещенная у поставщика, использует API CSOM для создания семейств веб-сайтов и дочерних сайтов.
    • CSOM/REST API также можно использовать для настройки других аспектов сайта в процессе подготовки.
  • Этот подход можно использовать в Office 365 клиентах и в локальной среде SharePoint.
  • Предоставляет огромную гибкость при создании и настройке сайтов SharePoint.
  • Простой и недорогой для реализации и обслуживания в краткосрочной и долгосрочной перспективе.

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

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

  • Асинхронная подготовка с гибридными сценариями (статья блога MSDN)
  • Provisioning.Hybrid.Simple (пример O365 PnP)
    • В этом примере демонстрируется простейшая гибридная настройка с очередями хранилища Azure, веб-заданиями и ретранслятором служебной шины. Это демонстрация размещения надстройки SharePoint поставщика на веб-сайте Azure, которая может использоваться для подготовки новых пользовательских семейств веб-сайтов с фирменной символикой в локальной ферме без требований к инфраструктуре надстроек SharePoint в локальной среде.
  • Provisioning.Services.SiteManager (пример O365 PnP)
    • В этом примере показано, как расширить локальную ферму для поддержки создания семейства веб-сайтов из надстройки SharePoint, размещенной у поставщика.
  • Provisioning.SiteCollectionCreation (пример O365 PnP)
    • Демонстрирует создание семейств веб-сайтов с помощью CSOM для Office 365 из надстройки SharePoint, размещенной у поставщика.

Использование приложений .NET/Java/Objective-C или сценариев PowerShell

В этом шаблоне код CSOM выполняется с помощью приложений .NET/Objective-C/iOS или сценариев PowerShell. Этот шаблон также включает в себя использование удаленных заданий таймера; например, веб-задание Azure.

  • Шаблон можно использовать для создания целевого семейства веб-сайтов и создания дочерних сайтов.
  • Надстройкам SharePoint необходимо предоставить разрешения на полный доступ к среде SharePoint.
  • Проверка подлинности может быть сложной в зависимости от типа создаваемой надстройки SharePoint и параметров безопасности SharePoint.
  • Размещаемая у поставщика надстройка SharePoint использует API CSOM для создания семейств веб-сайтов и дочерних сайтов.
    • CSOM/REST API также можно использовать для настройки других аспектов сайта в процессе подготовки.
  • Этот подход можно использовать в Office 365 клиентах и в локальной среде SharePoint.
  • Предоставляет огромную гибкость при создании и настройке сайтов SharePoint.
  • Простой и недорогой для реализации и обслуживания в краткосрочной и долгосрочной перспективе.

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

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

Образцы PnP

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

  • Office 365 Multi Tenant (MT)
  • Office 365 Dedicated (D) частично
  • Локальная среда SharePoint 2013 — частично

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