Diagnóstico de widget

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 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
    Base Widget de base instalado em um sistema de base ou com outros ServiceNow plug-ins. Os widgets de base não têm modificações, mas podem ter instâncias de widget para as quais você definiu opções de instância.
    Clonado Widget que você clonou de um widget de base.
    Novo(a) Widget que você criou.
    Personalizados Widget 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:

    • Verde: widget base
    • Amarelo: widget clonado
    • Azul: novo widget
    • Vermelho: widget personalizado
    Figura 1. Personalizações de widget realçadas em uma página do portal
    Identificando níveis de personalização

    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 clonado ou personalizado com um widget 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 versões de um registro relacionado a widget.

    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 base. Nesse caso, é recomendável clonar o widget novamente e adicionar suas personalizações ao clone.

    Um widget de base tem menor probabilidade de causar problemas na página. Se você já verificou outros widgets e ainda está enfrentando problemas com a página, remova os widgets básicos da página e adicione-os novamente sem definir opções de widget. Você também pode tentar adicionar widgets 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.