Diagnóstico de 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 conforme o 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:

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

Identificar 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 ServiceNow plug-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 a partir de um widget de base.
Novo(a)	Widget que você criou.
Personalizados	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 modificadas, ng-models ou provedores angular

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 de 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 de widget, você pode verificar o código do widget de várias maneiras:

• Exiba um registro de widget em 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 em 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 de base

  Identifique personalizações em um widget para que você possa reverter seus 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 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 Compare um widget clonado ou personalizado com um widget de base.

Dica:

Agora, mesmo que um widget personalizado não esteja causando problemas na página, você pode 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 de base. Nesse caso, é recomendável clonar o widget novamente e adicionar suas personalizações ao clone.

Um widget de base tem menos probabilidade de causar problemas na página. Se você já verificou outros widgets e ainda está enfrentando problemas na página, remova os widgets base da página e adicione-os novamente sem definir nenhuma opção de widget. Você também pode tentar adicionar widgets base 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 ao usar 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 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 que você a excluiu.