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

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

Запись ожидаемый результат

Перед преобразованием запишите:

  • Исходные и ожидаемые целевые URL-адреса.
  • Тип и макет страницы.
  • Видимый текст и заголовки.
  • Веб-части и их важная конфигурация.
  • Ссылки, изображения, файлы, списки и внедренное содержимое.
  • Метаданные, разрешения, состояние публикации и то, является ли страница домашней страницей.

Сохраните строку оценки и classicpagewebparts.csv строки с этим базовым показателем.

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

Просмотр результата преобразования

Для каждой страницы:

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

Обнаружение неполных выходных данных

Обрабатывать страницу как сбой, если:

  • Целевая страница пуста или содержит только заголовок.
  • Отсутствует ожидаемый текст или обязательная веб-часть.
  • Веб-часть присутствует, но указывает на неправильный список, файл, сайт, пользователя или термин.
  • Макет или заголовок страницы не позволяет странице выполнять свои бизнес-цели.
  • Необходимые метаданные или разрешения не были сохранены.
  • Журнал преобразования содержит неразрешенную ошибку.

Вручную проверьте страницы, на которых сообщается WebPartCount=0оценка , даже если MappingPercentage=100. Также проверьте страницы, сообщаемые как полностью сопоставленные, так как данные среды выполнения или функции сопоставления по-прежнему могут привести к сбою преобразования.

Запись результата волны

Используйте одну запись для каждой страницы попытки:

Поле Назначение
ScanId Связывает страницу с свидетельством оценки.
SiteUrl, WebUrl, PageUrl Определяет исходную страницу.
PlannedTargetPageUrl, TargetPageUrl Определяет проверенный план и созданный целевой объект.
PageType, Layout Групповая группа сопоставимых результатов.
MappingPercentage, UnmappedWebParts Сохраняет сигнал планирования.
TransformationStatus Skipped, PreflightPassed, Createdили Failed.
LogPath Указывает на точный журнал преобразования PnP для страницы.
ValidationStatus Pending, Passedили Failed.
ValidationNotes Записывает недостающее содержимое, проблемы с сопоставлением и последующую работу.
ValidatedBy, ValidatedAt Владение утверждением записей.

Решите, следует ли развернуть

Разворачивайте волну только в следующих случаях:

  • Все репрезентативные исходные страницы остаются доступными.
  • Каждая утвержденная целевая страница проходит проверку содержимого и поведения.
  • Проекты целевых объектов публикуются только после утверждения.
  • Распространенные блокировщики имеют документированные исправления или сопоставления.
  • Неудачные или частичные страницы исключаются из следующей волны.
  • Следующая волна имеет владельца, план отката и сохраненные журналы.

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

После утверждения черновика страницы опубликуйте ее в режиме редактирования страницы или с помощью текущего параметра Set-PnPPPage-Publish .

Развертывание волны

После проверки каждой репрезентативной страницы:

  1. Задайте для каждого репрезентативного результата значение ValidationStatus=Passed.
  2. Заполните ValidationNotes, ValidatedByи метку времени ISO-8601 ValidatedAt .
  3. Создайте approved-pages.csv из дополнительных сгруппированных строк, утвержденных пользователем.
  4. Запустите Convert-SelectedPages.ps1 -PreflightOnly с исходным репрезентативным манифестом и проверенными результатами.
  5. Запустите динамическое расширение только после прохождения каждой предварительной строки.
  6. Перед публикацией проверьте каждую созданную страницу в развернутой волне.

Скрипт блокирует расширение, если репрезентативный результат отсутствует, устарел, не передан или основан на другом PnP PowerShell или профиле скрипта.

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

  1. Возврат невыполненных страниц в невыполненную работу по исправлению.
  2. Добавьте переданные шаблоны страниц в approved-pages.csv и запустите скрипт расширения.

Справочные материалы

  • Last updated on