Discussions Vue d'ensemble
Discussions sépare les notifications en deux parties. Le composant WebPart enregistre qui veut être informé de quoi : il tient une liste d'abonnements, permet aux utilisateurs de suivre un forum ou un sujet avec la fréquence de leur choix et marque les personnes mentionnées dans un message. La remise des e-mails est confiée à un flux Power Automate que le propriétaire du site exécute dans son propre tenant. Le composant WebPart lui-même n'envoie jamais de courrier et ne demande jamais l'autorisation Mail.Send ni aucune autre autorisation Microsoft Graph ; les données dont le flux a besoin se trouvent dans des listes SharePoint ordinaires sur le site.
Cet article décrit ce contrat : ce que le composant WebPart garantit dans les listes, et ce qu'un flux doit en faire.
❗ Important
Dans la version 26.10.2, le modèle de flux Power Automate n'est pas livré. Le composant WebPart enregistre les abonnements et les mentions comme décrit ci-dessous, mais aucun e-mail n'est envoyé tant qu'un flux n'existe pas dans votre tenant. Le contrat décrit dans cet article est la base sur laquelle un tel flux est construit ; un modèle prêt à importer et son article de configuration sont prévus pour une version ultérieure.
Ce que fait le composant WebPart
Suivre un forum ou un sujet
Les utilisateurs qui peuvent publier (l'autorisation Add Items (Ajouter des éléments) sur le site, incluse dans Contribute et Edit) voient un bouton Follow dans la barre de commandes du forum et dans l'en-tête de chaque sujet. Un clic suit avec la fréquence Immediately ; la partie déroulante du bouton propose Immediately, Daily digest et Weekly digest, ainsi que Unfollow. Lorsqu'un utilisateur suit, le bouton affiche Following avec la fréquence choisie. L'auteur d'un nouveau sujet y est abonné automatiquement avec Immediately. Les visiteurs en lecture seule n'ont pas de bouton, car ils ne peuvent pas écrire dans la liste des abonnements.
Chaque suivi est un élément de la liste Discussions Subscriptions, un par utilisateur et par cible : suivre à nouveau le même sujet avec une autre fréquence met à jour l'élément au lieu d'en ajouter un second, et Unfollow le supprime. Désactiver les notifications revient donc à supprimer ses abonnements ; il n'existe pas d'indicateur « muet » distinct. Le guide utilisateur se trouve dans KB10404. Suivre des forums et des sujets : abonnements et fréquence des résumés.
Mentions
Lorsqu'un utilisateur tape @ dans l'éditeur et choisit une personne, le composant WebPart insère dans le corps du message un lien de la forme <a href="mailto:…" data-mention-id="{siteUserId}">@Nom</a> et, en même temps, ajoute la personne à la colonne de personnes Mentions du sujet ou de la réponse. La colonne est le signal pour un flux : il n'a pas besoin d'analyser le HTML pour savoir qui a été mentionné. Les mentions peuvent être modifiées avec le message ; la colonne est réécrite à chaque enregistrement. Voir KB10403. Utiliser les @mentions dans Discussions.
La liste Discussions Subscriptions
| Colonne | Nom interne | Valeur |
|---|---|---|
| User | VtxUser | L'abonné (colonne de personnes) |
| Target type | VtxTargetType | Board ou Topic |
| Target id | VtxTargetId | L'identifiant de l'élément de forum dans Discussions Boards ou de l'élément de sujet dans Discussions Topics |
| Frequency | VtxFrequency | Immediate, Daily ou Weekly |
| Board | VtxBoard | Recherche vers le forum, également pour les abonnements à des sujets, afin que tous les abonnements d'un forum puissent être lus avec un seul filtre |
| Title | Title | Board:{id} ou Topic:{id}, pour la lisibilité dans les affichages de liste |
Les valeurs des colonnes de choix sont stockées en anglais quelle que soit la langue de l'interface ; les noms d'affichage des colonnes suivent la langue de la personne qui a créé les listes. La liste réside sur le même site que le forum et hérite des autorisations du site, raison pour laquelle des droits de publication sont nécessaires pour suivre.
Événements auxquels un flux réagit
Tous les événements sont des événements d'élément ordinaires des deux listes de contenu ; un flux utilise les déclencheurs SharePoint standard When an item is created et When an item is created or modified.
| Événement | Liste | Condition |
|---|---|---|
| Nouveau sujet | Discussions Topics | Élément créé avec Approval status = Approved |
| Sujet approuvé par un modérateur | Discussions Topics | Élément modifié et Approval status passé à Approved |
| Nouvelle réponse | Discussions Posts | Élément créé avec Approval status = Approved |
| Réponse approuvée | Discussions Posts | Élément modifié et Approval status passé à Approved |
| Meilleure réponse acceptée | Discussions Topics | Accepted post passé de 0 à l'identifiant d'une réponse |
| Mention | Les deux listes | Mentions contient des utilisateurs |
| Élément en attente de modération | Les deux listes | Élément créé avec Approval status = Pending |
Sur un forum sans approbation, chaque nouvel élément est créé en Approved ; sur un forum avec Require approval of new posts, les éléments des membres sont créés en Pending et passent en Approved lorsqu'un modérateur les approuve — c'est le moment où les abonnés doivent être informés. Les éléments rejetés ne produisent jamais de notification.
📝 Remarque
Les listes peuvent être renommées par le propriétaire du site, car le composant WebPart les reconnaît par les identifiants de colonnes. Un flux doit donc référencer les listes par leur identifiant (GUID), pas par leur titre, et lire les valeurs des colonnes par leur nom interne (VtxApprovalStatus, VtxMentions, …).
Qui reçoit quoi
Les règles de destinataires du contrat :
- Nouveau sujet — les abonnés du forum : les éléments avec Target type =
Boardet Target id = le Board du sujet. - Nouvelle réponse — les abonnés du sujet (Target type =
Topic, Target id = le Topic de la réponse) plus les abonnés du forum de ce sujet. L'auteur de la réponse est exclu. - Meilleure réponse — l'auteur de la réponse acceptée et les abonnés du sujet.
- Mention — les utilisateurs de la colonne Mentions de l'élément. Ils sont notifiés indépendamment de tout abonnement et de sa fréquence ; une mention ne peut pas être désactivée par la personne mentionnée.
- En attente de modération — les membres du groupe des propriétaires du site, qui sont les modérateurs du forum.
Fréquences
- Immediate — un flux avec le déclencheur When an item is created or modified envoie un e-mail par événement aux abonnés ayant cette fréquence.
- Daily et Weekly — un flux planifié collecte les sujets dont la Last activity tombe dans la période et envoie un résumé par abonné. Une réponse met à jour la Last activity de son sujet, de sorte qu'un résumé construit sur les sujets couvre aussi les nouvelles réponses.
Liens dans l'e-mail
Un sujet s'ouvre via la page qui héberge le composant WebPart Discussions avec le paramètre de requête ?topic={Id}, où {Id} est l'identifiant de l'élément dans Discussions Topics. Le composant WebPart ne stocke l'adresse de sa page nulle part dans les listes ; l'adresse de la page est donc un paramètre du flux. Le même lien profond est utilisé par le composant WebPart Discussions Activity et est décrit dans KB10407. Partager un lien vers un sujet dans Discussions (liens profonds).
Ce qu'un flux doit faire
En résumé, un flux de remise construit sur ce contrat :
- s'exécute dans le contexte d'un propriétaire du site ou d'une boîte aux lettres partagée de votre tenant — l'identité d'envoi est la vôtre, pas celle de Vitextra ;
- se déclenche sur les événements d'élément de Discussions Topics et Discussions Posts listés ci-dessus, par identifiant de liste ;
- lit Discussions Subscriptions filtrée par Board (et Target type / Target id) pour déterminer les destinataires, et la colonne Mentions de l'élément pour les utilisateurs mentionnés ;
- exclut l'auteur de l'élément et dédoublonne une personne à la fois abonnée et mentionnée ;
- construit le lien à partir de son propre paramètre d'adresse de page et de l'identifiant du sujet ;
- pour les résumés, s'exécute selon une planification et regroupe les sujets par abonné.
💡 Astuce
Comme les abonnements et les mentions sont de simples données de liste, le même contrat fonctionne pour d'autres canaux que l'e-mail — un message de conversation Teams ou une carte adaptative envoyés par le flux utilisent les mêmes destinataires et le même lien. Seule la dernière action du flux change.
