Diagnóstico do widget

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 como esperado, pode ser devido a um bug no código do widget. Para diagnosticar a página, tente diagnosticar os widgets na página.

O diagnóstico de widgets envolve:

• Identificando os níveis de personalização do widget
• Verificando o código usado em cada widget

Identificando níveis de personalização

Níveis de personalização descreva 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. Há 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 outro ServiceNowplug-ins. Os widgets 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 clonado de um widget base.
Novo	Widget que você criou.
Personalizado	Widget base que você configurou de 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-models ou provedores Angular modificados

Para identificar os níveis de personalização dos 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:

• Verde: Widget de base
• Amarelo: Widget clonado
• Azul: Novo widget
• Vermelho: Widget personalizado

Figura 1. Personalizações de widget realçadas em uma página do portal

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 ( ) em um widget.

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

• Exiba um registro de widget de uma página do portal

  Exiba e identifique o código possivelmente problemático no registro do widget sem sair da página do portal.

• Identifique personalizações nos registros relacionados ao widget

  Exiba e identifique o código possivelmente problemático nas dependências do widget, Provedores angulares e ng-templates que estão sendo usados pelo widget.

• Compare versões de um registro relacionado ao widget

  Compare um Provedor angular ou ng-template com a versão anterior para verificar se as mudanças de código mais recentes estão causando problemas em uma página do portal.

• Compare versões de um widget personalizado

  Compare a atualização mais recente de um widget personalizado com a versão anterior para verificar se as mudanças recentes estão causando problemas em uma página do portal.

• Compare um widget clonado ou personalizado com um widget base

  Identifique personalizações em um widget para reverter os widgets clonados ou personalizados e resolver problemas em uma página do portal.

Recomendações para diagnosticar widgets

Dos quatro níveis de personalização, o problema de prioridade mais alta são widgets personalizados. Esses widgets não são compatíveis com upgrades do sistema. Se você estiver enfrentando problemas na página durante um upgrade, pode ser que 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 Compare um widget clonado ou personalizado com um widget base.

Dica:

Mesmo que um widget personalizado não esteja causando problemas na página agora, você pode querer reverter para o widget original para evitar problemas durante upgrades posteriores.

Se você ainda estiver enfrentando problemas de página depois de reverter widgets personalizados, verifique seus 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 suas mudanças mais recentes para que você possa depurar seu código, siga as etapas em Compare versões de um registro relacionado ao 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 base tem menos probabilidade de causar problemas na página. Se você já tiver verificado outros widgets e ainda estiver enfrentando problemas na página, remova os widgets base da página e adicione-os novamente sem nenhuma opção de widget definida. Você também pode tentar adicionar widgets base a outra página.

Limitações

Há 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 usa o diagnóstico de widget, o sistema desabilita 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 do widget listadas na página do portal refletem somente as dependências de primeiro nível. Qualquer dependência aninhada mais profunda do que o primeiro nível não será incluída. Para solucionar ainda mais problemas do widget, verifique as dependências aninhadas no registro do widget.
• Não há como o sistema rastrear uma dependência de widget depois de excluí-la.