Transformar páginas clássicas do SharePoint em páginas modernas

Este fluxo de trabalho principal transforma páginas Wiki e Web Part clássicas na biblioteca padrão SitePages no SharePoint Online. Use a ferramenta de Avaliação do Microsoft 365 para identificar páginas e suas Web Parts e, em seguida, use o PowerShell PnP para transformar páginas aprovadas e validar cada resultado antes de processar uma onda maior.

A publicação de páginas, páginas de blog, páginas externas SitePages, home pages e fontes do Servidor do SharePoint exigem procedimentos avançados separados e não são aceitas pelos scripts de onda de página.

Este fluxo de trabalho usa o PowerShell PnP como o caminho de execução primário. O mecanismo de transformação de página faz parte da estrutura PnP de software livre e não tem um SLA de suporte da Microsoft.

Fluxo de trabalho de transformação de página

  1. Selecione uma onda de páginas representativa da cobertura de Avaliação concluída.
  2. Resolva o bloqueio de Web Parts e escolha um destino in-loco ou entre sites.
  3. Prepare um aplicativo PnP PowerShell de propriedade do locatário e as permissões necessárias.
  4. Transforme a onda representativa com padrões e registro em log que preservam a origem.
  5. Valide todas as páginas geradas antes de expandir a onda.

1. Selecionar candidatos à página

Comece com uma avaliação de páginas clássicas concluída. Confirme a cobertura de verificação antes de selecionar páginas.

Para a primeira onda:

  • Selecione WikiPage ou linhas WebPartPage de varreduras bem-sucedidas do site e da Web.
  • Prefira páginas sem Web Parts não mapeadas e com uma porcentagem de mapeamento alta.
  • Examine classicpagewebparts.csv os tipos e mapeamentos exatos de Web Part.
  • Inspecione manualmente qualquer página com WebPartCount=0. Uma porcentagem de mapeamento de 100 para uma página de parte zero significa apenas que a Avaliação não extraiu nenhuma Web Parts.
  • Evite uma página inicial até que o processo de transformação e validação seja comprovado.
  • Registre texto visível, Web Parts, links, imagens e layout que devem estar presentes após a transformação.

MappingPercentage=100 é um sinal de planejamento. Isso não garante que a transformação será executada com êxito ou preservará o conteúdo esperado.

Criar uma onda representativa

Trate as páginas como o mesmo padrão de transformação somente quando essas dimensões corresponderem:

Dimensão Por que ele define um padrão separado
PageType Separa o comportamento de transformação do Wiki e da Web Part.
Layout Controla as seções e colunas geradas.
Assinatura da Web Part Solicitada Páginas com diferentes tipos de Web Part, ordem, estado oculto ou estado fechado podem ser transformadas de maneira diferente.
Resultado do mapeamento Web Parts não mapeadas ou mapeadas de forma diferente exigem correção e validação separadas.
Abordagem de destino As transformações in-loco e entre sites têm dependências e comportamentos de URL diferentes.
Manuseio especial Páginas iniciais, layouts de publicação personalizados e páginas de partes zero exigem revisão separada.

Use classicpagewebparts.csv para criar a assinatura da Web Part ordenada para cada página. Não agrupar apenas por MappingPercentage ou UnmappedWebParts; páginas totalmente mapeadas ainda podem conter diferentes tipos de Web Part e comportamento de tempo de execução.

Para a primeira onda:

  1. Exclua cobertura com falha, tipos de página sem suporte, home pages, páginas de partes zero e mapeamentos não resolvidos.
  2. Agrupe as páginas restantes por tipo de página, layout e assinatura da Web Part ordenada.
  3. Selecione pelo menos uma página de cada padrão que você planeja migrar.
  4. Adicione outro representante quando páginas no mesmo padrão usarem propriedades de Web Part ou dependências de conteúdo materialmente diferentes.
  5. Prefira uma página com uma linha de base de conteúdo clara e um proprietário de negócios que possa validar o resultado.

Use as datas de atividade e modificação para priorizar qual padrão processar primeiro, não como um substituto para a cobertura do padrão.

Confira Criar grupos de páginas representativas com o PowerShell.

Para mapeamento de campo para comando e um exemplo de página selecionada, consulte Interpretar o relatório de avaliação de páginas clássicas.

2. Resolva bloqueadores e escolha o alvo

Agrupar páginas candidatas por tipo de página, layout e combinação de Web Part não mapeada. Resolva bloqueadores comuns antes de transformar uma onda.

  • Para páginas Wiki e Web Part, a transformação in-loco é o ponto de partida preferencial, pois as dependências permanecem no site de origem.
  • As transformações entre sites Wiki e Web Part exigem validação adicional para links, arquivos, listas, usuários e taxonomia.

Consulte Escolher a transformação in-loco ou entre sites e Revisar mapeamentos clássicos de Web Part.

3. Preparar o PowerShell PnP

O PowerShell PnP requer um aplicativo Microsoft Entra de propriedade do locatário. Use um aplicativo de transformação separado do aplicativo de Avaliação somente leitura.

Para o fluxo interativo primário, use o SharePoint AllSites.Managedelegado, juntamente com as permissões de site existentes do usuário conectado. A cópia de permissões exclusivas no nível do item requer AllSites.FullControl; caso contrário, ignore explicitamente essa cópia.

Siga Transformar páginas selecionadas com o PnP PowerShell para registrar o aplicativo, conectar e executar a primeira transformação.

4. Transforme uma onda representativa

Transforme uma pequena onda que representa os tipos de página, layouts e combinações de Web Part que você pretende processar.

Para a primeira onda:

  • Deixe a página gerada usar o prefixo padrão Migrated_ .
  • Não use -TakeSourcePageName-Overwriteas opções de substituição de página inicial ou ,
  • Habilite o registro de arquivos e retenha o log com o manifesto de onda.
  • Pare na primeira falha inesperada ou incompatibilidade de conteúdo.

Só habilite o comportamento de renomeação ou substituição de origem depois que as páginas geradas tiverem sido aprovadas e existir um plano de reversão.

Use os scripts incorporados da referência de script de onda de página para processar todas as páginas representativas aprovadas por meio do mesmo contrato de segurança e resultado.

5. Validar e expandir

Abrir sem erros não é validação suficiente. Uma página gerada pode existir e ainda estar em branco ou incompleta.

Valide a página de origem e gerada, o log de transformação, o conteúdo, as Web Parts, o layout, os links, as imagens, os metadados, as permissões e o estado da publicação. Expanda o ciclo somente quando todas as páginas selecionadas atenderem aos critérios de aceitação.

Consulte Validar páginas clássicas transformadas.

Depois que cada resultado representativo for marcado Passed, use Convert-SelectedPages.ps1 para processar todas as linhas adicionais aprovadas pelo usuário. O script rejeita páginas cujo padrão de transformação não tem um representante aprovado.

Próximas etapas

  1. Transformar páginas selecionadas com o PowerShell PnP.
  2. Valide as páginas transformadas.

Referência avançada

  • Last updated on