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 erro no código do widget. Para diagnosticar a página, tente diagnosticar os widgets na página.
- Identificando níveis de personalização de widget
- Verificando o código usado em cada widget
Identificando níveis de personalização
| 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:
|
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
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.
- Exibir 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.
- Identificar 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.
- Comparar versões de um registro relacionado a 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.
- Comparar 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.
- Comparar um widget clonado ou personalizado com um widget 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 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.
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
- 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.