Interpretación del informe de evaluación de páginas clásicas

Una evaluación clásica exporta archivos CSV compartidos y específicos de la página. En Windows, el comando predeterminado report también crea ClassicAssessmentReport.pbit.

En esta guía se tratan las vistas Pages y scan-coverage. La plantilla clásica compartida contiene otras pestañas de componentes y compatibilidad, pero están fuera de este ámbito de evaluación de páginas.

Validar primero la cobertura de examen

Antes de interpretar la preparación de la página, confirme que el ámbito esperado se completó:

1. Use Información general del examen, scans.csvy history.csv para revisar el estado de evaluación y los mensajes.
2. Use sitecollections.csv y webs.csv para identificar ubicaciones con errores, sin terminar o inusualmente lentas.
3. Confirme si la evaluación usó un ámbito de inquilino completo, --siteslisto --sitesfile.
4. Revise el classicpageauditusage.csv estado de la cobertura antes de usar recuentos de actividad.

Una evaluación que haya finalizado puede contener errores de sitio o web. Trate las ubicaciones que faltan como una brecha de cobertura, no como una constatación de que no existe contenido clásico.

Para ver los esquemas de archivo comunes y las claves de combinación, consulte Common assessment CSV reference (Referencia csv de evaluación común).

Priorizar páginas

La pestaña Power BI de Pages actual usa los campos básicos de inventario de páginas, como el tipo de página, la dirección URL, la fecha de modificación y el código de corrección.

Use classicpages.csv para los campos de preparación enriquecidos y para segmentar las páginas por:

• Tipo de página.
• Estado de la página principal.
• Fecha y modificador de última modificación.
• Recuento de elementos web.
• Porcentaje de asignación.
• Tipos de elementos web no asignados.

Combine este inventario con classicpageauditusage.csv para distinguir las páginas usadas con frecuencia del contenido obsoleto o de uso bajo.

El modelo de Power BI insertado actual no incluye los campos de acumulación de página principal, elemento web, asignación, auditoría o preparación de páginas enriquecidos. Analice esos campos directamente en los archivos CSV o amplíe el modelo de Power BI antes de usarlos en objetos visuales.

El uso de auditorías es una señal de planeación, no un contador de análisis web sin procesar. QueryStatusCompruebe siempre :

Estado	Significado
succeeded	Se completó la ventana de auditoría solicitada.
partial	Error en una o varias subconsultas de auditoría. Los recuentos son un límite inferior.
failed	Error en la recopilación de auditorías. Los recuentos no se pueden usar.
skipped	La recopilación de auditorías no se ejecutó para el sitio, como en una nube no admitida.
error	Se produjo una excepción inesperada posterior al examen. Revisar SkipReason y el registro de evaluación.

Importante

Las evaluaciones de nube soberana no proporcionan la página Uso de auditoría. No interprete las filas de uso que faltan o se omiten como actividad cero. Priorice con ModifiedAt, la importancia de la página conocida y la entrada del propietario de la empresa.

Cuando la consulta de auditoría de un sitio se realizó correctamente, la ausencia de una fila de página significa que no se devolvieron eventos coincidentes para esa página en la ventana solicitada. Trate una fila ausente como actividad cero solo después de confirmar una cobertura correcta para el sitio.

Si SkipReason comienza por QueryTimeout, Microsoft Purview no completó la consulta durante la espera de 90 minutos de evaluación. Cuando ningún fragmento de auditoría se realiza correctamente, la fila tiene QueryStatus=failed; trate sus cero recuentos como cobertura con errores, no como evidencia de ninguna actividad. Esto es diferente de NoPermission, lo que indica que falta el permiso auditar.

Descripción de la cobertura de tipo de página

Las páginas Wiki, Elemento web y Publicación reciben análisis detallados de extracción y asignación de elementos web.

Las páginas blog, ASPX y Delve Blog se detectan y graban, pero no reciben el mismo enriquecimiento de preparación de asignación. No interprete un valor de asignación predeterminado o vacío para estos tipos de página como un análisis de preparación completado.

