Depurar scripts em Desktop Studio

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

Permissões necessárias: ACD > Studio > Scripts > Depurar

Studio fornece duas maneiras para você achar problemas nos seus scripts.

  • Verifique se há erros de sintaxe.
  • Execute um rastreamento de script, que mostra o que está acontecendo à medida que o script processa cada ação.

Se você tiver ações Snippet em seu script, você pode depurar o código do snippet na janela Snippet editor.

Verificar Erros de sintaxe

Quando você verifica erros de sintaxe, todos os problemas encontrados em seu script aparecem na guia Erros do script . A guia mostra todos os avisos e erros relacionados ao seu script, inclusive em snippets. Os Avisos não impedem que o script seja executado ou salvo, mas os erros impedem. A prática recomendada é resolver todos os avisos antes de colocar o script em produção, mesmo que eles não impeçam o funcionamento do script.

Verificações de sintaxe acontecem automaticamente quando você salva um script, mas você pode executar uma verificação de sintaxe quando quiser. Você não poderá executar nem salvar um script que contenha erros. Se você tentar executar ou salvar um script que contenha erros, Studio exibe uma janela de notificação. Você pode verificar a guia Script Errors para mais informações. Os Erros podem incluir problemas como:

  • Variáveis com erros de ortografia. Por exemplo: Snippet Linha 2. Função: NameLabel não foi definida.
  • Usar uma função como um parâmetro de método. Por exemplo: parâmetros de função não finalizados.
  • Usar um tipo de dado incorreto em uma função que requer um tipo de dado específico. Por exemplo: parâmetros de função não finalizados.

Há alguns erros que podem não aparecer na guia Script Errors. Alguns erros de validação aparecem em uma janela de notificação de erro com detalhes sobre o erro. Erros de validação incluem coisas como JSON inválido na ação REST API. Se você tentar salvar quando o script contiver um Erro de validação, o script poderá reverter para a versão mais recente do script sem o erro de validação. Se isso acontecer, todas as alterações não salvas serão perdidas.

Dê um duplo clique em qualquer aviso ou erro na guia Script Errors para ver a ação na área de trabalho em que o problema ocorre.

  1. No Studio, abra um script.
  2. Clique em Validation > Syntax Check.
  3. Clique na aba Erros de Script para visualizar os resultados da verificação de sintaxe.
  4. Dê um duplo clique em qualquer aviso ou erro na guia Script Errors para ver a ação na tela em que o problema ocorre.

Rastreamentos do script

Você pode rastrear o desempenho do seu script, gerar um script ou fazer uma chamada de teste com a ferramenta . Esta ferramenta rastreia o contato ou o script em execução e exibe cada ação disparada, quais variáveis estão sendo criadas e quando, e os valores que as variáveis tiveram em cada ponto. Esta é uma ferramenta útil para testar e depurar seus scripts. Você pode executar rastreamentos em interações em tempo real ou em interações simuladas.

Você só pode capturar um rastreamento se o script for salvo. Se você tentar fazer a captura de um rastreamento de script em um script com alterações não salvas, Studio solicita que você salve o script. Se você tiver erros de compilação no script, o Studio não salvará o script. Você deve resolver os erros antes de poder salvar o script e executar o rastreamento. Quaisquer erros de validação no script fazem com que Studio reverta para a última versão do script sem o erro de validação. Se você iniciou um rastreamento, ele é executado, mas será executado na última versão salva do script.

Use a Trace Output Janela

Quando você executa um rastreamento, a saída aparece na janela Trace Output. Você pode usar essa janela para visualizar as variáveis no script e ver como elas mudam conforme o script avança por cada açãoClosed Executa um processo em um script do Studio, como coletar dados de clientes ou reproduzir música..

  1. No Studio, abra um script e execute um rastreamento ou abra um arquivo de rastreamento salvo.

  2. Na parte superior direita da janela Trace Output, clique em uma ação no painel de detalhes do script. Se você estiver observando um trace em tempo real, esse painel é atualizado em tempo real conforme o script avança e dispara cada ação.

  3. Clique nos ícones na barra de ferramentas na parte superior da janela Trace Output para expandir The Expand All icon in the Trace Output window, a square with a minus sign it in and a series of stacked horizontal lines next to it, rrepresenting an open list. ou recolher tudo The Expand All icon in the Trace Output window, a square with a + in it and a series of horizontal lines stacked next to it  representing a list. os detalhes das variáveis no painel de detalhes do script. Isso afeta qualquer variável que tem detalhes adicionais dentro. Essas variáveis são indicadas por um ícone + ao lado do nome.
  4. Clique na guia Variáveis na parte inferior da janela para percorrer todas as variáveis presentes no script quando a ação selecionada foi disparada.

  5. Clique no ícone Tools O ícone de Ferramentas de rastreamento, um martelo e uma chave inglesa cruzados na forma de um X. e selecione uma opção para alterar quais variáveis são exibidas na guia Variables .

  6. No painel Properties , você pode ver as Propriedades da ação selecionada e como elas estão configuradas.
  7. Adicionar variáveis a uma lista de observação, se quiser acompanhar variáveis específicas durante o rastreamento.

Alterar a visibilidade de variáveis em um rastreamento

