Discussions Pārskats
Discussions ir SharePoint Framework risinājums. Katrs dēlis, tēma, atbilde, atzīme "patīk", sūdzība, abonements, pielikums un attēls glabājas parastos SharePoint sarakstos un dokumentu bibliotēkā vietnē, kurā darbojas tīmekļa daļa, un katra lasīšana un rakstīšana notiek caur SharePoint REST API ar pierakstījušā lietotāja identitāti. Nekas netiek glabāts ārpus jūsu Microsoft 365 nomnieka, un pakotne nepieprasa Microsoft Graph atļaujas. Šajā rakstā glabāšana aprakstīta tik detalizēti, cik nepieciešams drošības pārbaudei vai datu aizsardzības novērtējumam.
Kopsavilkums administratoriem
| Jautājums | Atbilde |
|---|---|
| Kur tiek glabāts saturs? | Četros sarakstos un vienā dokumentu bibliotēkā vietnē, kurā atrodas dēlis |
| Kas tos izveido? | Tīmekļa daļa, pirmajā lietošanas reizē, tāda lietotāja kontekstā, kuram ir atļauja Manage Lists (sarakstu pārvaldība) — vietnes īpašnieka; trūkstošie saraksti un kolonnas vēlāk tiek pievienoti tāpat |
| Vai sarakstus var pārdēvēt? | Jā — tīmekļa daļa tos atpazīst pēc fiksētiem kolonnu identifikatoriem, nevis pēc nosaukuma |
| Kur tiek glabāti pielikumi? | Kā saraksta elementu pielikumi sarakstos Discussions Topics un Discussions Posts |
| Kur tiek glabāti iegultie attēli? | Dokumentu bibliotēkā Discussions Assets, katra gada mapē |
| Kā identitāte tiek izmantota? | Pierakstījušā lietotāja — katrā izsaukumā |
| Kādas API atļaujas pieprasa pakotne? | Nekādas; Microsoft Graph netiek izsaukts |
| Kas tiek sūtīts Vitextra? | Tehniskie identifikatori licences pārbaudei un lietošanas telemetrija; saturs netiek sūtīts |
| Kas notiek ar datiem, kad tīmekļa daļa tiek noņemta? | Nekas — saraksti paliek vietnē, līdz jūs tos izdzēšat |
Saraksti vietnē
Kad vietnes īpašnieks izveido pirmo dēli, tīmekļa daļa vietnes līmenī izveido tālāk uzskaitītos sarakstus. Tie apkalpo visus vietnes dēļus: vietnē var būt vairāki dēļi, un visi tie izmanto vienus un tos pašus sarakstus.
| Noklusējuma nosaukums | Tips | Ko satur |
|---|---|---|
| Discussions Boards | Pielāgots saraksts | Viens elements katram dēlim: nosaukums, apraksts, režīms (Discussion, QnA vai Mixed), kategoriju saraksts, tēmu skaitītājs un iestatījums Require approval |
| Discussions Topics | Pielāgots saraksts | Tēmas: virsraksts, pamatteksts, uzmeklēšana uz dēli, kategorija, tips (Discussion vai Question), statuss (Open, Answered, Locked), piesprausta un izcelta pazīme, skaitītāji, pēdējā aktivitāte, pieņemtā atbilde, atzīmes "patīk", apstiprinājuma statuss, pieminējumi, sūdzības, mantotais identifikators |
| Discussions Posts | Pielāgots saraksts | Atbildes: pamatteksts, uzmeklēšana uz tēmu, uzmeklēšana uz vecākatbildi, materializētais ceļš un dziļums, pieņemtās atbildes pazīme, atzīmes "patīk", apstiprinājuma statuss, pieminējumi, sūdzības, mantotais identifikators |
| Discussions Subscriptions | Pielāgots saraksts | Kas seko kuram dēlim vai tēmai un ar kādu biežumu |
| Discussions Assets | Dokumentu bibliotēka | Attēli, kas ievietoti bagātinātā teksta redaktorā (ielīmēti, ievilkti vai augšupielādēti) |
Saraksti tiek izveidoti redzami sadaļā Vietnes saturs (Site contents), ar ieslēgtu versiju pārvaldību, atspējotiem satura tipiem un atspējotu ātro (režģa) rediģēšanu. Abiem satura sarakstiem ir iespējoti elementu pielikumi; dokumentu bibliotēkai ir iespējota mapju izveide. Saraksti tiek indeksēti, tāpēc tēmas un atbildes var parādīties SharePoint meklēšanas rezultātos tāpat kā jebkurš saraksta elements.
Sarakstu un kolonnu kopu tīmekļa daļa uztur aktuālu pati. Kad moderators (lietotājs ar atļauju Manage Lists) atver lapu, kurā tīmekļa daļa tika konfigurēta pirms abonementu saraksta vai līdzekļu bibliotēkas parādīšanās, trūkstošie saraksti un kolonnas tiek izveidoti automātiski. Dēļa iestatīšana — Create board un Use board — arī vienmēr pārbauda sarakstus un pievieno kolonnas, kas ieviestas vēlākās versijās, bet tikai lietotājiem ar atļauju Manage Lists; pārējie lietotāji tikai atrod esošos sarakstus. Šajā procesā nekas netiek pārdēvēts vai dzēsts.
📝 Piezīme
Sarakstu nosaukumi tiek ņemti no tās personas interfeisa valodas, kura izveido dēli. Angļu interfeisā saraksti saucas Discussions Boards, Discussions Topics, Discussions Posts, Discussions Subscriptions un Discussions Assets; krievu interfeisā tie saņem produkta krievu nosaukumus. Nosaukumus vēlāk var mainīt, nesabojājot tīmekļa daļas darbību.
Kā saraksti tiek atpazīti
Tīmekļa daļa nav atkarīga no sarakstu nosaukumiem. Katrā sarakstā ir marķiera kolonna ar fiksētu kolonnas identifikatoru: kolonna Mode dēļu sarakstā, uzmeklēšana Board tēmu sarakstā, uzmeklēšana Topic ziņu sarakstā, kolonna Target type abonementu sarakstā un teksta kolonna Discussions asset dokumentu bibliotēkā. Tīmekļa daļa vispirms meklē sarakstus pēc nosaukuma un, ja tos neatrod, pārskata vietnes redzamos sarakstus, meklējot marķiera kolonnas. No tā izriet:
- jūs drīkstat pārdēvēt sarakstu vai mainīt kolonnas parādāmo nosaukumu — tīmekļa daļa turpina darboties;
- jūs nedrīkstat dzēst marķiera kolonnas vai pārējās
Vtxkolonnas — tīmekļa daļa uzskatītu sarakstu par neesošu vai nespētu nolasīt elementus; - sarakstiem jāpaliek tajā pašā vietnē, kurā ir lapa ar tīmekļa daļu; dēli nevar apkalpot no citas vietnes.
Kolonnas
Visām produkta pievienotajām kolonnām iekšējie nosaukumi sākas ar Vtx; parādāmie nosaukumi tiek lokalizēti tāpat kā sarakstu nosaukumi. Pilna uzziņa ar tipiem, indeksiem un izvēles kolonnu atļautajām vērtībām ir rakstā KB10426. Discussions sarakstu un kolonnu uzziņa. Datu pārbaudei svarīgākais:
- Tēmu un atbilžu pamatteksti (
VtxBody) tiek glabāti kā HTML. Redaktors pirms saglabāšanas visu izlaiž caur atļauto tagu saraksta sanitizētāju, un tīmekļa daļa pirms attēlošanas saturu attīra vēlreiz, tāpēc tieši sarakstā rediģēta vērtība nevar ievadīt lapā skriptus. - Personas ir standarta SharePoint personu kolonnas: katra elementa autors un redaktors, pieminētie lietotāji (
VtxMentions), lietotāji, kuri atzīmējuši elementu ar "patīk" (VtxLikedBy) vai ziņojuši par to (VtxReportedBy), pēdējais atbildētājs (VtxLastReplyBy) un abonents (VtxUser). Personas kolonna atsaucas uz vietnes lietotāju informācijas sarakstu, nevis uz profila kopiju. - Moderācijas dati ir apstiprinājuma statuss (
VtxApprovalStatus: Approved, Pending vai Rejected), sūdzību skaitītājs un ziņotāji. - Dēļa iestatījumi (
VtxDescription,VtxMode,VtxCategories,VtxRequireApproval) un dēļa nosaukums tiek ierakstīti ar tīmekļa daļas komandu Board settings, ko moderatori atver komandjoslā; vienuma rediģēšana sarakstā Discussions Boards dod tādu pašu rezultātu. Kategorijas tiek glabātas pa vienai rindā. - Skaitītāji (
VtxReplyCount,VtxViewCount,VtxLikeCount,VtxTopicCount) ir skaitļi, ko atjaunina tīmekļa daļa; tos var izlabot sarakstā. Tēmas skatījumu skaitītājs tiek palielināts ne biežāk kā vienu reizi pārlūkprogrammas sesijā.VtxTopicCountdēļa vienumā tiek palielināts, kad tiek izveidota tēma, un samazināts, kad tēma tiek dzēsta; abi atjauninājumi tiek veikti pēc iespējas, un vērtība tīmekļa daļā netiek rādīta. - Mantotais identifikators (
VtxLegacyId) glabā klasiskā diskusiju dēļa elementa identifikatoru, no kura ieraksts tika importēts, lai importētāju varētu palaist atkārtoti bez dublikātiem.
Pielikumi un iegultie attēli
Faili, ko lietotāji pievieno tēmai vai atbildei, tiek glabāti kā attiecīgā saraksta elementa pielikumi sarakstā Discussions Topics vai Discussions Posts — elementa standarta SharePoint pielikumu mapē. Tie pārmanto elementa atļaujas un tiek dzēsti kopā ar to.
Ziņas pamattekstā ievietotie attēli tiek augšupielādēti dokumentu bibliotēkā Discussions Assets. Tīmekļa daļa izveido mapi ar pašreizējā gada nosaukumu (2026, 2027, …) un saglabā failu tajā ar unikālu nosaukumu, kas sastāv no laika zīmoga, nejauša sufiksa un sākotnējā faila nosaukuma, tāpēc divi lietotāji var augšupielādēt screenshot.png bez konflikta; gadu mapes notur bibliotēku zem saraksta skata sliekšņa aktīvās vietnēs. Attēlu, kas lielāks par 10 MB, redaktors noraida. Ziņa atsaucas uz attēlu pēc tā adreses bibliotēkā, tāpēc lasītājam, lai to redzētu, ir nepieciešama lasīšanas piekļuve bibliotēkai — pārmantota no vietnes.
Kad tēma vai atbilde tiek dzēsta tīmekļa daļā (to dara autors vai moderators pēc apstiprinājuma), tīmekļa daļa no bibliotēkas Discussions Assets dzēš arī dzēstā teksta iekļautos attēlus. Dzēšot tēmu, vispirms tiek dzēstas visas tās atbildes — dziļākās pirmās —, pēc tam pati tēma kopā ar visu šo ierakstu attēliem; atbildi, kurai vēl ir ligzdotas atbildes, dzēst nevar. Attēlu tīrīšana tiek veikta pēc iespējas: tiek skarti tikai bibliotēkas Discussions Assets faili, kļūda dzēšanu nepārtrauc, un attēls, ko rediģēšanas laikā izņem no ieraksta, paliek bibliotēkā.
❗ Svarīgi
Faila dzēšana no bibliotēkas Discussions Assets nemaina ziņu, kas uz to atsaucas: ziņa saglabā adresi un rāda bojātu attēlu. Saraksta elementa dzēšana dzēš arī tā pielikumus. Abus var atjaunot no vietnes atkritnes parastajā termiņā.
Kas tiek glabāts lapā
Tīmekļa daļas konfigurācija tiek glabāta lapas tīmekļa daļas rekvizītos, tāpat kā jebkurai SPFx tīmekļa daļai: izvēlētais dēlis un tā nosaukums, sarakstu identifikatori un adreses, kā arī attēlošanas opcijas. Tīmekļa daļa Discussions Activity glabā izvēlēto dēli, dēļa lapas adresi, maksimālo elementu skaitu un dēļa nosaukuma slēdzi. Saturs netiek kešots ne pārlūkprogrammā, ne lokālajā krātuvē.
Identitāte un atļaujas
- Katrs pieprasījums ir SharePoint REST izsaukums uz pašreizējo vietni ar pierakstījušā lietotāja marķieri. SharePoint katram izsaukumam piemēro šī lietotāja atļaujas; tīmekļa daļa tikai izlemj, kuras pogas rādīt (skatiet KB10408. Atļaujas Discussions: kas var lasīt, rakstīt un moderēt).
- Pakotne nepieprasa API atļaujas: SharePoint administrēšanas centra lapā API piekļuve (API access) nekas neparādās, un Microsoft Graph nekad netiek izsaukts. Sīkāka informācija ir rakstā KB10413. API atļaujas un administratora piekrišana Discussions; procedūra no raksta KB10360. Kā apstiprināt Microsoft Graph API atļaujas Vitextra risinājumiem SharePoint administrēšanas centrā šim produktam nav nepieciešama.
- Personu izvēle aiz @pieminējumiem izmanto vietnes standarta SharePoint personu meklēšanu; pieminētā persona tiek pievienota vietnes lietotāju informācijas sarakstam, ja tās tur vēl nebija, — tā ir standarta uzvedība, aizpildot personas kolonnu.
- Tīmekļa daļa nesūta e-pastu. Paziņojumus piegādā Power Automate plūsma, ko iestata vietnes īpašnieks; skatiet KB10414. Kā darbojas paziņojumi Discussions: abonementi, pieminējumi un Power Automate.
Kas tiek sūtīts ārpus nomnieka
| Mērķis | Kas tiek sūtīts | Kurp |
|---|---|---|
| Licences pārbaude | Nomnieka ID, lietotāja objekta ID, vietnes adrese, produkta identifikators, nosaukums un versija | vitextra.com |
| Lietošanas telemetrija | Notikums, kad tīmekļa daļa ielādējas (produkts un versija, vietnes ID un adrese, lietotāja objekta ID, interfeisa valoda, vai tīmekļa daļa darbojas Teams), un tehniska informācija par kļūdām | Azure Application Insights |
| Produkta faili | Parasts pieprasījums pēc tīmekļa daļu skriptiem un ikonām | static.vitextra.com, vitextra-storage.azureedge.net |
Neviens dēlis, tēma, atbilde, pielikums, attēls, abonements vai pieminējums netiek sūtīts Vitextra vai trešajai pusei. Kopējā aina visiem Vitextra produktiem, ieskaitot atļaujamās tīkla adreses, ir rakstā KB10363. Kur Vitextra produkti glabā jūsu datus: konfidencialitāte, datu atrašanās vieta un VDAR.
Datu dzīves cikls
- Tīmekļa daļas noņemšana no lapas neskar sarakstus un to saturu; pievienojiet tīmekļa daļu vēlreiz un izvēlieties esošo dēli, lai turpinātu.
- Pakotnes noņemšana no lietotņu kataloga vai no vietnes atspējo tīmekļa daļas, bet saglabā sarakstus, kuri paliek lasāmi standarta sarakstu skatos; skatiet KB10362. Kā noņemt Vitextra risinājumu no SharePoint Online un Microsoft Teams.
- Sarakstu dzēšana dzēš dēļus, tēmas, atbildes, abonementus un failus; tie nonāk vietnes atkritnē.
- Saglabāšana, eDiscovery, auditēšana un sensitivitātes etiķetes attiecas uz sarakstiem tāpat kā uz jebkuru citu vietnes sarakstu; skatiet KB10412. Saglabāšana, eDiscovery un sensitivitātes etiķetes Discussions saturam.
- Eksportēšana ir iespējama ar katra saraksta standarta komandu Eksportēt uz Excel vai ar Power Automate plūsmu; pamatteksti tiek eksportēti kā HTML.
