Discussions Pārskats
Discussions paziņojumus sadala divās daļās. Tīmekļa daļa fiksē, kas par ko vēlas uzzināt: tā uztur abonementu sarakstu, ļauj lietotājiem sekot dēlim vai tēmai ar izvēlētu biežumu un atzīmē ziņā pieminētās personas. E-pasta piegāde ir atstāta Power Automate plūsmai, ko vietnes īpašnieks darbina savā nomniekā. Pati tīmekļa daļa nekad nesūta pastu un nekad nepieprasa atļauju Mail.Send vai jebkādu citu Microsoft Graph atļauju; plūsmai nepieciešamie dati atrodas parastos SharePoint sarakstos vietnē.
Šajā rakstā aprakstīts šis līgums: ko tīmekļa daļa garantē sarakstos un kas plūsmai ar to jādara.
❗ Svarīgi
Versijā 26.10.2 Power Automate plūsmas veidne netiek piegādāta. Tīmekļa daļa saglabā abonementus un pieminējumus, kā aprakstīts tālāk, bet e-pasts netiek sūtīts, kamēr jūsu nomniekā nepastāv plūsma. Šajā rakstā aprakstītais līgums ir pamats, uz kura šāda plūsma tiek būvēta; importam gatava veidne un tās iestatīšanas raksts ir plānoti vēlākam laidienam.
Ko dara tīmekļa daļa
Sekošana dēlim vai tēmai
Lietotāji, kuri var rakstīt (atļauja Add Items (elementu pievienošana) vietnē, kas ietilpst līmeņos Contribute un Edit), redz pogu Follow dēļa komandu joslā un katras tēmas galvenē. Viens klikšķis seko ar biežumu Immediately; pogas nolaižamā daļa piedāvā Immediately, Daily digest un Weekly digest, kā arī Unfollow. Kad lietotājs seko, uz pogas ir rakstīts Following un izvēlētais biežums. Jaunas tēmas autors tai tiek abonēts automātiski ar biežumu Immediately. Apmeklētājiem ar tikai lasīšanas tiesībām pogas nav, jo viņi nevar rakstīt abonementu sarakstā.
Katra sekošana ir viens elements sarakstā Discussions Subscriptions, viens katram lietotājam un mērķim: atkārtota sekošana tai pašai tēmai ar citu biežumu atjaunina elementu, nevis pievieno otru, un Unfollow to dzēš. Tāpēc paziņojumu izslēgšana nozīmē savu abonementu dzēšanu; atsevišķa "apklusināšanas" pazīme nepastāv. Lietotāja rokasgrāmata ir rakstā KB10404. Paneļu un tēmu sekošana: abonementi un kopsavilkumu biežums.
Pieminējumi
Kad lietotājs redaktorā ievada @ un izvēlas personu, tīmekļa daļa ziņas pamattekstā ievieto saiti formā <a href="mailto:…" data-mention-id="{siteUserId}">@Vārds</a> un vienlaikus pievieno personu tēmas vai atbildes personu kolonnai Mentions. Kolonna ir signāls plūsmai: tai nav jāparsē HTML, lai noskaidrotu, kurš ir pieminēts. Pieminējumus var rediģēt kopā ar ziņu; kolonna tiek pārrakstīta katrā saglabāšanas reizē. Skatiet KB10403. @Pieminējumu lietošana Discussions.
Saraksts Discussions Subscriptions
| Kolonna | Iekšējais nosaukums | Vērtība |
|---|---|---|
| User | VtxUser | Abonents (personas kolonna) |
| Target type | VtxTargetType | Board vai Topic |
| Target id | VtxTargetId | Dēļa elementa identifikators sarakstā Discussions Boards vai tēmas elementa identifikators sarakstā Discussions Topics |
| Frequency | VtxFrequency | Immediate, Daily vai Weekly |
| Board | VtxBoard | Uzmeklēšana uz dēli, arī tēmu abonementiem, lai visus viena dēļa abonementus varētu nolasīt ar vienu filtru |
| Title | Title | Board:{id} vai Topic:{id}, lasāmībai sarakstu skatos |
Izvēles kolonnu vērtības tiek glabātas angļu valodā neatkarīgi no interfeisa valodas; kolonnu parādāmie nosaukumi seko tās personas valodai, kura izveidoja sarakstus. Saraksts atrodas tajā pašā vietnē, kur dēlis, un pārmanto vietnes atļaujas, tāpēc sekošanai nepieciešamas rakstīšanas tiesības.
Notikumi, uz kuriem plūsma reaģē
Visi notikumi ir parasti abu satura sarakstu elementu notikumi; plūsma izmanto standarta SharePoint trigerus When an item is created un When an item is created or modified.
| Notikums | Saraksts | Nosacījums |
|---|---|---|
| Jauna tēma | Discussions Topics | Elements izveidots ar Approval status = Approved |
| Moderators apstiprinājis tēmu | Discussions Topics | Elements modificēts, un Approval status mainījies uz Approved |
| Jauna atbilde | Discussions Posts | Elements izveidots ar Approval status = Approved |
| Atbilde apstiprināta | Discussions Posts | Elements modificēts, un Approval status mainījies uz Approved |
| Pieņemta labākā atbilde | Discussions Topics | Accepted post mainījies no 0 uz atbildes identifikatoru |
| Pieminējums | Abi saraksti | Mentions satur lietotājus |
| Elements gaida moderāciju | Abi saraksti | Elements izveidots ar Approval status = Pending |
Dēlī bez apstiprināšanas katrs jauns elements tiek izveidots kā Approved; dēlī ar iestatījumu Require approval of new posts dalībnieku elementi tiek izveidoti kā Pending un kļūst Approved, kad moderators tos apstiprina, — tas ir brīdis, kad abonentiem jāpaziņo. Noraidīti elementi paziņojumus nekad nerada.
📝 Piezīme
Vietnes īpašnieks sarakstus var pārdēvēt, jo tīmekļa daļa tos atpazīst pēc kolonnu identifikatoriem. Tāpēc plūsmai uz sarakstiem jāatsaucas pēc to identifikatora (GUID), nevis nosaukuma, un kolonnu vērtības jālasa pēc iekšējā nosaukuma (VtxApprovalStatus, VtxMentions, …).
Kas ko saņem
Līguma saņēmēju noteikumi:
- Jauna tēma — dēļa abonenti: elementi ar Target type =
Boardun Target id = tēmas Board. - Jauna atbilde — tēmas abonenti (Target type =
Topic, Target id = atbildes Topic) plus šīs tēmas dēļa abonenti. Atbildes autors tiek izslēgts. - Labākā atbilde — pieņemtās atbildes autors un tēmas abonenti.
- Pieminējums — lietotāji elementa kolonnā Mentions. Viņi tiek informēti neatkarīgi no jebkāda abonementa un tā biežuma; pieminētā persona pieminējumu nevar izslēgt.
- Gaida moderāciju — vietnes īpašnieku grupas dalībnieki, kuri ir dēļa moderatori.
Biežumi
- Immediate — plūsma ar trigeri When an item is created or modified nosūta vienu e-pastu par katru notikumu abonentiem ar šo biežumu.
- Daily un Weekly — ieplānota plūsma savāc tēmas, kuru Last activity iekrīt periodā, un nosūta vienu kopsavilkumu katram abonentam. Atbilde atjaunina savas tēmas Last activity, tāpēc uz tēmām būvēts kopsavilkums aptver arī jaunās atbildes.
Saites e-pastā
Tēma tiek atvērta caur lapu, kurā atrodas Discussions tīmekļa daļa, ar vaicājuma parametru ?topic={Id}, kur {Id} ir elementa identifikators sarakstā Discussions Topics. Tīmekļa daļa savas lapas adresi sarakstos nekur neglabā, tāpēc lapas adrese ir plūsmas parametrs. To pašu dziļo saiti izmanto Discussions Activity tīmekļa daļa, un tā aprakstīta rakstā KB10407. Saites uz tēmu kopīgošana Discussions (tiešās saites).
Kas plūsmai jādara
Apkopojot, uz šī līguma būvēta piegādes plūsma:
- darbojas vietnes īpašnieka vai jūsu nomnieka koplietojamās pastkastes kontekstā — sūtītāja identitāte ir jūsu, nevis Vitextra;
- tiek aktivizēta ar iepriekš uzskaitītajiem sarakstu Discussions Topics un Discussions Posts elementu notikumiem, pēc saraksta identifikatora;
- lasa sarakstu Discussions Subscriptions, filtrētu pēc Board (un Target type / Target id), lai noteiktu saņēmējus, un elementa kolonnu Mentions — pieminētajiem lietotājiem;
- izslēdz elementa autoru un novērš dublikātus personai, kura ir gan abonējusi, gan pieminēta;
- veido saiti no sava lapas adreses parametra un tēmas identifikatora;
- kopsavilkumiem darbojas pēc grafika un grupē tēmas pēc abonenta.
💡 Padoms
Tā kā abonementi un pieminējumi ir vienkārši sarakstu dati, tas pats līgums darbojas arī citiem kanāliem, ne tikai e-pastam — plūsmas nosūtīta Teams tērzēšanas ziņa vai adaptīvā kartīte izmanto tos pašus saņēmējus un to pašu saiti. Mainās tikai plūsmas pēdējā darbība.
