Avaliar páginas clássicas do SharePoint

Utilize o componente Páginas clássicas da ferramenta de Avaliação do Microsoft 365 para descobrir páginas clássicas de wiki, peça Web, publicação, blogue, ASPX e Blogue do Delve no SharePoint Online.

As páginas Wiki, Peças Web e Publicação recebem um melhoramento detalhado do inventário de Peças Web, esquema, home page e preparação para mapeamento. As páginas de Blogue, ASPX e Blogue do Delve são detetadas e gravadas, mas não recebem a mesma análise de preparação de mapeamento de Peças Web.

Opcionalmente, a avaliação pode recolher atividades de visualização/criação/edição de páginas a partir do registo de auditoria do Microsoft Graph.

Na implementação atual, as páginas do Blogue do Delve aparecem no classicpages.csv , mas não são incluídas no ClassicPages ou as contagens de tipo de página em classicwebsummaries.csv e classicsitesummaries.csv.

Suporte de tipo de página

Tipo de página Descoberto Preparação detalhada Rota de transformação Ação recomendada
WikiPage Sim Sim Fluxo de trabalho de lote de página representativa para páginas elegíveis na biblioteca predefinida SitePages Selecione padrões representativos, crie rascunhos e valide antes da expansão.
WebPartPage Sim Sim Fluxo de trabalho de lote de página representativa para páginas elegíveis na biblioteca predefinida SitePages Selecione padrões representativos, crie rascunhos e valide antes da expansão.
PublishingPage Sim Sim Transformação avançada de PnP entre sites Crie um atraso de publicação e defina um destino, mapeamento de esquema, metadados e procedimento de validação separados.
BlogPage Sim Não Transformação avançada do Blogue PnP para uma Web moderna de destino Não utilize a percentagem de mapeamento para seleção; reveja a página e utilize um procedimento validado separadamente.
ASPXPage Sim Não Nenhuma rota de transformação condicionada por avaliação equivalente Substitua ou recrie a página através de um plano específico do cenário.
DelveBlogPage Sim Não Existe uma opção de cmdlet PnP legada, mas não faz parte deste fluxo de trabalho Mantenha-o fora das ondas automatizadas e reveja o cenário legado separadamente.

Nesta documentação de orientação

Fluxo de trabalho

  1. Reveja os requisitos.
  2. Execute a avaliação.
  3. Interpretar e atribuir prioridades aos resultados.
  4. Reveja a preparação da página de publicação, quando aplicável.
  5. Transformar páginas selecionadas com o PnP PowerShell.
  6. Valide as páginas transformadas.

Referências

Executar a avaliação

Antes de executar o exemplo de autenticação de aplicação, configure o certificado de aplicação.

microsoft365-assessment.exe start --mode Classic --classicinclude Pages `
  --authmode application `
  --tenant <tenant>.sharepoint.com `
  --applicationid <application-id> `
  --certpath "My|CurrentUser|<certificate-thumbprint>"

Opções específicas da página:

Opção Objetivo
--exportwebpartproperties Exporta as propriedades da Peça Web como JSON.
--skipusageinformation Ignora a recolha de utilização do registo de auditoria.
--auditlogwindowdays Define a janela de auditoria de 1 a 180 dias. A predefinição é 14.
--skipuserinformation Omite informações do utilizador, como Modificado Por.
--homepageonly Avalia apenas a home page de cada Web.

Para autenticação, acesso ao SharePoint, permissões de auditoria, suporte da plataforma e orientações de saída confidencial, veja Requisitos para a avaliação de páginas clássicas.

Saída

Arquivo Conteúdo
classicpages.csv Uma linha por página clássica, incluindo tipo de página, esquema, sinalizadores de home page, percentagem de mapeamento e Peças Web não mapeadas.
classicpagewebparts.csv Uma linha por Peça Web encontrada numa página clássica.
classicwebpartunique.csv Uma linha por tipo de Peça Web exclusivo na avaliação.
classicpageauditusage.csv Vista de página/criar/editar atividade quando a coleção de auditoria é executada.
classicwebsummaries.csv Per-Web contagens de páginas e rollups de preparação.
classicsitesummaries.csv Contagens de páginas por coleção de sites e rollups de preparação.
classicpublishingsitesummaries.csv Resumo ao nível do site do Portal de Publicação.

O modelo do Power BI inclui um separador de relatório Páginas e separadores de resumo/descrição geral da análise partilhados.

Para esquemas e chaves de associação, veja Referência CSV de páginas clássicas.

Compreender os resultados do mapeamento

Para páginas Wiki, Peças Web e Publicação, MappingPercentage mede se cada Peça Web tem um mapeamento utilizável no modelo de mapeamento incorporado. Não garante que a página transformada preserve todo o comportamento visual ou empresarial.

Para páginas de Blogue, ASPX e Blogue do Delve, não interprete os valores de preparação de Peças Web predefinidos ou vazios como uma análise de mapeamento concluída.

Para uma página melhorada e WebPartCount=0MappingPercentage=100 significa que não foram extraídas peças Web. WebPartCount=0 e MappingPercentage=0 pode indicar que o melhoramento da página falhou; reveja o registo de avaliação dessa página.

InMappingFile in classicwebpartunique.csv indica apenas que um tipo de Peça Web está presente no ficheiro de mapeamento. Utilize IsMappable no classicpagewebparts.csv e a percentagem de mapeamento por página para determinar se foi encontrado um mapeamento utilizável.

Para obter um fluxo de trabalho de interpretação completo, veja Interpretar o relatório de avaliação de páginas clássicas.

Continuar para a transformação de páginas

Utilize o resultado da avaliação para selecionar páginas e identificar Peças Web que precisam de remediação. Uma percentagem de mapeamento elevada ajuda a priorizar o trabalho, mas não transforma a página.

  1. Reveja classicpages.csv e classicpagewebparts.csv.
  2. Remover, substituir ou mapear Peças Web a bloquear.
  3. Comece com uma pequena onda representativa.
  4. Transforme as páginas selecionadas com o PowerShell PnP.
  5. Valide as páginas modernas geradas antes de expandir a onda.

Para obter o modelo de transformação completo e as opções de mapeamento avançadas, veja Transformar páginas clássicas em páginas modernas.

Documentação open source adicional