Устранение неполадок при импорте классической доски

Обзор

Импорт в Discussions намеренно консервативен: он читает классический список, записывает то, что может, и обо всём, что не удалось сделать в точности, сообщает предупреждением, а не остановкой. Поэтому большинство проблем попадает в три группы: мастер не запускается или ничего не находит, пробный прогон или запуск завершается ошибкой, либо запуск завершается с предупреждениями. В этой статье симптомы перечислены именно в таком порядке, каждый с причиной и решением. Как работает мастер, описано в статье KB10417. Как импортировать классическую доску обсуждений SharePoint в Discussions; что он копирует - в статье KB10418. Что копирует импорт и как он восстанавливает цепочки ответов.

Начните здесь: что вы видите?

Кнопка «Импорт классической доски» отсутствует

Причина. Кнопка показывается только при одновременном выполнении двух условий: страница находится в режиме редактирования, и у вошедшего пользователя есть разрешение Управление списками на сайте (входит в уровни разрешений «Изменение» и «Полный доступ»). Участники с уровнем «Участие» видят Новая тема, но не видят ни Модерация, ни Импорт классической доски. Кнопка также отсутствует, пока доска находится в состоянии «только чтение» после окончания пробного периода.

Решение. Нажмите Изменить на странице или попросите владельца сайта выполнить импорт. Разрешения описаны в статье KB10408. Разрешения в Discussions: кто может читать, писать и модерировать.

На этом сайте нет классических досок обсуждений

Причина. Мастер показывает только те списки выбранного сайта, шаблон которых - классическая Доска обсуждений (шаблон 108) или базовый тип которых - Discussion Board; сюда входят и списки обсуждений сайтов сообщества. Пустой список возникает в трёх случаях:

• Доска находится на другом сайте. Мастер начинает с текущего сайта. Введите относительный адрес сайта, на котором размещена доска - /sites/legacy, а не полный адрес https://… и не адрес списка, - в поле Сайт (относительный адрес) и нажмите Загрузить доски.
• Версия веб-части ниже 26.10.3. До версии 26.10.3 мастер распознавал только списки с шаблоном 108 и не показывал список обсуждений классического сайта сообщества (Community Site, шаблон 925). Обновите веб-часть до версии 26.10.3 или новее: начиная с неё такие доски появляются в раскрывающемся списке наравне с остальными.
• У вас нет разрешений на исходный сайт. Списки, которые вошедший пользователь не может читать, SharePoint не возвращает. Запросите как минимум Чтение на классическую доску.

Другой сайт не загружается

Симптом. После нажатия Загрузить доски появляется красное сообщение, например ошибка SharePoint Отказано в доступе или Файл не найден, а раскрывающийся список остаётся пустым.

Причина. Адрес неверен, сайт находится в другом клиенте или у вас нет к нему доступа. Импорт вызывает SharePoint REST API введённого сайта от вашей учётной записи; сообщение - это ответ SharePoint.

Решение. Скопируйте адрес с домашней страницы сайта и оставьте только часть после имени узла (/sites/legacy); убедитесь, что сайт принадлежит тому же клиенту, что и страница; откройте сайт в новой вкладке, чтобы убедиться, что вы можете его читать.

Пробный прогон медленный или завершается ошибкой

Причина. Кнопка Проанализировать читает весь классический список по 2 000 элементов за запрос, а затем читает прежние идентификаторы, уже имеющиеся в списках Discussions. Обработка доски с десятками тысяч элементов занимает время; потерянное соединение или истёкший за это время сеанс завершают процесс ошибкой.

Решение. Дождитесь, пока индикатор рядом с кнопкой Проанализировать исчезнет; если появилась ошибка, обновите страницу, при необходимости войдите снова и нажмите Проанализировать ещё раз. Во время пробного прогона ничего не записывается, поэтому повторять его безопасно.

Импорт недоступен

Причина. План содержит 0 тем: в классическом списке нет обсуждений. Ответы нельзя импортировать сами по себе; каждому нужно обсуждение, к которому он относится.

