Verwenden von App-Seiten mit einem einzelne Part in SharePoint Online

  • Artikel

App-Seiten mit einem einzelnen Part ermöglichen das Hosten von SharePoint-Framework-Webparts oder Microsoft Teams-Anwendungen in SharePoint Online mit einem gesperrten Layout. Endbenutzer können die Seite, die das Layout der App-Seite mit einem einzelnen Part verwendet, nicht ändern oder konfigurieren.

App-Seiten weisen folgende Eigenschaften auf:

  • App-Seiten mit einzelnem Part können nicht von Endbenutzern im Browser bearbeitet werden.
  • Unterstützt derzeit nur das Hosten von einzelnen Webparts oder Microsoft Teams-Anwendungen
  • Endbenutzer können neue App-Seiten erstellen, indem Sie die Neue>Seitenoberfläche verwenden, die auf modernen Websites verfügbar ist.
  • Entwickler können das Seitenlayout programmgesteuert von einem normalen Seitenlayout zu einer Einzelseiten-App-Seite ändern
  • Auf einer Einzelseiten-App-Seite gibt es keine „Neue Oberfläche“. Endbenutzer können neue Artikelseiten oder Einzelseiten-App-Seiten erstellen, indem Sie die NEUE Oberflöche/Seitenoberfläche verwenden, die im Menüband aller modernen Artikelseiten vorhanden ist.

App-Seiten werden als Option in der modernen Seitenerstellungsfunktion bereitgestellt, wenn Sie das verwendete Seitenlayout für Ihre Seite ausgewählt haben. Alle Webparts, die so konfiguriert wurden, dass sie auch als App-Seite verfügbar sind, sind unter der Funktion Seite erstellen verfügbar.

Ein Webpart kann für die Bereitstellung als App-Seite konfiguriert werden. Diese Konfiguration erfolgt in der Webpart-Manifestdatei durch Anpassen des Werts supportedHosts. Das Webpart wird als Option in der kommenden App-Seitenauswahl-Benutzeroberfläche angezeigt, wenn der Wert supportedHosts den Wert "SharePointFullPage" enthält.

Das folgende Webpartmanifest zeigt ein Szenario, in dem das Webpart in allen unterstützten Plattformen enthalten ist, indem alle verschiedenen Werte für den supportedHosts-Parameter aktualisiert werden.

{
  // ...

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

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

So stellen Sie die App-Seite für ein einzelnes Element in Ihrem-Mandanten bereit

Die zwei häufigsten von Entwicklern verwendeten Methoden zur Bereitstellung von App-Seiten für einzelne Elemente sind „PnP PowerShell“ oder „CLI für Microsoft 365“.

Sie können PnP PowerShell verwenden, um das Seitenlayout für die vorhandene Seite mit dem folgenden Skript zu aktualisieren.

Hinweis

PnP PowerShell ist eine Open Source-Lösung mit aktiver Community, die Support dafür bietet. Es gibt keine SLA für den Support des Open-Source-Tools durch Microsoft.

Sie können auch CLI für Microsoft 365 verwenden, um das Seitenlayout für die vorhandene Seite mit dem folgenden Skript zu aktualisieren.

Hinweis

Die CLI für Microsoft 365 ist eine Open-Source-Lösung mit aktiver Community, die Support dafür bietet. Es gibt keine SLA für den Support des Open-Source-Tools durch Microsoft.

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

Ausführliche Informationen und Beispiele zu diesem „Cmdlet“ finden Sie in der PnP-PowerShell-Dokumentation.

Sie müssen den Mandanten- und Seitennamen basierend auf Ihrer Umgebung anpassen.