Discussions Überblick
Discussions ist eine SharePoint-Framework-Lösung. Jedes Board, jedes Thema, jede Antwort, jedes Like, jede Meldung, jedes Abonnement, jede Anlage und jedes Bild liegt in gewöhnlichen SharePoint-Listen und einer Dokumentbibliothek auf der Website, auf der das Webpart ausgeführt wird, und jeder Lese- und Schreibvorgang erfolgt über die SharePoint-APIs (REST und CSOM) mit der Identität des angemeldeten Benutzers. Nichts wird außerhalb Ihres Microsoft 365-Mandanten gespeichert, und das Paket fordert keine Microsoft-Graph-Berechtigungen an. Dieser Artikel beschreibt die Speicherung so detailliert, wie es eine Sicherheitsprüfung oder eine Datenschutz-Folgenabschätzung erfordert.
Zusammenfassung für Administratoren
| Frage | Antwort |
|---|---|
| Wo werden die Inhalte gespeichert? | In vier Listen und einer Dokumentbibliothek auf der Website, die das Board hostet |
| Wer erstellt sie? | Das Webpart, bei der ersten Verwendung, im Kontext eines Benutzers mit der Berechtigung Listen verwalten – also eines Websitebesitzers; fehlende Listen und Spalten werden später auf dieselbe Weise ergänzt |
| Können die Listen umbenannt werden? | Ja – das Webpart erkennt sie anhand fester Spalten-IDs, nicht anhand des Titels |
| Wo werden Anlagen gespeichert? | Als Anlagen der Listenelemente in Diskussionsthemen und Diskussionsbeiträge |
| Wo werden eingebettete Bilder gespeichert? | In der Dokumentbibliothek Diskussionsressourcen, in einem Ordner pro Jahr |
| Wessen Identität wird verwendet? | Die des angemeldeten Benutzers, bei jedem Aufruf |
| Welche API-Berechtigungen fordert das Paket an? | Keine; Microsoft Graph wird nicht aufgerufen |
| Was wird an Vitextra gesendet? | Technische Bezeichner für die Lizenzprüfung und Nutzungstelemetrie; keine Inhalte |
| Was geschieht mit den Daten, wenn das Webpart entfernt wird? | Nichts – die Listen bleiben auf der Website, bis Sie sie löschen |
Die Listen auf der Website
Wenn ein Websitebesitzer das erste Board erstellt, stellt das Webpart die folgenden Listen auf Websiteebene bereit. Sie bedienen jedes Board der Website: Eine Website kann mehrere Boards haben, und alle teilen sich dieselben Listen.
| Standardtitel | Typ | Inhalt |
|---|---|---|
| Diskussionsboards | Benutzerdefinierte Liste | Ein Element pro Board: Titel, Beschreibung, Modus (Discussion, QnA oder Mixed), die Liste der Kategorien, der Themenzähler und die Einstellung Genehmigung erforderlich |
| Diskussionsthemen | Benutzerdefinierte Liste | Themen: Titel, Text, Nachschlagen auf das Board, Kategorie, Typ (Discussion oder Question), Status (Open, Answered, Locked), Kennzeichen für angeheftet und hervorgehoben, Zähler, letzte Aktivität, akzeptierte Antwort, Likes, Genehmigungsstatus, Erwähnungen, Meldungen, Legacy-ID |
| Diskussionsbeiträge | Benutzerdefinierte Liste | Antworten: Text, Nachschlagen auf das Thema, Nachschlagen auf die übergeordnete Antwort, materialisierter Pfad und Tiefe, Kennzeichen für akzeptierte Antwort, Likes, Genehmigungsstatus, Erwähnungen, Meldungen, Legacy-ID |
| Diskussionsabonnements | Benutzerdefinierte Liste | Wer welchem Board oder Thema folgt und mit welcher Häufigkeit |
| Diskussionsressourcen | Dokumentbibliothek | Bilder, die in den Rich-Text-Editor eingefügt wurden (eingefügt, abgelegt oder hochgeladen) |
Die Listen werden sichtbar in den Websiteinhalten erstellt, mit aktivierter Versionsverwaltung, deaktivierten Inhaltstypen und deaktivierter Schnellbearbeitung (Rasteransicht). Die beiden Inhaltslisten haben Elementanlagen aktiviert; in der Dokumentbibliothek ist das Erstellen von Ordnern aktiviert. Die Listen werden durchforstet, sodass Themen und Antworten wie jedes Listenelement in den SharePoint-Suchergebnissen erscheinen können.
Den Satz an Listen und Spalten hält das Webpart selbst aktuell. Öffnet ein Moderator (ein Benutzer mit der Berechtigung Listen verwalten) eine Seite, deren Webpart vor dem Entstehen der Abonnementliste oder der Assets-Bibliothek konfiguriert wurde, werden die fehlenden Listen und Spalten automatisch angelegt. Auch die Board-Einrichtung - Board erstellen und Board verwenden - prüft die Listen immer und ergänzt Spalten, die spätere Versionen eingeführt haben, jedoch nur für Benutzer mit Listen verwalten; andere Benutzer suchen nur die vorhandenen Listen. Dabei wird nichts umbenannt oder entfernt.
📝 Hinweis
Die Listentitel werden aus der Oberflächensprache der Person übernommen, die das Board erstellt. In einer englischen Oberfläche heißen die Listen Discussions Boards, Discussions Topics, Discussions Posts, Discussions Subscriptions und Discussions Assets; in einer russischen Oberfläche erhalten sie die russischen Titel aus dem Produkt. Die Titel können nachträglich geändert werden, ohne das Webpart zu beeinträchtigen.
Wie die Listen erkannt werden
Das Webpart ist nicht von Listentiteln abhängig. Jede Liste trägt eine Markierungsspalte mit einer festen Spalten-ID: die Spalte Modus der Boards-Liste, das Nachschlagefeld Board der Themenliste, das Nachschlagefeld Thema der Beitragsliste, die Spalte Zieltyp der Abonnementliste und eine Textspalte Diskussionsressource in der Dokumentbibliothek. Das Webpart sucht die Listen zuerst nach Titel und durchsucht, wenn es sie nicht findet, die sichtbaren Listen der Website nach den Markierungsspalten. Daraus folgt:
- Sie dürfen eine Liste umbenennen oder den Anzeigenamen einer Spalte ändern – das Webpart funktioniert weiter;
- Sie dürfen die Markierungsspalten und die übrigen
Vtx-Spalten nicht löschen – das Webpart würde die Liste als fehlend behandeln oder die Elemente nicht lesen können; - die Listen müssen auf derselben Website bleiben wie die Seite, die das Webpart hostet; ein Board kann nicht von einer anderen Website bedient werden.
Die Spalten
Alle vom Produkt hinzugefügten Spalten haben interne Namen, die mit Vtx beginnen; die Anzeigenamen werden wie die Listentitel lokalisiert. Die vollständige Referenz mit Typen, Indizes und den zulässigen Werten der Auswahlspalten finden Sie in KB10426. Referenz der Listen und Spalten von Discussions. Die für eine Datenprüfung wichtigen Punkte:
- Texte von Themen und Antworten (
VtxBody) werden als HTML gespeichert. Der Editor leitet alles vor dem Speichern durch einen Sanitizer mit Positivliste, und das Webpart bereinigt die Inhalte vor dem Rendern erneut, sodass ein direkt in der Liste bearbeiteter Wert keine Skripte in die Seite einschleusen kann. - Personen sind Standard-Personenspalten von SharePoint: der Autor und der Bearbeiter jedes Elements, die erwähnten Benutzer (
VtxMentions), die Benutzer, die ein Element mit Like markiert (VtxLikedBy) oder gemeldet haben (VtxReportedBy), die zuletzt antwortende Person (VtxLastReplyBy) und der Abonnent (VtxUser). Eine Personenspalte verweist auf die Benutzerinformationsliste der Website, nicht auf eine Kopie des Profils. - Moderationsdaten sind der Genehmigungsstatus (
VtxApprovalStatus: Approved, Pending oder Rejected), der Meldungszähler und die meldenden Personen. - Board-Einstellungen (
VtxDescription,VtxMode,VtxCategories,VtxRequireApproval) und der Boardtitel werden vom Befehl Board-Einstellungen des Webparts geschrieben, den Moderatoren in der Befehlsleiste öffnen; das Bearbeiten des Elements in der Liste Diskussionsboards hat dieselbe Wirkung. Die Kategorien werden eine pro Zeile gespeichert. - Zähler (
VtxReplyCount,VtxViewCount,VtxLikeCount,VtxTopicCount) sind Zahlen, die das Webpart aktualisiert; sie können in der Liste korrigiert werden. Der Aufrufzähler eines Themas wird höchstens einmal pro Browsersitzung erhöht.VtxTopicCountim Board-Element wird beim Erstellen eines Themas erhöht und beim Löschen eines Themas verringert; beide Aktualisierungen erfolgen nach bestem Bemühen, und der Wert wird im Webpart nicht angezeigt. - Legacy-ID (
VtxLegacyId) bewahrt den Bezeichner des Elements des klassischen Diskussionsforums, aus dem ein Eintrag importiert wurde, damit der Importer ohne Duplikate erneut ausgeführt werden kann.
Anlagen und eingebettete Bilder
Dateien, die Benutzer an ein Thema oder eine Antwort anhängen, werden als Elementanlagen des jeweiligen Listenelements in Diskussionsthemen oder Diskussionsbeiträge gespeichert – im Standard-Anlagenordner des Elements in SharePoint. Sie folgen den Berechtigungen des Elements und werden zusammen mit ihm gelöscht.
Bilder, die in den Text eines Beitrags eingefügt werden, werden in die Dokumentbibliothek Diskussionsressourcen hochgeladen. Das Webpart erstellt einen Ordner mit dem Namen des aktuellen Jahres (2026, 2027, …) und speichert die Datei dort unter einem eindeutigen Namen aus Zeitstempel, zufälligem Suffix und ursprünglichem Dateinamen, sodass zwei Benutzer screenshot.png ohne Konflikt hochladen können; die Jahresordner ordnen die Bilder nach Jahr. Ein Bild, das größer als 10 MB ist, wird vom Editor abgelehnt. Der Beitrag verweist auf das Bild über dessen Adresse in der Bibliothek, sodass ein Leser Lesezugriff auf die Bibliothek – von der Website geerbt – benötigt, um es zu sehen.
Wird ein Thema oder eine Antwort im Webpart gelöscht (vom Autor oder von einem Moderator, nach einer Bestätigung), löscht das Webpart auch die eingebetteten Bilder des gelöschten Textes aus Diskussionsressourcen. Beim Löschen eines Themas werden zuerst alle seine Antworten gelöscht, die tiefsten zuerst, danach das Thema selbst, zusammen mit den Bildern all dieser Beiträge; eine Antwort, die noch verschachtelte Antworten hat, kann nicht gelöscht werden. Die Bildbereinigung erfolgt nach bestem Bemühen: Es werden nur Dateien der Bibliothek Diskussionsressourcen angefasst, ein Fehler bricht das Löschen nicht ab, und ein Bild, das beim Bearbeiten aus einem Beitrag entfernt wird, bleibt in der Bibliothek.
❗ Wichtig
Das Löschen einer Datei aus Diskussionsressourcen ändert den Beitrag nicht, der auf sie verweist: Der Beitrag behält die Adresse und zeigt ein defektes Bild. Das Löschen eines Listenelements löscht dessen Anlagen mit. Prüfen Sie gesondert, ob SharePoint eine Wiederherstellung anbietet; die Wiederherstellung gelöschter Elemente, Anlagen und Bilder ist nicht garantiert.
Was auf der Seite gespeichert wird
Die Konfiguration des Webparts wird wie bei jedem SPFx-Webpart in den Webpart-Eigenschaften der Seite gespeichert: das ausgewählte Board und sein Titel, die IDs und Adressen der Listen sowie die Anzeigeoptionen. Das Webpart Discussions Activity speichert das ausgewählte Board, die Adresse der Board-Seite, die maximale Anzahl der Elemente und den Schalter für den Board-Namen. Es werden keine Inhalte im Browser oder im lokalen Speicher zwischengespeichert.
Identität und Berechtigungen
- Jede Anfrage ist ein SharePoint-REST- oder CSOM-Aufruf an die betreffende SharePoint-Website mit dem Token des angemeldeten Benutzers. SharePoint wendet auf jeden Aufruf die Berechtigungen dieses Benutzers an; das Webpart entscheidet lediglich, welche Schaltflächen angezeigt werden (siehe KB10408. Berechtigungen in Discussions: Wer lesen, schreiben und moderieren darf).
- Das Paket fordert keine API-Berechtigungen an: Auf der Seite API-Zugriff (API access) des SharePoint Admin Centers erscheint nichts, und Microsoft Graph wird nie aufgerufen. Einzelheiten finden Sie in KB10413. API-Berechtigungen und Administratoreinwilligung für Discussions; das Verfahren aus KB10360. So genehmigen Sie Microsoft-Graph-API-Berechtigungen für Vitextra-Lösungen im SharePoint Admin Center ist für dieses Produkt nicht erforderlich.
- Die Personenauswahl hinter den @Erwähnungen verwendet die Standard-Personensuche von SharePoint auf der Website; eine erwähnte Person wird der Benutzerinformationsliste der Website hinzugefügt, falls sie dort noch nicht vorhanden war – das Standardverhalten beim Ausfüllen einer Personenspalte.
- Das Webpart sendet keine E-Mails. Benachrichtigungen werden von einem Power-Automate-Flow zugestellt, den der Websitebesitzer einrichtet; siehe KB10414. So funktionieren Benachrichtigungen in Discussions: Abonnements, Erwähnungen und Power Automate.
Der Importer klassischer Boards kann eine andere Website desselben Mandanten lesen. Ursprüngliche Autoren und Datumsangaben stellt er über SharePoint CSOM wieder her; andere Inhaltsvorgänge verwenden REST. Alle Aufrufe verwenden die Berechtigungen des angemeldeten Benutzers.
Was den Mandanten verlässt
| Zweck | Was gesendet wird | Wohin |
|---|---|---|
| Lizenzprüfung | Die Mandanten-ID, die Objekt-ID des Benutzers, die Websiteadresse, der Bezeichner, der Name und die Version des Produkts | vitextra.com |
| Nutzungstelemetrie | Ein Ereignis beim Laden des Webparts (Produkt und Version, Website-ID und -Adresse, die Objekt-ID des Benutzers, die Oberflächensprache, ob das Webpart in Teams ausgeführt wird) sowie technische Details zu Fehlern | Azure Application Insights |
| Produktdateien | Eine gewöhnliche Anfrage nach den Skripts und Symbolen der Webparts | static.vitextra.com, vitextra-storage.azureedge.net |
Kein Board, kein Thema, keine Antwort, keine Anlage, kein Bild, kein Abonnement und keine Erwähnung wird an Vitextra oder an Dritte gesendet. Das Gesamtbild über alle Vitextra-Produkte, einschließlich der freizugebenden Netzwerkadressen, finden Sie in KB10363. Wo Vitextra-Produkte Ihre Daten speichern: Datenschutz, Datenresidenz und DSGVO.
Lebenszyklus der Daten
- Das Entfernen des Webparts von einer Seite lässt die Listen und ihre Inhalte unberührt; fügen Sie das Webpart erneut hinzu und wählen Sie das vorhandene Board, um fortzufahren.
- Das Entfernen des Pakets aus dem App-Katalog oder von der Website deaktiviert die Webparts, behält aber die Listen, die in den Standard-Listenansichten lesbar bleiben; siehe KB10362. So entfernen Sie eine Vitextra-Lösung aus SharePoint Online und Microsoft Teams.
- Das Löschen der Listen löscht die Boards, Themen, Antworten, Abonnements und Dateien; sie landen im Papierkorb der Website.
- Aufbewahrung, eDiscovery, Überwachung und Vertraulichkeitsbezeichnungen gelten für die Listen wie für jede andere Liste der Website.
- Der Export ist mit dem Standardbefehl Nach Excel exportieren jeder Liste oder mit einem Power-Automate-Flow möglich; die Texte werden als HTML exportiert.
