Discussions Überblick
Discussions speichert alles in fünf Listen der Website, auf der das Board erstellt wurde: vier benutzerdefinierte Listen und eine Dokumentbibliothek. Es sind gewöhnliche SharePoint-Listen unter Websiteinhalte, die wie jede andere Liste den Websiteberechtigungen, der Versionierung, der Aufbewahrung und der Suche unterliegen. Dieser Artikel ist die Referenz für ihre Spalten – für Administratoren, die Ansichten, Berichte oder Flows auf den Listen aufbauen, und für alle, die ein Element von Hand korrigieren müssen. Wo die Daten liegen und was den Mandanten verlässt, behandelt KB10411. Wo Discussions Ihre Daten speichert: Listen, Spalten und Datenschutz; in diesem Artikel geht es um das Schema. Beschrieben wird die Version 26.10.3.
Wie die Listen erstellt und erkannt werden
Die Listen werden vom Webpart erstellt, wenn ein Websitebesitzer zum ersten Mal ein Board auf der Website anlegt (New board auf dem Bildschirm „Not Configured“). Dies erfordert die Berechtigung Listen verwalten. Jede Liste wird mit diesen Einstellungen erstellt:
- Versionierung ein, Inhaltstypen aus, Rasterbearbeitung aus, nicht ausgeblendet, in die Suchdurchforstung einbezogen;
- Anlagen aktiviert bei den vier Listen; Ordnererstellung nur in der Bibliothek aktiviert;
- jede benutzerdefinierte Spalte wird der Standardansicht hinzugefügt.
Die Titel der Listen stammen aus der Sprache der Benutzeroberfläche des Benutzers, der sie erstellt: Discussions Boards, Discussions Topics, Discussions Posts, Discussions Subscriptions, Discussions Assets auf einer englischen Website, Доски обсуждений, Темы обсуждений, Сообщения обсуждений, Подписки обсуждений, Файлы обсуждений auf einer russischen Website. Die Anzeigenamen der Spalten folgen derselben Regel; die internen Namen sind immer die in den Tabellen unten und beginnen immer mit Vtx.
Das Webpart ist nicht von den Titeln abhängig. Jede Liste wird an einer Markierungsspalte mit fester ID erkannt, sodass eine Liste frei umbenannt werden kann und trotzdem gefunden wird: Sie wird zuerst über ihren Standardtitel gesucht, dann unter den sichtbaren Listen derselben Vorlage anhand der Markierungsspalte.
| Liste | Standardtitel | Vorlage | Markierungsspalte | Enthält |
|---|---|---|---|---|
| Boards | Discussions Boards | Benutzerdefinierte Liste | Mode (VtxMode) | Ein Element pro Board: Modus, Kategorien, Genehmigungsregel |
| Topics | Discussions Topics | Benutzerdefinierte Liste | Board (VtxBoard) | Ein Element pro Thema mit seinen Zählern und seinem Status |
| Posts | Discussions Posts | Benutzerdefinierte Liste | Topic (VtxTopic) | Ein Element pro Antwort, mit der übergeordneten Antwort und dem Threadpfad |
| Subscriptions | Discussions Subscriptions | Benutzerdefinierte Liste | Target type (VtxTargetType) | Wer welchem Board oder Thema folgt und wie oft |
| Assets | Discussions Assets | Dokumentbibliothek | Discussions asset (VtxDiscussionsAsset) | Inline-Bilder von Beiträgen, in einem Ordner pro Jahr |
📝 Hinweis
Einer Website, die mit einer früheren Version eingerichtet wurde, fehlen möglicherweise die Liste Discussions Subscriptions, die Bibliothek Discussions Assets und die Moderationsspalten. Das Webpart fügt die fehlenden Listen und Spalten hinzu, sobald ein Benutzer mit Listen verwalten eine Seite öffnet, deren Webpart konfiguriert wurde, bevor es die beiden Listen gab; die Boardeinrichtung (Create board und Use board) führt immer dieselbe Prüfung aus, sodass auch von späteren Versionen eingeführte Spalten dort hinzugefügt werden. Eine bereits vorhandene Liste oder Spalte (erkannt an ihrer ID) wird nie doppelt erstellt; Benutzer ohne Listen verwalten suchen die Listen nur.
In den Tabellen unten bedeutet Indiziert, dass die Spalte mit einem SharePoint-Index erstellt wurde, damit Filter auf ihr bei großen Listen schnell bleiben. Standard ist der Wert, den SharePoint zuweist, wenn ein Element ohne die Spalte erstellt wird; das Webpart setzt die meisten Spalten explizit.
Discussions Boards
Ein Element pro Board. Title ist der Boardname, der in den Dropdownlisten Board angezeigt wird. Moderatoren bearbeiten den Titel, die Beschreibung, den Modus, die Kategorien und die Genehmigungseinstellung im Bereich Board settings des Webparts; das Listenformular ist eine Alternative.
| Spalte | Interner Name | Typ | Indiziert | Standard / Werte | Zweck |
|---|---|---|---|---|---|
| Description | VtxDescription | Mehrere Textzeilen (Nur-Text) | Nein | Leer | Eine Beschreibung des Boards, bearbeitet im Bereich Board settings; wird in dieser Version vom Webpart nicht angezeigt |
| Mode | VtxMode | Auswahl | Nein | Discussion, QnA, Mixed; Standard Discussion | Der Modus des Boards: nur Diskussionen, nur Fragen und Antworten oder beides. Neue Boards werden mit Mixed erstellt, sofern kein anderer Modus gewählt wird |
| Categories | VtxCategories | Mehrere Textzeilen (Nur-Text) | Nein | Leer | Die Kategorien des Boards, ein Name pro Zeile; siehe KB10423. Themen mit Kategorien organisieren |
| Topics | VtxTopicCount | Zahl | Nein | 0 | Die Anzahl der Themen des Boards: wird bei der Erstellung auf 0 gesetzt, beim Erstellen eines Themas erhöht und beim Löschen eines Themas aus dem Webpart verringert (nach bestem Bemühen); wird in dieser Version vom Webpart nicht angezeigt |
| Require approval | VtxRequireApproval | Ja/Nein | Nein | Nein | Ja: Themen und Antworten von Benutzern ohne Listen verwalten werden als Pending erstellt und warten in der Moderationswarteschlange |
Discussions Topics
Ein Element pro Thema. Title ist der Thementitel; Created und Created By sind der Zeitpunkt des Postens und der Autor; Attachments enthält die an das Thema angehängten Dateien.
| Spalte | Interner Name | Typ | Indiziert | Standard / Werte | Zweck |
|---|---|---|---|---|---|
| Body | VtxBody | Mehrere Textzeilen (erweiterter Rich-Text) | Nein | Leer | Der Text des Themas als bereinigtes HTML |
| Board | VtxBoard | Nachschlagen in Discussions Boards (Title) | Ja | — | Das Board, zu dem das Thema gehört |
| Category | VtxCategory | Einzelne Textzeile | Ja | Leer | Der Kategoriename; leer bei einem Thema ohne Kategorie |
| Type | VtxTopicType | Auswahl | Ja | Discussion, Question; Standard Discussion | Ob das Thema eine Diskussion oder eine Frage ist |
| Status | VtxStatus | Auswahl | Ja | Open, Answered, Locked; Standard Open | Locked, solange ein Moderator das Thema gesperrt hält; andernfalls Answered, wenn eine Antwort akzeptiert ist, und Open, wenn die Antwortmarkierung aufgehoben oder die akzeptierte Antwort gelöscht wird. Der vom Webpart angezeigte Beantwortet-Status wird aus Accepted post abgeleitet, nicht aus dieser Spalte, sodass das Sperren einer Frage weder ihr Badge noch ihre Ansicht ändert |
| Pinned | VtxIsSticky | Ja/Nein | Ja | Nein | Angeheftete Themen werden zuerst aufgeführt |
| Featured | VtxIsFeatured | Ja/Nein | Ja | Nein | Wird in der Ansicht Featured angezeigt |
| Replies | VtxReplyCount | Zahl | Nein | 0 | Die Anzahl der genehmigten Antworten, vom Webpart gepflegt |
| Views | VtxViewCount | Zahl | Nein | 0 | Wird beim ersten Öffnen des Themas in einer Browsersitzung erhöht |
| Last activity | VtxLastActivity | Datum und Uhrzeit | Ja | — | Der Zeitpunkt der letzten genehmigten Antwort (oder der Erstellungszeitpunkt); die Themenliste ist danach geordnet |
| Last reply by | VtxLastReplyBy | Person | Nein | — | Der Autor der letzten genehmigten Antwort – bei einer aus der Moderationswarteschlange genehmigten Antwort deren Autor, nicht der Moderator |
| Accepted post | VtxAcceptedPostId | Zahl | Nein | 0 | Die ID der akzeptierten Antwort in Discussions Posts; 0, wenn keine. Die Quelle des Beantwortet-Status: das Badge Answered und die Ansicht Answered sind Themen mit einem Wert größer als 0, die Ansicht Unanswered sind Fragen mit 0 |
| Likes | VtxLikeCount | Zahl | Nein | 0 | Die Anzahl der „Gefällt mir“-Angaben für das Thema |
| Liked by | VtxLikedBy | Person (mehrere) | Nein | — | Die Benutzer, denen das Thema gefällt; eine Angabe pro Benutzer |
| Approval status | VtxApprovalStatus | Auswahl | Ja | Approved, Pending, Rejected; Standard Approved | Der Moderationsstatus; Mitglieder sehen Approved-Elemente und ihre eigenen, Moderatoren sehen alles |
| Mentions | VtxMentions | Person (mehrere) | Nein | — | Die im Text mit @ erwähnten Benutzer, für Benachrichtigungen |
| Reports | VtxReportCount | Zahl | Ja | 0 | Die Anzahl der Meldungen; das Thema erscheint in der Moderationswarteschlange, solange sie größer als 0 ist |
| Reported by | VtxReportedBy | Person (mehrere) | Nein | — | Die Benutzer, die das Thema gemeldet haben; eine Meldung pro Benutzer |
| Legacy id | VtxLegacyId | Einzelne Textzeile | Ja | Leer | {source list ID}:{item ID} des klassischen Diskussionsforum-Elements, aus dem das Thema importiert wurde; lässt den Importer bereits importierte Themen überspringen |
Discussions Posts
Ein Element pro Antwort. Title wird auf Re: gefolgt vom Thementitel gesetzt; Created und Created By sind der Zeitpunkt des Postens und der Autor; Attachments enthält die an die Antwort angehängten Dateien.
| Spalte | Interner Name | Typ | Indiziert | Standard / Werte | Zweck |
|---|---|---|---|---|---|
| Body | VtxBody | Mehrere Textzeilen (erweiterter Rich-Text) | Nein | Leer | Der Text der Antwort als bereinigtes HTML |
| Topic | VtxTopic | Nachschlagen in Discussions Topics (Title) | Ja | — | Das Thema, zu dem die Antwort gehört |
| Parent post | VtxParentPost | Nachschlagen in Discussions Posts (Title) | Ja | — | Die Antwort, auf die diese antwortet; leer bei einer Antwort auf oberster Ebene |
| Path | VtxPath | Einzelne Textzeile | Ja | Leer | Die vom Webpart geschriebenen IDs der übergeordneten Antworten, zum Beispiel /12/15/; / bei einer Antwort auf oberster Ebene |
| Depth | VtxDepth | Zahl | Nein | 0 | Die Verschachtelungsebene: 0 bei einer Antwort auf oberster Ebene, 1 bei einer Antwort darauf und so weiter |
| Is accepted answer | VtxIsAccepted | Ja/Nein | Nein | Nein | Ja bei der als Antwort akzeptierten Antwort; höchstens eine pro Thema |
| Likes | VtxLikeCount | Zahl | Nein | 0 | Die Anzahl der „Gefällt mir“-Angaben für die Antwort |
| Liked by | VtxLikedBy | Person (mehrere) | Nein | — | Die Benutzer, denen die Antwort gefällt |
| Approval status | VtxApprovalStatus | Auswahl | Ja | Approved, Pending, Rejected; Standard Approved | Der Moderationsstatus der Antwort |
| Mentions | VtxMentions | Person (mehrere) | Nein | — | Die in der Antwort mit @ erwähnten Benutzer |
| Reports | VtxReportCount | Zahl | Ja | 0 | Die Anzahl der Meldungen zur Antwort |
| Reported by | VtxReportedBy | Person (mehrere) | Nein | — | Die Benutzer, die die Antwort gemeldet haben |
| Legacy id | VtxLegacyId | Einzelne Textzeile | Ja | Leer | {source list ID}:{item ID} der klassischen Antwort, aus der diese importiert wurde |
Die Nachschlagespalten zum Thema und zur übergeordneten Antwort werden ohne kaskadierendes oder einschränkendes Löschverhalten erstellt: Das Löschen eines Themas in der Liste löscht seine Antworten nicht, und das Löschen einer Antwort löscht die darunter liegenden Antworten nicht. Der Befehl Delete des Webparts verhält sich anders: Er löscht ein Thema zusammen mit allen seinen Antworten und den Inline-Bildern der Bibliothek Discussions Assets, und er verweigert das Löschen einer Antwort, die eigene Antworten hat. Das Webpart hängt Antworten, deren übergeordnetes Element fehlt, an die oberste Ebene des Threads an, damit nichts aus dem Blick verschwindet; siehe KB10432. Zähler, letzte Aktivität oder beste Antwort sehen falsch aus.
Discussions Subscriptions
Ein Element pro Benutzer und Ziel. Title ist Board:ID oder Topic:ID.
| Spalte | Interner Name | Typ | Indiziert | Standard / Werte | Zweck |
|---|---|---|---|---|---|
| User | VtxUser | Person | Ja | — | Der Abonnent |
| Target type | VtxTargetType | Auswahl | Ja | Board, Topic; Standard Board | Ob das Abonnement ein Board oder ein Thema betrifft |
| Target id | VtxTargetId | Zahl | Ja | 0 | Die ID des Boardelements oder des Themenelements |
| Frequency | VtxFrequency | Auswahl | Nein | Immediate, Daily, Weekly; Standard Immediate | Wie oft der Abonnent benachrichtigt werden möchte |
| Board | VtxBoard | Nachschlagen in Discussions Boards (Title) | Ja | — | Das Board des Abonnements (auch bei Themenabonnements), damit ein Flow nach Board gruppieren kann |
Ein Benutzer hat ein Element pro Ziel; erneutes Folgen mit einer anderen Häufigkeit aktualisiert das vorhandene Element, und das Beenden des Folgens löscht es. Der Autor eines Themas wird automatisch mit Immediate darauf abonniert. Das Webpart pflegt diese Liste nur; der E-Mail-Versand ist Aufgabe eines Power Automate-Flows, dessen Vertrag in KB10414. So funktionieren Benachrichtigungen in Discussions: Abonnements, Erwähnungen und Power Automate beschrieben ist.
Discussions Assets
Eine Dokumentbibliothek für die Bilder, die mit dem Editor in Themen und Antworten eingefügt werden (eingefügt, gezogen oder mit Insert image ausgewählt). Jedes Bild wird unter einem eindeutigen Namen in einen nach dem aktuellen Jahr benannten Ordner (2026, 2027, …) hochgeladen, damit kein Ordner über den Schwellenwert der Listenansicht hinauswächst. Die Bibliothek hat eine einzige benutzerdefinierte Spalte:
| Spalte | Interner Name | Typ | Indiziert | Standard / Werte | Zweck |
|---|---|---|---|---|---|
| Discussions asset | VtxDiscussionsAsset | Einzelne Textzeile | Nein | Leer | Nur Markierungsspalte; lässt die Bibliothek unabhängig von ihrem Titel erkennen |
Dateien, die mit Attach file an ein Thema oder eine Antwort angehängt werden, werden nicht hier gespeichert – sie sind Listenelementanlagen des Themen- oder Antwortelements und werden mit dem Element in der Liste Discussions Topics oder Discussions Posts aufbewahrt.
Auswahlwerte
Die Auswahlspalten speichern unabhängig von der Sprache der Benutzeroberfläche die unten stehenden englischen Werte; das Webpart übersetzt sie für die Anzeige.
| Spalte | Werte | Angezeigt als |
|---|---|---|
Mode (VtxMode) | Discussion, QnA, Mixed | Discussions only, Questions and answers only, Discussions and questions |
Type (VtxTopicType) | Discussion, Question | Discussion, Question |
Status (VtxStatus) | Open, Answered, Locked | das Badge Locked; das Badge Answered wird aus Accepted post abgeleitet (siehe oben); Open hat kein Badge |
Approval status (VtxApprovalStatus) | Approved, Pending, Rejected | die Badges Awaiting approval und Rejected; Approved hat kein Badge |
Target type (VtxTargetType) | Board, Topic | — |
Frequency (VtxFrequency) | Immediate, Daily, Weekly | Immediately, Daily digest, Weekly digest |
Was Sie in den Listen bearbeiten können
Das Webpart schreibt die Listen über die SharePoint-REST-API als angemeldeter Benutzer und liest sie bei jedem Laden erneut, sodass in den Listenformularen vorgenommene Änderungen beim nächsten Neuladen übernommen werden. Einige Spalten können gefahrlos bearbeitet werden, andere werden vom Webpart gepflegt und bleiben besser unangetastet:
| Gefahrlos in der Liste bearbeitbar | Vom Webpart gepflegt |
|---|---|
| Title, Description, Mode, Categories, Require approval eines Boards – oder, bequemer, der Bereich Board settings des Webparts | Replies, Views, Last activity, Last reply by eines Themas und Topics eines Boards (werden bei Aktivität neu berechnet; ein manueller Wert bleibt bis zur nächsten Antwort, zum nächsten Aufruf oder zum nächsten erstellten oder gelöschten Thema erhalten) |
| Category, Pinned, Featured, Status (Locked), Approval status eines Themas oder einer Antwort (Titel, Kategorie und Text eines Themas lassen sich auch mit Edit in der Themenansicht bearbeiten) | Accepted post eines Themas zusammen mit Is accepted answer der Antwort – ändern Sie sie nur gemeinsam; der Beantwortet-Status folgt Accepted post |
| Body eines Themas oder einer Antwort (reines HTML; das Webpart bereinigt es bei der Anzeige) | Path, Depth, Parent post, Topic einer Antwort – das manuelle Verschieben einer Antwort zerstört den Thread |
| Frequency eines Abonnements | Likes / Liked by, Reports / Reported by – halten Sie die Zahl gleich der Anzahl der Personen |
❗ Wichtig
Löschen oder benennen Sie die Vtx-Spalten nicht um und ändern Sie ihre Typen nicht. Das Webpart erkennt die Listen an den IDs der Markierungsspalten und liest jede andere Spalte über ihren internen Namen; eine fehlende Spalte führt dazu, dass das Board mit einem Fehler ausfällt. Das Umbenennen des Anzeigenamens einer Spalte oder einer Liste ist unbedenklich.
