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 Ajouter des éléments sur le site, incluse dans les niveaux Collaboration et Modification) voient un bouton Suivre dans la barre de commandes du forum et dans l'en-tête de chaque sujet. Un clic suit avec la fréquence Immédiatement ; la partie déroulante du bouton propose Immédiatement, Résumé quotidien et Résumé hebdomadaire, ainsi que Ne plus suivre. Lorsqu'un utilisateur suit, le bouton affiche Suivi avec la fréquence choisie. L'auteur d'un nouveau sujet y est abonné automatiquement avec Immédiatement. 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 Abonnements aux discussions, 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 Ne plus suivre 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 Abonnements aux discussions
| Colonne | Nom interne | Valeur |
|---|---|---|
| Utilisateur | VtxUser | L'abonné (colonne de personnes) |
| Type de cible | VtxTargetType | Board ou Topic |
| ID cible | VtxTargetId | L'identifiant de l'élément de forum dans Forums de discussion ou de l'élément de sujet dans Sujets de discussion |
| Fréquence | VtxFrequency | Immediate, Daily ou Weekly |
| Forum | VtxBoard | Colonne de recherche liée au forum, également pour les abonnements à des sujets, afin que tous les abonnements d'un forum puissent être lus avec un seul filtre |
| Titre | 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 Lorsqu’un élément est créé (When an item is created) et Lorsqu’un élément est créé ou modifié (When an item is created or modified).
| Événement | Liste | Condition |
|---|---|---|
| Nouveau sujet | Sujets de discussion | Élément créé avec Statut d'approbation = Approved |
| Sujet approuvé par un modérateur | Sujets de discussion | Élément modifié et Statut d'approbation passé à Approved |
| Nouvelle réponse | Publications de discussion | Élément créé avec Statut d'approbation = Approved |
| Réponse approuvée | Publications de discussion | Élément modifié et Statut d'approbation passé à Approved |
| Meilleure réponse acceptée | Sujets de discussion | Réponse acceptée 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 Statut d'approbation = Pending |
Sur un forum sans approbation, chaque nouvel élément est créé en Approved ; sur un forum avec Exiger l'approbation des nouvelles publications, 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 Type de cible =
Boardet ID cible = le Forum du sujet. - Nouvelle réponse - les abonnés du sujet (Type de cible =
Topic, ID cible = le Sujet 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 Lorsqu’un élément est créé ou modifié (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 Dernière activité tombe dans la période et envoie un résumé par abonné. Une réponse met à jour la Dernière activité 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 Sujets de discussion. 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 Sujets de discussion et Publications de discussion listés ci-dessus, par identifiant de liste ;
- lit Abonnements aux discussions filtrée par Forum (et Type de cible / ID cible) 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.
