Использование страницы одной части приложения в SharePoint Online

  • Статья

Страницы приложения с одной веб-частью дают возможность размещать веб-части SharePoint Framework или приложения Microsoft Teams в SharePoint Online в заблокированном макете. Конечные пользователи не могут изменять или настраивать страницу, которая использует схему страницы одной части приложения.

Страницы приложения имеют указанные ниже характеристики:

  • Страницы одной части приложения не могут быть изменены конечными пользователями, использующими браузер.
  • В настоящее время поддерживается размещение только одной веб-части или приложения Microsoft Teams
  • Конечные пользователи могут создавать новые страницы приложения с помощью функции Создать>Страница, доступной на современных сайтах.
  • Разработчики могут программно изменять макет страницы с обычного макета страницы на одностраничную страницу приложения.
  • Там нет нового опыта в одностраничной странице приложения. Конечные пользователи могут создавать новые страницы статей или одностраничные приложения, используя функцию New / page, представленную на ленте любых современных страниц статей.

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

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

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

{
  // ...

  "requiresCustomScript": false,
  "supportedHosts": ["SharePointWebPart", "SharePointFullPage", "TeamsTab"],

  "preconfiguredEntries": [{
    // ...
  }]
}

Как обеспечить страницу приложения Single Part App в вашем арендаторе

Как разработчик, два наиболее распространенных способа предоставления страниц приложения с одной деталью — это использование PnP PowerShell или CLI для Microsoft 365.

Вы можете использовать PnP PowerShell для обновления макета страницы для существующей страницы с помощью следующего сценария.

Примечание.

PnP PowerShell — это решение с открытым исходным кодом, поддержка которого предоставляется активным сообществом. Для инструментов с открытым исходным кодом не существует соглашения об уровне обслуживания в отношении поддержки корпорацией Майкрософт.

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

Примечание.

CLI для Microsoft 365 — это решение с открытым исходным кодом, поддерживаемое активным сообществом. SLA для поддержки инструмента с открытым исходным кодом со стороны Майкрософт отсутствует.

Connect-PnPOnline -Url https://contoso.sharepoint.com/sites/marketing
Set-PnPPage -Identity "Page" -LayoutType SingleWebPartAppPage

Подробные сведения и примеры этого командлета см. в документации по PnP PowerShell.

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