Überblick
Jedes Vitextra-Produkt für SharePoint Online wird als SharePoint-Framework-Paket (.sppkg) ausgeliefert, das in einen App-Katalog hochgeladen werden muss. SharePoint Online bietet zwei Arten von Katalogen: den Mandanten-App-Katalog, der die gesamte Organisation versorgt, und Websitesammlungs-App-Kataloge, die jeweils eine Websitesammlung versorgen. Ihre Wahl bestimmt, wer das Paket bereitstellen kann, wo die Webparts erscheinen, wie API-Berechtigungen und Microsoft Teams gehandhabt werden und an wie vielen Stellen Sie später aktualisieren müssen.
Dieser Artikel vergleicht die beiden Kataloge aus Sicht einer Vitextra-Bereitstellung und gibt eine Empfehlung. Die eigentlichen Upload-Schritte sind in KB10035. So installieren Sie ein Vitextra-Produkt in SharePoint Online beschrieben.
Die beiden Kataloge im Überblick
| Mandanten-App-Katalog | Websitesammlungs-App-Katalog | |
|---|---|---|
| Anzahl pro Mandant | Einer (einer pro geografischem Standort in einem Multi-Geo-Mandanten) | Beliebig viele, einer pro Websitesammlung |
| Erstellt von | SharePoint-Administrator, im SharePoint Admin Center | SharePoint-Administrator, mit der SharePoint Online-Verwaltungsshell |
| Wer Pakete hochladen kann | Besitzer der App-Katalog-Website (in der Regel SharePoint-Administratoren) | Websitesammlungsadministratoren dieser Websitesammlung |
| Wo die Webparts verwendet werden können | Auf jeder Website im Mandanten | Nur in dieser Websitesammlung |
| Diese App aktivieren und allen Websites hinzufügen (mandantenweite Bereitstellung) | Die Webparts erscheinen in der Toolbox jeder Website, ohne dass die App hinzugefügt werden muss | Gilt nur für die Websites dieser Websitesammlung |
| API-Berechtigungsanforderungen (Microsoft Graph, Azure DevOps) | Erscheinen auf der Seite API-Zugriff und werden mandantenweit genehmigt | Müssen im Mandanten bereits genehmigt sein |
| Zu Teams hinzufügen | Verfügbar | Nicht verfügbar |
| Updates | Das neue Paket einmal hochladen | Das neue Paket in jeden Websitesammlungs-App-Katalog separat hochladen |
| Vitextra-Lizenz | Eine Lizenz pro Mandant | Dieselbe Lizenz: Die Lizenzierung hängt nicht vom Katalog ab |
Der Mandanten-App-Katalog
Der Mandanten-App-Katalog ist eine spezielle Websitesammlung, die ein SharePoint-Administrator einmalig über Weitere Features → Apps im SharePoint Admin Center erstellt. Auf seiner Seite Apps verwalten werden Pakete hochgeladen, aktiviert, aktualisiert, zu Teams hinzugefügt und gelöscht.
Wenn Sie ein Vitextra-Paket hochladen, bietet der Bereich App aktivieren die Option Diese App aktivieren und allen Websites hinzufügen an. Alle Vitextra-Produkte unterstützen diese mandantenweite Bereitstellung:
- Ausgewählt – die Webparts des Produkts erscheinen sofort in der Webpart-Toolbox jeder Website im Mandanten. Websitebesitzer müssen die App nicht zu ihren Websites hinzufügen, und das Produkt wird nicht unter Websiteinhalte → Neu → App aufgeführt.
- Nicht ausgewählt – das Produkt steht zum Hinzufügen bereit, und der Besitzer jeder Website, die es benötigt, fügt es einmalig über Websiteinhalte → Neu → App (oder Von Ihrer Organisation in der App-Auswahl) hinzu. Die Webparts erscheinen nur in der Toolbox dieser Website.
Die Entscheidung ist nicht endgültig: Auf der Seite Apps verwalten können Sie das Paket später auswählen und Allen Websites hinzufügen oder Hinzufügen zu neuen Websites beenden verwenden.
Zwei Dinge sind nur über den Mandanten-App-Katalog verfügbar:
- API-Berechtigungsanforderungen. Produkte, die Microsoft Graph lesen – Employee Directory, Employee Details, Organizational Chart, Absence & Coverage, My Tasks, Password Vault – deklarieren die benötigten Berechtigungen, und SharePoint erstellt die zugehörigen Anforderungen auf der Seite API-Zugriff, wenn das Paket hier bereitgestellt wird. Siehe KB10360. So genehmigen Sie Microsoft-Graph-API-Berechtigungen für Vitextra-Lösungen im SharePoint Admin Center.
- Zu Teams hinzufügen. Der Teams-App-Katalog ist mandantenweit, daher kann ein Vitextra-Webpart nur aus dem Mandanten-App-Katalog als Registerkarte oder persönliche App in Microsoft Teams veröffentlicht werden.
💡 Tipp
Wählen Sie für Vitextra-Produkte Diese App aktivieren und allen Websites hinzufügen. Die Webparts stehen damit überall auf einmal zur Verfügung, und jeder Websitebesitzer entscheidet, ob er sie auf einer Seite platziert. Die Webparts ändern nichts an einer Website, bis jemand sie einer Seite hinzufügt.
Ein Websitesammlungs-App-Katalog
Ein Websitesammlungs-App-Katalog ist eine Bibliothek Apps für SharePoint innerhalb einer gewöhnlichen Websitesammlung. Ein SharePoint-Administrator aktiviert ihn für eine bestimmte Websitesammlung mit der SharePoint Online-Verwaltungsshell:
Connect-SPOService -Url https://contoso-admin.sharepoint.com
Add-SPOSiteCollectionAppCatalog -Site https://contoso.sharepoint.com/sites/marketing
Danach können die Websitesammlungsadministratoren dieser Websitesammlung Pakete unter Websiteinhalte → Apps für SharePoint hochladen, ohne eine Rolle im Mandanten zu haben, und die dort bereitgestellten Lösungen können nur innerhalb dieser Websitesammlung verwendet werden. Ein Mandanten-App-Katalog muss bereits vorhanden sein: Ohne ihn schlägt das Cmdlet fehl.
Was sich für eine Vitextra-Bereitstellung ändert:
- Geltungsbereich. Die Webparts sind nur auf den Websites dieser Websitesammlung verfügbar. Wenn Sie hier Diese App aktivieren und allen Websites hinzufügen auswählen, bedeutet „alle Websites“ die Websites derselben Websitesammlung.
- API-Berechtigungen. Ein Websitesammlungs-App-Katalog erzeugt keine Anforderungen auf der Seite API-Zugriff. Für ein Produkt, das Microsoft-Graph-Berechtigungen benötigt, stellen Sie das Paket zuerst im Mandanten-App-Katalog bereit, genehmigen die Anforderungen und verwenden erst dann den Websitesammlungs-App-Katalog; die Erteilungen gelten mandantenweit und werden von beiden Kopien gemeinsam genutzt. Ein Produkt ohne API-Berechtigungen (List Filter Online, Smart Tiles, Quick Poll, QR Code Generator und andere) funktioniert aus einem Websitesammlungs-App-Katalog ohne zusätzliche Schritte.
- Microsoft Teams. Zu Teams hinzufügen wird nicht angeboten; das Produkt kann in Teams nur verwendet werden, wenn es aus dem Mandanten-App-Katalog bereitgestellt wird.
- Updates. Jeder Websitesammlungs-App-Katalog wird separat aktualisiert: Eine neue Version, die in den Mandanten-App-Katalog hochgeladen wird, erreicht Pakete in Websitesammlungskatalogen nicht, und umgekehrt.
- Governance. Die Liste der Websitesammlungen mit einem App-Katalog wird im Mandanten-App-Katalog unter
/Lists/SiteCollectionAppCatalogsgeführt.Remove-SPOSiteCollectionAppCatalogdeaktiviert einen Websitesammlungs-App-Katalog: Die Bibliothek bleibt bestehen, aber die darin enthaltenen Lösungen funktionieren nicht mehr.
❗ Wichtig
Eine Lösung, die aus einem Websitesammlungs-App-Katalog bereitgestellt wird, läuft weiterhin im Browser des Benutzers mit dessen Berechtigungen und kann jede API aufrufen, die der Mandant genehmigt hat. Der kleinere Geltungsbereich begrenzt, wo die Webparts platziert werden können, nicht, worauf sie zugreifen können. Prüfen Sie Pakete von Drittanbietern für einen Websitesammlungs-App-Katalog genauso sorgfältig wie für den Mandanten-App-Katalog.
Lizenzierung und Testversion
Vitextra-Lizenzen werden pro Microsoft-365-Mandant ausgestellt, unabhängig vom Katalog, der Anzahl der Websites oder der Anzahl der Benutzer. Die kostenlose 14-tägige Testversion beginnt automatisch, wenn das Produkt im Mandanten bereitgestellt und zum ersten Mal geöffnet wird, und die Lizenz wird der Mandanten-ID (Tenant ID) zugewiesen – siehe KB10206. Vitextra Lizenzierung und Konto: Lizenz kaufen und aktivieren. Für die Bereitstellung desselben Produkts aus dem Mandanten-App-Katalog und aus einem oder mehreren Websitesammlungs-App-Katalogen wird eine Lizenz benötigt.
Welcher Katalog zu wählen ist
Verwenden Sie den Mandanten-App-Katalog, wenn:
- das Produkt für das Intranet als Ganzes oder für mehrere Websitesammlungen gedacht ist (Employee Directory, Organizational Chart, Smart Tiles auf Hub- und Abteilungswebsites);
- das Produkt Microsoft-Graph-Berechtigungen benötigt oder in Microsoft Teams verwendet werden soll;
- Sie einen einzigen Ort für Updates und eine einzige Version im Mandanten möchten.
Verwenden Sie einen Websitesammlungs-App-Katalog, wenn:
- eine Abteilung oder ein Projektteam ein Pilotprojekt durchführt oder ein Produkt benötigt, das der Rest der Organisation nicht erhalten wird;
- Ihre Governance-Regeln verlangen, dass nichts ohne gesonderte Prüfung mandantenweit bereitgestellt wird, und Sie die Bereitstellung an die Websitesammlungsadministratoren delegieren möchten;
- das Produkt keine API-Berechtigungen benötigt und nicht in Teams verwendet wird.
Die meisten Vitextra-Kunden stellen aus dem Mandanten-App-Katalog mit Diese App aktivieren und allen Websites hinzufügen bereit und verwenden Websitesammlungs-App-Kataloge, wenn überhaupt, für Pilotprojekte.