Las páginas del blog de Delve aparecen en classicpages.csv , pero no se incluyen en los paquetes acumulativos de recuento de páginas web y de sitio actuales.

Interpretación de los resultados de la asignación

MappingPercentage es el porcentaje de elementos web extraídos que tienen una asignación utilizable en el modelo de asignación incrustado:

• Una página sin elementos web extraídos es 100 por ciento por convención.
• Un resultado del 100% significa que todos los tipos de elementos web extraídos tienen asignaciones. No garantiza paridad visual, de datos, de permiso o de comportamiento empresarial después de la transformación.
• Un valor inferior a 100 con WebPartCount mayor que cero identifica uno o varios tipos de elementos web que requieren corrección, reemplazo o una asignación personalizada.
• Para una página Wiki, Elemento web o Publicación, WebPartCount=0 y MappingPercentage=0 puede indicar que se produjo un error de extracción antes de que se ejecutara el cálculo de asignación. Revise el registro de evaluación de Failed to assess the web parts of classic page.

Use classicpagewebparts.csv para la decisión por página:

• IsMappable significa que el elemento web tiene una asignación que no se puede usar.
• WebPartProperties solo se rellena cuando --exportwebpartproperties se seleccionó.
• Los valores de fila, columna, zona, orden, oculto y cerrado ayudan a explicar el diseño de página actual.

Use classicwebpartunique.csv para identificar los tipos de elementos web que afectan a muchas páginas. InMappingFile es más débil que IsMappable: solo significa que el tipo tiene una entrada en el archivo de asignación.

La implementación de evaluación actual trata deliberadamente las asignaciones de la comunidad para ScriptEditorWebPart y SimpleFormWebPart como no disponibles. Tampoco admite una invalidación del archivo de asignación en disco.

Este resultado de evaluación significa que el modelo de preparación predeterminado no aprueba esos elementos web. La transformación PnP puede enrutar opcionalmente el editor de scripts y el contenido de Formulario simple al Editor de scripts de la comunidad de código abierto después de instalar y -UseCommunityScriptEditor seleccionar esa solución.

Precaución

Un editor de scripts puede ejecutar código personalizado en la página. Trate esto como una decisión de corrección avanzada con una revisión de seguridad y una página validada por separado. Los scripts por lotes controlados por evaluación no habilitan el Editor de scripts de la comunidad.

Consulte Asignaciones de elementos web clásicos.

Decidir la siguiente acción

Evalúe la tabla de arriba abajo y use la primera fila coincidente. Las decisiones basadas en asignaciones solo se aplican una vez completada la cobertura y el enrutamiento de tipo de página.

Resultado de la evaluación	Decision	Siguiente acción
La colección de sitios o la web no finalizaron	Cobertura bloqueada	Resuelva el error de examen antes de interpretar los recuentos de páginas o la preparación.
El tipo de página es Blog, ASPX o Delve Blog	La puntuación de asignación no es accionable	Siga las instrucciones de soporte técnico de tipo de página en lugar de usar el porcentaje de preparación.
El tipo de página es Publicación	Trabajo pendiente avanzado	Revise el diseño y las entradas de nivel de portal que faltan antes de definir un destino y un procedimiento independientes.
La página wiki o del elemento web es una página principal	Aprobación independiente necesaria	Manténgalo fuera de la primera oleada y defina el comportamiento de dirección URL, navegación y reversión antes de la transformación.
La página wiki o del elemento web tiene WebPartCount=0 y MappingPercentage=0 con un error de enriquecimiento	Error en el examen de página	Revise el registro y vuelva a ejecutar Evaluación antes de seleccionar la página.
La página wiki o del elemento web tiene WebPartCount=0 y MappingPercentage=100	Revisión manual necesaria	Abra la página de origen y confirme si evaluación faltó contenido visible. No lo coloques en una ola automatizada.
La página wiki o elemento web tiene WebPartCount>0, MappingPercentage=100y no hay elementos web sin asignar	Candidato representante-piloto	Agrupe por diseño y firma ordenada del elemento web, transforme un borrador y valide el resultado.
La página wiki o del elemento web tiene MappingPercentage<100 o una o más UnmappedWebParts	Corrección necesaria	Reemplace los elementos web de bloqueo o defina y valide por separado una asignación personalizada antes de la transformación.

