Depurador de script e Log da sessão

O Depurador de script permite que os usuários com a função script_debugger depurem o JavaScript do lado do servidor, enquanto o Log da sessão permite que você exiba e baixe os logs necessários.

Usuários com a função script_debugger podem executar essas ações usando Depurador de script:

• Tenha uma transação de depuração dedicada, que se aplica somente à sessão atual.
• Definir e remover pontos de interrupção.
• Pausar a sessão atual em um ponto de interrupção.
• Avalie expressões durante o tempo de execução.
• Percorra o código linha por linha.
• Entrar e sair de chamadas de função e método.
• Exiba o valor de variáveis locais e globais.
• Exibir o valor de variáveis privadas de fechamentos de função.
• Exibir a pilha de chamadas.
• Exiba a transação que o sistema está processando.
• Desative o depurador de script para retomar a execução de scripts pausados.

Use a guia Log da sessão para recuperar o log da sessão para regras de negócios, inclusões de script e uma IU personalizada, como ServiceNow® Espaço do agente que tem um componente GraphQL. Usuários com a função script_debugger podem:

• Exibir logs de sessão em uma guia separada.
• Baixe um log.
• Exibir logs para Espaço do agente.
• Especifique opções de depuração para exibir ou baixar somente os logs necessários.

Por padrão, 100 transações e 10.000 mensagens aparecem na guia Log da sessão. Se a contagem de transações ou mensagens exceder o valor padrão, o log da sessão será limpo e as próximas transações ou mensagens serão exibidas. Você pode configurar esta transação e contagem de mensagens usando as preferências do usuário glide.debugger.log.transaction.count e glide.debugger.log_messages_limit respectivamente. Para obter mais informações sobre as preferências do usuário glide.debugger.log.transaction.count e glide.debugger.log_messages_limit, consulte Configurações de preferência do usuário.

Nota:

Habilite Log da sessão como uma guia separada com Depurador de script usando a propriedade do sistema glide.debugger.log.ui.

• A opção Página exibe logs em formulários e listas e na guia Log de sessão.
• A opção Sessão exibe logs somente na guia Log de sessão.

Para obter mais informações sobre a propriedade do sistema glide.debugger.log.ui, consulte Propriedades do sistema disponíveis.

Quando você executa uma declaração no Console, a declaração executada é armazenada no cache do navegador. Você pode usar a tecla de seta para cima para obter a declaração anterior e a tecla de seta para baixo para obter a próxima declaração do cache do navegador. A configuração de preferência do usuário, glide.debugger.console.cached_stmt_limit, define o número de declarações armazenadas em cache em uma sessão do navegador. O valor do cache de declaração padrão é 20 e o valor máximo é 100. Você pode configurar o valor do cache de declaração nas preferências do usuário.

Nota:

As declarações em cache não estão disponíveis quando o cache do navegador é limpo ou quando você faz login de um navegador diferente ou de um computador diferente.

O Depurador de script pode pausar qualquer script do lado do servidor que seja executado em uma transação interativa, como regras de negócios, inclusões de script, ações de script ou ações de IU que exigem uma resposta para prosseguir. Se o método GlideSystem isInteractive() retornar verdadeiro ao executar o script no contexto, o Depurador de script poderá pausá-lo.

Nota:

Alguns objetos de script, como inclusões de script, podem ser chamados de vários contextos. Por exemplo:

• quando uma regra de negócios executa uma inclusão de script em um envio de formulário que é uma transação interativa aguardando os dados do formulário mudarem antes de continuar.
• quando um trabalho programado executa a mesma inclusão de script que é uma transação em segundo plano não interativa que também pode executar outros scripts simultaneamente.

Para depurar scripts do lado do cliente, você pode usar ferramentas de desenvolvedores baseadas em navegador.

Uma transação do depurador permanecerá aberta enquanto a sessão do usuário for válida. Se um usuário fizer logout ou a sessão expirar, o sistema fechará a transação do depurador.

Para exibir logs de depuração, consulte Exibir logs de depuração.

Nota:

Quando o Depurador de script está habilitado, o código é executado no modo interpretado. Se partes do script forem definidas para serem executadas no modo estrito, o depurador não poderá encontrar os objetos corretos e o depurador falhará. O Depurador de script deve ser executado em scripts fora do modo estrito.

• Rastreador de script e scripts de depuração
  O Rastreador de script pode ajudar a filtrar sua pesquisa de depuração para restringir rapidamente os problemas de script. Você pode identificar linhas de scripts no registro do Glide que passaram por mudanças durante a execução. Encontrar essas linhas específicas de scripts em vez de fazer uma pesquisa ampla ajuda a economizar tempo e melhora a produtividade.
• Partes da interface do usuário
  A interface Depurador de script exibe informações sobre os pontos de interrupção definidos, a pilha de chamadas e o número da linha do script em execução no momento, detalhes sobre variáveis e transaçõese o status do console.
• Controles de console e de etapa de Depuração de script
  Depois que o Depurador de script pausar um script, use os controles passo a passo para se mover entre as linhas de script e entre os scripts na pilha de chamadas. Use os controles do console para expandir o console, recolher o console, limpar o console e executar novamente as expressões.
• Avaliar expressões em tempo de execução usando o console
  Defina, declare e verifique novas variáveis e funções enquanto depura um script em tempo de execução usando o Console. A execução do script deve ser pausada para usar o Console.
• Iniciar o Depurador de script
  Os desenvolvedores podem iniciar o Depurador de script no navegador de aplicativos, Studioou no editor de sintaxe.
• Definir ou remover pontos de interrupção
  Defina pontos de interrupção ou condicionais para pausar scripts em linhas específicas e remova os pontos de interrupção quando terminar de depurá-los.
• Definir ou remover logpoints
  Defina pontos de interrupção ou logpoints condicionais para registrar mensagens no console em linhas específicas e remova os logpoints quando terminar de depurá-los.
• Depurador de script status
  O status Depurador de script determina quais ações de depuração estão disponíveis e quais informações ele pode exibir.
• Detalhes da transação
  O Depurador de script exibe os detalhes da transação da sessão do usuário pausada atual.
• Detalhes da transação disponível
  O Depurador de script fornece um conjunto padrão de detalhes de transação para os desenvolvedores depurarem e solucionarem problemas de scripts.
• Depurador de script suporte a vários desenvolvedores
  O Depurador de script permite que vários desenvolvedores depurem suas próprias transações sem afetar um ao outro.
• Depurador de script suporte de representação
  Você pode usar o Depurador de script ao representar outro usuário, mas somente se o usuário representado tiver a função script_debugger e tiver acesso de leitura ao script de destino.
• Depurador de script Scripts - Suporte em segundo plano
  O módulo Scripts - Plano de fundo não oferece suporte à definição de pontos de interrupção diretamente no campo de script. No entanto, você pode definir pontos de interrupção nos objetos de script chamados ou acionados pelo módulo Scripts - Plano de fundo.
• Separação de domínios e Depurador de script
  Separação de domínios é compatível com Depurador de script. O Domain Separation permite separar dados, processos e tarefas administrativas em agrupamentos lógicos chamados de domínios. Você pode controlar vários aspectos dessa separação, incluindo quais usuários podem ver e acessar os dados.