Überblick
Ein Produkt auf Basis des SharePoint Framework (SPFx) wird in Schichten installiert: das Paket im App-Katalog, die App auf den Websites, die sie verwenden, die Webparts auf Seiten, optional eine Teams-App und die dafür genehmigten API-Berechtigungen. Deinstallieren heißt, diese Schichten rückwärts wieder abzutragen. SharePoint erledigt das nicht für Sie – das Löschen des Pakets aus dem App-Katalog ist ein Klick, hinterlässt aber defekte Webparts auf Seiten, eine verwaiste Teams-App und genehmigte Berechtigungen.
Dieser Artikel beschreibt die vollständige Entfernung eines Vitextra-Produkts aus einem Microsoft-365-Mandanten in der Reihenfolge, die defekte Seiten vermeidet, und was mit den vom Produkt erstellten Daten und mit der Lizenz zu tun ist. Die Schritte sind für jedes Vitextra-Produkt für SharePoint Online gleich; die SharePoint-Server-Produkte werden anders deinstalliert, siehe KB10022. So deinstallieren Sie ein Vitextra-Produkt von SharePoint Server.
📝 Hinweis
Sie müssen ein Produkt nicht deinstallieren, um nicht mehr dafür zu bezahlen: Kündigen Sie das Abonnement in Ihrem Vitextra-Konto, und die Webparts stellen ihre Arbeit ein, wenn der bezahlte Zeitraum endet. Deinstallieren Sie, wenn Sie das Produkt aus dem Mandanten entfernen möchten.
Bevor Sie beginnen
- Ermitteln Sie, wo das Produkt verwendet wird. SharePoint hat keinen Bericht über die Seiten, auf denen ein Webpart verwendet wird; fragen Sie die Websitebesitzer oder durchsuchen Sie die Websiteseiten des Intranets nach dem Produktnamen. Mandantenweit bereitgestellte Webparts können auf jeder Seite jeder Website liegen.
- Entscheiden Sie, was mit den Daten geschieht. Einige Produkte halten Daten in SharePoint-Listen oder in OneDrive (siehe Vom Produkt erstellte Daten unten). Exportieren Sie, was Sie benötigen, bevor Sie es löschen.
- Erforderliche Rollen. Zum Entfernen von Webparts und Apps von einer Website sind Websitebesitzerrechte erforderlich; zum Löschen des Pakets, Widerrufen von Berechtigungen und Entfernen der Teams-App ist die Rolle SharePoint-Administrator erforderlich (für Teams zusätzlich die Rolle Teams-Administrator oder Globaler Administrator).
Schritt 1. Webparts von Seiten entfernen
Beginnen Sie mit den Seiten. Wird das Paket zuerst gelöscht, zeigt jede Seite, die das Webpart noch enthält, anstelle des Inhalts einen Fehlerplatzhalter, und Seitenbearbeiter sehen denselben Platzhalter im Bearbeitungsmodus.
- Öffnen Sie die Seite und klicken Sie auf Bearbeiten.
- Wählen Sie das Vitextra-Webpart aus und klicken Sie in seiner Symbolleiste auf das Symbol Webpart löschen (Papierkorb).
- Klicken Sie auf Erneut veröffentlichen.
Wiederholen Sie dies für jede Seite. Die Einstellungen eines Webparts werden in der Seite gespeichert, daher entfernt das Löschen des Webparts auch seine Konfiguration.
Schritt 2. Die App von Websites entfernen
Dieser Schritt gilt nur für Produkte, die Websites einzeln hinzugefügt wurden (über Websiteinhalte → Neu → App). Produkte, die mit Diese App aktivieren und allen Websites hinzufügen bereitgestellt wurden, werden nicht in den Websiteinhalten aufgeführt und überspringen diesen Schritt.
- Öffnen Sie auf der Website Einstellungen → Websiteinhalte.
- Suchen Sie die Vitextra-App, öffnen Sie ihr Menü (…) und klicken Sie auf Entfernen.
- Bestätigen Sie.
Die entfernte App wird in den Papierkorb der Website verschoben und kann von dort wiederhergestellt werden.
Schritt 3. Die App aus Microsoft Teams entfernen
Wurde das Produkt mit Zu Teams hinzufügen in Teams veröffentlicht, existiert es im Teams-App-Katalog Ihrer Organisation als benutzerdefinierte App, unabhängig von SharePoint.
- Öffnen Sie das Microsoft Teams Admin Center und wechseln Sie zu Teams-Apps → Apps verwalten.
- Suchen Sie das Vitextra-Produkt nach Namen und öffnen Sie es.
- Klicken Sie auf Löschen und bestätigen Sie.
Die Registerkarten und persönlichen Apps, die Benutzer aus der App erstellt haben, funktionieren nicht mehr und verschwinden aus Teams. Wurde die App über eine App-Setuprichtlinie angeheftet, entfernen Sie sie auch aus der Richtlinie (Teams-Apps → Setuprichtlinien).
📝 Hinweis
Die Konfiguration der persönlichen Teams-App, die ein Administrator in der Gruppe Persönliche App (Microsoft Teams) des Eigenschaftenbereichs gespeichert hat (Employee Directory, Organizational Chart, RSS Reader), wird vom Vitextra-Lizenzdienst für Ihren Mandanten gespeichert. Sie wird nach dem Entfernen der App nicht mehr verwendet und bei der nächsten Konfiguration des Produkts überschrieben.
Schritt 4. Das Paket aus dem App-Katalog löschen
- Öffnen Sie im SharePoint Admin Center Weitere Features → Apps → Öffnen, um zur Seite Apps verwalten zu gelangen.
- Wählen Sie das Vitextra-Paket aus und klicken Sie auf Löschen. Bestätigen Sie.
- Das Paket wird in den Papierkorb der App-Katalog-Website verschoben. Um es vollständig zu entfernen, öffnen Sie die App-Katalog-Website (ihre Adresse wird auf der Seite Apps verwalten angezeigt), wechseln Sie zu Websiteinhalte → Papierkorb, löschen Sie das Paket dort und anschließend noch einmal aus dem Papierkorb der zweiten Stufe. Bis dahin kann das Paket wiederhergestellt werden.
❗ Wichtig
Sobald das Paket gelöscht ist, stellt jede verbliebene Instanz seiner Webparts die Arbeit ein – auf Seiten, die Sie in Schritt 1 übersehen haben, und auf Websites, von denen die App nicht entfernt wurde. Damit sie wieder funktionieren, muss das Paket aus dem Papierkorb wiederhergestellt werden. Wurde das Produkt breit eingesetzt, sollten Sie es zunächst deaktivieren: Wählen Sie das Paket aus, öffnen Sie Eigenschaften, deaktivieren Sie Aktiviert und warten Sie auf Rückmeldungen der Websitebesitzer, bevor Sie löschen.
Wurde das Produkt auch aus Websitesammlungs-App-Katalogen bereitgestellt, löschen Sie es auf dieselbe Weise aus der Bibliothek Apps für SharePoint jeder dieser Websitesammlungen.
Schritt 5. Die API-Berechtigungen widerrufen
Das Löschen eines Pakets widerruft nicht die Microsoft-Graph- oder Azure-DevOps-Berechtigungen, die dafür genehmigt wurden. Die Erteilungen gelten mandantenweit und werden von allen SPFx-Lösungen gemeinsam genutzt; widerrufen Sie sie daher nur, wenn keine andere Lösung sie benötigt.
- Erweitern Sie im SharePoint Admin Center Erweitert und öffnen Sie API-Zugriff.
- Wählen Sie auf der Registerkarte Genehmigte Anforderungen die Berechtigung aus und klicken Sie auf Entfernen. Wiederholen Sie dies für jede Berechtigung, die nur das entfernte Produkt verwendet hat.
Die Berechtigungen jedes Produkts und die gemeinsame Nutzung der Erteilungen sind in KB10360. So genehmigen Sie Microsoft-Graph-API-Berechtigungen für Vitextra-Lösungen im SharePoint Admin Center beschrieben. Produkte ohne API-Berechtigungen (List Filter Online, Smart Tiles, Quick Poll, QR Code Generator, Announcements Carousel, Questions & Answers, RSS Reader, Smart Search) überspringen diesen Schritt.
Vom Produkt erstellte Daten
Das Entfernen eines Webparts oder eines Pakets löscht nie die Daten, mit denen es gearbeitet hat. Entscheiden Sie für jedes Produkt, was Sie behalten:
| Produkt | Wo die Daten liegen | Was zu tun ist |
|---|---|---|
| Absence & Coverage | Sechs SharePoint-Listen auf der ausgewählten Website: AbsenceTypes, Absences, Substitutions, Balances, Holidays, Settings | Bei Bedarf nach Excel oder CSV exportieren, dann die Listen löschen |
| Quick Poll | Die Listen Vitextra Quick Poll Questions und Vitextra Quick Poll Responses auf der Website | Als gewöhnliche Listen behalten oder löschen |
| Questions & Answers, Announcements Carousel | Die benutzerdefinierte Liste oder Ankündigungsliste, die für das Webpart ausgewählt oder erstellt wurde | Als gewöhnliche Listen behalten oder löschen |
| Password Vault | Die verschlüsselte Datei vitextra-password-vault.json im Anwendungsordner des OneDrive jedes Benutzers (Ordner Apps) | Benutzer exportieren ihre Einträge vor der Entfernung und können die Datei selbst löschen |
| Employee Details | Von Benutzern bearbeitete Profilfelder werden in ihrem Microsoft-Entra-ID-Profil gespeichert, nicht im Webpart | Nichts zu bereinigen; die Daten bleiben Teil der Benutzerprofile |
| Employee Directory, Organizational Chart, My Tasks, Smart Search, RSS Reader | Lesen Daten aus Microsoft 365 oder externen Feeds; in SharePoint wird nichts über die Webpart-Einstellungen auf Seiten hinaus erstellt | Nichts zu bereinigen |
| Smart Tiles, QR Code Generator, List Filter Online | Einstellungen in den Webpart-Eigenschaften auf der Seite | Werden mit dem Webpart in Schritt 1 entfernt |
Daten, die einige Produkte im Browser halten – der Verzeichniscache von Employee Directory und Organizational Chart, die persönlichen Ansichtseinstellungen von My Tasks, die gespeicherten Filter von List Filter Online und die gespeicherten Suchen von Smart Search – bleiben auf den Geräten der Benutzer, bis die Browserdaten der Website gelöscht werden. Eine vollständige Übersicht finden Sie in KB10363. Wo Vitextra-Produkte Ihre Daten speichern: Datenschutz, Datenresidenz und DSGVO.
Schritt 6. Die Lizenz freigeben
Die Deinstallation ändert nichts an Ihrem Abonnement. Melden Sie sich bei vitextra.com an, öffnen Sie Account → My Subscriptions (Konto → Meine Abonnements), wählen Sie das Abonnement aus und entfernen Sie entweder mit Remove (Entfernen) die Lizenzzuweisung des Mandanten (wenn Sie die Lizenz in einem anderen Mandanten verwenden möchten) oder kündigen Sie mit Cancel Subscription (Abonnement kündigen). Die Schritte sind in KB10037. So verwalten Sie Ihr Vitextra-Abonnement beschrieben. Befand sich das Produkt nur in der Testphase, ist nichts zu tun.
📝 Hinweis
Wenn Sie das Produkt später erneut installieren, beginnt die Testversion nicht von vorn: Der Testzeitraum ist an den Mandanten und das Produkt gebunden. Ein Produkt, dessen Testzeitraum bereits abgelaufen ist, benötigt unmittelbar nach der Neuinstallation eine Lizenz.
Checkliste
- Webparts von allen Seiten gelöscht, Seiten erneut veröffentlicht.
- App von jeder Website entfernt, der sie einzeln hinzugefügt wurde.
- Benutzerdefinierte App im Teams Admin Center gelöscht und aus den Setuprichtlinien entfernt.
- Paket aus dem Mandanten-App-Katalog (und aus Websitesammlungs-App-Katalogen) sowie aus beiden Papierkörben gelöscht.
- API-Berechtigungen, die nur dieses Produkt verwendet hat, auf der Seite API-Zugriff entfernt.
- Daten exportiert oder bewusst gelöscht.
- Lizenzzuweisung entfernt oder Abonnement gekündigt.
