Преобразование классических страниц SharePoint в современные страницы

Этот основной рабочий процесс преобразует классические вики-страницы и страницы веб-частей в библиотеке по умолчанию SitePages в SharePoint Online. Используйте средство оценки Microsoft 365 для идентификации страниц и их веб-частей, а затем используйте PnP PowerShell для преобразования утвержденных страниц и проверки каждого результата перед обработкой более крупной волны.

Страницы публикации, страницы блогов, внешние страницы SitePages, домашние страницы и источники SharePoint Server требуют отдельных дополнительных процедур и не принимаются скриптами волны страниц.

Этот рабочий процесс использует PnP PowerShell в качестве основного пути выполнения. Подсистема преобразования страниц является частью платформы PnP Framework с открытым кодом и не имеет соглашения об уровне обслуживания для поддержки Майкрософт.

Рабочий процесс преобразования страницы

  1. Выберите репрезентативную волну страницы из завершенного покрытия оценки.
  2. Устраните блокировку веб-частей и выберите целевой объект на месте или между сайтами.
  3. Подготовьте приложение PowerShell PnP, принадлежащее клиенту, и необходимые разрешения.
  4. Преобразование репрезентативной волны с сохранением источника по умолчанию и ведением журнала.
  5. Проверьте каждую созданную страницу перед развертыванием волны.

1. Выбор кандидатов на страницу

Начните с завершенной оценки классических страниц. Прежде чем выбирать страницы, убедитесь, что проверка покрытия.

Для первой волны:

  • Выберите WikiPage или WebPartPage строки из успешного сканирования сайта и веб-сайта.
  • Предпочитайте страницы без несопоставленных веб-частей и высоким процентом сопоставления.
  • Проверьте classicpagewebparts.csv точные типы и сопоставления веб-частей.
  • Проверьте любую страницу вручную с помощью WebPartCount=0. Процент сопоставления 100 для страницы с нулевой частью означает только, что оценка не извлекла веб-части.
  • Избегайте домашней страницы, пока не будет проверен процесс преобразования и проверки.
  • Записывайте видимый текст, веб-части, ссылки, изображения и макет, которые должны присутствовать после преобразования.

MappingPercentage=100 является сигналом планирования. Это не гарантирует, что преобразование будет успешно выполнено или сохранит ожидаемое содержимое.

Создание репрезентативной волны

Обрабатывать страницы как один и тот же шаблон преобразования, только если эти измерения совпадают:

Dimension Почему он определяет отдельный шаблон
PageType Отделяет поведение преобразования вики-страниц и веб-частей.
Layout Управляет созданными разделами и столбцами.
Упорядоченная подпись веб-части Страницы с разными типами веб-частей, порядком, скрытым или закрытым состоянием могут преобразовыться по-разному.
Результат сопоставления Несопоставленные или сопоставленные по-другому веб-части требуют отдельного исправления и проверки.
Целевой подход Преобразования на месте и между сайтами имеют разные зависимости и поведение URL-адресов.
Специальная обработка Домашние страницы, пользовательские макеты публикации и страницы с нулевой частью требуют отдельной проверки.

Используйте classicpagewebparts.csv для создания упорядоченной подписи веб-части для каждой страницы. Не группировать только по MappingPercentage или UnmappedWebParts; полностью сопоставленные страницы по-прежнему могут содержать различные типы веб-частей и поведение среды выполнения.

Для первой волны:

  1. Исключите неисправное покрытие, неподдерживаемые типы страниц, домашние страницы, страницы с нулевой частью и неразрешенные сопоставления.
  2. Сгруппировать остальные страницы по типу страницы, макету и упорядоченной подписи веб-части.
  3. Выберите по крайней мере одну страницу из каждого шаблона, который планируется перенести.
  4. Добавьте еще одного представителя, если страницы в том же шаблоне используют существенно другие свойства веб-части или зависимости содержимого.
  5. Предпочитайте страницу с четким базовым содержимым и владельцем бизнеса, который может проверить результат.

Используйте даты действий и изменений, чтобы определить, какой шаблон следует обрабатывать в первую очередь, а не в качестве замены для покрытия шаблонов.

См . статью Создание репрезентативных групп страниц с помощью PowerShell.

Сведения о сопоставлении между полями и примере выбранной страницы см. в статье Интерпретация отчета об оценке классических страниц.

2. Устранение блокировщиков и выбор целевого объекта

Группирование страниц-кандидатов по типу страницы, макету и сочетанию несопоставленной веб-части. Устранение распространенных блокаторов перед преобразованием волны.

  • Для вики-страниц и страниц веб-частей преобразование на месте является предпочтительной отправной точкой, так как зависимости остаются на исходном сайте.
  • Преобразования межсайтовых вики-страниц и веб-частей требуют дополнительной проверки ссылок, файлов, списков, пользователей и таксономии.

См . статью Выбор преобразования на месте или между сайтами и Просмотр классических сопоставлений веб-частей.

3. Подготовка PowerShell для PnP

Для PnP PowerShell требуется приложение Microsoft Entra, принадлежащее клиенту. Используйте отдельное приложение преобразования от приложения оценки только для чтения.

Для основного интерактивного потока используйте делегированный SharePoint AllSites.Manageвместе с существующими разрешениями сайта пользователя, выполнившего вход. Для копирования уникальных разрешений на уровне элемента требуется AllSites.FullControl; в противном случае явно пропустите это копирование.

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

4. Преобразование репрезентативной волны

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

Для первой волны:

  • Позвольте созданной странице использовать префикс по умолчанию Migrated_ .
  • Не используйте -TakeSourcePageNameпараметры замены , -Overwriteили домашней страницы.
  • Включите ведение журнала файлов и сохраните журнал с помощью манифеста волны.
  • Остановите первый непредвиденный сбой или несоответствие содержимого.

Включите поведение переименования или перезаписи источника только после утверждения созданных страниц и создания плана отката.

Используйте внедренные скрипты из ссылки на скрипты волны страницы для обработки каждой утвержденной репрезентативной страницы с помощью одного и того же контракта безопасности и результата.

5. Проверка и развертывание

Открытие без ошибки не является достаточной проверкой. Созданная страница может существовать и по-прежнему быть пустой или неполной.

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

См . раздел Проверка преобразованных классических страниц.

После пометки Passedкаждого репрезентативного результата используйте Convert-SelectedPages.ps1 для обработки всех дополнительных строк, утвержденных пользователем. Скрипт отклоняет страницы, шаблон преобразования которых не имеет переданного представителя.

Дальнейшие действия

  1. Преобразование выбранных страниц с помощью PnP PowerShell.
  2. Проверьте преобразованные страницы.

Дополнительные справочные материалы

  • Last updated on