Discussions Vue d'ensemble
Discussions stocke tout dans cinq listes du site où le forum a été créé : quatre listes personnalisées et une bibliothèque de documents. Ce sont des listes SharePoint ordinaires dans Contenu du site, soumises comme toute autre liste aux autorisations du site, au contrôle de version, à la rétention et à la recherche. Cet article est la référence de leurs colonnes — pour les administrateurs qui construisent des affichages, des rapports ou des flux sur les listes, et pour quiconque doit corriger un élément à la main. L'emplacement des données et ce qui quitte le locataire sont traités dans KB10411. Où Discussions stocke vos données : listes, colonnes et confidentialité ; cet article porte sur le schéma. La version décrite est la 26.10.3.
Comment les listes sont créées et reconnues
Les listes sont créées par le composant WebPart la première fois qu'un propriétaire de site crée un forum sur le site (New board sur l'écran Not Configured). Cela nécessite l'autorisation Gérer les listes. Chaque liste est créée avec ces paramètres :
- contrôle de version activé, types de contenu désactivés, modification en grille désactivée, non masquée, incluse dans l'analyse de recherche ;
- pièces jointes activées sur les quatre listes ; création de dossiers activée uniquement dans la bibliothèque ;
- chaque colonne personnalisée est ajoutée à l'affichage par défaut.
Les titres des listes proviennent de la langue d'interface de l'utilisateur qui les crée : Discussions Boards, Discussions Topics, Discussions Posts, Discussions Subscriptions, Discussions Assets sur un site anglais, Доски обсуждений, Темы обсуждений, Сообщения обсуждений, Подписки обсуждений, Файлы обсуждений sur un site russe. Les noms d'affichage des colonnes suivent la même règle ; les noms internes sont toujours ceux des tableaux ci-dessous et commencent toujours par Vtx.
Le composant WebPart ne dépend pas des titres. Chaque liste est reconnue par une colonne marqueur dont l'ID est fixe, de sorte qu'une liste peut être renommée librement et rester trouvée : elle est d'abord recherchée par son titre par défaut, puis parmi les listes visibles du même modèle par la colonne marqueur.
| Liste | Titre par défaut | Modèle | Colonne marqueur | Contient |
|---|---|---|---|---|
| Boards | Discussions Boards | Liste personnalisée | Mode (VtxMode) | Un élément par forum : mode, catégories, règle d'approbation |
| Topics | Discussions Topics | Liste personnalisée | Board (VtxBoard) | Un élément par sujet avec ses compteurs et son statut |
| Posts | Discussions Posts | Liste personnalisée | Topic (VtxTopic) | Un élément par réponse, avec la réponse parente et le chemin du fil |
| Subscriptions | Discussions Subscriptions | Liste personnalisée | Target type (VtxTargetType) | Qui suit quel forum ou quel sujet, et à quelle fréquence |
| Assets | Discussions Assets | Bibliothèque de documents | Discussions asset (VtxDiscussionsAsset) | Les images insérées dans les messages, dans un dossier par année |
📝 Remarque
Un site configuré avec une version antérieure peut ne pas avoir la liste Discussions Subscriptions, la bibliothèque Discussions Assets et les colonnes de modération. Le composant WebPart ajoute les listes et colonnes manquantes dès qu'un utilisateur disposant de Gérer les listes ouvre une page dont le composant WebPart a été configuré avant l'existence de ces deux listes ; la configuration du forum (Create board et Use board) exécute toujours la même vérification, de sorte que les colonnes introduites par des versions ultérieures y sont également ajoutées. Une liste ou une colonne déjà existante (reconnue par son ID) n'est jamais créée deux fois ; les utilisateurs sans Gérer les listes ne font que rechercher les listes.
Dans les tableaux ci-dessous, Indexée signifie que la colonne a été créée avec un index SharePoint afin que les filtres sur celle-ci restent rapides sur les grandes listes. Par défaut est la valeur que SharePoint attribue lorsqu'un élément est créé sans la colonne ; le composant WebPart définit la plupart des colonnes explicitement.
Discussions Boards
Un élément par forum. Title est le nom du forum affiché dans les listes déroulantes Board. Les modérateurs modifient le titre, la description, le mode, les catégories et le paramètre d'approbation dans le panneau Board settings du composant WebPart ; le formulaire de liste est une alternative.
| Colonne | Nom interne | Type | Indexée | Par défaut / valeurs | Rôle |
|---|---|---|---|---|---|
| Description | VtxDescription | Plusieurs lignes de texte (brut) | Non | Vide | Une description du forum, modifiée dans le panneau Board settings ; non affichée par le composant WebPart dans cette version |
| Mode | VtxMode | Choix | Non | Discussion, QnA, Mixed ; par défaut Discussion | Le mode du forum : discussions uniquement, questions et réponses uniquement, ou les deux. Les nouveaux forums sont créés avec Mixed sauf si un autre mode est choisi |
| Categories | VtxCategories | Plusieurs lignes de texte (brut) | Non | Vide | Les catégories du forum, un nom par ligne ; voir KB10423. Organiser les sujets avec des catégories |
| Topics | VtxTopicCount | Nombre | Non | 0 | Le nombre de sujets du forum : mis à 0 à la création, incrémenté lorsqu'un sujet est créé et décrémenté lorsqu'un sujet est supprimé depuis le composant WebPart (au mieux) ; non affiché par le composant WebPart dans cette version |
| Require approval | VtxRequireApproval | Oui/Non | Non | Non | Oui : les sujets et réponses des utilisateurs sans Gérer les listes sont créés en Pending et attendent dans la file de modération |
Discussions Topics
Un élément par sujet. Title est le titre du sujet ; Created et Created By sont l'heure de publication et l'auteur ; Attachments contient les fichiers joints au sujet.
| Colonne | Nom interne | Type | Indexée | Par défaut / valeurs | Rôle |
|---|---|---|---|---|---|
| Body | VtxBody | Plusieurs lignes de texte (texte enrichi amélioré) | Non | Vide | Le texte du sujet sous forme de HTML assaini |
| Board | VtxBoard | Recherche vers Discussions Boards (Title) | Oui | — | Le forum auquel appartient le sujet |
| Category | VtxCategory | Une seule ligne de texte | Oui | Vide | Le nom de la catégorie ; vide pour un sujet sans catégorie |
| Type | VtxTopicType | Choix | Oui | Discussion, Question ; par défaut Discussion | Si le sujet est une discussion ou une question |
| Status | VtxStatus | Choix | Oui | Open, Answered, Locked ; par défaut Open | Locked tant qu'un modérateur garde le sujet verrouillé ; sinon Answered lorsqu'une réponse est acceptée et Open lorsque la réponse est désélectionnée ou que la réponse acceptée est supprimée. L'état « répondu » affiché par le composant WebPart est dérivé de Accepted post, pas de cette colonne, de sorte que verrouiller une question ne change ni son badge ni sa vue |
| Pinned | VtxIsSticky | Oui/Non | Oui | Non | Les sujets épinglés sont listés en premier |
| Featured | VtxIsFeatured | Oui/Non | Oui | Non | Affiché dans la vue Featured |
| Replies | VtxReplyCount | Nombre | Non | 0 | Le nombre de réponses approuvées, tenu à jour par le composant WebPart |
| Views | VtxViewCount | Nombre | Non | 0 | Incrémenté à la première ouverture du sujet dans une session de navigateur |
| Last activity | VtxLastActivity | Date et heure | Oui | — | L'heure de la dernière réponse approuvée (ou l'heure de création) ; la liste des sujets est classée selon elle |
| Last reply by | VtxLastReplyBy | Personne | Non | — | L'auteur de la dernière réponse approuvée — pour une réponse approuvée depuis la file de modération, son auteur, pas le modérateur |
| Accepted post | VtxAcceptedPostId | Nombre | Non | 0 | L'ID de la réponse acceptée dans Discussions Posts ; 0 s'il n'y en a pas. La source de l'état « répondu » : le badge Answered et la vue Answered correspondent aux sujets dont la valeur est supérieure à 0, la vue Unanswered aux questions à 0 |
| Likes | VtxLikeCount | Nombre | Non | 0 | Le nombre de mentions J'aime sur le sujet |
| Liked by | VtxLikedBy | Personne (plusieurs) | Non | — | Les utilisateurs qui ont aimé le sujet ; une mention J'aime par utilisateur |
| Approval status | VtxApprovalStatus | Choix | Oui | Approved, Pending, Rejected ; par défaut Approved | L'état de modération ; les membres voient les éléments Approved et les leurs, les modérateurs voient tout |
| Mentions | VtxMentions | Personne (plusieurs) | Non | — | Les utilisateurs mentionnés avec @ dans le corps, pour les notifications |
| Reports | VtxReportCount | Nombre | Oui | 0 | Le nombre de signalements ; le sujet apparaît dans la file de modération tant qu'il est supérieur à 0 |
| Reported by | VtxReportedBy | Personne (plusieurs) | Non | — | Les utilisateurs qui ont signalé le sujet ; un signalement par utilisateur |
| Legacy id | VtxLegacyId | Une seule ligne de texte | Oui | Vide | {source list ID}:{item ID} de l'élément du forum de discussion classique dont le sujet a été importé ; permet à l'importateur d'ignorer les sujets déjà importés |
Discussions Posts
Un élément par réponse. Title est défini sur Re: suivi du titre du sujet ; Created et Created By sont l'heure de publication et l'auteur ; Attachments contient les fichiers joints à la réponse.
| Colonne | Nom interne | Type | Indexée | Par défaut / valeurs | Rôle |
|---|---|---|---|---|---|
| Body | VtxBody | Plusieurs lignes de texte (texte enrichi amélioré) | Non | Vide | Le texte de la réponse sous forme de HTML assaini |
| Topic | VtxTopic | Recherche vers Discussions Topics (Title) | Oui | — | Le sujet auquel appartient la réponse |
| Parent post | VtxParentPost | Recherche vers Discussions Posts (Title) | Oui | — | La réponse à laquelle celle-ci répond ; vide pour une réponse de premier niveau |
| Path | VtxPath | Une seule ligne de texte | Oui | Vide | Les ID des réponses ancêtres écrits par le composant WebPart, par exemple /12/15/ ; / pour une réponse de premier niveau |
| Depth | VtxDepth | Nombre | Non | 0 | Le niveau d'imbrication : 0 pour une réponse de premier niveau, 1 pour une réponse à celle-ci, et ainsi de suite |
| Is accepted answer | VtxIsAccepted | Oui/Non | Non | Non | Oui pour la réponse acceptée comme réponse ; au plus une par sujet |
| Likes | VtxLikeCount | Nombre | Non | 0 | Le nombre de mentions J'aime sur la réponse |
| Liked by | VtxLikedBy | Personne (plusieurs) | Non | — | Les utilisateurs qui ont aimé la réponse |
| Approval status | VtxApprovalStatus | Choix | Oui | Approved, Pending, Rejected ; par défaut Approved | L'état de modération de la réponse |
| Mentions | VtxMentions | Personne (plusieurs) | Non | — | Les utilisateurs mentionnés avec @ dans la réponse |
| Reports | VtxReportCount | Nombre | Oui | 0 | Le nombre de signalements sur la réponse |
| Reported by | VtxReportedBy | Personne (plusieurs) | Non | — | Les utilisateurs qui ont signalé la réponse |
| Legacy id | VtxLegacyId | Une seule ligne de texte | Oui | Vide | {source list ID}:{item ID} de la réponse classique dont celle-ci a été importée |
Les recherches vers le sujet et vers la réponse parente sont créées sans comportement de suppression en cascade ni de restriction : supprimer un sujet dans la liste ne supprime pas ses réponses, et supprimer une réponse ne supprime pas les réponses en dessous. La commande Delete du composant WebPart se comporte différemment : elle supprime un sujet avec toutes ses réponses et les images insérées de la bibliothèque Discussions Assets, et elle refuse de supprimer une réponse qui a ses propres réponses. Le composant WebPart rattache les réponses dont le parent est manquant au premier niveau du fil afin que rien ne disparaisse de la vue ; voir KB10432. Les compteurs, la dernière activité ou la meilleure réponse semblent incorrects.
Discussions Subscriptions
Un élément par utilisateur et par cible. Title est Board:ID ou Topic:ID.
| Colonne | Nom interne | Type | Indexée | Par défaut / valeurs | Rôle |
|---|---|---|---|---|---|
| User | VtxUser | Personne | Oui | — | L'abonné |
| Target type | VtxTargetType | Choix | Oui | Board, Topic ; par défaut Board | Si l'abonnement porte sur un forum ou sur un sujet |
| Target id | VtxTargetId | Nombre | Oui | 0 | L'ID de l'élément du forum ou de l'élément du sujet |
| Frequency | VtxFrequency | Choix | Non | Immediate, Daily, Weekly ; par défaut Immediate | La fréquence à laquelle l'abonné souhaite être notifié |
| Board | VtxBoard | Recherche vers Discussions Boards (Title) | Oui | — | Le forum de l'abonnement (également pour les abonnements à un sujet), afin qu'un flux puisse regrouper par forum |
Un utilisateur a un élément par cible ; suivre à nouveau avec une autre fréquence met à jour l'élément existant, et se désabonner le supprime. L'auteur d'un sujet y est abonné automatiquement avec Immediate. Le composant WebPart ne fait que tenir cette liste à jour ; l'envoi des e-mails est le rôle d'un flux Power Automate dont le contrat est décrit dans KB10414. Fonctionnement des notifications dans Discussions : abonnements, mentions et Power Automate.
Discussions Assets
Une bibliothèque de documents pour les images insérées dans les sujets et les réponses avec l'éditeur (collées, déposées ou choisies avec Insert image). Chaque image est chargée sous un nom unique dans un dossier nommé d'après l'année en cours (2026, 2027, …) afin qu'aucun dossier ne dépasse le seuil d'affichage de liste. La bibliothèque a une seule colonne personnalisée :
| Colonne | Nom interne | Type | Indexée | Par défaut / valeurs | Rôle |
|---|---|---|---|---|---|
| Discussions asset | VtxDiscussionsAsset | Une seule ligne de texte | Non | Vide | Colonne marqueur uniquement ; permet de reconnaître la bibliothèque quel que soit son titre |
Les fichiers joints à un sujet ou à une réponse avec Attach file ne sont pas stockés ici — ce sont des pièces jointes d'élément de liste du sujet ou de la réponse, conservées avec l'élément dans la liste Discussions Topics ou Discussions Posts.
Valeurs de choix
Les colonnes de choix stockent les valeurs anglaises ci-dessous quelle que soit la langue de l'interface ; le composant WebPart les traduit pour l'affichage.
| Colonne | Valeurs | Affiché comme |
|---|---|---|
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 | le badge Locked ; le badge Answered est dérivé de Accepted post (voir ci-dessus) ; Open n'a pas de badge |
Approval status (VtxApprovalStatus) | Approved, Pending, Rejected | les badges Awaiting approval et Rejected ; Approved n'a pas de badge |
Target type (VtxTargetType) | Board, Topic | — |
Frequency (VtxFrequency) | Immediate, Daily, Weekly | Immediately, Daily digest, Weekly digest |
Ce que vous pouvez modifier dans les listes
Le composant WebPart écrit dans les listes via l'API REST SharePoint en tant qu'utilisateur connecté, et il les relit à chaque chargement, de sorte que les modifications effectuées dans les formulaires de liste sont prises en compte au prochain rechargement. Certaines colonnes peuvent être modifiées sans risque, d'autres sont tenues à jour par le composant WebPart et il vaut mieux ne pas y toucher :
| Modifiable sans risque dans la liste | Tenue à jour par le composant WebPart |
|---|---|
| Title, Description, Mode, Categories, Require approval d'un forum — ou, plus commodément, le panneau Board settings du composant WebPart | Replies, Views, Last activity, Last reply by d'un sujet et Topics d'un forum (recalculées lors d'une activité ; une valeur manuelle est conservée jusqu'à la prochaine réponse, vue, ou création ou suppression de sujet) |
| Category, Pinned, Featured, Status (Locked), Approval status d'un sujet ou d'une réponse (le titre, la catégorie et le corps d'un sujet sont également modifiables avec Edit dans la vue du sujet) | Accepted post d'un sujet avec Is accepted answer de la réponse — ne les modifiez qu'ensemble ; l'état « répondu » suit Accepted post |
| Body d'un sujet ou d'une réponse (HTML brut ; le composant WebPart l'assainit à l'affichage) | Path, Depth, Parent post, Topic d'une réponse — déplacer une réponse à la main casse le fil |
| Frequency d'un abonnement | Likes / Liked by, Reports / Reported by — gardez le nombre égal au nombre de personnes |
❗ Important
Ne supprimez pas et ne renommez pas les colonnes Vtx, et ne changez pas leurs types. Le composant WebPart reconnaît les listes par les ID des colonnes marqueurs et lit toutes les autres colonnes par leur nom interne ; une colonne manquante fait échouer le forum avec une erreur. Renommer le nom d'affichage d'une colonne ou d'une liste est sans danger.
