Depurar scripts no Desktop Studio

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

Studio provides two ways you can check for issues in your scripts:

• Check for syntax errors.
• Run a script trace, which shows you what's happening as the script processes each action.

If you have Snippet actions in your script, you can debug the snippet code from within the Snippet editor window.

Verificar por erros de sintaxe

Ao verificar por erros de sintaxe, quaisquer problemas encontrados no seu script aparecem na guia Script Errors . A guia mostra todos os avisos e erros relacionados ao seu script, incluindo nos snippets. Os avisos não impedem que o seu script seja executado ou salvo, mas os erros impedem. A melhor prática é abordar todos os avisos antes de colocar o script em produção, mesmo que eles não impeçam o script de funcionar.

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 conseguirá executar ou salvar um script que contém erros. Se você tentar executar ou salvar um script com erros, o Studio exibirá uma janela de notificação. Você também pode verificar a Script Errors para mais informações. Os erros podem incluir problemas como:

• Variáveis digitadas incorretamente. Por exemplo: Snippet Line 2. Function: NameLabel has not been defined.
• Usar uma função como um parâmetro de método. Por exemplo: Unterminated function parameters.
• Usar um tipo de dado incorreto em uma função que requer um tipo de dado específico. Por exemplo: Unterminated function parameters.

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 problemas como JSON inválido na ação REST API. Se você tentar salvar quando o script contém um erro de validação, o script pode 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.

Clique duas vezes em qualquer aviso ou erro na guia Script Errors para ver a ação na tela em que o problema ocorre.

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

Rastreamentos do script

You can track the progress and performance of your script with the tool. This tool traces the contact through the script and displays the results of each action that fired, what variables are being set and when, and the values the variables held at each point. This is a helpful tool to test and debug your scripts. You can run traces on live interactions or simulated ones.

Você só pode executar um rastreamento se o script está salvo. Se tentar executar um rastreamento de script em um script com alterações não salvas, Studio solicita que você salve o script. Se você tiver erros no script, Studio não salvará o script. Você precisa solucionar os erros antes de poder salvar o script e executar o rastreamento. Any validation errors in the script cause Studio to revert to the last version of the script without the validation error. If you've started a trace, it runs, but will run on the last saved version of the script.

Usar a Janela Trace Output

When you run a trace, the output appears in the window. You can use this window to view the variables in the script and see how they change as the script progresses through each action Executa um processo dentro de um script do Studio, como coletar dados do cliente, reproduzir uma mensagem ou música ou rotear um contato para um agente..

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

   Ver imagem da janela Saída de rastreamento

   
   Saiba mais sobre os campos nesta etapa

   campo	Detalhes
   IBVoice	O nome do script. IBVoice é o nome do script nesta imagem de exemplo.
   Barra de ferramentas	Debaixo do nome do script está a barra de ferramentas da janela Trace Output . Esta barra de ferramentas contém opções que permitem que você: : Mude o layout da janela Trace Output , incluindo os paineis e guias que são visíveis. : Mude as variáveis visíveis na guia Variáveis, salve a lista de observação atual e salve o rastreamento atual em um arquivo do seu computador. : Crie e gerencie uma lista de variáveis que você quer assistir neste rastreamento. : Expandir ou minimizar todas as ações ou variáveis que contêm informações dentro. : Esta parte da barra de ferramentas mostra o ID de contato do contato atual. Ela também mostra o nome e o caminho do script sendo rastreado. Você não pode alterar a localização da barra de ferramentas.
   Propriedades	Ao selecionar uma ação no painel Script Details , o painel Properties mostra todas as propriedades da ação e suas configurações de definição. A localização padrão do painel Properties é no canto superior esquerdo da janela Trace Output abaixo da barra de ferramentas.
   Script Details	O painel Script Details mostra todas as ações que são acionadas à medida que o script é executado, na ordem em que são acionadas. Ele não inclui ações que são parte do script mas não são acionadas, como ações que são parte de um ramal que não foi tomado. Quando você clica em uma ação, todas as variáveis no script naquele ponto aparecem na guia Variables . A localização padrão do painel Detalhes do script é no canto superior direito da janela Trace Output abaixo da barra de ferramentas. Veja a tabela suspensa na etapa 2 para informações sobre os cabeçalhos das colunas neste painel.
   Guia Variables	Ao selecionar uma variável no painel Script Details , todas as variáveis atualmente no script aparecem nesta guia. A localização padrão da guia Variables é na parte inferior da janela Trace Output .
   Guia Watch List	Você pode criar uma lista de variáveis de script que você quer acompanhar à medida que o script é executado. As variáveis que você adiciona aparecem nesta guia. A localização padrão da guia Watch List  é na parte inferior da janela Trace Output .

