Referência Técnica Guide

As informações desta página de ajuda se aplicam tanto a Studio quanto a Desktop Studio.

Esta seção fornece informações de referência técnica detalhadas sobre a criação de scripts em Studio. As informações são geralmente aplicáveis à criação de scripts com ações e em snippets com código personalizado. Em alguns casos, as informações se aplicam somente a um método de criação de scripts ou ao outro.

As informações contidas nesta página resumem os conceitos fundamentais de script que você precisa conhecer ao criar scripts com Studio. mais informações detalhadas estão disponíveis nas outras páginas desta seção.

Estrutura de script e Snippet

Studio scripts podem estar contidos em um único arquivo ou ser compostos por um script principal e um ou mais subscripts em arquivos separados. A cada script, deve-se:

  • Inicie com uma ação Begin. Os subscripts também devem ser iniciados com uma ação Begin.
  • Termine com uma ação de encerramento , como End. Subscripts terminam com Return, uma ação que retorna o fluxo do script para o script principal.
  • Ter um tipo DE mídia definido.

Dentro do script, a estrutura segue o fluxo exigido pelos comportamentos que você precisa que o script forneça. Você pode organizar e dispor o fluxo de ações no seu script da maneira que funcionar melhor para você. Por exemplo, você pode fazer com que o fluxo vá da direita para a esquerda ou da esquerda para a direita. Da mesma forma, ele pode ir de cima para baixo.

Algumas observações sobre a estrutura de scripts:

  • Use as condições de ramificação para criar ramificações no seu script. Isso permite que você cubra os muitos resultados, variações ou situações possíveis que podem ocorrer em qualquer ponto específico durante o script. Você pode usar ramificações para tratamento de erros, para as opções em um menu de RviClosed Resposta de Voz Interativa. Menu de telefone automatizado que os contatos usam por meio de entradas de voz ou de teclas para obter informações, rotear uma chamada de voz de entrada, ou ambos., ou para os caminhos verdadeiro/falso baseados em uma ação IF.
  • Algumas ações têm várias condições de ramal disponíveis. Não é preciso conectá-los todas as vezes. No entanto, é importante que você sempre conecte a ramificação Default. Esse é o ramal que o script toma se nenhuma das outras condições for aplicável. Isso pode evitar que os contatos fiquem travados nesse ponto do script se algo inesperado acontecer.
  • As ações do evento não estão conectadas às ações que acionam o evento. Elas começam uma nova seção no mesmo arquivo de script. As novas seções podem estar localizadas em qualquer lugar no arquivo script. Se houver várias ações de evento no seu script, é uma boa prática mantê-las organizadas de uma forma que facilite localizá-las posteriormente.

Snippets não possuem requisitos para estrutura a não ser os limites da ordem lógica das instruções. Eles podem conter uma única instrução ASSIGN ou uma lógica de script complexo composta por uma série de instruções e blocos aninhados. Caso precise criar funções personalizadas, você deverá usar snippets.

Você pode usar os Snippets para mais do que apenas armazenar código personalizado. Você pode usá-los para consolidar atribuições de variáveis em menos localizações. Em vez de usar uma ação ASSIGN cada vez que precisar adicionar uma variável, você pode colocar múltiplas declaration statements em uma única ação Snippet.

Há algumas coisas que você pode fazer para tornar os seus scripts mais fáceis de ler.Isso pode ajudar outros escritores de script que possam precisar trabalhar com o script posteriormente. Você pode:

  • Altere a propriedade Adicionar legenda de cada ação. O conteúdo desta propriedade aparece na tela da área de trabalho do script. Você pode adicionar uma palavra ou frase curta que ajude a identificar o que cada ação faz. Por exemplo, você pode querer indicar a competência que cada ação usa, o arquivo de música que ela reproduz ou o que o código Snippet faz.
  • Use as ações Annotation e Note para fornecer documentação adicional em seu script. Nas ações Snippet, você pode adicionar comentários.
  • Siga as outras práticas recomendadas para scripts em Studio.

