Interpretar o relatório de avaliação de páginas clássicas

Uma avaliação clássica exporta arquivos CSV compartilhados e específicos da página. No Windows, o comando padrão report também cria ClassicAssessmentReport.pbit.

Essas diretrizes abrangem as páginas e as exibições de cobertura de verificação. O modelo Clássico compartilhado contém outras guias de componentes e compatibilidade, mas elas estão fora deste escopo de avaliação de página.

Validar a cobertura de verificação primeiro

Antes de interpretar a preparação da página, confirme se o escopo esperado foi concluído:

1. Use Verificar visão geralscans.csv e history.csv para revisar o estado e as mensagens da avaliação.
2. Use sitecollections.csv e webs.csv para identificar locais com falha, inacabados ou inesperadamente lentos.
3. Confirme se a avaliação usou um escopo completo de locatário, --siteslistou --sitesfile.
4. Examine o classicpageauditusage.csv status da cobertura antes de usar as contagens de atividade.

Uma avaliação concluída ainda pode conter falhas de site ou da Web. Trate os locais ausentes como uma lacuna de cobertura, não como uma constatação de que não existe conteúdo clássico.

Para os esquemas de arquivo comuns e chaves de junção, consulte Referência de CSV de avaliação comum.

Priorizar páginas

A guia Páginas atual do Power BI usa os campos básicos de inventário de página, como tipo de página, URL, data de modificação e código de correção.

Use classicpages.csv para os campos de preparação avançada e para segmentar páginas por:

• Tipo de página.
• Status da página inicial.
• Data da última modificação e modificador.
• Contagem de Web parts.
• Percentual de mapeamento.
• Tipos de web part não mapeados.

Combine esse inventário para classicpageauditusage.csv diferenciar páginas usadas com frequência de conteúdo obsoleto ou de pouco uso.

O modelo inserido atual do Power BI não inclui os campos de página inicial enriquecida, web part, mapeamento, auditoria ou acúmulo de preparação de página. Analise esses campos diretamente nos arquivos CSV ou estenda o modelo do Power BI antes de usá-los em visuais.

O uso da auditoria é um sinal de planejamento, não um contador bruto de análise da web. Sempre marque QueryStatus:

Quando a consulta de auditoria de um site foi bem-sucedida, a ausência de uma linha de página significa que nenhum evento correspondente foi retornado para aquela página na janela solicitada. Trate uma linha ausente como atividade zero somente depois de confirmar a cobertura bem-sucedida para o site.

Se SkipReason começar com QueryTimeout, o Microsoft Purview não concluiu a consulta durante a espera de 90 minutos da Avaliação. Quando nenhuma parte de auditoria é bem-sucedida, a linha tem QueryStatus=failed; trate suas contagens zero como cobertura com falha, não como evidência de nenhuma atividade. Isso é diferente de NoPermission, o que indica uma permissão de auditoria ausente.

Entender a cobertura de tipo de página

As páginas Wiki, Web Part e Publicação recebem análise detalhada de mapeamento e extração de Web Part.

Blog, ASPX e Delve As páginas de blog são descobertas e gravadas, mas não recebem o mesmo enriquecimento de preparação para mapeamento. Não interprete um valor de mapeamento padrão ou vazio para esses tipos de página como uma análise de preparação concluída.

As páginas do Blog Delve aparecem, classicpages.csv mas não estão incluídas nos pacotes cumulativos atuais de contagem de páginas da Web e do site.

Interpretar os resultados do mapeamento

MappingPercentage é a porcentagem de Web Parts extraídas que têm um mapeamento utilizável no modelo de mapeamento inserido:

• Uma página sem Web Parts extraídas é 100% por convenção.
• Um resultado de 100% significa que todos os tipos de web part extraídos têm mapeamentos. Ela não garante a paridade visual, de dados, de permissão ou de comportamento de negócios após a transformação.
• Um valor abaixo de 100 com WebPartCount maior que zero identifica um ou mais tipos de web part que exigem correção, substituição ou um mapeamento personalizado.
• Para um Wiki, Web Part ou página WebPartCount=0 de Publicação e MappingPercentage=0 pode indicar que a extração falhou antes da execução do cálculo de mapeamento. Examine o log de avaliação para Failed to assess the web parts of classic page.

Use classicpagewebparts.csv para a decisão por página:

• IsMappable significa que a Web Part tem um mapeamento utilizável não vazio.
• WebPartProperties é preenchido somente quando --exportwebpartproperties foi selecionado.
• Os valores de linha, coluna, zona, ordem, oculto e fechado ajudam a explicar o layout atual da página.

