Expressões
As informações desta página de ajuda se aplicam tanto a Studio quanto a Desktop Studio.
Uma expressão é qualquer coisa no seu script que compara um valor ou resulta em um valor. Por exemplo,
Qualquer um dos exemplos anteriores também poderiam ser instruções de atribuição. Uma instrução de atribuição atribui o valor do lado direito do sinal de igual à variável no lado esquerdo. Atribuições de variável não são expressões.
Expressões podem ser usadas para:
- Efetuar cálculos matemáticos ou algébricos.
- Comparar dois valores e tomar uma ação com base no resultado da comparação.
- Tomar decisões lógicas dependendo se uma expressão é avaliada como true ou false.
Os valores comparados em uma expressão podem ser compostos por letras, números ou uma combinação de ambos. Eles também podem incluir variáveis. Em Studio, existem três tipos de expressões, numérica, string e Booleana.
Tente Agora
Baixe o script de exemplos de expressão e importe-o para Studio. Os exemplos desta página de ajuda estão disponíveis em ações
Expressões NUMÉRICAS
Expressões numéricas incluem apenas numerais e operadores matemáticos ou booleanos, como +, -, e assim por diante. Elas também podem incluir referências de variáveis, se as variáveis contiverem valores numéricos usados nos cálculos.
As expressões numéricas são usadas em snippets e para configurar as propriedades das ações de Studio. Por exemplo, na ação IF, você configura a propriedade Expression com uma expressão a ser avaliada como o mecanismo de tomada de decisão da ação. Você pode fazer a mesma coisa em um Snippet usando a palavra-chave
Sintaxe de expressão NUMÉRICA
Um tipo de dados que tem dois valores possíveis: verdadeiro e falso.. Se você colocar uma expressão NUMÉRICA entre aspas, ela será tratada como texto. Por exemplo, c1 = 123 + 456 é avaliado como 579, mas
c2 = "123 + 456" resulta em 123 + 456.
Não coloque entre chaves e aspas duplas as variáveis usadas em expressões numéricas. Isso resulta em um erro no seu script.
Avaliação de expressões numéricas
Em uma expressão numérica, se o script puder avaliar valores numéricos como números, ele o fará. Isso significa que:
- Tudo que não puder ser avaliado como um valor numérico, como letras ou uma palavra, é considerado uma referência de variável.
- Se os caracteres não numéricos na expressão forem uma variável no script com um valor de string, o script ignorará os caracteres não numéricos e avaliará a porção NUMÉRICA da expressão original.
- Se os caracteres não numéricos na expressão forem uma variável com um valor numérico, o script incluirá tal valor na avaliação da expressão.
- Se os caracteres não numéricos na expressão não forem uma variável no script, o script ignorará esses caracteres na expressão original.
No exemplo seguinte, o script tenta avaliar nextNum como uma variável pois ela não pode ser avaliada como um número: c1 = 123 + 456 + nextNum. Os exemplos a seguir mostram o resultado de três situações dependendo se nextNum é uma variável e qual é o seu valor.
Quando nextNum é uma variável com um valor de string, o resultado é c1 = 579:
ASSIGN nextNum = "my string"
ASSIGN c2 = 123 + 456 + nextNum
When nextNum é uma variável com um valor numérico, o resultado é c2 = 1368:
ASSIGN nextNum = 789
ASSIGN c3 = 123 + 456 + nextNum
Quando nextNum não for uma variável, o resultado é c3 = 579:
ASSIGN c3 = 123 + 456 + nextNum
Se você avaliar uma expressão que inclua duas variáveis que contenham números tratados como valores de string, o script converterá os valores em números e os avaliará de acordo. O resultado do exemplo a seguir é c4 = 50:
ASSIGN nextNum = "20"
ASSIGN otherNum = "30"
ASSIGN c4 = nextNum + otherNum
Você pode incluir expressões NUMÉRICAS em valores de string colocando a expressão entre chaves. Por exemplo:
ASSIGN nextNum = 6
ASSIGN otherNum = 7
ASSIGN c5 = "There are {nextNum + otherNum} fish in the aquarium."
Números com zeros à frente
Há uma diferença na forma como o Studio trata os números quando eles são tratados como strings em comparação a quando são tratados como números. Quando números estão sendo tratados como uma string, eles podem ter zeros à esquerda. Se você somar duas variáveis que contêm valores de string numérico com zeros à esquerda, os zeros à esquerda serão removidos. Por exemplo, o resultado da expressão a seguir é c6=59:
ASSIGN nextNum = "00020"
ASSIGN otherNum = "000039"
ASSIGN c6 = nextNum+otherNum
Se você precisar que o valor resultante tenha zeros à esquerda, poderá usar a
Expressões de string
As expressões de comando incluem caracteres alfanuméricos e especiais, como #, @, e assim por diante. A sintaxe para expressões de string é semelhante à sintaxe para atribuir valores de string às variáveis:
- Nos snippets, valores de string para expressões devem sempre ser colocados entre aspas simples ou duplas. Isso é o mesmo para valores de string
- Para fazer a substituição de variável em expressões de cadeia de caracteres, coloque o nome da variável entre chaves.
- Alguns caracteres, como as aspas duplas, são considerados código. Para incluir esses caracteres em valores de cadeia de caracteres, você deve usar sequências de escape.
Comparações de cadeias de caracteres
Strings podem ser avaliadas como valores em expressões booleanas. Por exemplo, você pode usar a seguinte expressão em uma instrução
customer = "Grendel Cainson"
Quando customer contém o valor exato Grendel Cainson, o resultado é true. Para qualquer outro valor, o resultado é false.
Você pode usar operadores de maior que e menor que em comparações de strings. Neste tipo de comparação, cada caractere de letra tem um valor atribuído (A = 1 and Z = 26). O script começa comparando o primeiro caractere. Se eles forem diferentes, aquele que começa com uma letra posterior na ordem alfabética será considerado maior. Por exemplo, na comparação apple > banana, o resultado será false. Isso ocorre porque
Se os primeiros caracteres forem os mesmos, o script compara os segundos caracteres. Se eles forem diferentes, a comparação termina. Se os segundos caracteres forem os mesmos, o script continua comparando caracteres até que alcance um par que seja diferente. Por exemplo, na comparação de grapes > grapey, o script compara cada caractere até chegar ao final. O resultado é false, porque
Nas comparações maior ou igual a ou menor ou igual a, aplicam-se as mesmas regras. Se os scripts percebem que a string no lado esquerdo do operador é a mesma que a string no lado direito, a expressão é avaliada como true.
Comparações de string diferenciam maiúsculas de minúsculas.
Sequências de escape em strings
Studio suporta sequências de escape dentro de constantes de string. sequências de escape permitem que você inclua determinados caracteres especiais em uma cadeia de Caracteres. caracteres como aspas duplas ou uma chave de abertura são reconhecidos como código. Quando são incluídos em uma string, o compilador os interpreta com o significado do código não literal, em vez de seu valor literal. As sequências de escape permitem incluir esses caracteres em strings.Se você incluir esses caracteres em strings sem uma sequência de escape, a saída não será o que você espera, e um erro poderá ocorrer.
Não é preciso adicionar sequências de escape a strings que contêm XML ou JSON convertido. sequências de escape são automaticamente adicionadas para caracteres que precisam delas.
Prefix any string where you use an escape sequence with a dollar sign ($): $"...". Within the double quotes, you can use any of the following escape sequences:
| Sequência | Detalhes |
|---|---|
|
|
Incorpore uma citação dupla. |
|
|
Incorpore uma única citação. |
|
|
Incorpore uma tab (ASCII 9). |
|
|
Incorpore um retorno de carro (ASCII 13). |
|
|
Incorpore um avanço de linha (ASCII 10). |
|
|
Incorpore um backspace (ASCII 8). |
|
|
Incorpore uma chave aberta. Você só precisa escapar a chave de fechamento se não houver uma chave aberta escapada no texto antes dela. Se você precisar escapar uma chave de fechamento, ela ficará assim: |
|
|
Incorpore um nulo (0 é um zero). |
O exemplo a seguir usa a sequência de escape \n para adicionar um avanço de linha à string. Isso move o cursor para a próxima linha sem retornar ao início da linha.
x = $"A phrase\nAnd a new line"
Quando a string é impressa, a saída tem esta aparência:
Uma frase
E uma nova line ]
No exemplo anterior, o colchete quadrado de fechamento representa o cursor.
O exemplo a seguir usa a sequência de escape \" para incluir aspas duplas na string:
y = $"Embedding \"double quotes\" in a string."
Quando a string é imprimida, ela tem este aspecto: Incorporando "aspas duplas" em uma string. Sem a sequência de escape, o script reconheceria a string somente até o símbolo de aspas duplas antes da palavra double.
O exemplo a seguir usa a sequência de escape \{ para incluir chaves literais na string:
z = $"Using \{curly} braces."
Quando a string é imprimida, ela tem este aspecto: Usando chaves {curly}. Sem a sequência de escape, o script teria interpretado
Expressões booleanas
Studio oferece suporte para o uso de expressões Booleanas
Um tipo de dados que tem dois valores possíveis: verdadeiro e falso.. Elas podem ser usadas para criar lógica tomadora de decisão no seu script. Como expressões booleanas podem ser avaliadas ou como true ou como false, você pode usá-las para criar condições que precisam ser atendidas para decidir qual caminho tomar. Se a condição é atendida, o script toma aquele ramal, mas se não for atendida o script toma o outro ramal.
Há vários operadores que você pode usar em expressões booleanas. Isso permite definir uma instrução de condição lógica que atende às necessidades do seu script. Por exemplo, você pode verificar se um valor é igual a outro usando o sinal de igual (=) ou pode verificar se um valor é maior que outro usando o operador maior que (>).
Você pode usar expressões booleanas com ações como If e Snippet. Diversas instruções que você pode usar em snippets utilizam expressões booleanas como mecanismo de tomada de decisão, incluindo:
- IF
- IF ... ELSE
- SELECT
O exemplo a seguir mostra o uso de uma expressão booleana com uma instrução
ASSIGN var1 = "Cat"
IF var1 = "Dog"
{
ASSIGN dogWasFound = true
}
ELSE
{
ASSIGN dogWasFound = false
}
Expressões booleanas também podem ser usadas em scripts com Actions. A imagem a seguir mostra a mesma instrução
Valores booleanos para ativar ou desativar Configurações
Valores booleanos às vezes são usados em Scripts para ativar ou desativar configurações em NiCE CXone. Nesses casos, você atribui um valor booleano a uma variável. Para ativar uma configuração, atribua o valor true ou 1. Para desativar uma configuração, atribua o valor false ou 0.
Ambas as palavras e números são valores booleanos válidos. No entanto, consulte a ajuda online da ação Studio que está usando para saber se há um valor preferencial para as propriedades da ação. De toda forma, o valor que você usa não deve ser colocado entre aspas. Se você colocar o valor entre aspas, o script o trata como uma cadeia de caracteres literal em vez de um valor booliano.
Operadores
Um operador é um símbolo que representa uma operação matemática ou uma comparação. Símbolos como +, - e = são operadores. Operadores booleanos comparam duas expressões e resultam em uma resposta verdadeiro/falso. O snippet suporta tanto operadores matemáticos quanto booleanos.
Além dos operadores matemáticos normais de multiplicação, divisão, adição e subtração, você também pode usar estes operadores:
- Operador de módulo (%)
- Potência/expoente (^)
- Inteiro divide (\)
- Exclusivo OU (~)
A ordem matemática regular de operações se aplica a todas as expressões. Qualquer coisa entre parêntesis é avaliada primeiro como uma subunidade. Operadores de expoente/potência são avaliados em segundo lugar. A multiplicação e a divisão são avaliadas em seguida, depois a adição e a subtração. Os operadores de comparação são os últimos a serem avaliados, depois que todas as operações matemáticas tiverem sido concluídas.
Operadores Booleanos
You can use the following Boolean operators in snippets. All of these operators can be used with
| SÍMBOLO do Operador | NOME DO OPERADOR | Detalhes |
|---|---|---|
| = | Igual | Se os dois lados da expressão forem equivalentes, a expressão resulta em |
| != | Diferente de | Se os dois lados da expressão não forem equivalentes, a expressão será avaliada como |
| > | Maior que |
Se o lado direito da expressão for menor do que o esquerdo, a expressão resulta em |
| >= | Maior que ou igual |
Se o lado direito da expressão for menor do que ou igual ao lado esquerdo, a expressão resulta em |
| < | Menor que |
Se o lado esquerdo da expressão for menor do que o direito, a expressão resulta em |
| <= | Menor ou igual |
Se o lado esquerdo da expressão for menor do que ou igual ao direito, a expressão resulta em |
| & | e | Se todas as subexpressões forem avaliadas como verdadeiras, a expressão inteira resultará em |
| | | ou | Se qualquer uma das subexpressões for avaliada como verdadeira, a expressão resulta em |
Sinais de igual em expressões
O operador sinal de igual (=) significa coisas diferentes dependendo do tipo de expressão com que está trabalhando.
As expressões usadas em instruções de atribuição atribuem uma expressão para ser o valor de uma variável. O sinal de igual usado nessas instruções representa a atribuição do valor do lado direito da expressão à variável no lado esquerdo.
Em outras expressões, o sinal de igual indica avaliação de igualdade. Por exemplo, na expressão algébrica x = 3 * (5 + 10), o sinal de igual significa que x representa o valor resultante da expressão algébrica 3 * (5 + 10). Nesse caso, x = 45. Você pode usar essa expressão algébrica em uma instrução de atribuição para atribuir o valor da expressão a uma variável x. No entanto, se a mesma expressão fosse usada como um booleano, ela seria avaliada como verdadeira ou falsa dependendo do valor de x.
Expressões booleanas são comumente usadas em scripts do Studio. Se usar um sinal de igual como o operador nessas expressões, ele comparará o valor do lado esquerdo do sinal de igual ao valor do lado direito para determinar se há igualdade. Se for necessário alterar o valor de uma variável usada em uma expressão booleana, use uma ação ASSIGN ou uma instrução ASSIGN em uma ação Snippet.