Ü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. Websitebesitzer können Webparts und Apps von ihren Websites entfernen. Ein SharePoint-Administrator verwaltet den App-Katalog, ein Teams-Administrator die Teams-App. Verwalten Sie den API-Zugriff mit einem entsprechend berechtigten Konto; siehe KB10360.

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.

  1. Öffnen Sie die Seite und klicken Sie auf Bearbeiten.
  2. Wählen Sie das Vitextra-Webpart aus und klicken Sie in seiner Symbolleiste auf das Symbol Webpart löschen (Papierkorb).
  3. Klicken Sie auf Erneut veröffentlichen.

Löschen eines Webparts von einer Seite

Löschen eines Webparts von einer Seite

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.

  1. Öffnen Sie auf der Website Einstellungen → Websiteinhalte.
  2. Suchen Sie die Vitextra-App, öffnen Sie ihr Menü (…) und klicken Sie auf Entfernen.
  3. Bestätigen Sie.

Entfernen einer App von einer Website

Entfernen einer App von einer Website

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.

  1. Öffnen Sie das Microsoft Teams Admin Center und wechseln Sie zu Teams-Apps → Apps verwalten.
  2. Suchen Sie das Vitextra-Produkt nach Namen und öffnen Sie es.
  3. Klicken Sie auf Löschen und bestätigen Sie.

Löschen einer App im Teams Admin Center

Löschen einer App im Teams Admin Center

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

  1. Öffnen Sie im SharePoint Admin Center Weitere Features → Apps → Öffnen, um zur Seite Apps verwalten zu gelangen.
  2. Wählen Sie das Vitextra-Paket aus und klicken Sie auf Löschen. Bestätigen Sie.

Löschen des Pakets aus dem App-Katalog

Löschen des Pakets aus dem App-Katalog

3. 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.

  1. Erweitern Sie im SharePoint Admin Center Erweitert und öffnen Sie API-Zugriff.
  2. Wählen Sie auf der Registerkarte Genehmigte Anforderungen die Berechtigung aus und klicken Sie auf Zugriff 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:

ProduktWo die Daten liegenWas zu tun ist
Absence & CoverageSechs SharePoint-Listen auf der ausgewählten Website: AbsenceTypes, Absences, Substitutions, Balances, Holidays, SettingsBei Bedarf nach Excel oder CSV exportieren, dann die Listen löschen
Quick PollDie Listen Vitextra Quick Poll Questions und Vitextra Quick Poll Responses auf der WebsiteAls gewöhnliche Listen behalten oder löschen
Questions & Answers, Announcements CarouselDie benutzerdefinierte Liste oder Ankündigungsliste, die für das Webpart ausgewählt oder erstellt wurdeAls gewöhnliche Listen behalten oder löschen
Password VaultDie 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 DetailsVon Benutzern bearbeitete Profilfelder werden in ihrem Microsoft-Entra-ID-Profil gespeichert, nicht im WebpartNichts zu bereinigen; die Daten bleiben Teil der Benutzerprofile
Employee Directory, Organizational Chart, My Tasks, Smart Search, RSS ReaderLesen Daten aus Microsoft 365 oder externen Feeds; in SharePoint wird nichts über die Webpart-Einstellungen auf Seiten hinaus erstelltNichts zu bereinigen
Smart Tiles, QR Code Generator, List Filter OnlineEinstellungen in den Webpart-Eigenschaften auf der SeiteWerden 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

  1. Webparts von allen Seiten gelöscht, Seiten erneut veröffentlicht.
  2. App von jeder Website entfernt, der sie einzeln hinzugefügt wurde.
  3. Benutzerdefinierte App im Teams Admin Center gelöscht und aus den Setuprichtlinien entfernt.
  4. Paket aus dem Mandanten-App-Katalog (und aus Websitesammlungs-App-Katalogen) sowie aus beiden Papierkörben gelöscht.
  5. API-Berechtigungen, die nur dieses Produkt verwendet hat, auf der Seite API-Zugriff entfernt.
  6. Daten exportiert oder bewusst gelöscht.
  7. Lizenzzuweisung entfernt oder Abonnement gekündigt.

Fragen und Antworten

Stellen Sie eine Frage zu diesem Artikel und erhalten Sie eine offizielle Antwort von unserem Team.

Noch keine Fragen. Stellen Sie die erste Frage.

Ausgewählte Artikel

Warum Password Vault nicht geladen wird: „Leider ist ein Fehler aufgetreten“ und Berechtigungsfehler

Leitfaden zur Fehlerbehebung für das Vitextra Password Vault-Webpart in SharePoint Online und Microsoft Teams: der Bildschirm „Leider ist ein Fehler aufgetreten“ mit der Schaltfläche „Aktualisieren“, die nicht genehmigte Microsoft-Graph-Berechtigung Files.ReadWrite.AppFolder, Benutzer ohne OneDrive, blockierter Netzwerkzugriff, Fehler beim Speichern eines Eintrags, Änderungen, die auf einem anderen Gerät nicht erscheinen, ein unerwarteter PIN-Einrichtungsbildschirm und die Lizenzmeldung – jeweils mit Prüfung und Lösung.

40 9 Min.
Ausgewählte Elemente aus einer nativen SharePoint-Liste in List Filter Online öffnen

So aktivieren und verwenden Sie den Befehl „In List Filter öffnen", den das Vitextra-List-Filter-Online-Paket nativen SharePoint-Listen und -Bibliotheken hinzufügt: Eintrag in der Liste Tenant Wide Extensions konfigurieren, Zielseite festlegen, Geltungsbereich des Befehls einschränken und ausgewählte Elemente auf einer Seite mit dem List-Filter-Online-Webpart öffnen.

100 7 Min.
Kachelgrößen und Layout in Smart Tiles

Wie Kacheln im Vitextra Smart Tiles Webpart angeordnet werden: die sechs Kachelgrößen von Extra klein bis Volle Breite und der Anteil der Zeile, den jede einnimmt, wie Kacheln umbrechen und sich dehnen, um Zeilen zu füllen, die Einstellungen Interner Einzug, Symbol Einzug und Externer Einzug, die Kachelhöhe sowie Layoutrezepte für Abschnitte, Spalten und Panels mit voller Breite.

105 5 Min.

Teilen