Transformación de páginas clásicas de SharePoint en páginas modernas

Este flujo de trabajo principal transforma las páginas wiki y elementos web clásicas en la biblioteca predeterminada SitePages de SharePoint Online. Use la herramienta de evaluación de Microsoft 365 para identificar páginas y sus elementos web y, a continuación, use PowerShell PnP para transformar páginas aprobadas y validar cada resultado antes de procesar una ola mayor.

Las páginas de publicación, las páginas de blog, las páginas fuera SitePagesde , las páginas principales y los orígenes de SharePoint Server requieren procedimientos avanzados independientes y no son aceptados por los scripts de onda de página.

Este flujo de trabajo usa PowerShell PnP como ruta de acceso de ejecución principal. El motor de transformación de página forma parte de PnP Framework de código abierto y no tiene un Acuerdo de Nivel de Servicio de soporte técnico de Microsoft.

Flujo de trabajo de transformación de página

  1. Seleccione una oleada de página representativa de la cobertura de evaluación completada.
  2. Resuelva los elementos web de bloqueo y elija un destino local o entre sitios.
  3. Prepare una aplicación de PowerShell PnP propiedad del inquilino y los permisos necesarios.
  4. Transforme la onda representativa con valores predeterminados y registros que conservan el origen.
  5. Valide todas las páginas generadas antes de expandir la ola.

1. Seleccionar candidatos de página

Comience con una evaluación de páginas clásicas completada. Confirme la cobertura del examen antes de seleccionar páginas.

Para la primera ola:

  • Seleccione WikiPage o WebPartPage las filas de los exámenes web y del sitio correctos.
  • Prefiere páginas sin elementos web sin asignar y un alto porcentaje de asignación.
  • Revise classicpagewebparts.csv los tipos y asignaciones exactos de elementos web.
  • Inspeccione manualmente cualquier página con WebPartCount=0. Un porcentaje de asignación de 100 para una página de cero solo significa que Assessment no extrajo elementos web.
  • Evite una página principal hasta que se pruebe el proceso de transformación y validación.
  • Registre texto visible, elementos web, vínculos, imágenes y diseño que deben estar presentes después de la transformación.

MappingPercentage=100 es una señal de planeamiento. No garantiza que la transformación se ejecute correctamente ni conserve el contenido esperado.

Creación de una ola representativa

Trate las páginas como el mismo patrón de transformación solo cuando estas dimensiones coincidan:

Dimension Por qué define un patrón independiente
PageType Separa el comportamiento de transformación wiki y elemento web.
Layout Controla las secciones y columnas generadas.
Firma de elemento web ordenada Las páginas con diferentes tipos de elementos web, orden, estado oculto o estado cerrado pueden transformarse de forma diferente.
Resultado de asignación Los elementos web no asignados o asignados de forma diferente requieren una corrección y validación independientes.
Enfoque de destino Las transformaciones en contexto y entre sitios tienen un comportamiento de dependencia y dirección URL diferente.
Control especial Las páginas principales, los diseños de publicación personalizados y las páginas de cero partes requieren una revisión independiente.

Use classicpagewebparts.csv para compilar la firma de elemento web ordenada para cada página. No agrupe solo por MappingPercentage o UnmappedWebParts; las páginas totalmente asignadas todavía pueden contener diferentes tipos de elementos web y comportamiento en tiempo de ejecución.

Para la primera ola:

  1. Excluir la cobertura con errores, los tipos de página no admitidos, las páginas principales, las páginas de parte cero y las asignaciones sin resolver.
  2. Agrupe las páginas restantes por tipo de página, diseño y firma ordenada del elemento web.
  3. Seleccione al menos una página de cada patrón que planee migrar.
  4. Agregue otro representante cuando las páginas del mismo patrón usen propiedades o dependencias de contenido materialmente diferentes.
  5. Prefiere una página con una línea de base de contenido clara y un propietario empresarial que pueda validar el resultado.

Use las fechas de actividad y modificación para priorizar el patrón que se va a procesar primero, no como reemplazo para la cobertura de patrones.

Consulte Compilación de grupos de páginas representativos con PowerShell.

Para la asignación de campo a comando y un ejemplo de página seleccionada, consulte Interpretación del informe de evaluación de páginas clásicas.

2. Resolución de bloqueadores y elección del destino

Agrupar páginas candidatas por tipo de página, diseño y combinación de elementos web no asignados. Resuelva los bloqueadores comunes antes de transformar una ola.

  • Para las páginas wiki y de elementos web, la transformación local es el punto de partida preferido, ya que las dependencias permanecen en el sitio de origen.
  • Las transformaciones wiki y elementos web entre sitios requieren validación adicional para vínculos, archivos, listas, usuarios y taxonomía.

Consulte Elegir transformación local o entre sitios y Revisar asignaciones clásicas de elementos web.

3. Preparar PowerShell PnP

PnP PowerShell requiere una aplicación de Microsoft Entra propiedad del inquilino. Use una aplicación de transformación independiente de la aplicación de evaluación de solo lectura.

Para el flujo interactivo principal, use SharePoint AllSites.Managedelegado, junto con los permisos de sitio existentes del usuario que ha iniciado sesión. La copia de permisos únicos de nivel de elemento requiere AllSites.FullControl; de lo contrario, omita explícitamente esa copia.

Siga Transform selected pages with PnP PowerShell (Transformar páginas seleccionadas con PowerShell de PnP ) para registrar la aplicación, conectarse y ejecutar la primera transformación.

4. Transformar una ola representativa

Transforme una onda pequeña que represente los tipos de página, los diseños y las combinaciones de elementos web que pretende procesar.

Para la primera ola:

  • Deje que la página generada use el prefijo predeterminado Migrated_ .
  • No use -TakeSourcePageName, -Overwriteni opciones de reemplazo de página principal.
  • Habilite el registro de archivos y conserve el registro con el manifiesto de onda.
  • Detenga el primer error inesperado o la falta de coincidencia de contenido.

Habilite solo el cambio de nombre de origen o el comportamiento de sobrescritura una vez aprobadas las páginas generadas y exista un plan de reversión.

Use los scripts incrustados de la referencia de script de onda de página para procesar todas las páginas representativas aprobadas a través del mismo contrato de seguridad y resultados.

5. Validar y expandir

Abrir sin un error no es suficiente validación. Una página generada puede existir y seguir estando en blanco o incompleta.

Valide la página de origen y generada, el registro de transformación, el contenido, los elementos web, el diseño, los vínculos, las imágenes, los metadatos, los permisos y el estado de publicación. Expanda la onda solo cuando cada página seleccionada cumpla los criterios de aceptación.

Consulte Validación de páginas clásicas transformadas.

Una vez marcado Passedcada resultado representativo, use Convert-SelectedPages.ps1 para procesar todas las filas adicionales aprobadas por el usuario. El script rechaza las páginas cuyo patrón de transformación no tiene un representante pasado.

Pasos siguientes

  1. Transforme las páginas seleccionadas con PowerShell PnP.
  2. Valide las páginas transformadas.

Referencia avanzada

  • Last updated on