Depurar trechos em Studio

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

Você pode depurar snippets na janela do editor Snippet. O depurador permite que você veja as variáveis no código 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. No Studio, abra um script contendo uma ação Snippet.
  2. Clique em Abrir Editor Um retângulo com uma linha horizontal perto do topo. na ação Snippet.
  3. Adicione Snippet código, se ele ainda não contiver alguns.
  4. No lado esquerdo da janela do editor de Snippet, clique no Ícone de um bug. de bugs. O painel Executar & Depurar desliza para fora do lado esquerdo da janela.
  5. Clique no Ícone de um triângulo apontando para a direita. triângulo 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 executou todo o código do snippet. Dinâmico objetos de dados mostram o valor {Dinâmico}. Clique para expandi-los e visualizar os valores de seus membros.
  7. Verifique se há erros na variável _err em qualquer ponto do processo de depuração. Alguns erros aparecem como mensagens do sistemaFechado As mensagens de alerta são pequenas mensagens pop-up temporárias na parte inferior da tela, indicando coisas como erros e sucessos. Elas são embutidas na funcionalidade do CXone Mpower e podem aparecer em qualquer tela. na janela Snippet editor.

  8. Para fazer alterações no snippet:
    1. Parar o depurador, se ele ainda não estiver parado. Enquanto o depurador está em execução, o snippet está 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 editor de Snippet 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 de um ponto de interrupção e fazer com que o depurador pule de ponto de interrupção para ponto de interrupção. Isso permite que você veja as variáveis e valores em pontos específicos do snippet sem passar por ele linha por linha.

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

  1. No Studio, abra um script contendo uma ação Snippet.
  2. Clique em Abrir Editor Um retângulo com uma linha horizontal perto do topo. na ação Snippet.
  3. Adicione Snippet código, se ele ainda não contiver alguns.
  4. No lado esquerdo da janela do editor de Snippet, clique no Ícone de um bug. de bugs. O painel Executar & Depurar desliza para fora do lado esquerdo da janela.
  5. Adicione um ponto de interrupção clicando na coluna à esquerda de qualquer linha na janela do editor de Snippet. Um círculo vermelho aparece ao lado do número da linha. Você pode adicionar mais de 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 Ícone de um triângulo apontando para a direita. triângulo 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, se você definir um. A linha onde a depuração foi pausada para o ponto de pausa é destacada na janela Editor Snippet. Dinâmico objetos de dados mostram o valor {Dinâmico}. Clique para expandi-los e visualizar os valores de seus membros.
  8. Se tiver terminado um ponto de interrupção, clique novamente no círculo vermelho para limpá-lo.
  9. Para continuar a depuração a partir do ponto de interrupção, clique em retomar Ícone de uma linha vertical com um triângulo ao lado.. Se você tiver definido mais de um ponto de interrupção, o depurador pausará um pouco 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 Ícone de uma seta apontando para baixo.. Você pode retomar Ícone de uma linha vertical com um triângulo ao lado. a qualquer momento para concluir a depuração ou pular 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 do sistemaFechado As mensagens de alerta são pequenas mensagens pop-up temporárias na parte inferior da tela, indicando coisas como erros e sucessos. Elas são embutidas na funcionalidade do CXone Mpower e podem aparecer em qualquer tela. na janela Snippet editor.

  12. Para interromper a depuração, clique no quadrado Ícone de um quadrado vazio..
  13. Para fazer alterações no snippet:
    1. Parar o depurador, se ele ainda não estiver parado. Enquanto o depurador está em execução, o snippet está 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 editor de Snippet e execute o depurador novamente.

Avançar pelo código snippet

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. No Studio, abra um script contendo uma ação Snippet.
  2. Clique em Abrir Editor Um retângulo com uma linha horizontal perto do topo. na ação Snippet.
  3. Adicione Snippet código, se ele ainda não contiver alguns.
  4. No lado esquerdo da janela do editor de Snippet, clique no Ícone de um bug. de bugs. O painel Executar & Depurar desliza para fora do lado esquerdo da janela.
  5. Clique na coluna à esquerda de qualquer linha na janela do editor de Snippet. Um círculo vermelho aparece ao lado da linha. Este é um ponto de interrupção, que marca o local a partir do qual você pode começar a percorrer o código.

  6. Clique no Ícone de um triângulo apontando para a direita. triângulo 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 snippet. Dinâmico objetos de dados mostram o valor {Dinâmico}. Clique para expandi-los e visualizar os valores de seus membros.
  8. Clique na seta para baixo Ícone de uma seta apontando para baixo. para ir 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 snippet.
  9. Repita as duas etapas anteriores para cada linha do snippet. A seção Variáveis continua a ser atualizada após cada linha.
  10. Se você quiser ignorar as linhas de código restantes, clique em retomar Ícone de uma linha vertical com um triângulo ao lado.. A seção Variáveis exibe as variáveis e seus valores quando todo o código do snippet é executado.
  11. Verifique se há erros na variável _err em qualquer ponto do processo de depuração. Alguns erros aparecem como mensagens do sistemaFechado As mensagens de alerta são pequenas mensagens pop-up temporárias na parte inferior da tela, indicando coisas como erros e sucessos. Elas são embutidas na funcionalidade do CXone Mpower e podem aparecer em qualquer tela. na janela Snippet editor.

  12. Para interromper a depuração, clique no Ícone de um quadrado vazio. quadrado e repita o processo de depuração, se necessário.
  13. Para fazer alterações no snippet:
    1. Parar o depurador, se ele ainda não estiver parado. Enquanto o depurador está em execução, o snippet está 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 editor de Snippet e execute o depurador novamente.

Depurar usando a palavra-chave TRACE

O TRACE palavra-chave permite que você depure usando o registro em log. Esta palavra-chave funciona somente ao usar a ferramenta de depuração na janela de editor Snippet . Quando você o inclui no código do snippet e executa o depurador, o texto é enviado para a seção Rastreamento da janela Executar & Depurar na janela Snippet editor.

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 é enviado para a seção Rastreamento da janela Executar & Depurar na janela do editor de Snippet.

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

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

A saída deste exemplo na seção Rastreamento da janela Executar & Depurar é:

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