Diagnóstico de widget

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 4 min. de leitura
  • Resolva os problemas da página Portal de serviços identificando os níveis de personalização do widget e verificando o código do widget diretamente em uma página do portal.

    Se uma página do portal não estiver funcionando conforme o esperado, pode ser devido a um erro no código do widget. Para diagnosticar a página, tente diagnosticar os widgets na página.

    O diagnóstico de widgets envolve:
    • Identificando níveis de personalização de widget
    • Verificando o código usado em cada widget

    Identificando níveis de personalização

    Os níveis de personalização descrevem como os widgets foram modificados ou desenvolvidos. Identificar o nível de personalização de um widget pode ajudar você a saber qual parte do código do widget é mais importante verificar. Existem quatro níveis de personalização de widget.
    Nível de personalização Descrição
    Sistema de base Widget do sistema base sem modificações, incluindo widgets para os quais você definiu opções de instância.
    Clonado O widget que você clonou de um widget de sistema de base
    Novo Widget que você criou.
    Personalizado Widget do sistema base que você configurou de uma das seguintes maneiras:
    • Houve modificação direta no código do widget
    • Esquema de opção de widget modificado
    • Dependências de widget modificadas, ng-templates ou provedores angulares

    Para identificar os níveis de personalização de widgets em uma página do portal, abra o Menu de contexto de widget e selecione Mostrar personalizações de widget. Os widgets são codificados por cores da seguinte forma:

    Identificando níveis de personalização
    • Verde – widget do sistema de base
    • Amarelo - widget clonado
    • Azul – novo widget
    • Vermelho – widget personalizado

    Verificando o código do widget

    Depois de identificar os níveis de personalização dos widgets em uma página do portal, verifique o código em cada widget.

    Para exibir o código do widget na página do portal, clique no ícone de informações ( ícone de informações) em um widget.

    Janela de diagnóstico de widget

    Na janela de diagnóstico do widget, você pode verificar o código do widget de várias maneiras:

    Recomendações para diagnóstico de widgets

    Dos quatro níveis de personalização, o problema de maior prioridade são os widgets personalizados. Esses widgets não são compatíveis com upgrades do sistema. Se você estiver enfrentando problemas de página durante um upgrade, pode ser porque você tem um widget personalizado na página do portal.

    Para resolver problemas de página que podem ser causados por widgets personalizados, identifique quais partes do código do widget foram personalizadas. Em seguida, reverta o código para a configuração original. Para obter mais informações sobre como identificar essas diferenças de código, consulte Comparar um widget personalizado com o sistema de base.

    Dica:
    Mesmo que um widget personalizado não esteja causando problemas de página no momento, convém reverter para o widget original para evitar problemas durante upgrades posteriores.

    Se você ainda estiver enfrentando problemas de página após reverter os widgets personalizados, verifique os widgets novos e clonados em seguida.

    Com um novo widget, é provável que as mudanças de código mais recentes estejam causando problemas na página do portal. Para identificar as mudanças mais recentes para que você possa depurar seu código, siga as etapas em Comparar mudanças com registros relacionados.

    Se você clonou um widget antes de um upgrade do sistema, é provável que o widget clonado não tenha recebido o mesmo código atualizado que o widget do sistema de base. Nesse caso, é recomendável clonar o widget novamente e adicionar suas personalizações ao clone.

    Um widget do sistema de base tem menor probabilidade de causar problemas de página. Se você já verificou outros widgets e ainda está enfrentando problemas com a página, remova os widgets do sistema de base da página e adicione-os novamente sem definir opções de widget. Você também pode tentar adicionar widgets do sistema de base a outra página.

    Limitações

    Existem várias limitações conhecidas ao usar o diagnóstico de widget de uma página do portal:
    • Embora você possa exibir e comparar o código do widget, não é possível corrigir ou reverter o código diretamente. Saia do portal para mudar o código.
    • Se você navegar para outra página do portal enquanto estiver usando o diagnóstico de widget, o sistema desabilitará a ferramenta.
    • Como a ferramenta usa cores para categorizar widgets, ela pode não estar acessível para usuários com deficiência visual.
    • As dependências de widget listadas na página do portal refletem somente as dependências de primeiro nível. Qualquer dependência aninhada mais fundo do que o primeiro nível não está incluída. Para solucionar problemas do widget, verifique as dependências aninhadas no registro do widget.
    • O sistema não tem como rastrear uma Dependência de Widget depois que você a exclui.