Identificar e resolver erros do cliente

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 2 min. de leitura
  • Identifique erros do cliente e resolva-os em scripts do lado do cliente.

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Quando ocorrem erros de cliente, o Automated Test Framework falha no teste na etapa que estava sendo executada quando o erro ocorreu. Mesmo que os scripts do lado do cliente possam falhar silenciosamente em erros de JavaScript enquanto os procedimentos estão sendo executados, o erro ainda pode afetar os dados e o procedimento que está sendo executado. O Automated Test Framework considera esses erros como falhas de validação.

    Procedimento

    1. Navegar até Todos > Aplicação > Automated Test Framework > Testes e execute um teste do Automated Test Framework que interage com um formulário.
    2. Nos resultados do teste para este teste, verifique se há um resultado de etapa com o seguinte resumo:

      Esta etapa falhou porque o erro do cliente “DETALHADA DE MENSAGEM DE ERRO” foi detectado na página que está sendo testada. Consulte Logs de teste reprovados. Para ignorar esses erros na próxima simulação, use os links "Adicionar todos os erros de cliente à lista de avisos/ignorados".

      Este resultado de etapa aparece somente em uma etapa que interage com a IU.

    3. Para identificar e resolver esses erros de script, abra o console do navegador de ferramentas para desenvolvedores na página Executor de teste do cliente.
      Nota:
      Para obter informações sobre como abrir o console do navegador, consulte o seguinte artigo: http://webmasters.stackexchange.com/questions/8525/how-to-open-the-javascript-console-in-diferentes-browsers
    4. Se você puder ver o erro, tente identificar e solucionar problemas do script problemático do lado do cliente, que pode estar em qualquer uma das seguintes tabelas do sistema de base:
      • ServiceNow Client script
      • Ação de IU
      • Macro de IU (script HTML)
      • Página de IU (script HTML)
      • Política de IU
      • Script da IU
      • Tabelas que estendem as tabelas do sistema de base anteriores
    5. Revise o script em busca de erros e, depois de corrigi-los, execute o teste novamente.

    O que Fazer Depois

    Determine a origem do erro do cliente revisando o histórico da versão do script. Se você personalizou um script do sistema de base, é possível que o script tenha novas versões que foram ignoradas durante a atualização.

    Exemplos de erros do cliente

    Existem vários tipos de erros de cliente comuns.

    Erros de JavaScript do cliente

    Quando um client script causa um erro, o console do navegador exibe um erro semelhante ao seguinte exemplo:

    ***************************************************
    A script has encountered an error in render events
    TypeError: Cannot read property 'id' of undefined
    Script ends. Continuing happily
    ***************************************************
    [00:00:00.002] onLoad Modify Comments Label

    Neste exemplo, o client script Modificar rótulo de comentários causou o erro.

    Outros erros de client script

    Qualquer outro tipo de erro de script é relatado diretamente no console do navegador com qualquer formatação após a ocorrência.

    TypeError: callbacks(id) é indefinido

    Links de recursos de script por SYS ID

    Em alguns casos, o erro do console fornece um link para o arquivo de recurso de script usando seu SYS ID. Seguir este link pode fornecer contexto para qual script o executou.

    Uncaught ReferenceError: myobj is not defined
        at incident.do?sys_id=12345678901234567890123456789012
    (anonymous) @ incident.do?sys_id=12345678901234567890123456789012  <---- LINK
    

    Permissões de acesso ao script

    Ao identificar scripts problemáticos, certifique-se de que o script tenha permissão para acessar os dados. Verificar:
    • Permissões de regra de controle de acesso para tabelas e campos.
    • Permissões de acesso à aplicação se o script acessar aplicações em um escopo privado.
    • Permissões de separação de domínio se a separação de domínio estiver configurada.