Depurar fragmentos em Scripts

Esta página de ajuda é para Studio. Esta informação também está disponível para Desktop 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:

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.

Usar a Ferramenta de depuração

  1. Em Studio, abra um script contendo uma ação Snippet.
  2. Clique em Abrir editor A rectangle with a horizontal line near the top. na ação Snippet.
  3. Adicione o código Snippet, se ele ainda não contiver algum.
  4. Na parte esquerda da janela do Snippet editor, clique no ícone de inseto Icon of a bug.. O painel Run & Debug é exibido a partir do lado esquerdo da janela.
  5. Clique no triângulo Ícone de um triângulo apontando para a direita. para iniciar a depuração.
  6. Visualize o conteúdo da seção Variáveis do painel Executar & Depurar. Esta seção mostra as variáveis e seus valores quando o depurador tiver executado todo o código do snippet. Nesta seção:

    • Os objetos de dados dinâmicos mostram o valor {Dynamic}. Clique para expandi-los e visualizar os valores de seus membros.
    • Passe o cursor sobre um valor para ver esse valor em uma dica de ferramenta. Isso permite que você veja valores grandes.
    • Clique em um valor e pressione CTRL+C para copiar o valor para a área de transferência.
  7. Verifique se há erros na variável _err em qualquer ponto do processo de depuração. Alguns erros aparecem como mensagens toastClosed mensagens pop-up pequenas e temporárias, exibidas na parte inferior da tela, que indicam situações como erros e sucessos. na janela do Snippet editor.

  8. To make changes to your snippet: 
    1. Parar o depurador, se estiver em execução. Enquanto o depurador estiver em execução, o Snippet fica no modo somente leitura.
    2. Faça suas alterações.
    3. Clique em Aplicar na janela do editor de Snippet. A janela do editor é fechada automaticamente. Isso envia as alterações para o servidor, onde o serviço de depuração é executado.
    4. Reabra a janela do Snippet editor e execute o depurador novamente.

Depurar com um ponto de pausa

Você pode definir um ponto de pausa se quiser parar de depurar em uma determinada linha do código snippet. Você pode definir mais que um ponto de pausa e fazer com que o depurador ignore de um ponto de pausa para outro. Isso permite que você veja as variáveis e os valores em pontos específicos do snippet sem percorrê-lo linha por linha.

Você pode definir pontos de interrupção antes de iniciar o depurador ou enquanto ele estiver executando. A depuração é pausada quando a linha com o ponto de interrupção está a ponto de ser executada. Enquanto estiver pausada, você pode ver o valor atual de todas as variáveis no Snippet na seção Variáveis da janela Executar & Depurar.

  1. Em Studio, abra um script contendo uma ação Snippet.
  2. Clique em Abrir editor A rectangle with a horizontal line near the top. na ação Snippet.
  3. Adicione o código Snippet, se ele ainda não contiver algum.
  4. Na parte esquerda da janela do Snippet editor, clique no ícone de inseto Icon of a bug.. O painel Run & Debug é exibido a partir do lado esquerdo da janela.
  5. Adicione um ponto de interrupção clicando na coluna à esquerda de qualquer linha na janela do Snippet editor. Um ponto vermelho aparece ao lado do número da linha. Você pode adicionar mais que um ponto de interrupção ao snippet. Você também pode adicionar pontos de interrupção enquanto o depurador está em execução.

  6. Clique no triângulo Ícone de um triângulo apontando para a direita. para iniciar a depuração.
  7. Visualize o conteúdo da seção Variáveis do painel Executar & Depurar. Esta seção mostra 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 para o ponto de interrupção é destacada na janela do editor do Snippet e uma seta aberta Icon of a yellow arrow aparece na coluna de ponto de interrupção. Nesta seção:

    • Os objetos de dados dinâmicos mostram o valor {Dynamic}. Clique para expandi-los e visualizar os valores de seus membros.
    • Passe o cursor sobre um valor para ver esse valor em uma dica de ferramenta. Isso permite que você veja valores grandes.
    • Clique em um valor e pressione CTRL+C para copiar o valor para a área de transferência.
  8. Se você terminou com um ponto de interrupção, clique novamente no círculo vermelho para limpá-lo.
  9. Para continuar depurando a partir do ponto de interrupção, clique em retomar Icon of a vertical line with a triangle next to it.. Se você definiu mais que um ponto de interrupção, o depurador pausa imediatamente antes do próximo.
  10. Para percorrer o código linha por linha a partir do ponto de interrupção atual, clique na seta para baixo Icon of an arrow pointing down.. Você pode retomar Icon of a vertical line with a triangle next to it. em qualquer ponto para terminar a depuração ou para saltar para o próximo ponto de interrupção.
  11. Verifique se há erros na variável _err em qualquer ponto do processo de depuração. Alguns erros aparecem como mensagens toastClosed mensagens pop-up pequenas e temporárias, exibidas na parte inferior da tela, que indicam situações como erros e sucessos. na janela do Snippet editor.

  12. Para parar a depuração, clique no quadrado Icon of an empty square..
  13. To make changes to your snippet: 
    1. Parar o depurador, se estiver em execução. Enquanto o depurador estiver em execução, o Snippet fica no modo somente leitura.
    2. Faça suas alterações.
    3. Clique em Aplicar na janela do editor de Snippet. A janela do editor é fechada automaticamente. Isso envia as alterações para o servidor, onde o serviço de depuração é executado.
    4. Reabra a janela do Snippet editor e execute o depurador novamente.

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 à medida que cada linha é executada.

  1. Em Studio, abra um script contendo uma ação Snippet.
  2. Clique em Abrir editor A rectangle with a horizontal line near the top. na ação Snippet.
  3. Adicione o código Snippet, se ele ainda não contiver algum.
  4. Na parte esquerda da janela do Snippet editor, clique no ícone de inseto Icon of a bug.. O painel Run & Debug é exibido a partir do lado esquerdo da janela.
  5. Clique na coluna à esquerda de qualquer linha na janela do editor do Snippet. Um ponto vermelho aparece ao lado da linha. Esse é um ponto de interrupção, que marca o local a partir do qual você pode começar a percorrer o código passo a passo.

  6. Clique no triângulo Ícone de um triângulo apontando para a direita. para iniciar a depuração. Se o ponto de interrupção estiver na primeira linha, nenhum código será executado ainda.
  7. Visualize o conteúdo da seção Variáveis do painel Executar & Depurar. Esta seção exibe as variáveis no código e seus valores antes do início do código do snippet. Nesta seção:

    • Os objetos de dados dinâmicos mostram o valor {Dynamic}. Clique para expandi-los e visualizar os valores de seus membros.
    • Passe o cursor sobre um valor para ver esse valor em uma dica de ferramenta. Isso permite que você veja valores grandes.
    • Clique em um valor e pressione CTRL+C para copiar o valor para a área de transferência.
  8. Clique na seta para baixo Icon of an arrow pointing down. no painel Executar e Depurar para avançar para a próxima linha do Snippet. A seção Variáveis é atualizada para mostrar as variáveis e seus valores após a execução da primeira linha do código do Snippet.
  9. Repeat as duas etapas anteriores para cada linha no snippet. A seção Variáveis continua a ser atualizada após cada linha.
  10. Se você quiser ignorar as linhas restantes do código, clique em retomar Icon of a vertical line with a triangle next to it.. A seção Variáveis exibe as variáveis e seus valores quando todo o código do Snippet tiver sido executado.
  11. Verifique se há erros na variável _err em qualquer ponto do processo de depuração. Alguns erros aparecem como mensagens toastClosed mensagens pop-up pequenas e temporárias, exibidas na parte inferior da tela, que indicam situações como erros e sucessos. na janela do Snippet editor.

  12. Para parar a depuração, clique no quadrado Icon of an empty square., depois repita o processo de depuração se necessário.
  13. To make changes to your snippet: 
    1. Parar o depurador, se estiver em execução. Enquanto o depurador estiver em execução, o Snippet fica no modo somente leitura.
    2. Faça suas alterações.
    3. Clique em Aplicar na janela do editor de Snippet. A janela do editor é fechada automaticamente. Isso envia as alterações para o servidor, onde o serviço de depuração é executado.
    4. Reabra a janela do Snippet editor e execute o depurador novamente.