Решение. Откройте классический список в браузере и убедитесь, что он содержит обсуждения; если доска пуста, импортировать нечего.

Не удалось восстановить автора и даты

Симптом. В отчёте после названия элемента указано сообщение об ошибке или Не удалось восстановить автора и даты. В некоторых импортированных элементах могут остаться ваше имя или дата импорта.

Причина. При включённом параметре Сохранить исходных авторов и даты импорт восстанавливает Кем создано, Кем изменено, Создан и Изменен через SharePoint CSOM после остальных операций записи в новые элементы. Учётной записи нужны разрешения на изменение этих системных полей. Если исходного автора не удаётся сопоставить с пользователем сайта, в отчёте появляется предупреждение, а автором остаётся импортирующий пользователь; даты при этом могут быть восстановлены. При ошибке обновления через CSOM поля сохраняют текущие значения. Сам элемент остаётся импортированным.

Решение. Запускайте импорт от имени владельца сайта. Учётные записи, которых больше нет, восстановить нельзя; элементы остаются приписанными импортирующему пользователю. Поскольку уже импортированные темы при повторном запуске пропускаются, системные поля не исправляются простым повторным запуском мастера: удалите затронутые элементы (отфильтруйте Темы обсуждений и Сообщения обсуждений по столбцу Прежний идентификатор), затем запустите мастер снова под нужной учётной записью.

Ответ пропущен: его тема не импортирована

Симптом. Строки Ответ пропущен: его тема не импортирована: 418, где 418 - классический идентификатор ответа.

Причина. Папка ответа не соответствует ни одной теме, которую импорт создал или нашёл. Обычно сама тема завершилась ошибкой раньше - поищите выше строк об ответах предупреждение с названием темы и сообщением SharePoint - либо ответ лежит в папке, которая не является классическим обсуждением.

Решение. Устраните ошибку темы (чаще всего это проблема разрешений или названия) и запустите мастер снова: тема будет создана, а ответы темы, которая раньше не была импортирована, импортируются вместе с ней. Ответы тем, удалённых в классическом списке, импортировать нельзя.

Родительский ответ не импортирован; ответ помещён на верхний уровень

Симптом. Строки Родительский ответ не импортирован; ответ помещён на верхний уровень: 419, где 419 - классический идентификатор ответа. В импортированной теме такой ответ стоит на первом уровне, а не под ответом, на который он отвечал в классической доске.

Причина. Родительский ответ есть в классическом списке, но создать его в этом запуске не удалось - в отчёте выше строк о его ответах есть предупреждение о самом родителе с его названием и сообщением SharePoint. Импорт не пропускает дочерние ответы: он импортирует каждый из них на верхний уровень темы и добавляет это предупреждение. Ответы, вложенные в такой дочерний ответ, прикрепляются к нему как обычно.

Решение. Устраните ошибку, указанную для родителя. Уже импортированные ответы при повторном запуске пропускаются, поэтому повторный запуск мастера создаст недостающего родителя, но не переместит ответы: удалите перенесённые на верхний уровень ответы вместе с вложенными в них ответами (отфильтруйте Сообщения обсуждений по столбцу Прежний идентификатор вида {classic list id}:{reply id}), затем запустите мастер снова.

Вложения

Симптом. Строки имя файла: текст ошибки; число вложений в итоговом сообщении меньше, чем предполагала строка Элементы с вложениями плана.

Причина. Файл не удалось скачать с исходного сайта или добавить к новому элементу. Типичные причины: тип файла заблокирован в клиенте, файл больше допустимого при загрузке, имя файла стало недопустимым. Импорт заменяет символы, которые SharePoint не допускает в именах, и сокращает имена длиннее 120 символов, но при ошибке загрузки по другой причине в отчёт добавляется сообщение SharePoint.

