Discussions Обзор
Discussions хранит всё в пяти списках сайта, на котором создана доска: четыре настраиваемых списка и одна библиотека документов. Это обычные списки SharePoint в разделе Содержимое сайта, на которые, как и на любой список, распространяются разрешения сайта, управление версиями, хранение и поиск. Эта статья - справочник по их столбцам: для администраторов, которые строят представления, отчёты или потоки на основе списков, и для всех, кому нужно исправить элемент вручную. Где находятся данные и что покидает клиент, рассказано в статье KB10411. Где Discussions хранит ваши данные: списки, столбцы и конфиденциальность; эта статья посвящена схеме. Описана версия 26.10.3.
Как списки создаются и распознаются
Списки создаёт веб-часть, когда владелец сайта впервые создаёт доску на сайте (Новая доска на экране «Не настроено»). Для этого нужно разрешение Управление списками. Каждый список создаётся с такими параметрами:
- управление версиями включено, типы контента отключены, редактирование в режиме таблицы отключено, список не скрыт, включён в обход поиска;
- вложения разрешены у четырёх списков; создание папок разрешено только в библиотеке;
- каждый пользовательский столбец добавлен в представление по умолчанию.
Названия списков берутся из языка интерфейса пользователя, который их создаёт: Discussions Boards, Discussions Topics, Discussions Posts, Discussions Subscriptions, Discussions Assets на англоязычном сайте, Доски обсуждений, Темы обсуждений, Сообщения обсуждений, Подписки обсуждений, Файлы обсуждений на русскоязычном. Отображаемые имена столбцов подчиняются тому же правилу; внутренние имена всегда такие, как в таблицах ниже, и всегда начинаются с Vtx.
Веб-часть не зависит от названий. Каждый список распознаётся по столбцу-маркеру с фиксированным идентификатором, поэтому список можно свободно переименовывать, и он всё равно будет найден: сначала он ищется по названию по умолчанию, затем среди видимых списков того же шаблона по столбцу-маркеру.
| Список | Название по умолчанию | Шаблон | Столбец-маркер | Содержит |
|---|---|---|---|---|
| Доски | Доски обсуждений | Настраиваемый список | Режим (VtxMode) | По одному элементу на доску: режим, категории, правило утверждения |
| Темы | Темы обсуждений | Настраиваемый список | Доска (VtxBoard) | По одному элементу на тему с её счётчиками и статусом |
| Сообщения | Сообщения обсуждений | Настраиваемый список | Тема (VtxTopic) | По одному элементу на ответ, с родительским ответом и путём в ветке |
| Подписки | Подписки обсуждений | Настраиваемый список | Тип объекта (VtxTargetType) | Кто подписан на какую доску или тему и с какой частотой |
| Файлы | Файлы обсуждений | Библиотека документов | Файл обсуждений (VtxDiscussionsAsset) | Встроенные изображения сообщений, в папке на каждый год |
📝 Заметка
На сайте, настроенном более ранней версией, могут отсутствовать список Подписки обсуждений, библиотека Файлы обсуждений и столбцы модерации. Веб-часть добавляет недостающие списки и столбцы, как только пользователь с разрешением Управление списками открывает страницу, веб-часть на которой была настроена до появления этих двух списков; настройка доски (Создать доску и Использовать доску) всегда выполняет ту же проверку, поэтому столбцы, появившиеся в более поздних версиях, добавляются и там. Список или столбец, который уже существует (распознаётся по идентификатору), никогда не создаётся повторно; пользователи без разрешения Управление списками только находят списки.
В таблицах ниже Индекс означает, что столбец создан с индексом SharePoint, чтобы фильтры по нему оставались быстрыми на больших списках. По умолчанию - значение, которое SharePoint присваивает при создании элемента без этого столбца; большинство столбцов веб-часть задаёт явно.
Доски обсуждений
По одному элементу на доску. Название - это имя доски, показываемое в раскрывающихся списках Доска. Модераторы изменяют название, описание, режим, категории и параметр утверждения на панели Настройки доски веб-части; форма списка - альтернативный способ.
| Столбец | Внутреннее имя | Тип | Индекс | По умолчанию / значения | Назначение |
|---|---|---|---|---|---|
| Описание | VtxDescription | Несколько строк текста (обычный текст) | Нет | Пусто | Описание доски, редактируемое на панели Настройки доски; в этой версии веб-частью не показывается |
| Режим | VtxMode | Выбор | Нет | Discussion, QnA, Mixed; по умолчанию Discussion | Режим доски: только обсуждения, только вопросы и ответы или и то и другое. Новые доски создаются с Mixed, если не выбран другой режим |
| Категории | VtxCategories | Несколько строк текста (обычный текст) | Нет | Пусто | Категории доски, по одному названию в строке; см. статью KB10423. Организация тем с помощью категорий |
| Темы | VtxTopicCount | Число | Нет | 0 | Число тем доски: при создании устанавливается в 0, увеличивается при создании темы и уменьшается при удалении темы из веб-части (по мере возможности); в этой версии веб-частью не показывается |
| Требуется утверждение | VtxRequireApproval | Да/Нет | Нет | Нет | Да: темы и ответы пользователей без разрешения Управление списками создаются как Pending и ждут в очереди модерации |
Темы обсуждений
По одному элементу на тему. Название - название темы; Создан и Кем создано - время публикации и автор; Вложения содержат файлы, прикреплённые к теме.
| Столбец | Внутреннее имя | Тип | Индекс | По умолчанию / значения | Назначение |
|---|---|---|---|---|---|
| Содержимое | VtxBody | Несколько строк текста (расширенный форматированный текст) | Нет | Пусто | Текст темы в виде очищенного HTML |
| Доска | VtxBoard | Подстановка из Доски обсуждений (Название) | Да | - | Доска, к которой относится тема |
| Категория | VtxCategory | Одна строка текста | Да | Пусто | Название категории; пусто у темы без категории |
| Тип | VtxTopicType | Выбор | Да | Discussion, Question; по умолчанию Discussion | Является ли тема обсуждением или вопросом |
| Статус | VtxStatus | Выбор | Да | Open, Answered, Locked; по умолчанию Open | Locked, пока модератор держит тему закрытой; иначе Answered, когда ответ принят, и Open, когда отметка ответа снята или принятый ответ удалён. Состояние «есть ответ», показываемое веб-частью, выводится из столбца Принятый ответ, а не из этого столбца, поэтому закрытие вопроса не меняет ни его значок, ни его представление |
| Закреплена | VtxIsSticky | Да/Нет | Да | Нет | Закреплённые темы выводятся первыми |
| Рекомендуемая | VtxIsFeatured | Да/Нет | Да | Нет | Показывается в представлении Рекомендуемые |
| Ответы | VtxReplyCount | Число | Нет | 0 | Число утверждённых ответов, ведётся веб-частью |
| Просмотры | VtxViewCount | Число | Нет | 0 | Увеличивается при первом открытии темы в сеансе браузера |
| Последняя активность | VtxLastActivity | Дата и время | Да | - | Время добавления утверждённого ответа или утверждения ответа; изначально — время создания темы. По нему сортируется список тем. Удаление или отклонение ответа не восстанавливает время предыдущей активности |
| Последний ответ | VtxLastReplyBy | Пользователь | Нет | - | Автор последнего утверждённого ответа - для ответа, утверждённого из очереди модерации, его автор, а не модератор |
| Принятый ответ | VtxAcceptedPostId | Число | Нет | 0 | Идентификатор принятого ответа в списке Сообщения обсуждений; 0, если его нет. Источник состояния «есть ответ»: значок Есть ответ и представление С ответом - это темы со значением больше 0, представление Без ответа - вопросы с 0 |
| Лайки | VtxLikeCount | Число | Нет | 0 | Число лайков у темы |
| Кому понравилось | VtxLikedBy | Пользователь (несколько) | Нет | - | Пользователи, которым понравилась тема; один лайк на пользователя |
| Статус утверждения | VtxApprovalStatus | Выбор | Да | Approved, Pending, Rejected; по умолчанию Approved | Состояние модерации; участники видят элементы Approved и свои, модераторы - всё |
| Упоминания | VtxMentions | Пользователь (несколько) | Нет | - | Пользователи, упомянутые через @ в тексте, для уведомлений |
| Жалобы | VtxReportCount | Число | Да | 0 | Число жалоб; тема находится в очереди модерации, пока оно больше 0 |
| Кто пожаловался | VtxReportedBy | Пользователь (несколько) | Нет | - | Пользователи, пожаловавшиеся на тему; одна жалоба на пользователя |
| Прежний идентификатор | VtxLegacyId | Одна строка текста | Да | Пусто | {source list ID}:{item ID} элемента классической доски обсуждений, из которого импортирована тема; позволяет средству импорта пропускать уже импортированные темы |
Сообщения обсуждений
По одному элементу на ответ. Название состоит из Re: и названия темы; Создан и Кем создано - время публикации и автор; Вложения содержат файлы, прикреплённые к ответу.
| Столбец | Внутреннее имя | Тип | Индекс | По умолчанию / значения | Назначение |
|---|---|---|---|---|---|
| Содержимое | VtxBody | Несколько строк текста (расширенный форматированный текст) | Нет | Пусто | Текст ответа в виде очищенного HTML |
| Тема | VtxTopic | Подстановка из Темы обсуждений (Название) | Да | - | Тема, к которой относится ответ |
| Родительское сообщение | VtxParentPost | Подстановка из Сообщения обсуждений (Название) | Да | - | Ответ, на который отвечает данный; пусто у ответа верхнего уровня |
| Путь | VtxPath | Одна строка текста | Да | Пусто | Идентификаторы родительских ответов, записываемые веб-частью, например /12/15/; / у ответа верхнего уровня |
| Уровень | VtxDepth | Число | Нет | 0 | Уровень вложенности: 0 у ответа верхнего уровня, 1 у ответа на него и так далее |
| Принятый ответ | VtxIsAccepted | Да/Нет | Нет | Нет | Да у ответа, принятого как ответ на вопрос; не более одного на тему |
| Лайки | VtxLikeCount | Число | Нет | 0 | Число лайков у ответа |
| Кому понравилось | VtxLikedBy | Пользователь (несколько) | Нет | - | Пользователи, которым понравился ответ |
| Статус утверждения | VtxApprovalStatus | Выбор | Да | Approved, Pending, Rejected; по умолчанию Approved | Состояние модерации ответа |
| Упоминания | VtxMentions | Пользователь (несколько) | Нет | - | Пользователи, упомянутые через @ в ответе |
| Жалобы | VtxReportCount | Число | Да | 0 | Число жалоб на ответ |
| Кто пожаловался | VtxReportedBy | Пользователь (несколько) | Нет | - | Пользователи, пожаловавшиеся на ответ |
| Прежний идентификатор | VtxLegacyId | Одна строка текста | Да | Пусто | {source list ID}:{item ID} классического ответа, из которого импортирован данный |
Подстановки на тему и на родительский ответ созданы без каскадного удаления и без ограничения удаления: удаление темы в списке не удаляет её ответы, а удаление ответа не удаляет ответы под ним. Команда Удалить веб-части ведёт себя иначе: она удаляет тему вместе со всеми её ответами и встроенными изображениями из библиотеки Файлы обсуждений и отказывается удалять ответ, у которого есть собственные ответы. Веб-часть прикрепляет ответы, у которых отсутствует родитель, к верхнему уровню ветки, чтобы ничего не пропадало из виду; см. статью KB10432. Счётчики, последняя активность или лучший ответ выглядят неверно.
При удалении темы выполняется попытка удалить её встроенные изображения из библиотеки файлов; если очистка завершается ошибкой, файлы могут остаться.
Подписки обсуждений
По одному элементу на пользователя и объект. Название - Board:ID или Topic:ID.
| Столбец | Внутреннее имя | Тип | Индекс | По умолчанию / значения | Назначение |
|---|---|---|---|---|---|
| Пользователь | VtxUser | Пользователь | Да | - | Подписчик |
| Тип объекта | VtxTargetType | Выбор | Да | Board, Topic; по умолчанию Board | Является ли подписка подпиской на доску или на тему |
| Идентификатор объекта | VtxTargetId | Число | Да | 0 | Идентификатор элемента доски или элемента темы |
| Частота | VtxFrequency | Выбор | Нет | Immediate, Daily, Weekly; по умолчанию Immediate | Как часто подписчик хочет получать уведомления |
| Доска | VtxBoard | Подстановка из Доски обсуждений (Название) | Да | - | Доска подписки (в том числе для подписок на тему), чтобы поток мог группировать по доске |
У пользователя один элемент на объект; повторная подписка с другой частотой обновляет существующий элемент, а отписка его удаляет. Автор темы подписывается на неё автоматически с частотой Immediate. Веб-часть только ведёт этот список; отправка писем - задача потока Power Automate, контракт которого описан в статье KB10414. Как работают уведомления в Discussions: подписки, упоминания и Power Automate.
Файлы обсуждений
Библиотека документов для изображений, вставленных в темы и ответы с помощью редактора (из буфера обмена, перетаскиванием или через Вставить изображение). Каждое изображение загружается под уникальным именем в папку, названную по текущему году (2026, 2027, …), для организации изображений по годам; это не гарантирует, что папка не превысит порог представления списка. У библиотеки один пользовательский столбец:
| Столбец | Внутреннее имя | Тип | Индекс | По умолчанию / значения | Назначение |
|---|---|---|---|---|---|
| Файл обсуждений | VtxDiscussionsAsset | Одна строка текста | Нет | Пусто | Только столбец-маркер; позволяет распознать библиотеку при любом названии |
Файлы, прикреплённые к теме или ответу с помощью Прикрепить файл, здесь не хранятся - это вложения элемента списка темы или ответа, хранящиеся вместе с элементом в списке Темы обсуждений или Сообщения обсуждений.
Значения выбора
Столбцы выбора хранят приведённые ниже английские значения независимо от языка интерфейса; веб-часть переводит их при показе.
| Столбец | Значения | Показывается как |
|---|---|---|
Режим (VtxMode) | Discussion, QnA, Mixed | Только обсуждения, Только вопросы и ответы, Обсуждения и вопросы |
Тип (VtxTopicType) | Discussion, Question | Обсуждение, Вопрос |
Статус (VtxStatus) | Open, Answered, Locked | значок Закрыта; значок Есть ответ выводится из столбца Принятый ответ (см. выше); у Open значка нет |
Статус утверждения (VtxApprovalStatus) | Approved, Pending, Rejected | значки Ожидает утверждения и Отклонено; у Approved значка нет |
Тип объекта (VtxTargetType) | Board, Topic | - |
Частота (VtxFrequency) | Immediate, Daily, Weekly | Сразу, Ежедневная сводка, Еженедельная сводка |
Что можно редактировать в списках
Веб-часть записывает в списки через SharePoint REST API от имени вошедшего пользователя и заново читает их при каждой загрузке, поэтому изменения, сделанные в формах списков, подхватываются при следующей перезагрузке. Одни столбцы безопасно редактировать, другие ведёт веб-часть, и их лучше не трогать:
| Безопасно редактировать в списке | Ведёт веб-часть |
|---|---|
| Название, Описание, Режим, Категории, Требуется утверждение доски - или, что удобнее, панель Настройки доски веб-части | Ответы, Просмотры, Последняя активность, Последний ответ темы и Темы доски |
| Категория, Закреплена, Рекомендуемая и Статус (Locked) темы; Статус утверждения темы или ответа. Название, категорию и содержимое темы также можно изменить командой Изменить в представлении темы | Принятый ответ темы вместе с Принятый ответ (VtxIsAccepted) ответа - меняйте их только вместе; состояние «есть ответ» следует за столбцом Принятый ответ |
| Содержимое темы или ответа (обычный HTML; веб-часть очищает его при показе) | Путь, Уровень, Родительское сообщение, Тема ответа - перенос ответа вручную ломает ветку |
| Частота подписки | Лайки / Кому понравилось, Жалобы / Кто пожаловался |
Счётчики изменяются увеличением или уменьшением загруженных значений, а не полным пересчётом списков при каждом действии. Ошибки и одновременная запись могут привести к неточностям; следующее действие не обязательно исправит значение, введённое вручную. Историческое число импортированных лайков может превышать число пользователей в столбце «Кому понравилось»; сохраняйте этот исторический счётчик. Для изменения утверждения используйте команды модерации: прямое редактирование столбца не обновляет связанные счётчики.
❗ Важно
Не удаляйте и не переименовывайте столбцы Vtx и не меняйте их типы. Веб-часть распознаёт списки по идентификаторам столбцов-маркеров и читает все остальные столбцы по внутренним именам; отсутствующий столбец приводит к ошибке доски. Переименование отображаемого имени столбца или списка безвредно.
💡 Совет
Поскольку это обычные списки SharePoint, вы можете построить то, чего веб-часть не предлагает: представление списка тем со Статус утверждения = Pending для модераторов, Экспорт в Excel тем для отчёта, отчёт Power BI по спискам Темы обсуждений и Сообщения обсуждений или поток Power Automate по списку Подписки обсуждений для доставки писем.
