Diagnóstico de widget

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. 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 por causa de um erro no código do widget. Para diagnosticar a página, tente diagnosticar os widgets na página.

    Diagnosticar widgets envolve:
    • Identificar níveis de personalização do widget
    • Verificando o código usado em cada widget

    Identificar 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 do widget.
    Nível de personalização Descrição
    Sistema de base Widget do sistema básico 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 básico que você configurou em qualquer uma das seguintes maneiras:
    • Houve modificação direta no código do widget
    • Esquema de opção de widget modificado
    • Dependências de widget, ng-templates ou provedores em angular modificados

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

    Identificar níveis de personalização
    • Verde – widget do sistema básico
    • 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 diagnosticar widgets

    Dos quatro níveis de personalização, o problema de prioridade mais alta são os widgets personalizados. Esses widgets não são compatíveis com atualizações do sistema. Se você estiver enfrentando problemas de página durante uma atualização, talvez você tenha 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 atualizações 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 uma atualização 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 básico tem menos probabilidade de causar problemas de página. Se você já verificou outros widgets e ainda está enfrentando problemas de página, remova os widgets do sistema de base da página e adicione-os novamente sem nenhuma opção de widget definida. Você também pode tentar adicionar widgets do sistema básico a outra página.

    Limitações

    Existem várias limitações conhecidas usando 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 que esteja aninhada mais profundamente do que o primeiro nível não será 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 de excluí-la.