Mandantenweite Lösungsbereitstellung für SharePoint-Framework-Lösungen
Sie können Ihre SharePoint-Framework (SPFx)-Komponenten konfigurieren, damit diese sofort in dem Mandanten verfügbar sind, wenn das Lösungspaket im Mandanten-App-Katalog installiert ist. Dies kann mit dem skipFeatureDeployment-Attribut in der Datei ./config/package-solution.json konfiguriert werden.
Ist dieses Attribut für eine Lösung aktiviert, wird dem Mandantenadministrator bei der Installation des Lösungspakets im App-Katalog des Mandanten angeboten, die Lösung automatisch in allen Websitesammlungen und auf allen Websites im Mandanten verfügbar zu machen.
Eine Demonstration der mandantenweiten Bereitstellung finden Sie in dem folgenden Video in unserem YouTube-Kanal „Microsoft 365 Platform Communtiy Patterns & Practices (PnP)“:
Hinweis
Sie müssen auf die neueste Version der SharePoint-Framework-Yeoman-Vorlage aktualisieren, um diese Funktion nutzen zu können. Sie können Ihre globale Installation aktualisieren, indem Sie **npm install -g @microsoft/generator-sharepoint**ausführen.
Die mandantenweite Bereitstellung wird in SPFx Version 1.4 veröffentlicht und kann beim Entwickeln von Webparts verwendet werden, die auf SharePoint 2019 und SharePoint Online bereitgestellt werden. Diese Bereitstellungsoption ist für SharePoint 2016 Feature Pack 2 nicht verfügbar, da es nur SPFx 1.1 unterstützt.
Wenn Sie ein SPFx-Webpart verwenden, das älter als 1.4 ist, können Sie ein Upgrade mit Anweisungen über die CLI für Microsoft 365 ausführen.
Lösungspezifische Anforderungen
Wenn diese Option verwendet wird, werden alle Featureframeworkdefinitionen in der SharePoint-Framework Lösung ignoriert. Wenn die Lösung Featureframeworkdefinitionen enthält, z. B. zum Erstellen einer benutzerdefinierten Liste, sollten Sie diese lösungsspezifische Option nicht verwenden.
Weitere Informationen finden Sie unter Bereitstellen von SharePoint-Elementen mit Ihrem Lösungspaket.
Hinweis
Lösungen, für die eine automatische mandantenweite Bereitstellung konfiguriert ist, werden auf Website-Ebene nicht unter „App hinzufügen“ aufgeführt.
Konfigurieren von Lösungen für mandantenweite Verfügbarkeit
In der SharePoint-Framework-Yeoman-Vorlage wird eine bestimmte Frage im Zusammenhang mit dieser Option gestellt. Diese Frage wirkt sich direkt auf das skipFeatureDeployment-Attribut in der Datei package-solution.json aus.
In der folgenden Beispielkonfiguration ist skipFeatureDeployment auf true festgelegt. Das bedeutet, dass die Lösung zentral im gesamten Mandanten bereitgestellt werden kann.
{
"solution": {
"name": "tenant-deploy-client-side-solution",
"id": "dd4feca4-6f7e-47f1-a0e2-97de8890e3fa",
"version": "1.0.0.0",
"skipFeatureDeployment": true,
"features": [
{
"title": "Application Extension - Deployment of custom action.",
"description": "Deploys a custom action with ClientSideComponentId association",
"id": "54f0dc0e-c190-439d-933b-2dd2809ed3c3",
"version": "1.0.0.0",
"assets": {
"elementManifests": [
"elements.xml",
"ClientSideInstance.xml"
]
}
}
]
},
"paths": {
"zippedPackage": "solution/tenant-deploy-true.sppkg"
}
}
Genehmigen einer mandantenweiten Bereitstellung im App-Katalog
Wird eine Lösung, für die das Attribut skipFeatureDeployment auf true gesetzt ist, im App-Katalog eines Mandanten bereitgestellt, wird dem Administrator angeboten, sie zentral für den gesamten Mandantenbereich bereitzustellen.
Standardmäßig ist das Kontrollkästchen Diese Lösung für alle Websites der Organisation verfügbar machen nicht aktiviert. Wenn Sie das Kontrollkästchen vom Administrator aktiviert wird, werden Komponenten in den Lösungen automatisch für den gesamten Mandantenbereich angezeigt und verfügbar.
Da die Lösung und die websitespezifischen Upgradeaktionen nur verfügbar sind, wen Sie das Featureframework verwenden, gibt es keine spezifische Upgradeoption für die zentral bereitgestellten Lösungen. Diese Lösungen können aktualisiert werden, indem lösungsspezifische Objekte im CDN aktualisiert werden sowie das Paket im App-Katalog aktualisiert und bereitgestellt wird. Dabei werden alle vorhandenen Komponenteninstanzen für den gesamten Mandanten automatisch für die Verwendung der neuesten Komponentenobjekte, u. a. JavaScript-Dateien und aktualisierte CSS-Dateien, aktualisiert.
Warnung
Bei Lösungspaketen, die Website Erweiterungen enthalten, müssen Sie das Kontrollkästchen Diese Lösung für alle Websites in der Organisation zur Verfügung stellen nur dann aktivieren, wenn Sie die Website-Erweiterung(en) erstmalig aktivieren. Wenn Sie vorhandene Lösungspakete aktualisieren, können durch Aktivieren des Kontrollkästchens während der Bereitstellung doppelte Einträge in der Liste Mandantenweite Erweiterung erstellt werden.
Sichtbarkeit clientseitiger Webparts auf SharePoint-Websites
In zentral bereitgestellten Lösungen enthaltene Webparts sind sofort in der Webpartauswahl sichtbar, sowohl auf klassischen als auch auf modernen Seiten.
Auswirkungen der Einstellung „skipFeatureDeployment“ auf Erweiterungen
SharePoint-Framework-Erweiterungen sind sofort verfügbar und können auf SharePoint-Websites verwendet werden. Das bedeutet, dass sie den ClientSideComponentId-Eigenschaften in bestimmten SharePoint-Elementen, z. B. Feldern und benutzerdefinierten Aktionen zugeordnet werden können.
Zudem können, sofern ein Administrator während der Bereitstellung das Kontrollkästchen Diese Lösung für alle Websites in der Organisation verfügbar machen auswählt, Automatisierungen im Lösungspaket möglicherweise Einträge in der Liste Mandantenweite Erweiterungen im App-Katalog erstellen. Einträge in dieser Liste verwalten die mandantenweite Aktivierung von Website-Erweiterungen. Die Automatisierungen werden in der Datei ClientSideInstance.xml beschrieben, die in der ./config/package-solution.json referenziert wird.
Weitere Informationen finden Sie unter Mandantenweite Bereitstellung von SharePoint-Framework-Erweiterungen.