Use classicwebpartunique.csv para identificar tipos de Web Part que afetam muitas páginas. InMappingFile é mais fraco do que IsMappable: significa apenas que o tipo tem uma entrada no arquivo de mapeamento.

A implementação atual da Avaliação trata deliberadamente os mapeamentos da comunidade para ScriptEditorWebPart e SimpleFormWebPart como indisponíveis. Ele também não dá suporte a uma substituição de arquivo de mapeamento no disco.

Esse resultado de Avaliação significa que o modelo de preparação padrão não aprova essas Web Parts. A transformação PnP pode, opcionalmente, rotear o conteúdo do Editor de Scripts e do Formulário Simples para o Editor de Scripts da Comunidade de código aberto depois que essa solução for instalada e -UseCommunityScriptEditor selecionada.

Consulte Mapeamentos clássicos de Web Part.

Decidir a próxima ação

Avalie a tabela de cima para baixo e use a primeira linha correspondente. As decisões baseadas em mapeamento se aplicam somente após a conclusão da cobertura e do roteamento do tipo de página.

Usar pacotes cumulativos

Usar classicwebsummaries.csv e classicsitesummaries.csv identificar:

• Webs e conjuntos de sites com as páginas mais clássicas.
• Páginas com web parts totalmente mapeáveis ou não mapeadas.
• Percentual médio de mapeamento entre páginas que contêm Web Parts.
• Páginas iniciais que exigem uma lista de pendências aprovada separada para URL, navegação e planejamento de reversão.

Os pacotes cumulativos são úteis para sequenciamento, mas retorne à página e aos arquivos CSV da Web Part antes de tomar uma decisão de correção.

Revisar portais de publicação

classicpublishingsitesummaries.csv Fornece um resumo de publicação no nível da coleção de sites. A configuração detalhada de publicação no nível da Web herdada não está incluída.

Consulte Entender a cobertura do portal de publicação antes de planejar a transformação da página de publicação.

Passar da avaliação para a transformação

Transforme o relatório em uma lista de pendências de transformação:

1. Exclua locais de verificação com falha ou incompletos.
2. Priorize páginas ativas e home pages importantes.
3. Agrupar páginas por tipo de página, layout e combinação de Web Part não mapeada.
4. Resolva bloqueadores comuns antes de transformar uma onda grande.
5. Mapeie a identidade da página CSV para a conexão de origem do PowerShell PnP e os parâmetros de cmdlet.
6. Transforme uma amostra representativa e valide o resultado antes de expandir horizontalmente.

Mapear campos CSV para o PowerShell PnP

O aplicativo Avaliação é somente leitura. Use uma conexão separada do PowerShell PnP com permissão para criar ou atualizar páginas na Web de origem ou de destino.

Continuar com a tarefa de transformação

Use o mapeamento de campo para aprovar a linha de Avaliação exata e registrar o conteúdo esperado. Em seguida, siga Transformar páginas clássicas selecionadas com o PnP PowerShell para o aplicativo atual, permissão, identidade de origem, saída de rascunho, registro em log e proteções de validação.

Encaminhar outros tipos de página deliberadamente:

• PublishingPage: use -PublishingPage, uma Web de destino e o modelo de layout de página de publicação.
• BlogPage: use -BlogPage, PageName como a identidade do título do blog e um site de destino. As linhas de blog não recebem o enriquecimento detalhado de preparação de mapeamento descrito para páginas Wiki, Web Part e Publicação.
• ASPXPage e DelveBlogPage: exclua-os dessa fila de transformação automatizada; a avaliação de página não fornece um caminho de preparação equivalente para eles.

Comece com Transformar páginas clássicas selecionadas com o PowerShell PnP e, em seguida, valide cada página transformada. Use o modelo de transformação de página para mapeamentos personalizados de Web Part e o modelo de publicação para publicar layouts de página.

Power BI e CSV

O modelo do Power BI é uma camada de visualização sobre a saída CSV. Os arquivos CSV continuam sendo a fonte para:

• Automação.
• Validação no nível do esquema.
• Junção de registros de página, web part, uso, web e site.
• Retendo um snapshot de evidência revisável.

A geração de modelo do Power BI requer o Windows. A geração CSV funciona no Windows, macOS e Linux.

Referências

• Referência de CSV de avaliação de páginas clássicas
• Referência de CSV de avaliação comum