Решение. Вложения копируются только при создании элемента; повторный запуск не повторяет их копирование. Скачайте файл из классического списка и прикрепите его к импортированной теме или ответу вручную; см. KB10402. Прикрепление файлов к темам и ответам.

Плоские деревья ответов

Симптом. Все ответы темы находятся на одном уровне в хронологическом порядке, хотя на классической доске они были вложенными; пробный прогон показал большое число в строке Ответы без известного родителя (станут верхнего уровня).

Причина. Классические ссылки Родительский элемент были потеряны до импорта - как правило, когда доску копировали инструментом миграции, который их не переносит, - или указывают на удалённые ответы. Импорт восстанавливает дерево только по существующим ссылкам; он не угадывает родителей по датам или темам.

Решение. Если исходная доска ещё существует, скопируйте её снова инструментом, который сохраняет ссылки, удалите импортированные элементы и импортируйте ещё раз. Если нет, плоский импорт - лучший доступный результат.

Если после возобновления импорта вложенность нарушена при корректных ссылках на родительские ответы, причиной может быть текущая реализация: новые ответы под уже импортированными родителями могут получить неверные путь и глубину. См. ограничения в KB10418; повторный запуск не перестраивает пути существующих ответов.

Дубли после повторного импорта

Симптом. После повторного запуска мастера каждая тема существует дважды.

Причина. Импорт распознаёт импортированные элементы по столбцу Прежний идентификатор, значение которого - {classic list id}:{item id}. Повторный запуск из того же списка пропускает всё, что уже есть. Дубли появляются, когда повторный запуск использует другой список - доска была перенесена ещё раз в новый список, скопирована шаблоном сайта или восстановлена из резервной копии как новый список, - потому что у нового списка новый идентификатор.

Решение. Удалите один набор: откройте Темы обсуждений и Сообщения обсуждений, отфильтруйте по столбцу Прежний идентификатор, начинающемуся с идентификатора ненужного списка, и удалите эти элементы (корзина хранит их обычный срок). Затем всегда импортируйте из одного и того же списка.

Импорт был прерван

Симптом. Вкладка браузера была закрыта или соединение пропало, пока шёл индикатор выполнения; отчёт так и не появился.

Причина. Импорт выполняется во вкладке браузера. Закрытие вкладки или потеря соединения могут прервать любой этап; отправленный на сервер запрос при этом мог уже завершиться.

Решение. Откройте страницу в режиме редактирования и запустите мастер снова для того же источника. Созданные темы и ответы распознаются по прежнему идентификатору и пропускаются; остальное импортируется, а завершающий этап пересчитывает счётчики всех тем плана. Авторы, даты или вложения элементов, созданных до прерывания, могут быть не восстановлены; повторный запуск не пытается восстановить их заново. Проверьте затронутые элементы и исправьте их вручную либо удалите и импортируйте повторно после устранения причины.

Импортированные сообщения видны, хотя доска требует утверждения

Причина. Импортированные темы и ответы создаются со статусом утверждения Approved; импорт считает классическое содержимое уже опубликованным.

Решение. Просмотрите содержимое в классическом списке до импорта или отклоните то, что не должно показываться, после импорта в очереди Модерация.

Пользователи могут снова ставить лайки импортированным сообщениям

Причина. Импорт копирует число лайков, но не список пользователей, которым понравился элемент (столбец Кому понравилось остаётся пустым). Пользователь, поставивший лайк сообщению на классической доске, может поставить его ещё раз в Discussions, что увеличивает счётчик на единицу.

Решение. Это ожидаемое поведение. Счётчики описаны в статье KB10405. Лайки, просмотры и счётчики ответов в Discussions.

Проблема не решена

Соберите следующее и обратитесь в поддержку Vitextra: версию продукта из группы Информация панели свойств, адреса исходного сайта и страницы, числа пробного прогона, строки предупреждений из отчёта и снимок экрана любого сообщения об ошибке. Общие симптомы веб-части перечислены в статье KB10429. Устранение неполадок Discussions: «Не настроено», доска не найдена и ошибки разрешений.