Você pode alterar quais conjuntos de variáveis são exibidos em um rastreamento. Isso permite que você se concentre em tipos específicos de variáveis, dependendo do que você está procurando no rastreamento.

  1. No Studio, abra um script e execute um rastreamento.
  2. Na barra de ferramentas da janela Trace Output , clique no ícone Tools O ícone de Ferramentas de rastreamento, um martelo e uma chave inglesa cruzados na forma de um X. .
  3. Selecione a opção para o conjunto de variáveis que você quer ver ou ocultar no rastreamento. Opções com uma marca de seleção ao lado estão atualmente visíveis no rastreamento.

Capturar um rastreamento do script

Você pode capturar um rastreamento em um script enquanto ele é executado. Você pode fazer isso com Scripts de produção processando contatos EM tempo real. Isso permite que você diagnostique problemas que o seu centro de contatos está tendo, ou que capture dados para resoluções de problemas com o suporte técnico. Você pode optar por capturar um trace na próxima instância em que o script for executado, ou pode capturar um trace contínuo. Um rastreamento contínuo captura todas as interações que o script processa. Quando você captura um único rastreamento, as informações resultantes aparecem na janela Trace Output .

  1. No Studio, abra o script cujo rastreamento deseja capturar.
  2. Clique em Depurar > Capture Script > Next Instance.
  3. Quando uma interação é iniciada e o script começa a ser executado, a janela Trace Output é aberta. A janela exibe o rastreamento à medida que o script é executado.

Capturar um Rastreamento de script Contínuo

Um rastreamento contínuo captura todas as interações que o script processa. A saída do trace é salva em arquivos no seu locatário NiCE CXone. Você pode especificar onde esses arquivos são salvos.

  1. No Studio, abra o script cujo rastreamento deseja capturar.
  2. Clique em Depurar > Captura de Script > Contínuo. Studio começa a capturar todas as instâncias do script sendo executado.

Ver Arquivos de rastreamento

Você pode ver os arquivos de rastreamento salvos de um rastreamento contínuo.

  1. Em Studio, clique no menu Depurar, depois selecione se deseja carregar um arquivo de rastreamento localizado no seu sistema ou remotamente no seu locatário NiCE CXone.
  2. Selecione o arquivo que quer abrir a partir da janela de arquivos que aparece.
  3. Clique no botão para abrir o arquivo de rastreamento selecionado. O nome varia dependendo se você está abrindo um arquivo remoto ou local. O arquivo selecionado é carregado na janela Trace Output .
  4. Se você quiser baixar os arquivos de rastreamento de NiCE CXone para o seu computador local, clique no ícone Ferramentas O ícone de Ferramentas de rastreamento, um martelo e uma chave inglesa cruzados na forma de um X. na janela Trace Output e, em seguida, selecione Save Trace As.

Capturar um rastreamento com um ANI ou DNIS específico

Você pode definir um ANIClosed Também conhecido como id do chamador. número de telefone listado de uma chamada de voz recebida. ou DNISClosed O número discado em chamadas de voz de entrada ou de saída. para disparar um rastreio quando uma chamada do número especificado entrar no sistema.

  1. No Studio, abra o script cujo rastreamento deseja capturar.
  2. Na barra de ferramentas Studio, clique no menu suspenso Trace Script e selecione Trace when ANI is ou Trace when DNIS is.

  3. Enter o número de ANI ou DNIS que deseja usar para acionar o rastreamento no campo Inserir <number>.
  4. Click the Capture Next Instance icon A grey sphere. . The number of times you click changes the behavior: 
    • Clique uma vez para rastrear a próxima instância do script executando com o número especificado. O ícone fica vermelho.
    • Clique duas vezes para rastrear continuamente futuras instâncias do script em execução com o número especificado. O ícone muda para dois círculos vermelhos.
    • Clique três vezes para limpar a captura. O ícone volta para a sua cor cinza original.
  5. Na próxima vez que o script for executado com o ANI ou DNIS especificado, um rastreamento é capturado e salvo em um arquivo.

Monitorar Variáveis em um Trace

Você pode criar uma lista de variáveis de seu interesse específico. A lista de observação permite que você acompanhe somente essas variáveis sem precisar procurá-las no rastreamento. Você pode salvar a lista para que, cada vez que você executar um rastreamento nesse script específico, a lista de observação seja salva e carregada na janela Trace Output .

  1. No Studio, abra o script que deseja rastrear.
  2. Execute um rastreamento inicial do script.
  3. Na janela Saída de Traço , clique para percorrer a lista de ações no painel de detalhes do script. As variáveis associadas a cada ação aparecem na guia Variáveis .
  4. For each variable you want to add to the watch list:
    1. Selecione a variável na guia Variables .
    2. Clique no ícone Add to Watch List O ícone Adicionar à lista de observação - um par de óculos..
  5. You can add a variable manually if you know the name:
    1. Na barra de ferramentas da janela Trace Output , clique no ícone de sinal de mais. A guia Watch List aparece com um campo para uma nova variável.
    2. Digite o nome da variável que deseja observar e pressione Enter.
  6. Se quiser remover uma variável da lista de observação, selecione-a na guia Watch List e clique no ícone de sinal de menos na barra de ferramentas da janela Trace Output .
  7. Para salvar essa lista de observação, clique no ícone Tools The Trace Tools icon, a hammer and a wrench crossed like an X. na barra de ferramentas da janela Trace Output e selecione Save Watch List. A lista é salva no Studio. Sempre que você executar um rastreamento neste script, a lista de observação será carregada na janela Trace Output .
  8. Quando estiver pronto para assistir às variáveis na sua lista de observação, execute um novo rastreamento no script.