2. No canto superior direito da janela Trace Output, clique em uma ação no painel de detalhes do script. Se estiver assistindo um rastreamento um tempo real, este painel é atualizado em tempo real à medida que o script avança e aciona cada ação.

   Saiba mais sobre os campos nesta etapa

   campo	Detalhes
   Script	O nome do script que contém a ação. Se um script principal gerar um subscript, você pode ver mais de um nome na lista.
   Time	A hora em que a ação foi acionada.
   Action	O nome da ação, incluindo os argumentos para cada uma. Os argumentos são todas as definições de configuração nas propriedades da ação.
   Result	O resultado após a ação ser acionada. Isso indica o que aconteceu como resultado de um script processando uma ação. Isso pode ser o ramal que o script tomou ou a ação que ocorreu como resultado da ação ser acionada. Por exemplo, na imagem de exemplo na etapa 1 desta seção, Default e Error são ramais. DirectJump to 4 e StartAt ONRELEASE são o resultado do acionamento dessas ações. DirectJump to 4 indica que o contato selecionou uma opção no menu RVI Menu de telefone automatizado que permite que os chamadores interajam por meio de comandos de voz, entradas de teclas ou ambos para obter informações, encaminhar uma chamada de voz de entrada ou ambos. que levou o script a pular para ação com o ID de ação 4. StartAt ONRELEASE indica que o script está atualmente em espera e reiniciará quando um agente responder à interação.

3. Clique nos ícones na barra de ferramentas no topo da janela Trace Output para expandir ou minimizar todos dos detalhes para as variáveis no painel 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 Variables na parte inferior da janela para avançar por todas as variáveis presentes no script quando a ação selecionada foi acionada.

   Saiba mais sobre os campos nesta etapa

   campo	Detalhes
   Name	O nome da variável. Variáveis com nomes que começam com dois caracteres sublinhados (__) são variáveis de sistema.
   Value	O valor da variável. Isto pode mudar à medida que o script avança de ação para ação.
   Type	O tipo de variável. As opções são Variable para variáveis padrão de valor único ou UCN.Data.Dynamic para objetos de dados dinâmicos.

5. Clique no ícone Tools e selecione uma opção para alterar quais variáveis são exibidas na guia Variables .

   Learn more about fields in this step

   Field	Details
   Show Global Variables in Subs	Select this option if you want global variables to appear in the Variables tab. This includes global variables that are set in this script or are set in another script and can be used in this script. For example, a subscript.
   Show System Variables	Select this option if you want pre-defined system variables to appear in the Variables tab. These are variables added to the script automatically by the system, including the actions in the script.
   Show Private Members	Select this option if you want private members to appear in the Variables tab.

6. No painel Properties , você pode ver as propriedades da ação selecionada e como elas estão configuradas.
7. Adicione variáveis à lista de observação caso queira acompanhar variáveis específicas durante o rastreamento.

Alterar a visibilidade de variáveis em um rastreamento

You can change which sets of variables show in a trace. This allows you to focus on specific kinds of variables, depending on what you're looking for in the trace.

