Avaliar páginas clássicas do SharePoint

Use o componente Páginas clássicas da ferramenta Avaliação do Microsoft 365 para descobrir páginas wiki clássicas, Web Part, publicação, blog, ASPX e Delve Blog no SharePoint Online.

As páginas Wiki, Web Part e Publicação recebem inventário detalhado de Web Part, layout, página inicial e enriquecimento de prontidão para mapeamento. As páginas de blog, ASPX e Delve são descobertas e registradas, mas não recebem a mesma análise de prontidão de mapeamento de Web Part.

Opcionalmente, a avaliação pode coletar atividades de exibição/criação/edição de página do log de auditoria do Microsoft Graph.

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

Suporte ao tipo de página

Tipo de página Descoberto Prontidão detalhada Rota de transformação Ação recomendada
WikiPage Sim Sim Fluxo de trabalho em lotes de páginas representativas para páginas elegíveis na biblioteca padrão SitePages Selecione padrões representativos, crie rascunhos e valide antes da expansão.
WebPartPage Sim Sim Fluxo de trabalho em lotes de páginas representativas para páginas elegíveis na biblioteca padrão SitePages Selecione padrões representativos, crie rascunhos e valide antes da expansão.
PublishingPage Sim Sim Transformação avançada entre sites PnP Crie uma lista de pendências de publicação e defina um destino separado, mapeamento de layout, metadados e procedimento de validação.
BlogPage Sim Não Blog PnP avançado transformação em um destino da Web Não use porcentagem de mapeamento para seleção; Examine a página e use um procedimento validado separadamente.
ASPXPage Sim Não Nenhuma rota de transformação controlada por avaliação equivalente Substitua ou recrie a página por meio de um plano específico do cenário.
DelveBlogPage Sim Não Existe uma opção de cmdlet PnP herdado, mas não faz parte deste fluxo de trabalho Mantenha-o fora das ondas automatizadas e examine o cenário herdado separadamente.

Neste guia

Fluxo de trabalho

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

Referências

Executar a avaliação

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

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 propriedades da Web Part como JSON.
--skipusageinformation Ignora a coleta de uso do log de auditoria.
--auditlogwindowdays Define a janela de auditoria de 1 a 180 dias. O padrão é 14.
--skipuserinformation Omite informações do usuário, como Modificado por.
--homepageonly Avalia apenas a página inicial de cada Web.

Para autenticação, acesso ao SharePoint, permissões de auditoria, suporte à plataforma e diretrizes de saída confidencial, consulte 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, layout, sinalizadores da página inicial, porcentagem de mapeamento e Web Parts não mapeadas.
classicpagewebparts.csv Uma linha por Web Part encontrada em uma página clássica.
classicwebpartunique.csv Uma linha por tipo de Web Part exclusivo na avaliação.
classicpageauditusage.csv Atividade de exibição/criação/edição de página quando a coleção de auditoria é executada.
classicwebsummaries.csv Per-Web contagens de páginas e pacotes cumulativos de preparação.
classicsitesummaries.csv Contagens de páginas por conjunto de sites e pacotes cumulativos de preparação.
classicpublishingsitesummaries.csv Resumo no nível do site do Portal de Publicação.

O modelo do Power BI inclui uma guia Relatório de páginas e guias compartilhadas de resumo/visão geral da verificação.

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

Entender os resultados do mapeamento

Para páginas Wiki, Web Part e Publicação, MappingPercentage mede se cada Web Part tem um mapeamento utilizável no modelo de mapeamento inserido. Isso não garante que a página transformada preservará todo o comportamento visual ou comercial.

Para páginas de Blog, ASPX e Delve Blog, não interprete os valores de preparação da Web Part padrão ou vazios como uma análise de mapeamento concluída.

Para uma página WebPartCount=0 enriquecida e MappingPercentage=100 significa que nenhuma Web Part foi extraída. WebPartCount=0 e pode indicar que o enriquecimento da página falhou; revise MappingPercentage=0 o log de avaliação dessa página.

InMappingFile em classicwebpartunique.csv apenas indica que um tipo de Web Part está presente no arquivo de mapeamento. Use IsMappable em classicpagewebparts.csv e a porcentagem de mapeamento por página para determinar se um mapeamento utilizável foi encontrado.

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

Continuar para transformação de página

Use o resultado da avaliação para selecionar páginas e identificar Web Parts que precisam de correção. Uma porcentagem alta de mapeamento ajuda a priorizar o trabalho, mas não transforma a página.

  1. Revisão classicpages.csv e classicpagewebparts.csv.
  2. Remover, substituir ou mapear Web Parts de bloqueio.
  3. Comece com uma pequena onda representativa.
  4. Transformar 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 avançadas de mapeamento, consulte Transformar páginas clássicas em páginas modernas.

Documentação adicional de código aberto

  • Last updated on