Validación de páginas clásicas transformadas

Valide todas las páginas de una oleada de transformación representativa antes de procesar más páginas. Un comando correcto o una respuesta HTTP 200 no prueba que la página generada conserva el contenido esperado.

Captura el resultado esperado

Antes de la transformación, registre:

  • Direcciones URL de origen y destino esperadas.
  • Diseño y tipo de página.
  • Texto y encabezados visibles.
  • Elementos web y su configuración importante.
  • Vínculos, imágenes, archivos, listas y contenido incrustado.
  • Metadatos, permisos, estado de publicación y si la página es una página principal.

Conserve la fila y classicpagewebparts.csv las filas de evaluación con esta línea base.

Para la ruta de acceso de primera onda delegada AllSites.Manage , seleccione las páginas que hereden permisos de su biblioteca y mantengan las páginas generadas como borradores. Si se deben conservar permisos de origen únicos, use la ruta de acceso revisada AllSites.FullControl en lugar de omitir la copia de permisos.

Revisión del resultado de la transformación

Para cada página:

  1. Revise el registro de transformación PnP para ver si hay errores, elementos web omitidos, asignaciones de reserva y mensajes de copia de permisos.
  2. Confirme que la página de origen clásica sigue existiendo y conserva su nombre esperado.
  3. Confirme que la página moderna esperada existe y se abre.
  4. Compare el texto visible, los elementos web, las secciones, las columnas y el orden.
  5. Pruebe vínculos, imágenes, documentos, vistas de lista y otras dependencias.
  6. Compare los metadatos necesarios, los valores de autor y modificados, los permisos, los comentarios y el estado de publicación.
  7. Registre el resultado y la evidencia antes de procesar la página siguiente.

Detección de resultados incompletos

Trate la página como un error cuando:

  • La página de destino está en blanco o solo contiene un título.
  • Falta texto esperado o un elemento web necesario.
  • Un elemento web está presente, pero apunta a la lista, el archivo, el sitio, el usuario o el término incorrectos.
  • El diseño o el encabezado de página impide que la página cumpla su propósito empresarial.
  • No se conservaron los metadatos o permisos necesarios.
  • El registro de transformación contiene un error sin resolver.

Inspeccione manualmente las páginas en las que Assessment notificó WebPartCount=0, incluso cuando MappingPercentage=100. Valide también las páginas notificadas como totalmente asignadas, ya que los datos en tiempo de ejecución o las funciones de asignación pueden provocar un error de transformación.

Registro del resultado de la ola

Use un registro por página de intento:

Campo Objetivo
ScanId Vincula la página a las pruebas de evaluación.
SiteUrl, WebUrl, PageUrl Identifica la página de origen.
PlannedTargetPageUrl, TargetPageUrl Identifica el plan revisado y el destino creado.
PageType, Layout Agrupa resultados comparables.
MappingPercentage, UnmappedWebParts Conserva la señal de planificación.
TransformationStatus Skipped, PreflightPassed, Createdo Failed.
LogPath Apunta al registro de transformación PnP exacto de la página.
ValidationStatus Pending, Passedo Failed.
ValidationNotes Registra el contenido que falta, los problemas de asignación y el trabajo de seguimiento.
ValidatedBy, ValidatedAt Registra la propiedad de aprobación.

Decidir si se va a expandir

Expanda la onda solo cuando:

  • Cada página de origen representativa permanece disponible.
  • Cada página de destino aprobada pasa la validación de contenido y comportamiento.
  • Los destinos de borrador solo se publican después de la aprobación.
  • Los bloqueadores comunes tienen una corrección o asignación documentada.
  • Las páginas con errores o parciales se excluyen de la siguiente oleada.
  • La siguiente oleada tiene un propietario, un plan de reversión y registros retenidos.

Si se produce un error en una página, detenga el procesamiento de páginas comparables. Revise el registro y los elementos web de origen, actualice la asignación o la regla candidata cuando corresponda y vuelva a intentar una sola página representativa antes de reanudarla.

Una vez aprobada una página de borrador, publíquela a través de la experiencia de edición de páginas o con la opción Set-PnPPage-Publish actual.

Expandir la ola

Después de validar cada página representativa:

  1. Establezca cada resultado representativo en ValidationStatus=Passed.
  2. Rellene ValidationNotes, ValidatedByy la marca de tiempo ISO-8601 ValidatedAt .
  3. Cree approved-pages.csv a partir de las filas agrupadas adicionales que el usuario aprobó.
  4. Ejecute Convert-SelectedPages.ps1 -PreflightOnly con el manifiesto representativo original y los resultados validados.
  5. Ejecute la expansión en vivo solo después de que pase cada fila preparatoria.
  6. Valide todas las páginas generadas en la oleada expandida antes de publicarla.

El script bloquea la expansión si falta un resultado representativo, está obsoleto, no se pasa o se basa en un perfil de script o PowerShell PnP diferente.

Pasos siguientes

  1. Devolver páginas con errores al trabajo pendiente de corrección.
  2. Agregue patrones de página pasados a approved-pages.csv y ejecute el script de expansión.

Referencia