Discussions Vue d'ensemble
Discussions est une solution SharePoint Framework. Chaque forum, sujet, réponse, mention J'aime, signalement, abonnement, pièce jointe et image réside dans des listes SharePoint ordinaires et une bibliothèque de documents sur le site où s'exécute le composant WebPart, et chaque lecture et chaque écriture passent par les API de SharePoint (REST et CSOM) avec l'identité de l'utilisateur connecté. Rien n'est stocké en dehors de votre tenant Microsoft 365, et le package ne demande aucune autorisation Microsoft Graph. Cet article décrit le stockage avec le niveau de détail qu'exige un examen de sécurité ou une analyse de protection des données.
Synthèse pour les administrateurs
| Question | Réponse |
|---|---|
| Où le contenu est-il stocké ? | Dans quatre listes et une bibliothèque de documents sur le site qui héberge le forum |
| Qui les crée ? | Le composant WebPart, lors de la première utilisation, dans le contexte d'un utilisateur disposant de l'autorisation Gérer les listes - un propriétaire du site ; les listes et colonnes manquantes sont ajoutées plus tard de la même manière |
| Les listes peuvent-elles être renommées ? | Oui - le composant WebPart les reconnaît par des identifiants de colonnes fixes, pas par leur titre |
| Où sont stockées les pièces jointes ? | Comme pièces jointes des éléments de liste dans Sujets de discussion et Publications de discussion |
| Où sont stockées les images incorporées ? | Dans la bibliothèque de documents Ressources de discussion, dans un dossier par année |
| Quelle identité est utilisée ? | Celle de l'utilisateur connecté, pour chaque appel |
| Quelles autorisations d'API le package demande-t-il ? | Aucune ; Microsoft Graph n'est pas appelé |
| Qu'est-ce qui est envoyé à Vitextra ? | Des identifiants techniques pour la vérification de licence et la télémétrie d'utilisation ; aucun contenu |
| Qu'advient-il des données lorsque le composant WebPart est supprimé ? | Rien - les listes restent sur le site jusqu'à ce que vous les supprimiez |
Les listes sur le site
Lorsqu'un propriétaire du site crée le premier forum, le composant WebPart approvisionne les listes suivantes au niveau du site. Elles servent tous les forums du site : un site peut avoir plusieurs forums, et tous partagent les mêmes listes.
| Titre par défaut | Type | Contenu |
|---|---|---|
| Forums de discussion | Liste personnalisée | Un élément par forum : titre, description, mode (Discussion, QnA ou Mixed), la liste des catégories, le compteur de sujets et le paramètre Approbation requise |
| Sujets de discussion | Liste personnalisée | Sujets : titre, corps, référence vers le forum, catégorie, type (Discussion ou Question), statut (Open, Answered, Locked), indicateurs épinglé et mis en avant, compteurs, dernière activité, réponse acceptée, mentions J'aime, statut d'approbation, mentions, signalements, identifiant hérité |
| Publications de discussion | Liste personnalisée | Réponses : corps, référence vers le sujet, référence vers la réponse parente, chemin matérialisé et profondeur, indicateur de réponse acceptée, mentions J'aime, statut d'approbation, mentions, signalements, identifiant hérité |
| Abonnements aux discussions | Liste personnalisée | Qui suit quel forum ou quel sujet et à quelle fréquence |
| Ressources de discussion | Bibliothèque de documents | Images insérées dans l'éditeur de texte enrichi (collées, déposées ou chargées) |
Les listes sont créées visibles dans Contenu du site, avec le contrôle de version activé, les types de contenu désactivés et la modification rapide (en grille) désactivée. Les deux listes de contenu ont les pièces jointes d'éléments activées ; la bibliothèque de documents a la création de dossiers activée. Les listes sont analysées par l'indexation, de sorte que les sujets et les réponses peuvent apparaître dans les résultats de recherche SharePoint comme n'importe quel élément de liste.
Le composant WebPart maintient lui-même à jour l'ensemble des listes et des colonnes. Lorsqu'un modérateur (utilisateur disposant de l'autorisation Gérer les listes) ouvre une page dont le composant WebPart a été configuré avant l'existence de la liste des abonnements ou de la bibliothèque des ressources, les listes et colonnes manquantes sont créées automatiquement. La configuration d'un forum - Créer un forum et Utiliser le forum - vérifie elle aussi toujours les listes et ajoute les colonnes introduites par les versions ultérieures, mais uniquement pour les utilisateurs disposant de Gérer les listes ; les autres utilisateurs se contentent de rechercher les listes existantes. Rien n'est renommé ni supprimé au cours de l'opération.
📝 Remarque
Les titres des listes sont repris de la langue d'interface de la personne qui crée le forum. Dans une interface anglaise, les listes s'appellent Discussions Boards, Discussions Topics, Discussions Posts, Discussions Subscriptions et Discussions Assets ; dans une interface russe, elles reçoivent les titres russes du produit. Les titres peuvent être modifiés ensuite sans perturber le composant WebPart.
Comment les listes sont reconnues
Le composant WebPart ne dépend pas des titres des listes. Chaque liste porte une colonne marqueur avec un identifiant de colonne fixe : la colonne Mode de la liste des forums, la colonne de recherche Forum de la liste des sujets, la colonne de recherche Sujet de la liste des réponses, la colonne Type de cible de la liste des abonnements et une colonne de texte Ressource de discussion dans la bibliothèque de documents. Le composant WebPart cherche d'abord les listes par leur titre et, s'il ne les trouve pas, parcourt les listes visibles du site à la recherche des colonnes marqueurs. Par conséquent :
- vous pouvez renommer une liste ou modifier le nom d'affichage d'une colonne - le composant WebPart continue de fonctionner ;
- vous ne devez pas supprimer les colonnes marqueurs ni les autres colonnes
Vtx- le composant WebPart considérerait la liste comme manquante ou ne pourrait plus lire les éléments ; - les listes doivent rester sur le même site que la page qui héberge le composant WebPart ; un forum ne peut pas être servi depuis un autre site.
Les colonnes
Toutes les colonnes ajoutées par le produit ont des noms internes qui commencent par Vtx ; les noms d'affichage sont localisés de la même manière que les titres des listes. La référence complète, avec les types, les index et les valeurs autorisées des colonnes de choix, se trouve dans KB10426. Référence des listes et des colonnes de Discussions. Les points qui comptent pour un examen des données :
- Les corps des sujets et des réponses (
VtxBody) sont stockés en HTML. L'éditeur fait tout passer par un assainisseur à liste d'autorisation avant l'enregistrement, et le composant WebPart assainit à nouveau avant le rendu, de sorte qu'une valeur modifiée directement dans la liste ne peut pas injecter de scripts dans la page. - Les personnes sont des colonnes de personnes SharePoint standard : l'auteur et la dernière personne ayant modifié chaque élément, les utilisateurs mentionnés (
VtxMentions), les utilisateurs qui ont aimé (VtxLikedBy) ou signalé (VtxReportedBy) un élément, la dernière personne à avoir répondu (VtxLastReplyBy) et l'abonné (VtxUser). Une colonne de personnes référence la liste d'informations utilisateur du site, pas une copie du profil. - Les données de modération sont le statut d'approbation (
VtxApprovalStatus: Approved, Pending ou Rejected), le compteur de signalements et les personnes qui ont signalé. - Les paramètres du forum (
VtxDescription,VtxMode,VtxCategories,VtxRequireApproval) et le titre du forum sont écrits par la commande Paramètres du forum du composant WebPart, que les modérateurs ouvrent depuis la barre de commandes ; modifier l'élément dans la liste Forums de discussion a le même effet. Les catégories sont stockées à raison d'une par ligne. - Les compteurs (
VtxReplyCount,VtxViewCount,VtxLikeCount,VtxTopicCount) sont des nombres mis à jour par le composant WebPart ; ils peuvent être corrigés dans la liste. Le compteur de vues d'un sujet est incrémenté au plus une fois par session de navigateur.VtxTopicCountde l'élément du forum est incrémenté à la création d'un sujet et décrémenté à sa suppression ; ces deux mises à jour sont effectuées au mieux, et la valeur n'est pas affichée dans le composant WebPart. - L'identifiant hérité (
VtxLegacyId) conserve l'identifiant de l'élément du forum de discussion classique à partir duquel une entrée a été importée, afin que l'importateur puisse être relancé sans doublons.
Pièces jointes et images incorporées
Les fichiers que les utilisateurs joignent à un sujet ou à une réponse sont stockés comme pièces jointes d'élément de l'élément de liste correspondant dans Sujets de discussion ou Publications de discussion - le dossier de pièces jointes standard de l'élément dans SharePoint. Ils suivent les autorisations de l'élément et sont supprimés avec lui.
Les images insérées dans le corps d'un message sont chargées dans la bibliothèque de documents Ressources de discussion. Le composant WebPart crée un dossier portant le nom de l'année en cours (2026, 2027, …) et y enregistre le fichier sous un nom unique composé d'un horodatage, d'un suffixe aléatoire et du nom de fichier d'origine, de sorte que deux utilisateurs peuvent charger screenshot.png sans conflit ; les dossiers annuels regroupent les images par année. Une image de plus de 10 Mo est refusée par l'éditeur. Le message référence l'image par son adresse dans la bibliothèque, de sorte qu'un lecteur a besoin d'un accès en lecture à la bibliothèque - hérité du site - pour la voir.
Lorsqu'un sujet ou une réponse est supprimé dans le composant WebPart (par son auteur ou par un modérateur, après confirmation), le composant WebPart supprime aussi de Ressources de discussion les images en ligne du texte supprimé. La suppression d'un sujet supprime d'abord toutes ses réponses, les plus profondes en premier, puis le sujet lui-même, avec les images de tous ces messages ; une réponse qui possède encore des réponses imbriquées ne peut pas être supprimée. Le nettoyage des images est effectué au mieux : seuls les fichiers de la bibliothèque Ressources de discussion sont touchés, une erreur n'interrompt pas la suppression, et une image retirée d'une publication lors de sa modification reste dans la bibliothèque.
❗ Important
La suppression d'un fichier de Ressources de discussion ne modifie pas le message qui le référence : le message conserve l'adresse et affiche une image cassée. La suppression d'un élément de liste supprime ses pièces jointes avec lui. Vérifiez séparément si SharePoint permet une récupération ; la récupération des éléments supprimés, des pièces jointes et des images n’est pas garantie.
Ce qui est stocké sur la page
La configuration du composant WebPart est conservée dans les propriétés du composant WebPart de la page, comme pour tout composant WebPart SPFx : le forum sélectionné et son titre, les identifiants et les adresses des listes, ainsi que les options d'affichage. Le composant WebPart Discussions Activity stocke le forum sélectionné, l'adresse de la page du forum, le nombre maximal d'éléments et le commutateur du nom du forum. Aucun contenu n'est mis en cache dans le navigateur ni dans le stockage local.
Identité et autorisations
- Chaque requête est un appel REST SharePoint ou CSOM vers le site SharePoint concerné, effectué avec le jeton de l'utilisateur connecté. SharePoint applique les autorisations de cet utilisateur à chaque appel ; le composant WebPart décide seulement quels boutons afficher (voir KB10408. Autorisations dans Discussions : qui peut lire, publier et modérer).
- Le package ne demande aucune autorisation d'API : rien n'apparaît sur la page Accès aux API (API access) du Centre d'administration SharePoint, et Microsoft Graph n'est jamais appelé. Les détails figurent dans KB10413. Autorisations d'API et consentement administrateur pour Discussions ; la procédure décrite dans KB10360. Comment approuver les autorisations d'API Microsoft Graph pour les solutions Vitextra dans le Centre d'administration SharePoint n'est pas nécessaire pour ce produit.
- Le sélecteur de personnes derrière les @mentions utilise la recherche de personnes SharePoint standard du site ; une personne mentionnée est ajoutée à la liste d'informations utilisateur du site si elle n'y figurait pas encore, ce qui est le comportement standard lorsqu'une colonne de personnes est renseignée.
- Le composant WebPart n'envoie aucun e-mail. Les notifications sont remises par un flux Power Automate que le propriétaire du site met en place ; voir KB10414. Fonctionnement des notifications dans Discussions : abonnements, mentions et Power Automate.
L'importateur de forums classiques peut lire un autre site du même tenant. Il restaure les auteurs et dates d'origine via SharePoint CSOM ; les autres opérations sur le contenu utilisent REST. Tous ces appels utilisent les autorisations de l'utilisateur connecté.
Ce qui sort du tenant
| Objet | Ce qui est envoyé | Destination |
|---|---|---|
| Vérification de licence | L'ID du tenant, l'ID d'objet de l'utilisateur, l'adresse du site, l'identifiant, le nom et la version du produit | vitextra.com |
| Télémétrie d'utilisation | Un événement au chargement du composant WebPart (produit et version, ID et adresse du site, ID d'objet de l'utilisateur, langue de l'interface, exécution ou non dans Teams) et des détails techniques sur les erreurs | Azure Application Insights |
| Fichiers du produit | Une requête ordinaire pour les scripts et les icônes des composants WebPart | static.vitextra.com, vitextra-storage.azureedge.net |
Aucun forum, sujet, réponse, pièce jointe, image, abonnement ou mention n'est envoyé à Vitextra ni à un tiers. La vue d'ensemble pour tous les produits Vitextra, y compris les adresses réseau à autoriser, se trouve dans KB10363. Où les produits Vitextra stockent vos données : confidentialité, résidence des données et RGPD.
Cycle de vie des données
- Retirer le composant WebPart d'une page laisse les listes et leur contenu intacts ; ajoutez à nouveau le composant WebPart et choisissez le forum existant pour continuer.
- Supprimer le package du catalogue d'applications ou du site désactive les composants WebPart mais conserve les listes, qui restent lisibles dans les affichages de liste standard ; voir KB10362. Comment supprimer une solution Vitextra de SharePoint Online et Microsoft Teams.
- Supprimer les listes supprime les forums, les sujets, les réponses, les abonnements et les fichiers ; ils vont dans la Corbeille du site.
- La rétention, eDiscovery, l'audit et les étiquettes de confidentialité s'appliquent aux listes comme à toute autre liste du site.
- L'exportation est possible avec la commande standard Exporter vers Excel de chaque liste ou avec un flux Power Automate ; les corps sont exportés en HTML.
