Интерпретация отчета об оценке классических страниц

Классическая оценка экспортирует csv-файлы для конкретной страницы и общие файлы. В Windows команда по умолчанию report также создает ClassicAssessmentReport.pbit.

В этом руководстве рассматриваются представления Pages и scan-coverage. Общий классический шаблон содержит другие вкладки компонентов и совместимости, но они находятся за пределами этой область оценки страницы.

Сначала проверьте охват сканирования

Перед интерпретацией готовности страницы убедитесь, что ожидаемый область завершен:

1. Используйте обзор сканирования, scans.csvи history.csv для просмотра состояния и сообщений оценки.
2. Используйте sitecollections.csv и webs.csv для выявления неудачных, незавершенных или необычно медленных расположений.
3. Убедитесь, что оценка использовала полный область клиента, --siteslistили --sitesfile.
4. Проверьте classicpageauditusage.csv состояние покрытия перед использованием счетчиков действий.

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

Общие схемы файлов и ключи соединения см. в справочнике по CSV-файлам для общей оценки.

Определение приоритета страниц

На текущей вкладке Pages Power BI используются основные поля инвентаризации страниц, такие как тип страницы, URL-адрес, дата изменения и код исправления.

Используйте classicpages.csv для обогащенных полей готовности и для сегментирования страниц по следующим причинам:

• Тип страницы.
• Состояние домашней страницы.
• Дата последнего изменения и модификатор.
• Количество веб-частей.
• Процент сопоставления.
• Несопоставленные типы веб-частей.

Объедините этот инвентарь с, classicpageauditusage.csv чтобы отличить часто используемые страницы от устаревшего или низкого использования содержимого.

Текущая внедренная модель Power BI не включает в себя расширенные поля сводки домашней страницы, веб-части, сопоставления, аудита или подготовки страниц. Проанализируйте эти поля непосредственно в CSV-файлах или расширьте модель Power BI, прежде чем использовать их в визуальных элементах.

Использование аудита — это сигнал планирования, а не необработанный счетчик веб-аналитики. Всегда проверка QueryStatus:

Состояние	Смысл
succeeded	Запрошенное окно аудита завершено.
partial	Сбой одного или нескольких вложенных запросов аудита. Счетчики являются нижней границей.
failed	Сбой сбора аудита. Счетчики не являются пригодными для использования.
skipped	Коллекция аудита не выполнялась для сайта, например в неподдерживаемом облаке.
error	Произошло непредвиденное исключение после сканирования. Проверьте SkipReason и журнал оценки.

Важно!

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

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

Если SkipReason начинается с QueryTimeout, Microsoft Purview не выполнил запрос во время 90-минутного ожидания оценки. Если блок аудита не выполняется успешно, строка имеет QueryStatus=failedзначение ; обрабатывает нулевые счетчики как неудачное покрытие, а не как свидетельство отсутствия действий. Это отличается от NoPermission, который указывает на отсутствие разрешения аудита.

Общие сведения о покрытии типа страницы

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

Страницы блогов, ASPX и Delve обнаруживаются и записываются, но не получают одно и то же обогащение готовности к сопоставлению. Не интерпретирует значение по умолчанию или пустое сопоставление для этих типов страниц как завершенный анализ готовности.

Страницы блога Delve отображаются в classicpages.csv , но не включаются в текущие накопительные пакеты веб-страниц и сайтов.

Интерпретация результатов сопоставления

MappingPercentage — это процент извлеченных веб-частей, которые имеют доступное для использования сопоставление во внедренной модели сопоставления.

• Страница без извлеченных веб-частей составляет 100 процентов по соглашению.
• 100-процентный результат означает, что все извлеченные типы веб-частей имеют сопоставления. Он не гарантирует четность визуальных элементов, данных, разрешений или бизнес-поведения после преобразования.
• Значение ниже 100 и WebPartCount больше нуля определяет один или несколько типов веб-частей, требующих исправления, замены или пользовательского сопоставления.
• Для вики-страницы, веб-части или страницы публикации может указывать, WebPartCount=0MappingPercentage=0 что извлечение завершилось ошибкой до выполнения вычисления сопоставления. Просмотрите журнал оценки для Failed to assess the web parts of classic page.

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

• IsMappable означает, что веб-часть имеет непустое сопоставление.
• WebPartProperties заполняется только в том случае, если --exportwebpartproperties выбрано значение .
• Строки, столбцы, зоны, порядка, скрытые и закрытые значения помогают объяснить текущий макет страницы.

Используйте classicwebpartunique.csv для определения типов веб-частей, влияющих на многие страницы. InMappingFile слабее , чем IsMappable: это означает только, что тип содержит запись в файле сопоставления.

Текущая реализация оценки намеренно рассматривает сопоставления сообщества как ScriptEditorWebPart недоступные.SimpleFormWebPart Он также не поддерживает переопределение файла сопоставления на диске.

