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

Столбцы сайтов и типы контента в модели надстройки SharePoint

  • Статья

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

В сценарии модели надстройки SharePoint для создания столбцов сайта и типов контента используется клиентская объектная модель SharePoint (CSOM) или REST API SharePoint.

Рекомендации высокого уровня

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

  • Для создания столбцов и типов контента сайта следует использовать CSOM sharePoint или REST API.
  • Не следует использовать элементы платформы компонентов для создания столбцов сайта и типов контента.
    • Единственным исключением из этого руководства является использование декларативной подготовки на основе XML для веб-сайта надстройки SharePoint в надстройке SharePoint, размещенной в SharePoint. Это связано с тем, что CSOM недоступна в надстройке SharePoint, размещенной в SharePoint.
  • Вы можете автоматизировать создание столбцов сайта и типов контента в рамках процесса подготовки сайта. Дополнительные сведения см. в разделе Рецепт подготовки сайта .

Проблемы при создании столбцов сайтов и типов контента на сайтах SharePoint

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Параметры для создания столбцов сайта и типов контента на сайтах SharePoint

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

  • Переопределение ссылки на создание сайта
  • Переопределение ссылки на создание вложенного сайта
  • Использование надстройки SharePoint, размещенной у поставщика
  • Использование приложений Windows, Java, iOS или сценариев PowerShell

Независимо от выбранного варианта, вы в конечном итоге будете использовать CSOM/REST для создания столбцов сайта и типов контента.

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

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

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

  • Core.ContentTypesAndFields (пример O365 PnP)
    • Демонстрирует, как создать новый тип контента на хост-сайте, создать поле таксономии на хост-сайте и подключить его к таксономии, создать список и связать его с типом контента, а также создать типы и поля контента на определенных языках.

Использование приложений Windows, Java, iOS или сценариев PowerShell

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

  • Core.CreateContentTypes (пример PnP O365)
    • В этом примере показано, как создать столбцы сайта, типы контента, а затем добавить столбцы сайта в тип контента. В ней также описываются новые функции локализации, которые были добавлены для Office 365 API CSOM.
  • Core.CreateDocumentContentType (пример O365 PnP)
    • В этом примере показано, как создать типы контента документов и добавить, а затем связать шаблон документа с типом контента.

Образцы PnP

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

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

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