Anleitung · App-Katalog
Vom Download zur fertigen Seite
So stellen Sie ein gekauftes Webpart Ihrer Organisation zur Verfügung. Sie brauchen keine Entwicklerkenntnisse – nur die .sppkg-Datei und SharePoint-Administrator-Rechte. Typische Dauer: unter 10 Minuten.
Das brauchen Sie
- Die .sppkg-Datei aus Ihrem Kauf (Download-Link in der Bestellbestätigung)
- Die Rolle „SharePoint-Administrator“ (oder Global Admin) in Microsoft 365
- Einen App-Katalog im Tenant – falls noch keiner existiert, legt Schritt 2 ihn an
- 01
.sppkg-Datei herunterladen
Nach dem Kauf erhalten Sie einen Download-Link per E-Mail. Speichern Sie die Datei lokal – sie ist Ihr Installationspaket und zugleich Ihre Lizenzkopie für ein späteres erneutes Deployment.
- 02
App-Katalog öffnen (oder anlegen)
Öffnen Sie das SharePoint Admin Center und navigieren Sie zu „Weitere Funktionen“ → „Apps“ → „App-Katalog“. Existiert noch kein Katalog, bietet SharePoint hier die Einrichtung an – die Bereitstellung dauert einmalig einige Minuten.
https://<ihr-tenant>-admin.sharepoint.com
- 03
Paket hochladen und bereitstellen
Wählen Sie im App-Katalog „Apps für SharePoint“ und laden Sie die .sppkg-Datei hoch. Im Bereitstellungs-Dialog aktivieren Sie „Diese App für alle Websites in der Organisation aktivieren“ – damit steht das Webpart sofort tenant-weit zur Verfügung, ohne dass es je Website einzeln installiert werden muss.
- 04
API-Berechtigungen freigeben (falls gefordert)
Liest das Webpart Daten über Microsoft Graph (z. B. Profile für ein Organigramm), erscheint nach dem Upload eine ausstehende Berechtigungsanfrage. Genehmigen Sie diese im Admin Center unter „Erweitert“ → „API-Zugriff“. Welche Berechtigungen ein Produkt benötigt, steht auf seiner Produktseite.
- 05
Webpart auf einer Seite einsetzen
Öffnen Sie eine beliebige moderne Seite, klicken Sie auf „Bearbeiten“ und dann auf das Plus-Symbol in einem Abschnitt. Suchen Sie das Webpart per Name, platzieren Sie es und konfigurieren Sie es über den Eigenschaften-Bereich rechts. „Erneut veröffentlichen“ – fertig.
- 06
Updates einspielen
Neue Versionen liefern wir als aktualisierte .sppkg-Datei. Laden Sie diese einfach erneut in den App-Katalog hoch (Schritt 3) – SharePoint erkennt die höhere Versionsnummer und aktualisiert alle Instanzen tenant-weit. Einstellungen und platzierte Webparts bleiben unverändert erhalten.
Wenn etwas hakt
Das Webpart erscheint nicht in der Werkzeugliste der Seite
Prüfen Sie, ob beim Upload die tenant-weite Bereitstellung aktiviert wurde, und laden Sie die Seite ohne Cache neu (Strg+F5). Nach dem ersten Deployment kann es vereinzelt bis zu 15 Minuten dauern, bis alle Websites das Webpart anbieten.
Die Berechtigungsanfrage taucht unter „API-Zugriff“ nicht auf
Anfragen erscheinen erst nach der Bereitstellung im App-Katalog und brauchen gelegentlich ein paar Minuten. Prüfen Sie außerdem, ob Sie im richtigen Admin Center angemeldet sind (SharePoint-Administrator-Rolle erforderlich).
Funktioniert das auch auf klassischen SharePoint-Seiten?
Nein – SPFx-Webparts sind für moderne Seiten konzipiert. Klassische Seiten (Web Part Pages) werden von Microsoft nicht mehr weiterentwickelt und von unseren Produkten nicht unterstützt.
Diese Anleitung liegt jedem Kauf zusätzlich als bebildertes PDF bei – zugeschnitten auf das jeweilige Webpart samt seiner Berechtigungen.