Validar páginas clássicas transformadas

Valide cada página em uma onda de transformação representativa antes de processar mais páginas. Um comando bem-sucedido ou uma resposta HTTP 200 não prova que a página gerada preservou o conteúdo esperado.

Captura o resultado esperado

Antes da transformação, registre:

• URLs de origem e de destino esperadas.
• Tipo e layout da página.
• Texto e títulos visíveis.
• Web Parts e suas configurações importantes.
• Links, imagens, arquivos, listas e conteúdo incorporado.
• Metadados, permissões, estado de publicação e se a página é uma página inicial.

Manter a linha de Avaliação e classicpagewebparts.csv as linhas com essa linha de base.

Para o caminho delegado AllSites.Manage da primeira onda, selecione as páginas que herdam permissões de sua biblioteca e mantenha as páginas geradas como rascunhos. Se as permissões de origem exclusiva devem ser preservadas, use o caminho revisado AllSites.FullControl em vez de ignorar a cópia de permissão.

Revisar o resultado da transformação

Para cada página:

1. Examine o log de transformação PnP em busca de erros, Web Parts ignoradas, mapeamentos de fallback e mensagens de cópia de permissão.
2. Confirme se a página de origem clássica ainda existe e mantém o nome esperado.
3. Confirme se a página moderna esperada existe e é aberta.
4. Compare texto visível, Web Parts, seções, colunas e ordenação.
5. Teste links, imagens, documentos, exibições de lista e outras dependências.
6. Compare metadados necessários, valores de autor e modificados, permissões, comentários e estado de publicação.
7. Registre o resultado e as evidências antes de processar a próxima página.

Detectar saída incompleta

Tratar a página como com falha quando:

• A página de destino está em branco ou contém apenas um título.
• O texto esperado ou uma Web Part necessária está ausente.
• Uma Web Part está presente, mas aponta para a lista, arquivo, site, usuário ou termo errado.
• O layout ou o cabeçalho da página impede que a página atenda à sua finalidade comercial.
• Os metadados ou permissões necessários não foram retidos.
• O log de transformação contém um erro não resolvido.

Inspecione manualmente as páginas em que Avaliação relatada WebPartCount=0, mesmo quando MappingPercentage=100. Além disso, valide as páginas relatadas como totalmente mapeadas porque os dados de tempo de execução ou as funções de mapeamento ainda podem causar uma falha de transformação.

Registre o resultado da onda

Use um registro por página tentada:

Decida se deseja expandir

Expanda a onda somente quando:

• Todas as páginas de origem representativas permanecem disponíveis.
• Cada página de destino aprovada passa na validação de conteúdo e comportamento.
• As metas preliminares são publicadas somente após a aprovação.
• Os bloqueadores comuns têm uma correção ou mapeamento documentado.
• As páginas com falha ou parciais são excluídas da próxima onda.
• A próxima onda tem um proprietário, um plano de reversão e logs retidos.

Se uma página falhar, pare o processamento de páginas comparáveis. Examine o log e as Web Parts de origem, atualize o mapeamento ou a regra candidata quando apropriado e tente novamente uma única página representativa antes de retomar.

Depois que uma página de rascunho for aprovada, publique-a por meio da experiência de edição de página ou com a opção Set-PnPPage-Publish atual.

Expandir a onda

Depois de validar cada página representativa:

1. Defina cada resultado representativo como ValidationStatus=Passed.
2. Preencha ValidationNotes, ValidatedBye o carimbo de data/hora ISO-8601 ValidatedAt .
3. Crie approved-pages.csv a partir das linhas agrupadas adicionais que o usuário aprovou.
4. Executado Convert-SelectedPages.ps1 -PreflightOnly com o manifesto representativo original e os resultados validados.
5. Execute a expansão ao vivo somente depois que todas as linhas de comprovação passarem.
6. Valide todas as páginas geradas no ciclo expandido antes de publicá-las.

O script bloqueia a expansão se um resultado representativo estiver ausente, obsoleto, não aprovado ou com base em um PowerShell PnP diferente ou perfil de script.

Próximas etapas

1. Devolver páginas com falha para a lista de pendências de correção.
2. Adicione padrões de approved-pages.csv página aprovados e execute o script de expansão.

Referências

• Transformar páginas selecionadas com o PowerShell PnP
• Referência de script de onda de página
• Referência de CSV de avaliação de páginas clássicas
• Mapeamentos clássicos de Web Part