Sintaxe

Assim como todas as linguagens de programação, Snippet tem regras de sintaxe que devem ser seguidas. Cada página de ajuda na seção de referência tem uma seção sobre sintaxe que aborda as regras para esse elemento do idioma. É possível saber sobre as regras de sintaxe para:

As regras de sintaxe são descritas com resumos de sintaxe. Os resumos utilizam determinadas convenções para distinguir entre elementos opcionais e obrigatórios. Saiba mais sobre essas convenções na página de ajuda Statements.

Tipos de dados

Os tipos de dados descrevem como os dados são representados e os tipos de operações que podem ser realizadas com os dados. Muitas linguagens de programação suportam muitos tipos de dados que fazem distinção entre diferentes tipos de representações numéricas e alfanuméricas. Studio não faz essas distinções. Em Studio, os valores são de um dos seguintes tipos:

  • String: O valor da variável contém caracteres alfanuméricos e especiais, como pontos, vírgulas e sublinhados. Os valores de string devem ser colocados entre aspas duplas.
  • numérico: O valor da variável é um número. Os valores Numéricos não precisam de aspas duplas.
  • Data/hora: O valor da variável é uma data, hora ou ambos. Quando um valor de data/hora é usado com funções de data/hora em Studio, o valor deve ser colocado entre aspas e precedido por um sinal de cerquilha fora das aspas: var = #"11-23-2022".
  • Booleano: O valor da variável é true ou 1, ou false ou 0. Não coloque valores booleanos entre aspas.

Não é necessário declarar tipos de dados ao criar variáveis, como ocorre em algumas linguagens de programação. Em Studio, as variáveis são tipadas implicitamente. Isso significa que o tipo é determinado automaticamente quando o script é compilado.

Os tipos de dados são parte integrante da criação de scripts. Você pode saber mais sobre tipos de dados em scripts do Studio nas páginas de ajuda sobre estruturas de dados, expressões e variáveis. Se você trabalha com funções, precisa saber os tipos de dados que está usando no script. Você também precisa saber o que a função que está usando espera e como a saída pode variar dependendo do tipo com que ela é usada.

Estruturas de dados: Variáveis, Matrizes e Objetos

Estruturas de dados permitem que você armazene dados para usar no seu script. É possível recuperar os dados da estrutura de dados quando necessário, ou substituí-los com outros dados. Em outras linguagens de programação, pode haver muitos tipos de estruturas de dados e eles podem ser muito complexos. Em Studio, existem somente três tipos de estruturas de dados:

É possível criar qualquer uma dessas estruturas de dados declarando-as com uma instrução de declaração.

Expressões

Uma expressão é qualquer coisa no seu script que compara um valor ou resulta em um valor. Todas a seguir são exemplos de expressões:

  • x = 3(5+10)

  • y = 123 North Street
  • x != 5

Existem diferentes tipos de expressões, incluindo string, numérico e BooleanoClosed Um tipo de dados que tem dois valores possíveis: verdadeiro e falso.. As expressões têm muitas utilizações em scripts de Studio. Elas são usadas para:

Operadores

Operadores são símbolos matemáticos que indicam qual operação matemática ou algébrica deve ocorrer com os números. Studio oferece suporte a todos os operadores matemáticos padrão e alguns algébricos. Ele também oferece suporte a operadores BooleanosClosed Um tipo de dados que tem dois valores possíveis: verdadeiro e falso., que são usados em expressões booleanas.Estas são expressões que são avaliadas como true ou false. Você pode usar booleanos em algumas instruções para criar um mecanismo de tomada de decisão em seu script.

Instruções

