Questions & Answers Общие вопросы
Что такое Questions and Answers? Веб-часть SharePoint Framework от Vitextra, которая показывает базу знаний в формате «вопрос - ответ» на современной странице SharePoint Online или на вкладке Microsoft Teams: аккордеон вопросов с поиском, категориями, ответами с расширенным содержимым, комментариями и кнопкой «Задать вопрос». Обзор: KB10217. Questions and Answers. Обзор решения.
Где хранится содержимое? Продукт хранит вопросы, ответы, вложения и комментарии в списке SharePoint сайта. Это не гарантирует, что все запросы браузера и всех зависимостей остаются внутри тенанта. KB10384. Разрешения, хранение данных и конфиденциальность в Questions and Answers
Работает ли она на SharePoint Server или классических страницах? Нет. Она предназначена для современных страниц SharePoint Online и для Microsoft Teams.
Как она соотносится со страницей со свёртываемыми разделами или с Viva Engage? См. KB10386. Questions and Answers, страница FAQ в SharePoint или Viva Engage: какую базу знаний выбрать.
Настройка и список
Можно ли использовать уже имеющийся список? Да, если он находится на том же сайте и содержит столбцы с внутренними именами Category, Answer, Link, VideoUrl, Contact и Order, а также столбец типа «Да/Нет» с именем Published. Подходящие списки предлагаются в варианте «Существующий список»; см. KB10382. Справочник параметров веб-части Questions and Answers.
Может ли одна веб-часть показывать список с другого сайта? Нет. Веб-часть работает со списками того сайта, на котором она размещена. Поместите веб-часть на страницу сайта, где находится список, или дайте ссылку на эту страницу.
Могут ли несколько страниц показывать одну и ту же базу знаний? Да. Добавьте веб-часть на каждую страницу и подключите её к тому же списку с помощью «Существующий список»; у каждой веб-части свои настройки.
Как изменить подключённый список? Удалите веб-часть со страницы и добавьте её заново; переключить список в панели свойств нельзя.
Почему веб-часть не создаёт список за меня? Для создания списка нужно разрешение на добавление списков на сайте. Попросите владельца сайта один раз создать его с помощью «Новый список», а затем подключитесь через «Существующий список».
Содержимое и ответы
Как форматировать ответы? С помощью Markdown, набранного как обычный текст в столбце Answer: **полужирный**, - списки, [ссылки](url), ## заголовки. Не используйте панель форматирования формы; переведите столбец в обычный текст, если форматирование не отображается. См. KB10380. Оформление ответов в Questions and Answers: Markdown, видео, вложения, ссылки на подробности и контакты.
Может ли ответ содержать видео? Да: укажите адрес в столбце VideoUrl. YouTube и Vimeo воспроизводятся во встроенном плеере, прямые видеофайлы (.mp4, .webm, .ogg, .ogv, .m4v) - в плеере браузера; другие адреса показываются как ссылка.
Можно ли прикреплять файлы? Да, с помощью вложений элемента списка; они показываются как карточки файлов под ответом.
Почему вопрос не отображается? Сначала проверьте, не установлено ли для столбца Published значение «Нет». Показываются только опубликованные элементы; см. KB10385. Устранение неполадок Questions and Answers: «Не настроено», отсутствующие столбцы, скрытые вопросы и разрешения.
Как управлять порядком? Установите «Сортировать по» в «Порядок вопросов» и пронумеруйте столбец Order; либо сортируйте по «Имя» или «Создано». См. KB10379. Организация вопросов: категории, группировка, фильтр по категориям, сортировка и свёртывание.
Есть ли ограничение на количество вопросов? Один запрос возвращает до 5 000 элементов. При заданном значении «Элементов на странице» веб-часть загружает вопросы порциями и справляется с большими списками; по мере роста списка добавьте индексы для столбца Published и столбца сортировки. См. KB10378. Поиск по базе знаний и постраничная загрузка в Questions and Answers.
Поиск и категории
Что охватывает поиск? Текст вопроса, текст ответа и имя контакта по всем опубликованным вопросам списка - но не вложения, комментарии или категории.
Почему поиск SharePoint не находит мои вопросы? Список, созданный веб-частью, исключён из поискового индексирования. Измените параметр Разрешить отображение элементов этого списка в результатах поиска в дополнительных параметрах списка, если хотите видеть их в глобальном поиске.
Как работают категории? У каждого вопроса есть Category (столбец выбора). Веб-часть может группировать список по категории и показывать вкладки фильтра («Все» + категории), когда существует не менее двух категорий. Вкладки используют категории уже загруженных вопросов и появляются только при наличии хотя бы двух непустых категорий.
Вопросы сотрудников и комментарии
Могут ли сотрудники задавать вопросы? Кнопка требует включённой настройки веб-части и разрешения Add Items. Форма отправляет только Title и полагается на значения списка по умолчанию: у создаваемого столбца Published это No, но в существующем списке настройка может отличаться. Редактор может опубликовать вопрос, изменив Published; это могут сделать и другие пользователи с фактическим правом изменения. Код отправки не проверяет статус HTTP, поэтому даже после сообщения об успехе проверьте элемент в списке. KB10220. Как разрешить сотрудникам задавать вопросы в Questions and Answers
Можно ли разрешить всем спрашивать, не разрешая публиковать? Одной настройки изменения собственных элементов недостаточно: пользователь может изменить Published в собственном обращении. Само разрешение Изменение элементов не отменяет ограничения на уровне элементов; это позволяет разрешение Управление списками (Manage Lists). Стандартный уровень Изменение включает Управление списками. Published фильтрует только веб-часть, а чтение всех элементов позволяет напрямую читать черновики в списке. Для строгого редакционного контроля нужны отдельно настроенные и проверенные разрешения SharePoint и подходящий рабочий процесс. KB10384. Разрешения, хранение данных и конфиденциальность в Questions and Answers.
Хранятся ли комментарии где-то особо? Нет. Это комментарии SharePoint к элементу списка, и они показываются как в веб-части, так и в списке. См. KB10381. Комментарии, упоминания @ и глубокие ссылки в Questions and Answers.
Можно ли отключить комментарии? Для веб-части - с помощью «Показать комментарии» → «Скрыть»; для списка - в разделе Дополнительные параметры → Комментарии.
Как отправить кому-то ссылку на один ответ? Кнопкой «Копировать ссылку» в заголовке вопроса; ссылка открывает страницу с раскрытым и выделенным вопросом.
Microsoft Teams
Можно ли использовать её в Teams? Да, как вкладку канала со списком на сайте команды.
Есть ли личное приложение? Нет. База знаний принадлежит сайту или команде и закрепляется как вкладка канала.
Разрешения и безопасность
Какие разрешения API запрашивает пакет? Никаких. Веб-часть использует SharePoint REST API текущего сайта от имени вошедшего пользователя.
Что отправляется в Vitextra? Показанный запрос проверки лицензии содержит технические идентификаторы, а не поля вопросов и ответов. Внешние изображения Markdown, адреса видео и ссылки могут обращаться к своим узлам. SDK Application Insights и компоненты SharePoint также выполняют запросы; оценивайте их конфигурацию и публикуемое содержимое, не воспринимая статью как гарантию отсутствия стороннего трафика или хранения в браузере.
Какие узлы должен разрешить наш брандмауэр? vitextra.com, static.vitextra.com и vitextra-storage.azureedge.net; а также youtube.com или player.vimeo.com, если вы встраиваете видео с этих служб. Это примеры, а не полный список разрешений брандмауэра. Учтите ресурсы Microsoft 365, конечные точки телеметрии и узлы изображений, видео и ссылок из содержимого; проверьте фактический сетевой трафик.
Языки, темы и лицензирование
Какие языки поддерживаются? В исходниках 50 файлов локалей, а не 50 отдельных языков. Локаль интерфейса выбирает SPFx; содержимое - текст, сохранённый в списке.
Поддерживает ли веб-часть тему нашего сайта? Да - тема сайта, фон разделов, тёмный режим в Teams, шрифт сайта и разделы во всю ширину.
Есть ли пробный период и как лицензируется продукт? Срок пробного периода, правила активации и охват подписки определяются коммерческими условиями вне исходного кода веб-части. Проверьте актуальные инструкции по лицензированию и учётную запись: сам код не подтверждает срок 14 дней, событие его начала или права на весь тенант. KB10206. Лицензирование и учётная запись Vitextra: как приобрести и активировать лицензию; KB10364. Что происходит, когда заканчивается пробный период или подписка Vitextra.
Где посмотреть версию? В группе «Информация» в нижней части панели свойств.
