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

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

Esta documentação de orientação abrange as páginas e as vistas de cobertura de análise. O modelo Clássico partilhado contém outros separadores de componentes e compatibilidade, mas estão fora deste âmbito de avaliação de páginas.

Validar a cobertura da análise primeiro

Antes de interpretar a preparação de páginas, confirme se o âmbito esperado foi concluído:

1. Utilize a Descrição geral da análise, scans.csve history.csv para rever o estado e as mensagens da avaliação.
2. Utilize sitecollections.csv e webs.csv para identificar localizações falhadas, inacabadas ou invulgarmente lentas.
3. Confirme se a avaliação utilizou um âmbito de inquilino completo, --siteslistou --sitesfile.
4. Reveja classicpageauditusage.csv a cobertura status antes de utilizar contagens de atividade.

Uma avaliação concluída ainda pode conter falhas no site ou na Web. Trate as localizações em falta como uma lacuna de cobertura, não como uma constatação de que não existe conteúdo clássico.

Para obter os esquemas de ficheiro comuns e as chaves de associação, veja Referência CSV de avaliação comum.

Priorizar páginas

O separador Páginas atuais do Power BI utiliza os campos de inventário de páginas básicos, como o tipo de página, o URL, a data de modificação e o código de remediação.

Utilize classicpages.csv para os campos de preparação melhorados e segmentar páginas por:

• Tipo de página.
• Home page status.
• Última data de modificação e modificador.
• Contagem de peças Web.
• Percentagem de mapeamento.
• Tipos de peças Web não mapeadas.

Combine este inventário com classicpageauditusage.csv para distinguir as páginas utilizadas frequentemente do conteúdo obsoleto ou de baixa utilização.

O atual modelo incorporado do Power BI não inclui os campos de rollup de home page, peça Web, mapeamento, auditoria ou preparação de páginas melhorados. Analise esses campos diretamente nos ficheiros CSV ou expanda o modelo do Power BI antes de os utilizar em elementos visuais.

A utilização da auditoria é um sinal de planeamento, não um contador de análise Web não processado. Sempre marcarQueryStatus:

Status	Significado
succeeded	A janela de auditoria pedida foi concluída.
partial	Uma ou mais subconsultas de auditoria falharam. As contagens são um limite inferior.
failed	Falha na recolha da auditoria. As contagens não são utilizáveis.
skipped	A recolha de auditorias não foi executada para o site, como numa cloud não suportada.
error	Ocorreu uma exceção pós-análise inesperada. Reveja SkipReason e o registo de avaliação.

Importante

As avaliações de cloud soberana não fornecem a página Utilização da auditoria. Não interprete as linhas de utilização em falta ou ignoradas como atividade zero. Priorize com ModifiedAt, importância conhecida da página e entrada do proprietário da empresa.

Quando a consulta de auditoria de um site foi bem-sucedida, a ausência de uma linha de página significa que não foram devolvidos eventos correspondentes para essa página na janela pedida. Tratar uma linha ausente como atividade zero apenas depois de confirmar a cobertura com êxito do site.

Se SkipReason começar com QueryTimeouto , o Microsoft Purview não concluiu a consulta durante a espera de 90 minutos da Avaliação. Quando nenhum segmento de auditoria for bem-sucedido, a linha tem QueryStatus=failed; trata as suas contagens zero como cobertura falhada e não como prova de nenhuma atividade. Isto é diferente de NoPermission, o que indica uma permissão de Auditoria em falta.

Compreender a cobertura do tipo de página

As páginas Wiki, Peças Web e Publicação recebem análises detalhadas de mapeamento e extração de peças Web.

As páginas de Blogue, ASPX e Blogue do Delve são detetadas e gravadas, mas não recebem o mesmo melhoramento de preparação para mapeamento. Não interprete um valor de mapeamento predefinido ou vazio para estes tipos de página como uma análise de preparação concluída.

As páginas do Blogue do Delve aparecem no classicpages.csv , mas não estão incluídas nos rollups de contagem de páginas atuais na Web e no site.

Interpretar resultados de mapeamento

MappingPercentage é a percentagem de peças Web extraídas que têm um mapeamento utilizável no modelo de mapeamento incorporado:

• Uma página sem peças Web extraídas é 100% por convenção.
• Um resultado de 100 por cento significa que todos os tipos de peças Web extraídas têm mapeamentos. Não garante paridade visual, de dados, de permissão ou de comportamento empresarial após a transformação.
• Um valor inferior a 100 com WebPartCount mais de zero identifica um ou mais tipos de peças Web que requerem remediação, substituição ou um mapeamento personalizado.
• Para uma página Wiki, Peça Web ou Publicação, WebPartCount=0 e MappingPercentage=0 pode indicar que a extração falhou antes de o cálculo de mapeamento ser executado. Reveja o registo de avaliação de Failed to assess the web parts of classic page.

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

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

Utilize classicwebpartunique.csv para identificar tipos de peças Web que afetam muitas páginas. InMappingFile é mais fraco do que IsMappable: significa apenas que o tipo tem uma entrada no ficheiro de mapeamento.

A implementação de Avaliação atual trata deliberadamente os mapeamentos da comunidade para ScriptEditorWebPart e SimpleFormWebPart como indisponíveis. Também não suporta uma substituição de ficheiro de mapeamento no disco.

Este resultado de Avaliação significa que o modelo de preparação predefinido não aprova essas Peças Web. Opcionalmente, a transformação PnP pode encaminhar o Editor de Scripts e o conteúdo de Formulário Simples para o Editor de Scripts da Comunidade open source depois de a solução estar instalada e -UseCommunityScriptEditor selecionada.