Instruções definem as ações que um script toma quando é executado. Isso inclui criar variáveis, atribuir novos valores, realizar cálculos e fazer escolhas lógicas com base em uma condição determinada. Algumas instruções apenas executam uma tarefa, como atribuir um valor a uma variável. outras instruções afetam o fluxo do script. A instrução é executada em uma ordem lógica, mas essa ordem pode mudar a cada execução do script.

Ao criar script com ações, você normalmente não precisa pensar em termo de instruções. Dentro de snippets, você pode usar os seguintes tipos de instruções:

  • Declaração: Use instruções de declaração para declarar, ou criar, novas variáveis, objetos e funções.
  • Tomada de decisão: Use instruções de tomada de decisão para que o código snippet selecione uma tarefa para ser executada com base nas condições que você especifica. Você pode usá-los para controlar o fluxo linear do que acontece no script.
  • Looping: Use instruções de looping para que o snippet execute uma tarefa ou um conjunto de tarefas repetidamente até que a condição de encerramento especificada seja atendida.
  • Outro: Estas instruções permitem encerrar funções, exibir resultados na janela Snippet editor durante a depuração e incluir DLLs de proxy de serviço da web em seus snippets.

Algumas das instruções têm ações Studio que fazem a mesma coisa. Por exemplo, as ações ASSIGN e IF fazem a mesma coisa que as instruções ASSIGN e IF que você pode usar em snippets. Para muitas das instruções, a única opção para usá-las é em snippets.

Palavras reservadas

Studio tem algumas palavras reservadas que não estão disponíveis para uso como nomes de variáveis e outras entidades em Scripts. Palavras reservadas incluem os nomes de:

Caso use uma palavra reservada como o nome de uma entidade no seu script, ocorrerá um erro. Será preciso renomear a entidade para corrigir o erro.

Comentários

Comentários permitem que você documente algo no seu script ou snippet. Você pode usá-los para deixar uma nota para você mesmo ou para um futuro desenvolvedor de script, ou para explicar o propósito de algo no script.

Em Studio Scripts, você pode adicionar comentários com a ação Note ou a ação Annotation. Ambas as ações permitem que você adicione um comentário à tela do script. A ação Anotação coloca o comentário visivelmente na área de trabalho. Para ler o comentário em uma ação Note, você deve dar duplo clique na ação.

Em snippets, é possível adicionar comentários colocando duas barras para frente ( // ). Os comentários podem ser colocados em linhas próprias ou no final de uma instrução.

Você também pode usar comentários em trechos de código para ocultar linhas de código que não deseja que façam parte do script quando ele for executado. Isso é útil para solucionar problemas.

Funçoes

Funções são uma forma de criar código que você quer reutilizar. Você pode criar suas próprias funções e, em seguida, chamá-las em outro lugar do script quando quiser usar o código que a função contém. O Studio também possui algumas funções integradas que você pode usar sem precisar declará-las no script.

Manuseio de comando

Nos trechos, você pode fazer muitas coisas com strings usando funções integradas:

  • Concatená-las
  • Dividi-las em substrings
  • Buscá-las
  • Substituir parte do conteúdo
  • Compare-as
  • Alterar suas letras de maiúsculas para minúsculas e vice versa.

Em alguns casos, pode ser necessário especificar a formatação de strings que envolvam datas, horas ou números. Você pode usar os especificadores de formato designados para definir o formato que quer que o script use.Também é possível usar algumas das funções incorporadas para converter strings para formatos diferentes.

Há determinados caracteres que você não pode incluir em cadeias de caracteres sem usar uma sequência de escape. Como as cadeias de caracteres devem ser colocadas entre aspas simples ou duplas, se você incluir uma aspa simples ou dupla literal em uma cadeia de caracteres, o script a interpretará como o início ou o fim de uma cadeia de caracteres. A sequência de escape informa ao script que o caractere deve ser interpretado como um literal, e não como o símbolo padrão que ele representa. Outros caracteres que requerem sequências de escape são tabs, backspaces e chaves abertas.