Trechos de depurar

Esta página de ajuda é para Desktop Studio. Esta informação também está disponível para Studio.

Você pode depurar snippets a partir da janela do editor Snippet . O depurador permite que você veja as variáveis no código do Snippet. Isso pode ajudá-lo(a) a resolver problemas com seu código. Há cinco opções para se depurar snippets:

  • Verificar a sintaxe no snippet. Você pode fazer isso a qualquer momento enquanto escreve o código de um snippet. Isso não usa a ferramenta de depuração.
  • Depure o Snippet inteiro para ver as variáveis e seus valores depois que todo o Snippet tiver sido executado.
  • Defina um ponto de interrupção para parar a depuração em uma determinada linha do código.
  • Avance por cada linha no código do snippet e veja como a variável e seus valores mudam linha após linha.
  • Use instruções TRACE para enviar dados de saída ao painel Trace na janela do editor Snippet .

Além disso, se o seu código contém objetos dinâmicos ou matrizes, você pode ver os conteúdos deles e como o código é alterado.

Verificar sintaxe do Snippet

Você pode fazer com que Studio verifique a sintaxe em um Snippet.

  1. Em Studio, abra um script contendo uma ação Snippet.
  2. Duplo clique na ação Snippet.
  3. Adicione o código Snippet na guia Text View , caso ainda não o contenha.
  4. Clique no ícone Check Syntax Um ícone com três círculos verdes em um conjunto e um botão triangular de reproduzir ao lado deles. na parte inferior da janela do editor Snippet .

    Se nenhum erro de sintaxe for encontrado, o campo status próximo ao ícone Verificar Sintaxe exibe a mensagem Okay.

    Se forem encontrados erros de sintaxe, uma mensagem de erro aparecerá descrevendo o erro. A descrição inclui o número da linha onde o erro está localizado. Além disso, o campo status ao lado do ícone Check Syntax exibe a mensagem erro na linha [#].

  5. Corrija erros de sintaxe encontrados.
  6. Você pode selecionar uma ou mais linhas no código do snippet e clicar no ícone Comentar linhas selecionadas An icon with open and closed angle brackets next to each other with a blue forward slash between them. . Isso é útil se você quer pular um erro e verificar os outros erros restantes.
  7. Você pode selecionar uma ou mais linhas comentadas no código do snippet e clicar no ícone remover comentário das linhas selecionadas Um ícone com colchetes angulares abertos e fechados um ao lado do outro, com uma barra invertida entre eles. Uma grande barra vermelha risca os outros caracteres. .

Usar a Ferramenta de depuração

  1. Em Studio, abra um script contendo uma ação Snippet.
  2. Duplo clique na ação Snippet.
  3. Adicione o código Snippet na guia Text View , caso ainda não contenha algum.
  4. No lado direito da janela do Snippet editor, clique na guia Debugger.
  5. Clique no botão de seta para baixo no lado direito do ícone Depurar Um ícone de uma janela com um triângulo verde apontando para a direita. No lado direito do ícone há um triângulo preto apontando para baixo que abre um menu suspenso. e selecione IniciarUm ícone de um botão de reprodução verde em formato de triângulo. .
  6. Se houver erros de sintaxe no código, a janela do Snippet editor se expande. todos os erros no código aparecem em um painel na parte inferior da janela. Se não houver erros, pule para a próxima etapa.

    1. Corrija os erros.
    2. Quando os erros tiverem sido corrigidos, clique nos ícones Close ou Clear Trace Output An X. para fechar o painel de erros.
    3. Inicie o depurador novamente.
  7. Visualize o conteúdo da guia Variables as Text . A guia exibe as Variáveis e seus valores quando todo o código foi executado, caso você não tenha definido um ponto de interrupção.
  8. Você pode selecionar uma ou mais linhas no código do Snippet e clicar no ícone Comentar linhas selecionadas An icon with open and closed angle brackets next to each other with a blue forward slash between them. . Isso é útil quando você quer remover parte do código para ver como o resultado da depuração muda.
  9. Você pode selecionar uma ou mais linhas de código comentado e clicar no ícone remover comentário das linhas selecionadas An icon with open and closed angle brackets next to each other with a forward slash between them. Uma grande barra vermelha risca os outros caracteres. para adicionar essas linhas novamente ao snippet.

Depurar com um ponto de pausa

Você pode definir um ponto de interrupção se quiser que a depuração pare em uma linha específica no código do Snippet. Isso permite que você veja as variáveis e os valores na metade do Snippet sem precisar percorrê-lo linha por linha.

  1. Em Studio, abra um script contendo uma ação Snippet.
  2. Duplo clique na ação Snippet.
  3. Adicione o código Snippet na guia Text View , caso ainda não contenha algum.
  4. Clique na coluna à esquerda dos números de linha na janela do Snippet editor. Um círculo vermelho aparecerá naquele número de linha.

  5. No lado direito da janela do Snippet editor, clique na guia Debugger.
  6. Clique no botão de seta para baixo no lado direito do ícone Depurar Um ícone de uma janela com um triângulo verde apontando para a direita. No lado direito do ícone há um triângulo preto apontando para baixo que abre um menu suspenso. e selecione IniciarUm ícone de um botão de reprodução verde em formato de triângulo. .
  7. Se houver erros de sintaxe no código, a janela do Snippet editor se expande. todos os erros no código aparecem em um painel na parte inferior da janela. Se não houver erros, pule para a próxima etapa.

    1. Corrija os erros.
    2. Quando os erros tiverem sido corrigidos, clique nos ícones Close ou Clear Trace Output An X. para fechar o painel de erros.
    3. Inicie o depurador novamente.
  8. Visualize o conteúdo da guia Variables as Text . A guia exibe as variáveis e seus valores no ponto de interrupção, caso você tenha definido um. A linha em que a depuração foi pausada devido ao ponto de interrupção é destacada na janela do Snippet editor.
  9. Se tiver concluído o uso do ponto de pausa, clique no círculo vermelho novamente para limpá-lo.
  10. Defina outro ponto de pausa, se precisar de um.
  11. Para continuar a depuração a partir do ponto de interrupção, clique no ícone ResumeAn icon of a green play triangle..
  12. Para parar a depuração, clique no ícone Parar depuração Um quadrado preto..

Percorrer o código do Snippet etapa a etapa

Você pode usar a ferramenta de depuração para avançar pelo código snippet linha por linha. Isso permite que você veja como as variáveis e seus valores mudam conforme cada linha é executada.

  1. Em Studio, abra um script contendo uma ação Snippet.
  2. Duplo clique na ação Snippet.
  3. Adicione o código Snippet na guia Text View , caso ainda não contenha algum.
  4. No lado direito da janela do Snippet editor, clique na guia Debugger.
  5. Clique no botão de seta para baixo no lado direito do ícone Depurar Um ícone de uma janela com um triângulo verde apontando para a direita. No lado direito do ícone há um triângulo preto apontando para baixo que abre um menu suspenso. e selecione IniciarUm ícone de um botão de reprodução verde em formato de triângulo. .
  6. Se houver erros de sintaxe no código, a janela do Snippet editor se expande. todos os erros no código aparecem em um painel na parte inferior da janela. Se não houver erros, pule para a próxima etapa.

    1. Corrija os erros.
    2. Quando os erros tiverem sido corrigidos, clique nos ícones Close ou Clear Trace Output An X. para fechar o painel de erros.
    3. Inicie o depurador novamente.
  7. Visualize o conteúdo da guia Variables as Text . Ela exibe as variáveis no código e seus valores quando o código do snippet é iniciado.
  8. Clique no ícone Etapa Um ícone para mover para a próxima linha do Snippet.
  9. Repita as duas etapas anteriores para cada linha no snippet.
  10. Se você quiser ignorar as linhas restantes do código, clique no ícone Resume Um ícone de um botão triangular verde de reproduzir.. A guia Variables as Text exibe as Variáveis e seus valores quando todo o código do Snippet tiver sido executado.
  11. Para parar a depuração, clique no ícone Parar depuração Um quadrado preto. e repita esse processo a partir da etapa 3.

Ver Conteúdos de Objetos Dinâmicos e Matrizes

Você pode visualizar o conteúdo de objetos dinâmicos na janela do editor Snippet ao executar o depurador. Isso permite verificar se o objeto contém os dados que deveria conter em cada etapa do seu código.

  1. Em Studio, dê um duplo clique em uma ação Snippet.
  2. Adicione o código do snippet, se necessário.
  3. Na guia Debugger , clique na guia Variáveis como Árvore.
  4. Na guia Debugger , clique na seta para baixo ao lado do ícone Iniciar depuração Uma imagem de um botão triangular de reprodução verdee selecione Step Into Uma série de linhas horizontais com uma seta apontando de uma linha para a linha abaixo dela. . Se você não quiser percorrer o código linha por linha, clique no ícone Iniciar depuração.
  5. Clique no ícone Etapa Uma série de linhas horizontais com uma seta apontando de uma linha para outra abaixo dela. e observe o conteúdo na aba Variables as Tree. Cada vez que você clicar em Step, esse campo é atualizado com as Variáveis e objetos no script após a linha de código anterior. Ignore esta Etapa se você clicou em Iniciar depuração.
  6. Quando você percorrer todas as linhas de código ou se clicar em Iniciar depuração, a guia Variables as Tree exibirá todas as Variáveis, objetos e seus conteúdos ao final do Snippet.
  7. Você pode clicar no ícone + ao lado de qualquer conjunto de strings ou objetos dinâmicos no código para expandi-los. Se o conteúdo for outra matriz ou objeto, você pode continuar expandindo a árvore para ver o que cada entidade contém.

Depurar usando TRACE

A palavra-chave TRACE permite depurar usando registro em log. Essa palavra-chave só funciona ao usar a ferramenta de depuração na janela do editor Snippet . Ao incluí-la no código do seu Snippet e executar o depurador, o texto é exibido no painel Trace que aparece na parte inferior da janela do editor Snippet .

A palavra-chave TRACE é ignorada fora da janela do editor Snippet . Ela só funciona com a ferramenta de depuração.

A sintaxe é TRACE "<text>":

O texto entre aspas duplas é enviado como saída para a janela do editor Snippet . Ele aparece no painel Trace na parte inferior da janela.

Você pode usar a substituição de variáveis entre as aspas duplas para imprimir o valor das variáveis. Por exemplo:

FOR i=1 TO 5
{
   TRACE "I = {i}"
}

A saída deste exemplo é:

I = 1

I = 2

I = 3

I = 4

I = 5

Use a Variável do Sistema Testar

A variável é uma variável de sistema reservada para uso na depuração de snippets. Ela permite definir o valor de variáveis que são usadas no snippet e que já seriam preenchidas pelo script antes de chegar à ação .

Quando você usa em um Snippet, ele deve ser usado como parte de uma instrução e definido como 1. O código entre chaves só é executado quando você executa o depurador de script porque a variável só é igual a 1 quando o depurador é executado. Quando o script é executado para um contatoClosed A pessoa que interage com um agente, Rvi ou bot em seu contact center., tem o valor 0, portanto, o código entre chaves na instrução é ignorado.

Por exemplo:

Neste exemplo, a instrução dentro da instrução define a condição inicial da variável . Em um script ativo, esse valor seria definido em outra parte do script, e o valor definido na instrução seria ignorado. O motivo pelo qual você precisa dele na depuração do Snippet é que o script completo não está em execução para definir esse valor.

  1. Em NiCE CXone, clique no seletor de aplicativos Icon of three-by-three grid of white squares on a blue background e selecioneOmnichannel Routing > Studio Três setas unidas na base. Uma aponta para cima, outra para cima e para a direita, e outra para cima e para a esquerda. .
  2. Na página Scripts, localize e dê um duplo clique para abrir o script com o qual deseja trabalhar. O script é aberto em uma nova guia.
  3. Abra uma ação ou adicione uma nova ao canvas.

  4. Clique na aba Modo de exibição de texto.

  5. Na parte superior da janela do , adicione o seguinte código:

  6. Em , insira o código ou as instruções necessárias para definir as condições iniciais exigidas para a execução do Snippet, como a definição dos valores iniciais de variáveis exigidos pelo código do seu Snippet. Por exemplo:

  7. Adicione o código do Snippet que você deseja testar. Por exemplo:

  8. Para testar o código, clique no inseto Icon of an insect. para abrir o depurador.

  9. Clique em Apply para salvar o snippet e, em seguida, salve seu script.