Cuidado

Um editor de scripts pode executar código personalizado na página. Trate-o como uma decisão de remediação avançada com revisão de segurança e uma página validada separadamente. Os scripts de lote orientados por avaliação não ativam o Editor de Scripts da Comunidade.

Veja Mapeamentos de Peças Web Clássicas.

Decidir a próxima ação

Avalie a tabela de cima para baixo e utilize a primeira linha correspondente. As decisões baseadas no mapeamento aplicam-se apenas após a cobertura e o encaminhamento de tipo de página estarem concluídos.

Resultado da avaliação	Decision	Ação seguinte
A coleção de sites ou a Web não foi concluída	Cobertura bloqueada	Resolva a falha de análise antes de interpretar as contagens de páginas ou a preparação.
O tipo de página é Blogue, ASPX ou Blogue do Delve	A classificação de mapeamento não é acionável	Siga a documentação de orientação de suporte de tipo de página em vez de utilizar a percentagem de preparação.
O tipo de página é Publicação	Caixa de tarefas pendentes avançada	Reveja o esquema e as entradas ao nível do portal em falta antes de definir um destino e procedimento separados.
A página Wiki ou Peça Web é uma home page	Aprovação separada necessária	Mantenha-o fora da primeira onda e defina o URL, a navegação e o comportamento de reversão antes da transformação.
A página Wiki ou Peça Web tem WebPartCount=0 e MappingPercentage=0 com um erro de melhoramento	A análise da página falhou	Reveja o registo e volte a executar a Avaliação antes de selecionar a página.
A página Wiki ou Peça Web tem WebPartCount=0 e MappingPercentage=100	Revisão manual necessária	Abra a página de origem e confirme se a Avaliação falhou conteúdo visível. Não o coloque numa onda automatizada.
A página Wiki ou Peça Web tem WebPartCount>0, MappingPercentage=100e não tem Peças Web não mapeadas	Candidato a piloto representativo	Agrupe-a por esquema e assinatura de Peça Web ordenada, transforme um rascunho e valide o resultado.
A página Wiki ou Peça Web tem MappingPercentage<100 uma ou mais UnmappedWebParts	Remediação necessária	Substitua as Peças Web de bloqueio ou defina e valide separadamente um mapeamento personalizado antes da transformação.

Utilizar rollups

Utilize classicwebsummaries.csv e classicsitesummaries.csv para identificar:

• Webs e coleções de sites com as páginas mais clássicas.
• Páginas com peças Web totalmente mappable ou não mapeadas.
• Percentagem média de mapeamento entre páginas que contêm peças Web.
• Home pages que requerem um registo de tarefas pendentes aprovado separado para o URL, navegação e planeamento de reversão.

Os rollups são úteis para sequenciação, mas regressam à página e aos ficheiros CSV da peça Web antes de tomar uma decisão de remediação.

Rever portais de publicação

classicpublishingsitesummaries.csv fornece um resumo de publicação ao nível da coleção de sites. A configuração de publicação detalhada ao nível da Web legada não está incluída.

Veja Compreender a cobertura do portal de publicação antes de planear a transformação da página de publicação.

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

Transforme o relatório num atraso de transformação:

1. Excluir localizações de análise falhadas ou incompletas.
2. Priorize páginas ativas e home pages importantes.
3. Agrupar páginas por tipo de página, esquema e combinação de Peças Web não mapeadas.
4. Resolva bloqueadores comuns antes de transformar uma onda grande.
5. Mapeie a identidade da página CSV para os parâmetros de cmdlet e ligação de origem do PowerShell do PnP.
6. Transforme um exemplo representativo e valide o resultado antes de aumentar horizontalmente.

Mapear campos CSV para o PowerShell PnP

Campo CSV	Utilização da transformação
SiteUrl + WebUrl	Crie o URL web de origem para Connect-PnPOnline.
PageUrl + ListUrl	Derivar o nome do ficheiro de página, que contém a biblioteca e a pasta opcional.
PageName	Utilize o título da página como -Identity para uma página de Blogue clássica.
PageType	Encaminhar para o caminho de transformação Wiki/Peça Web, Publicação ou Blogue.
Layout	Selecione ou valide o mapeamento de esquema de página para publicar páginas.

A aplicação Avaliação é só de leitura. Utilize uma ligação PnP do PowerShell separada com permissão para criar ou atualizar páginas na Web de origem ou de destino.

Continuar com a tarefa de transformação

Utilize o mapeamento de campos para aprovar a linha de Avaliação exata e registar o conteúdo esperado. Em seguida, siga Transformar páginas clássicas selecionadas com o PnP PowerShell para a aplicação atual, permissão, identidade de origem, saída de rascunho, registo e salvaguardas de validação.

Encaminhar outros tipos de página deliberadamente:

• PublishingPage: utilize -PublishingPage, uma Web de destino e o modelo de esquema de página de publicação.
• BlogPage: utilize -BlogPage, PageName como a identidade do título do blogue e uma Web de destino. As linhas de blogue não recebem o melhoramento detalhado da preparação do mapeamento descrito para as páginas Wiki, Peça Web e Publicação.
• ASPXPage e DelveBlogPage: exclua-os desta fila de transformação automatizada; a avaliação da página não fornece um caminho de preparação equivalente para os mesmos.

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

Power BI e CSV

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

• Automação.
• Validação ao nível do esquema.
• Associar registos de página, peça Web, utilização, Web e site.
• Manter uma prova revejavel snapshot.

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

Referências

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