Uso de paquetes acumulativos de actualizaciones

Use classicwebsummaries.csv y classicsitesummaries.csv para identificar:

• Webs y colecciones de sitios con las páginas más clásicas.
• Páginas con elementos web totalmente mappables o no asignados.
• Porcentaje medio de asignación entre páginas que contienen elementos web.
• Páginas principales que requieren un trabajo pendiente aprobado independiente para la dirección URL, la navegación y el planeamiento de reversión.

Los paquetes acumulativos son útiles para la secuenciación, pero vuelven a los archivos CSV de página y elemento web antes de tomar una decisión de corrección.

Revisión de portales de publicación

classicpublishingsitesummaries.csv proporciona un resumen de publicación de nivel de colección de sitios. No se incluye la configuración de publicación de nivel web heredada detallada.

Consulte Descripción de la cobertura del portal de publicación antes de planear la transformación de página de publicación.

Pasar de la evaluación a la transformación

Convierta el informe en un trabajo pendiente de transformación:

1. Excluir ubicaciones de examen erróneas o incompletas.
2. Priorice las páginas activas y las páginas principales importantes.
3. Agrupar páginas por tipo de página, diseño y combinación de elementos web sin asignar.
4. Resuelva los bloqueadores comunes antes de transformar una ola grande.
5. Asigne la identidad de página CSV a los parámetros de cmdlet y conexión de origen de PowerShell de PnP.
6. Transforme un ejemplo representativo y valide el resultado antes de escalar horizontalmente.

Asignación de campos CSV a PowerShell de PnP

Campo CSV	Uso de transformación
SiteUrl + WebUrl	Compile la dirección URL web de origen para Connect-PnPOnline.
PageUrl + ListUrl	Derive el nombre del archivo de página, que contiene la biblioteca y la carpeta opcional.
PageName	Use el título de la página como -Identity para una página de blog clásica.
PageType	Enrute a la ruta de transformación Wiki/Elemento web, Publicación o Blog.
Layout	Seleccione o valide la asignación de diseño de página para publicar páginas.

La aplicación Evaluación es de solo lectura. Use una conexión de PowerShell PnP independiente con permiso para crear o actualizar páginas en la web de origen o de destino.

Continuar con la tarea de transformación

Use la asignación de campos para aprobar la fila de evaluación exacta y registrar el contenido esperado. A continuación, siga Transform selected classic pages with PnP PowerShell for the current application, permission, source-identity, draft-output, logging, and validation safeguards ( Transformar páginas clásicas seleccionadas con PnP PowerShell para las medidas de seguridad actuales de aplicación, permiso, identidad de origen, borrador-salida, registro y validación).

Enrutar otros tipos de página deliberadamente:

• PublishingPage: use -PublishingPage, una web de destino y el modelo de diseño de página de publicación.
• BlogPage: use -BlogPage, PageName como identidad de título de blog y una web de destino. Las filas de blog no reciben el enriquecimiento detallado de preparación de asignación descrito para las páginas Wiki, Elemento web y Publicación.
• ASPXPage y DelveBlogPage: los excluye de esta cola de transformación automatizada; la evaluación de páginas no proporciona una ruta de preparación equivalente para ellos.

Comience con Transformar páginas clásicas seleccionadas con PowerShell PnP y, a continuación, valide cada página transformada. Use el modelo de transformación de página para asignaciones de elementos web personalizadas y el modelo de publicación para publicar diseños de página.

Power BI y CSV

La plantilla de Power BI es una capa de visualización sobre la salida CSV. Los archivos CSV siguen siendo el origen de:

• Automatización.
• Validación de nivel de esquema.
• Registros de página, elemento web, uso, web y sitio.
• Conservar una instantánea de evidencia revisable.

La generación de plantillas de Power BI requiere Windows. La generación de CSV funciona en Windows, macOS y Linux.

Referencia

• Referencia csv de evaluación de páginas clásicas
• Referencia CSV de evaluación común