Depurar usando a Palavra-chave TRACE

O TRACE palavra-chave permite depurar usando registro de log. Essa palavra-chave funciona somente quando você usa a ferramenta de depuração na janela do editor Snippet . Quando você a inclui no código do seu snippet e executa o depurador, o texto é exibido na seção Trace da janela Run & Debug na janela do editor Snippet .

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

A sintaxe é TRACE "<expression>":

O texto entre aspas duplas é exibido na seção Trace da janela Executar & Depurar, na janela do editor de Snippet.

Você pode usar a substituição de variável 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 na seção Trace da janela Executar & Depurar é:

I = 1
I = 2
I = 3
I = 4
I = 5

Use a Variável de Sistema Testar

A variável test é 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 SNIPPET.

Quando você usa test em um Snippet, ele deve ser usado como parte de uma instrução IF e definido como 1. O código entre chaves só é executado quando você executa o depurador de script porque a variável test 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., test tem o valor 0, portanto, o código entre chaves na instrução IF é ignorado.

Por exemplo:

IF test = {
 ASSIGN myDate = "07/03/2026" //This date falls on a Friday}
ASSIGN myDow = myDate.asdatedow
SWITCH myDow
{
 CASE 0   { ASSIGN newToday = "Sunday"  }
 CASE 1   { ASSIGN newToday = "Monday"  }
 CASE 2   { ASSIGN newToday = "Tuesday" }
 CASE 3   { ASSIGN newToday = "Wednesday" }
 CASE 4   { ASSIGN newToday = "Thursday" }
 CASE 5   { ASSIGN newToday = "Friday"  }
 CASE 6   { ASSIGN newToday = "Saturday"   }
}

Neste exemplo, a instrução ASSIGN dentro da instrução IF define a condição inicial da variável myDate. Em um script ativo, esse valor seria definido em outra parte do script, e o valor definido na instrução IF 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 SNIPPET ou adicione uma nova ao canvas.

  4. Na parte superior da janela do Snippet editor , adicione o seguinte código:

    IF test = 1
    {
    	[code or variable assignments]
    }
  5. Em [código ou atribuições de variáveis], insira o código ou as instruções ASSIGN 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:

    IF test = 1 {
     ASSIGN MyDate = "07/03/2026" //This date falls on a Friday
    }
  6. Adicione o código do Snippet que você deseja testar. Por exemplo:

    ASSIGN myDow = myDate.asdatedow
    SWITCH myDow
    {
     CASE 0   { ASSIGN newToday = "Sunday"  }
     CASE 1   { ASSIGN newToday = "Monday"  }
     CASE 2   { ASSIGN newToday = "Tuesday" }
     CASE 3   { ASSIGN newToday = "Wednesday" }
     CASE 4   { ASSIGN newToday = "Thursday" }
     CASE 5   { ASSIGN newToday = "Friday"  }
     CASE 6   { ASSIGN newToday = "Saturday"   }
    }
  7. Para testar o código, clique no inseto Icon of an insect. para abrir o depurador.

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