1. No Studio, abra um script e execute um rastreamento.
2. Na barra de ferramentas da janela Trace Output , clique no ícone Tools .

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 verificação ao lado delas estão atualmente visíveis no rastreamento.

   Learn more about fields in this step

   Field	Details
   Show Global Variables in Subs	Select this option if you want global variables to appear in the Variables tab. This includes global variables that are set in this script or are set in another script and can be used in this script. For example, a subscript.
   Show System Variables	Select this option if you want pre-defined system variables to appear in the Variables tab. These are variables added to the script automatically by the system, including the actions in the script.
   Show Private Members	Select this option if you want private members to appear in the Variables tab.

Capturar um rastreamento do script

Você pode capturar um rastreamento em um script à medida que 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 escolher capturar um rastreamento na próxima instância quando o script é executado, ou você pode capturar um rastreamento contínuo. Um rastreamento contínuo captura todas as interações que um script processa. Ao capturar um rastreamento único, a informação resultante aparece na janela Trace Output .

1. No Studio, abra o script cujo rastreamento deseja capturar.
2. Clique em Debug > Capture Script > Next Instance.
3. Quando uma interação começa 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 contínuo do script

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

1. No Studio, abra o script cujo rastreamento deseja capturar.
2. Clique em Debug > Capture Script > Continuous. 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. No Studio, clique no menu Debug e selecione se quer carregar um arquivo de rastreamento localizado no seu sistema ou remotamente no seu 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 quiser baixar arquivos de rastreamento do CXone para o seu computador local, clique no ícone Tools na janela Trace Output e selecione Save Trace As.

Capturar um rastreamento com um ANI ou DNIS específico

Você pode definir um ANI Também conhecido como identificador de chamadas. Número de telefone listado de uma chamada de voz recebida. ou DNIS Identifica o número que o contato discou para falar com você nas chamadas de voz de entrada e o número que o agente ou sistema discou nas chamadas de voz de saída. específico 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 na lista suspensa Trace Script e selecione Trace when ANI is ou Trace when DNIS is.

   Ver imagem da lista suspensa script de rastreamento com a opção ANI selecionada

   
3. Digite o número ANI ou DNIS que você quer acionar o rastreamento no campo Insert <number>.
4. Clique no ícone Capture Next Instance . O número de vezes que você clica altera o comportamento.
   • Clique uma vez para rastrear a próxima instância do script sendo executado com o número especificado. O ícone fica vermelho.
   • Clique duas vezes para rastrear continuamente instâncias futuras do script sendo executado 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 é executado com o ANI ou DNIS especificado, um rastreamento é capturado e salvo em um arquivo.

Assistir variáveis em um rastreamento

Você pode criar uma lista de variáveis nas quais está particularmente interessado. A lista de observação permite que você acompanhe apenas essas variáveis sem ter que procurar por elas no rastreamento. Você pode salvar a lista para que, toda vez que executar um rastreamento naquele script particular, 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 rastreio inicial do script.
3. Na janela Trace Output , clique pela lista de ações no painel de detalhes do script. As variáveis associadas a cada ação aparecem na guia Variables .
4. Para cada variável que quer adicionar à lista de observação:
   1. Selecione a variável na guia Variables .
   2. Clique no ícone Add to Watch List .
5. Você pode adicionar uma variável manualmente se souber seu nome:
   1. Na barra de ferramentas da janela Trace Output , clique no ícone de sinal de adição. A guia Watch List aparece com um campo para uma nova variável.
   2. Digite o nome da variável que deseja assistir e aperte Enter.
6. Se você deseja remover uma variável da lista de observação, selecione-a na guia Watch List e clique no ícone de sinal negativo na barra de ferramentas na janela Trace Output .
7. Para salvar esta lista de observação, clique no ícone Tools na barra de ferramentas da janela Trace Output e selecione Save Watch List. A lista é salva no Studio. Toda vez que você executar um rastreamento neste script, a lista de observação será carregada na janela Trace Output .
8. Quando estiver pronto para assistir as variáveis na sua lista de observação, execute um novo rastreamento no seu script.