Discussions Overzicht
Discussions verdeelt meldingen in twee onderdelen. Het webonderdeel legt vast wie waarover geïnformeerd wil worden: het houdt abonnementen bij, laat gebruikers een bord of onderwerp volgen met een gekozen frequentie en registreert wie in een bericht wordt vermeld. De bezorging van e-mail wordt overgelaten aan een Power Automate-stroom die de site-eigenaar in de eigen tenant uitvoert. Het webonderdeel verzendt zelf nooit e-mail en vraagt nooit om de machtiging Mail.Send of andere Microsoft Graph-machtigingen. De gegevens die de stroom nodig heeft staan in gewone SharePoint-lijsten op de site.
Dit artikel beschrijft die afspraken: wat het webonderdeel in de lijsten vastlegt en wat een stroom met die gegevens moet doen.
❗ Belangrijk
Versie 26.10.2 bevat geen sjabloon voor een Power Automate-stroom. Het webonderdeel slaat abonnementen en vermeldingen op zoals hieronder beschreven, maar er wordt pas e-mail verzonden wanneer er een stroom in uw tenant bestaat. De afspraken in dit artikel vormen de basis voor zo'n stroom. Een importeerbaar sjabloon en een installatieartikel zijn gepland voor een latere release.
Wat het webonderdeel doet
Een bord of onderwerp volgen
Gebruikers die berichten mogen plaatsen (de machtiging Items toevoegen op de site, opgenomen in Bijdragen en Bewerken) zien de knop Volgen in de opdrachtbalk van het bord en in de kop van elk onderwerp. Met één klik volgen zij met de frequentie Onmiddellijk. Het vervolgkeuzemenu biedt Onmiddellijk, Dagelijks overzicht, Wekelijks overzicht en Niet meer volgen. Zodra een gebruiker volgt, toont de knop Volgend met de geselecteerde frequentie. De auteur van een nieuw onderwerp wordt er automatisch op geabonneerd met Onmiddellijk. Bezoekers met alleen-lezen toegang hebben geen knop, omdat zij niet naar de abonnementenlijst kunnen schrijven.
Elk abonnement is één item in de lijst Discussieabonnementen, één per gebruiker en doel. Hetzelfde onderwerp opnieuw volgen met een andere frequentie werkt het bestaande item bij in plaats van een tweede item toe te voegen; Niet meer volgen verwijdert het. Meldingen uitschakelen betekent dus de eigen abonnementen verwijderen. Er is geen afzonderlijke instelling om meldingen te dempen. De gebruikershandleiding staat in KB10404. Borden en onderwerpen volgen: abonnementen en frequentie van overzichten.
Vermeldingen
Wanneer een gebruiker @ typt in de editor en een persoon kiest, voegt het webonderdeel een koppeling in de berichtinhoud in met de vorm <a href="mailto:…" data-mention-id="{siteUserId}">@Name</a> en voegt het die persoon tegelijk toe aan de persoonskolom Vermeldingen van het onderwerp of antwoord. De kolom is het signaal voor een stroom: deze hoeft geen HTML te analyseren om te bepalen wie is vermeld. Vermeldingen kunnen samen met het bericht worden bewerkt; de kolom wordt bij elke opslag opnieuw geschreven. Zie KB10403. @vermeldingen gebruiken in Discussions.
De lijst Discussieabonnementen
| Kolom | Interne naam | Waarde |
|---|---|---|
| Gebruiker | VtxUser | De abonnee (persoonskolom) |
| Doeltype | VtxTargetType | Board of Topic |
| Doel-id | VtxTargetId | De ID van het borditem in Discussieborden of van het onderwerpitem in Discussieonderwerpen |
| Frequentie | VtxFrequency | Immediate, Daily of Weekly |
| Bord | VtxBoard | Verwijzing naar het bord, ook bij onderwerpabonnementen, zodat alle abonnementen op één bord met één filter kunnen worden opgehaald |
| Titel | Title | Board:{id} of Topic:{id}, voor leesbaarheid in lijstweergaven |
De waarden van keuzekolommen worden in het Engels opgeslagen, ongeacht de interfacetaal. De weergavenamen van kolommen volgen de taal van de persoon die de lijsten heeft gemaakt. De lijst staat op dezelfde site als het bord en erft de sitemachtigingen. Daarom zijn plaatsingsrechten vereist om te volgen.
Gebeurtenissen waarop een stroom reageert
Alle gebeurtenissen zijn gewone itemgebeurtenissen van de twee inhoudslijsten. Een stroom gebruikt de standaardtriggers van SharePoint Wanneer een item wordt gemaakt en Wanneer een item wordt gemaakt of gewijzigd.
| Gebeurtenis | Lijst | Voorwaarde |
|---|---|---|
| Nieuw onderwerp | Discussieonderwerpen | Item gemaakt met Goedkeuringsstatus = Approved |
| Onderwerp goedgekeurd door een moderator | Discussieonderwerpen | Item gewijzigd en Goedkeuringsstatus gewijzigd in Approved |
| Nieuw antwoord | Discussieberichten | Item gemaakt met Goedkeuringsstatus = Approved |
| Antwoord goedgekeurd | Discussieberichten | Item gewijzigd en Goedkeuringsstatus gewijzigd in Approved |
| Beste antwoord geaccepteerd | Discussieonderwerpen | Geaccepteerd antwoord gewijzigd van 0 in de ID van een antwoord |
| Vermelding | Beide lijsten | Vermeldingen bevat gebruikers |
| Item wacht op moderatie | Beide lijsten | Item gemaakt met Goedkeuringsstatus = Pending |
Op een bord zonder goedkeuring wordt elk nieuw item als Approved gemaakt. Op een bord met Goedkeuring van nieuwe berichten vereisen worden items van leden als Pending gemaakt en krijgen zij Approved zodra een moderator ze goedkeurt. Dat is het moment waarop abonnees moeten worden geïnformeerd. Afgewezen items leiden nooit tot een melding.
📝 Opmerking
De site-eigenaar kan de lijsten hernoemen, omdat het webonderdeel ze herkent aan kolom-ID's. Een stroom moet daarom naar lijsten verwijzen met hun ID (GUID), niet met hun titel, en kolomwaarden lezen via de interne naam (VtxApprovalStatus, VtxMentions, …).
Wie ontvangt wat?
De afspraken voor ontvangers:
- Nieuw onderwerp - de abonnees van het bord: items met Doeltype =
Boarden Doel-id = het Bord van het onderwerp. - Nieuw antwoord - de abonnees van het onderwerp (Doeltype =
Topic, Doel-id = het Onderwerp van het antwoord), plus de abonnees van het bord waarop dat onderwerp staat. De auteur van het antwoord wordt uitgesloten. - Beste antwoord - de auteur van het geaccepteerde antwoord en de abonnees van het onderwerp.
- Vermelding - de gebruikers in de kolom Vermeldingen van het item. Zij krijgen een melding ongeacht abonnementen en de ingestelde frequentie. De vermelde persoon kan een vermelding niet uitschakelen.
- Wacht op moderatie - de leden van de groep site-eigenaren, die de moderators van het bord zijn.
Frequenties
- Immediate - een stroom met de trigger Wanneer een item wordt gemaakt of gewijzigd verzendt één e-mail per gebeurtenis aan abonnees met deze frequentie.
- Daily en Weekly - een geplande stroom verzamelt de onderwerpen waarvan Laatste activiteit binnen de periode valt en verzendt één overzicht per abonnee. Een antwoord werkt Laatste activiteit van het onderwerp bij, zodat een overzicht op basis van onderwerpen ook nieuwe antwoorden omvat.
Koppelingen in de e-mail
Een onderwerp wordt geopend via de pagina waarop het webonderdeel Discussions staat, met de queryparameter ?topic={Id}, waarbij {Id} de ID van het item in Discussieonderwerpen is. Het webonderdeel slaat het pagina-adres nergens in de lijsten op. Het pagina-adres is daarom een parameter van de stroom. Het webonderdeel Discussions Activity gebruikt dezelfde directe koppeling, die wordt beschreven in KB10407. Een koppeling naar een onderwerp delen in Discussions (directe koppelingen).
Wat een stroom moet doen
Een bezorgingsstroom op basis van deze afspraken:
- wordt uitgevoerd in de context van een site-eigenaar of een gedeeld postvak van uw tenant; de afzenderidentiteit is van u, niet van Vitextra;
- wordt geactiveerd door de hierboven genoemde itemgebeurtenissen van Discussieonderwerpen en Discussieberichten, op basis van de lijst-ID;
- leest Discussieabonnementen, gefilterd op Bord (en Doeltype / Doel-id), om ontvangers te bepalen, en de kolom Vermeldingen van het item voor vermelde gebruikers;
- sluit de auteur van het item uit en voorkomt dubbele bezorging aan iemand die zowel geabonneerd als vermeld is;
- stelt de koppeling samen uit de eigen parameter voor het pagina-adres en de onderwerp-ID;
- wordt voor overzichten volgens een planning uitgevoerd en groepeert de onderwerpen per abonnee.
💡 Tip
Omdat abonnementen en vermeldingen gewone lijstgegevens zijn, werken dezelfde afspraken ook voor andere kanalen dan e-mail. Een Teams-chatbericht of Adaptive Card die de stroom verzendt gebruikt dezelfde ontvangers en dezelfde koppeling. Alleen de laatste actie van de stroom verandert.