Этот результат оценки означает, что модель готовности по умолчанию не утверждает эти веб-части. При необходимости преобразование PnP может перенаправить редактор скриптов и содержимое простой формы в редактор сценариев сообщества с открытым кодом после установки этого решения и -UseCommunityScriptEditor выбора.

Предостережение

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

См. статью Сопоставления классических веб-частей.

Решение о следующем действии

Оцените таблицу сверху вниз и используйте первую соответствующую строку. Решения на основе сопоставления применяются только после завершения покрытия и маршрутизации типа страницы.

Результат оценки	Decision	Следующее действие
Семейство веб-сайтов или веб-сайт не завершены	Покрытие заблокировано	Устраните сбой сканирования перед интерпретацией количества страниц или готовности.
Тип страницы: Blog, ASPX или Delve Blog	Оценка сопоставления не является практической	Следуйте указаниям по поддержке типа страницы вместо использования процента готовности.
Тип страницы — Публикация	Расширенная невыполненная работа	Прежде чем определять отдельный целевой объект и процедуру, просмотрите макет и отсутствующие входные данные на уровне портала.
Вики-страница или страница веб-частей является домашней страницей	Требуется отдельное утверждение	Не используйте его в первой волне и определите URL-адрес, навигацию и поведение отката перед преобразованием.
Вики-сайт или страница веб-части содержит WebPartCount=0 и MappingPercentage=0 с ошибкой обогащения	Сбой сканирования страницы	Просмотрите журнал и повторно запустите оценку, прежде чем выбрать страницу.
Вики-сайт или страница веб-части содержит WebPartCount=0 и MappingPercentage=100	Требуется проверка вручную	Откройте исходную страницу и убедитесь, что оценка пропустила видимое содержимое. Не помещайте его в автоматизированную волну.
Вики-сайт или страница веб-частей содержит WebPartCount>0, MappingPercentage=100и не имеют несопоставленных веб-частей	Представитель пилотного кандидата	Сгруппировать его по макету и упорядоченной подписи веб-части, преобразовать черновик и проверить результат.
Вики-сайт или страница веб-части содержит MappingPercentage<100 один или несколько UnmappedWebParts	Требуется исправление	Замените блокирующие веб-части или определите и отдельно проверьте пользовательское сопоставление перед преобразованием.

Использование накопительных исправлений

Используйте classicwebsummaries.csv и classicsitesummaries.csv для идентификации:

• Веб-сайты и семейства веб-сайтов с наиболее классическими страницами.
• Страницы с полностью сопоставляемыми или несопоставленными веб-частями.
• Средний процент сопоставления между страницами, содержащими веб-части.
• Домашние страницы, для которых требуется отдельный утвержденный список невыполненных работ для URL-адреса, навигации и планирования отката.

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

Просмотр порталов публикации

classicpublishingsitesummaries.csv предоставляет сводку по публикации на уровне семейства веб-сайтов. Подробные сведения о устаревшей конфигурации публикации веб-уровня не включены.

См . статью Общие сведения об охвате портала публикации перед планированием преобразования страницы публикации.

Переход от оценки к преобразованию

Превратите отчет в невыполненную работу по преобразованию:

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

Сопоставление полей CSV с PnP PowerShell

Поле CSV	Использование преобразования
SiteUrl + WebUrl	Создайте исходный URL-адрес веб-сайта для Connect-PnPOnline.
PageUrl + ListUrl	Наследуйте имя файла страницы, содержащего библиотеку и необязательную папку.
PageName	Используйте заголовок страницы как -Identity для классической страницы блога.
PageType	Маршрут к вики-части или веб-части, публикации или пути преобразования блога.
Layout	Выберите или проверьте сопоставление макетов страниц для страниц публикации.

Приложение оценки доступно только для чтения. Используйте отдельное подключение PowerShell PnP с разрешением на создание или обновление страниц в исходном или целевом веб-сайте.

Продолжить работу с задачей преобразования

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

Перенаправление других типов страниц намеренно:

• PublishingPage: используется -PublishingPage, целевой веб-сайт и модель макета страницы публикации.
• BlogPage: используйте -BlogPageв PageName качестве удостоверения заголовка блога и целевой веб-сайт. Строки блога не получают подробных сведений о готовности к сопоставлению, описанных для вики-страниц, веб-частей и страниц публикации.
• ASPXPage и DelveBlogPage: исключите их из этой очереди автоматического преобразования; оценка страницы не предоставляет эквивалентный путь готовности для них.

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

Power BI и CSV

Шаблон Power BI — это слой визуализации поверх выходных данных CSV. CSV-файлы остаются источником для:

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

Для создания шаблона Power BI требуется Windows. Создание CSV-файлов работает в Windows, macOS и Linux.

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

• Справочник по CSV для оценки классических страниц
• Справочник по CSV-файлам для общей оценки