Variables

Las variables SOn marcadores de posición que almacenan valores que pueden cambiar. Úselas cuando sea diferente un valor cada vez que se ejecute el script. Por ejemplo, ANI es una variable que contiene el ANI, o número DE teléfono, de la persona que llama Also known as caller ID. Listed phone number of an incoming voice call.. Cuando se usa ANI en un script, contiene la identificación de llamada del contacto. Cada vez que se ejecuta el script, maneja un contacto diferente, por lo que el valor de ANI cambia.

Puede crear sus propios variables en cualquier momento que necesite una. Las variables pueden contener valores individuales. También pueden contener objetos dinámicos de datos y arreglos.

Algunas variables utilizadas en Studio los scripts están definidos por el sistema. Esto significa que forman parte del código dentro de las Studio acciones Performs a process within a Studio script, such as collecting customer data or playing music. para que no tenga que crearlas. Hay DOs tipos de variables definidas por el sistema:

• Variables reservadas: variables de Solo lectura que puede usar cuando necesite incluir un tipo específico de información en su script.
• Variables predefinidas: variables que ya están definidas. Se pueden escribir, por lo que puede asignarles un valor.

Inténtelo

Descargue el script de ejemplos de Variable e impórtelo en Studio. Los ejemplos de esta página de ayuda están disponibles en las acciones de Snippet en el script de ejemplo. Puede abrir la ventana del editor de Snippet y ejecutar el depurador para ver cómo funciona cada ejemplo.

Resumen de la sintaxis de Variable

La siguiente lista resume la sintaxis de las variables. Encontrará más información sobre estos puntos en otras secciones de esta página.

• Cree y asigne un valor a una variable mediante una acción ASSIGN o una acción Snippet. En un Snippet, puede usar la palabra clave ASSIGN al declarar una variable. Es opcional, pero se recomienda ampliamente consultar highly recommended. Use esta sintaxis en un Snippet: ASSIGN <var name> = <var value> o <var name> = <var value>.

• When assigning values to a variable: 
  • Los valores de cadena y de fecha/hora deben estar encerrados entre comillas simples o dobles. Por ejemplo: ASSIGN life = "forty-two"
  • Para asignar un valor de fecha/hora que se utilizará con las funciones de fecha/hora, coloque un signo de almohadilla ( # ) delante del valor, pero fuera de las comillas dobles. Por ejemplo: ASSIGN var = #"02/09/2023" Si no se utilizará el valor de fecha/hora con las funciones de fecha/hora, no es necesario utilizar el carácter de gato. Sin embargo, sin el signo de número, el valor es de tipo cadena, no de tipo fecha/hora.
  • Los valores numéricos no necesitan estar entre comillas. Si encierra un valor numérico entre comillas, se trata como una cadena a menos que se esté evaluando en una expresión matemática.
  • Las expresiones numéricas y booleanas A data type that has two possible values: true and false. no se pueden encerrar entre comillas. Si se ponen estas expresiones entre comillas, se les trata como una cadena. Por ejemplo: ASSIGN myVar = var2 > 42 se evalúa como verdadero o falso según el valor de var2. Sin embargo, ASSIGN myVar = "var2 > 42" da como resultado que el valor de myVar sea literalmente var2 > 42.
  • Los valores booleanos no deben ir entre comillas.
  • Use secuencias de escape si necesita incluir los siguientes caracteres en un valor de cadena: comillas dobles ( " ), comilla simple ( ' ), llave de apertura ( ), tabulación (ASCII 9), retorno de carro (ASCII 13), avance de línea (ASCII 10), retroceso (ASCII 8), nulo.
• When substituting a variable's value in a string: 
  • Incluya las variables entre llaves. Por ejemplo: ASSIGN myVar = "the meaning of life is {life}"
  • Si la variable es un objeto de datos dinámicos, debe hacer referencia a una propiedad dentro del objeto. Por ejemplo: ASSIGN myVar = "the meaning of life is {anObj.thisProperty}". Hacer referencia únicamente al objeto generará un error.
  • Si la variable contiene una matriz, debe incluir el índice del valor que desea asignar. Por ejemplo: ASSIGN myVar = myArray[4].
• When assigning the value of one variable to another:
  • No necesita comillas dobles ni llaves. Por ejemplo: ASSIGN myVar = var2. Esto da como resultado que se asigne a myVar una copia del valor de la variable.
  • Si una Variable contiene una matriz, puede asignarla a otra Variable.
  • Si una variable es un objeto, solo puede asignarla a otro objeto.

• Cuando haga referencia a las variables en las propiedades de la acción Studio, generalmente se aplicarán los siguientes lineamientos. Siempre consulte la página de ayuda en línea correspondiente a la acción que esté utilizando, ya que existen excepciones a estas afirmaciones.

  • Las propiedades esperan una variable o datos. Los datos pueden consistir en literales o variables. Cuando una propiedad espera datos, generalmente puede aceptar un literal o una variable. Sin embargo, existen excepciones, así que consulte siempre la ayuda en línea para la acción si no está seguro de qué espera una propiedad.

  • Si la propiedad espera un nombre de variable, ingrese el nombre de la variable sin llaves.

  • Si la propiedad espera datos y desea utilizar la sustitución de variables, incluya el nombre de la variable entre llaves: {varName}.

Tipos de datos y tipado implícito

Los tipos de datos definen qué tipo de datos contiene una variable y cómo debe utilizarse en el programa. En Studio, las variables pueden tener los siguientes tipos de datos:

• Cadena: El valor de la variable contiene caracteres alfanuméricos y especiales, como puntos, comas y guiones bajos. Los valores en cadenas deben estar entre comillas dobles.
• Numérico: El valor de la variable es un número. Los valores Numéricos no necesitan comillas dobles.
• Fecha/hora: El valor de la variable es una fecha, hora o ambas. When a date/time value is used with funciones de fecha/hora en Studio, el valor debe estar entre comillas y debe estar precedido por un signo de número fuera de las comillas: var = #"11-23-2022".
• Booleano: El valor de la variable es true o 1, o false o 0. No encierre los valores booleanos entre comillas.

En muchos lenguajes de programación y de scripts, debe asignar explícitamente un tipo de datos a una variable cuando la crea. En Studio, las variables se escriben de manera implícita. El compilador de Studio determina el tipo de cada Variable cuando compila el script. Esto significa que no es necesario definir el tipo de datos para ninguna de las variables que utilice. La única excepción es cuando una variable contiene un valor de fecha/hora que desee usar con funciones de fecha/hora.

Inferencia de tipo

La escritura implícita afecta la forma en que se evalúan las variables. Por ejemplo, las comparaciones de variables tienen diferentes resultados según el tipo Studio con el que reconoce las variables. El comportamiento predeterminado en Studio es que todo se trate como una cadena hasta que se requieran cálculos matemáticos. Por lo tanto, si puede evaluarse algo como un número, lo será, incluso si está entre comillas. Esto se conoce como inferencia de tipo.

El compilador de Studio reconoce un valor como numérico incluso si está entre comillas. Las comillas significan que un valor es una cadena. Cuando un valor numérico está entre comillas, Studio lo trata como una cadena a menos que lo utilice en cálculos matemáticos en el script. Por ejemplo:

var1 = "42"
var2 = 42

var3 = var2 + var1	

El resultado del ejemplo es var3 = 84. Studio infiere que el valor de var1 es numérico y lo trata como tal al evaluar la expresión en var3, aunque esté encerrado entre comillas dobles.

Crear variables

Puede crear sus propias variables para usar en scripts. Puede hacer esto usando una acción Assign o una acción Snippet en el script.

Asignar Acción

La acción Assign le permite crear una única variable y asignarle un valor. Esto se realiza mediante las propiedades Variable y Value de la acción. La ventaja de Assign es que ofrece una forma fácil de usar y configurable para crear variables.

Esta acción tiene otras propiedades que le permiten definir la manera en que se utiliza la variable. Ahora es posible:

• Haga que el valor de la variable se incluya en el screen pop asignado en el nivel de habilidad Used to automate delivery of interactions based on agent skills, abilities, and knowledge. ACD.
• Hacer que el valor de la variable se guarde en la base de datos.

Acción de Snippet

La acción Snippet es una forma basada en código para crear variables. Con una sola acción, puede crear una o más variables, además de cualquier otro código personalizado que necesite incluir. La ventaja de usar Snippet es que, si desea agregar más variables a su script más adelante, puede agregarlas a la misma acción. No necesita agregar más acciones ni rehacer los conectores en su script, como tendría que hacer si originalmente hubiera usado una acción Assign.

Utilice cualquiera de los siguientes formatos de sintaxis:

ASSIGN varName = value o varName = value

Puede agregar propiedades a la variable que coincidan con las propiedades en la acción Assign:

• Para que el valor de la variable se incluya en un screen pop, agregue setscreenpop(1) al nombre DE variable.
• Para que el valor de la variable se guarde en la base de datos, agregue savetodb(1) al nombre de la variable.

Por ejemplo:

ASSIGN epicPoem = "Beowulf"
epicPoem.setscreenpop(1)
epicPoem.savetodb(1)

En ambas propiedades, el 1 es un valor booleano A data type that has two possible values: true and false. que establece la propiedad en true.

Datos clave sobre la creación de variables en las acciones de Snippet :

• No es necesario declarar el tipo cuando declara una variable, excepto para las variables de fecha/hora.
• Usar la palabra clave ASSIGN es opcional. Sin embargo, es una mejor práctica utilizar esta palabra clave cada vez que cree una variable.
• Si declara una Variable en un subscript y desea que se devuelva al script de origen, agregue global: al principio del nombre DE variable. Esto lo denota como global en alcance.

Comillas simples, comillas dobles o sin comillas

Al asignar el valor de una variable a otra, algunos valores deben estar entre comillas. Los demás valores no necesitan comillas. Seguir estas pautas:

• Los valores en las cadenas deben estar entre comillas simples o dobles. Esto es verdadero incluso si el nombre DE variable termina en un signo de dólar. Si no está entre comillas una cadena, el script asume que el valor es una variable. En el siguiente ejemplo, a1, a2 y a1$ se evalúan como el valor literal Example. El valor de a3 y a3$ depende de si Example se ha declarado como una variable. Si existe una variable Example en el script, a3 y a3$ evalúan al valor de Example. Si Example no existe, a3 y a3$ dan como resultado valores vacíos.

  ASSIGN a1 = "Example"
  ASSIGN a2 = 'Example'
  ASSIGN a1$ = "Example"
  ASSIGN a3 = Example
  ASSIGN a3$ = Example

• Los valores numéricos no requieren comillas. Pero puede usarlas si lo desea. En el ejemplo siguiente, b1, b2 y b3 evalúan a 123.

  ASSIGN b1 = "123" 
  ASSIGN b2 = '123' 
  ASSIGN b3 = 123

• Expresiones NUMÉRICAS no pueden estar encerradas entre comillas. Esto incluye expresiones matemáticas y booleanas A data type that has two possible values: true and false.. Si encierra una expresión NUMÉRICA entre comillas, se trata como texto. Por ejemplo, c1 = 123 + 456 se evalúa como 579, pero c2 = "123 + 456" genera 123 + 456.
• Los valores de fecha/hora deben estar entre comillas si los declara como tipo de fecha/hora.
• Los valores booleanos no deben ir entre comillas.
• Si está asignando a una Variable una matriz o el valor de un miembro de un objeto Dinámico, no use comillas ni llaves con el nombre de la matriz o del miembro del objeto.

Crear variables con valores de fecha/hora

Studio no identifica implícitamente la fecha/hora como un tipo. Sin embargo, puede agregar un identificador antes de un valor de variable para declararlo como este tipo. solo necesita hacer esto si el valor se utilizará en funciones de fecha/hora o si desea realizar operaciones con el valor.

Para declarar un valor de variable como fecha/hora, utilice la sintaxis ASSIGN <varName> = #"<datetime>", donde <datetime> es el valor de fecha/hora que desea almacenar en la variable. Por ejemplo, date1 = #"7/15/2050 5:00pm". Si una variable no está declarada como fecha/hora, puede usar la asdatetime() función para convertirla en una.

Algunas funciones que manipulan fechas y horas requieren que se declaren las variables como fecha/hora. Incluso si es correcto el formato de fecha/hora, la función no funcionará si no se declara correctamente la variable. También puede usar esta sintaxis para realizar operaciones en fechas y horas que de otro modo no podría realizar. Por ejemplo, puede compararlas:

date1 = #"7/15/2050 5:00pm" 
date2 = #"7/15/2050 4pm"
x = date1 > date2 

El resultado es 1 (verdadero) porque el valor literal de date1 es mayor que el valor literal de date2.

Nomenclatura de variables

Nombre las variables siguiendo estas pautas:

• Utilice caracteres alfanuméricos (a-z, A-Z, 0-9).

• El primer carácter del nombre debe ser una letra.
• Utilice el carácter de guión bajo ( _ ) y el signo de dólar ( $ ) en cualquier parte del nombre.
• Si el último carácter en el nombre de una variable es un signo de dólar, elel valor se trata como texto.
• No utilice los nombres de variables predefinidas o palabras reservadas.

Sustitución de variables

Cuando necesite usar el valor de una variable en su script, incluya el nombre de la variable en el código del snippet o en el campo de la propiedad de la acción.

Si está sustituyendo el valor de una variable por una cadena, incluya el nombre de la variable entre llaves. En una cadena, todo se trata como texto sin formato a menos que esté formateado como una variable. Por ejemplo:

ASSIGN foeName = "Grendel"
ASSIGN numberFoes = "3"
ASSIGN x = numberFoes
ASSIGN y = "One of Beowulf's foes is {foeName}. He faced {numberFoes} foes in all." 
ASSIGN z = "One of Beowulf's foes is foeName. He faced numberFoes in all." 

Los resultados de este ejemplo SOn:

• x=3.
• y=One of Beowulf's foes is Grendel. He faced 3 foes in all.
• z=One of Beowulf's foes is foeName. He faced numberFoes in all.

Cuando copie el valor de una variable en otra, no necesita usar llaves. Esto aplica a valores de texto y numéricos. En el siguiente ejemplo, el resultado es:x=3 y z=Grendel:

ASSIGN numberFoes = "3"
ASSIGN name = "Grendel"
ASSIGN x = numberFoes 
ASSIGN y = name 

Si realiza operaciones matemáticas con variables, no necesita encerrarlas entre llaves. En el siguiente ejemplo, el resultado es y=200.

ASSIGN a1 = "100"
ASSIGN a2 = "100.00"
ASSIGN y = (a1 + a2) 

Sustitución de Variable en Propiedades de Acción

Muchas propiedades de las acciones pueden aceptar variables en lugar de valores literales. Esto es así incluso si la página de ayuda de la acción no especifica que puede usar un variable para configurar una propiedad.

Usar variables en las propiedades de una acción permite reutilizar scripts. Por ejemplo, si su organización tiene tres líneas de negocios, necesitaría tres Scripts de colas para definir la ACD habilidad Used to automate delivery of interactions based on agent skills, abilities, and knowledge., la gestión de prioridad y otras configuraciones para cada línea de negocios si utiliza valores literales. Si utiliza variables para configurar las propiedades cuando el valor difiera entre líneas de negocio, puede tener un script en lugar de tres.

Cuando haga referencia a las variables en las propiedades de la acción Studio, generalmente se aplicarán los siguientes lineamientos.

• Las propiedades esperan una variable o datos. Los datos pueden consistir en literales o variables. Cuando una propiedad espera datos, generalmente puede aceptar un literal o una variable. Sin embargo, existen excepciones, así que consulte siempre la ayuda en línea para la acción si no está seguro de qué espera una propiedad.

• Si la propiedad espera un nombre de variable, ingrese el nombre de la variable sin llaves.

• Si la propiedad espera datos y desea utilizar la sustitución de variables, incluya el nombre de la variable entre llaves: {varName}.

Pasar valores de variable de script a script

Los valores de Variable pueden pasar de un script a otro. Pueden pasar del:

• Script de origen al Subscript: Todas las variables en el script de origen están presentes y disponibles para usarse en los subscripts. Pero están en alcance global. Para usarlas en subíndices, debe preceder el nombre DE variable con global:. Por ejemplo, global:varName. Esto incluye las variables predefinidas del sistema y las variables que usted cree.
• Del Subscript al Script de Origen: Las variables que declare en un subscript no pasan automáticamente al script de origen. Si desea pasar una variable personalizada de un script al script de origen, debe declararla como global. De manera similar, si declara variables en un sub-subscript, debe declararlas como global y hacer referencia a ellas como global en el subscript y en el script de nivel superior originario.

Puede ver variables globales en los rastreos del script. Puede que necesite opción en la ventana Trace Output al ver un seguimiento.

Parte de los datos puede provenir de una fuente externa a sus scripts, como un CRM Third-party systems that manage such things as contacts, sales information, support details, and case histories. o una llamada a la API Application Programming Interface. Allows you to automate certain functionality by connecting your NiCE CXone system with other software.. Puede pasar estos valores a subscripts o scripts generados mediante la propiedad Parámetros en la acción RunSub o la acción Spawn. La acción Begin también tiene una propiedad Parámetros. Configure la acción Begin en el subscript con los nombres de las variables que recibirán los valores transmitidos a través de RunSub o Spawn.

Si los datos que necesita pasar están contenidos en un objeto, primero este objeto debe ser convertido a JSON o xml. Puede pasar la variable que contiene la cadena JSON o XML. En el segundo script, puede reformar los datos en un objeto, si lo desea.

Comparación y Evaluación de Variable

El hecho de que Studio aplique tipos implícitos a las variables afecta la manera en que estas se evalúan en expresiones y comparaciones booleanas A data type that has two possible values: true and false..

Por ejemplo:

ASSIGN a1 = "100"
ASSIGN a2 = "100"
ASSIGN y = (a1 = a2)

En este ejemplo, la expresión y = (a1 = a2) resulta y = 1 (verdadera).

Forzar comparación como texto

Puede forzar que un Variable se evalúe como texto incluso si su valor es numérico. Puede hacer esto de DOs maneras:

• Agregue un signo de dólar al final del nombre DE variable. Por ejemplo: varName$ = 42 Al hacer una comparación, únicamente una de las DOs variables necesita un sufijo con el signo de dólar.
• Ponga los nombres de las variables con llaves y comillas dobles. Por ejemplo, y = ("{a1}" = "{a2}").

Cuando el nombre de una variable termina en un signo de dólar, todas las operaciones Boolean An attribute of information that defines how it is used in a program, such as integer (numbers that can be manipulated) or boolean (true/false). (=, >, <, >=, <=) que utilizan esa variable tratan el valor como texto. Por ejemplo:

ASSIGN a$ = 20
ASSIGN b = 100
ASSIGN x = a$ > b

En este ejemplo, la variable x es 1 (verdadero). Debido a que la variable a$ termina con un signo de dólar, el valor 20 se trata como texto. Esto implica que a$ > b es una comparación de 20 y 100 como cadenas de texto y no como enteros. Al comparar como texto, 20 es mayor que 100 porque 20 comienza con un2 y 100 comienza con un1. Sin el signo de dólar en el nombre de la variable, x = a > b es 0 (falso) porque los valores se comparan como enteros. El número entero 20 no es mayor que el número entero 100.

Las variables Reservadas y Predefinidas

Hay variables preexistentes en Studio. SOn:

• Variables Reservadas: Estas variables devuelven cierto tipo de información, como la hora actual o el ID de la zona horaria actual. Las variables reservadas SOn de solo lectura, lo que significa que un script no puede guardar valores en ellas. Sólo existen para devolver información. Puede usarlas en su script cuando necesite ingresar la información que devuelven.
• Variables Predefinidas: Estas SOn variables del sistema. Ya están definidas en Studio, por lo que puede usarlas en sus scripts sin crearlas. Utilice variables del sistema en sus scripts cada vez que necesite la información que contienen. Solo anule las variables de sistema predefinidas si la ayuda en línea o un representante de la cuenta se lo indican. Puede obtener más información sobre variables predefinidas.

Variables globales

Las variables globales le permiten declarar una variable en un subscript y que se devuelva automáticamente al script de origen después de la acción Return. Cuando declara una variable global en un subscript, no tiene que devolverla al script de origen con la acción Return.

Puede crear una variable global usando la acción Snippet o la acción Assign. Use la siguiente sintaxis al crear una variable global con Snippet:

ASSIGN global:<variable name>

ASSIGN global:<variable name>="{firstname} {lastname}"

Ensure that there is no space between the colon and the variable name.

If you're using the Assign action, do not include the ASSIGN keyword.

You don't need to declare variables in the originating script as global. Limiting the declaration of global variables to subscripts provides you a visual clue about the script you're working in. When you see global:var, you know you're in a subscript.

Ejemplo de variables globales

El siguiente ejemplo muestra cómo usar variables globales.

Variables de abonado para Data Maps

Los mapas de datos SOn colecciones de datos a los que se hace referencia en sus Scripts. Puede usarlos en lugar de codificar valores de forma fija en los Scripts. Cuando los mapas de datos están configurados, puede hacer referencia a los datos que contienen mediante variables con el prefijo tenant: utilizando la siguiente sintaxis:

tenant:<DataMapName>.<Key>

Por ejemplo, para leer el valor de una clave denominada QueueId de un mapa de datos denominado BillingScript, use:

tenant:BillingScript.QueueId

Puede obtener más información sobre cómo trabajar con mapas de datos en sus Scripts en la página de ayuda de Data Maps.

Modificación de Variable

La modificación de Variable elimina los valores de Variable de los rastros y registros generados por un script. Puede redactar variables y objetos.

La modificación se configura a nivel de script en el campo VariableRedaction de un propiedades del script. Los valores redactados se reemplazan con una cadena de caracteres X. La longitud del valor de la variable determina cuántas X se usan, lo que significa que una palabra de cinco letras modificada tendría como resultado cinco X. No se admite la modificación Parcial de Variable, como parte de un número de tarjeta de crédito.

Para censurar variables:

1. En NiCE CXone, haga clic en el selector de aplicaciones y seleccione Omnicanal Routing > Studio .
2. En la página Scripts, ubique y haga doble clic para abrir el script que desea utilizar. Se abre el script en una nueva pestaña.
3. En el panel de propiedades del lado derecho del script, haga clic en la pestaña de variables.

4. Haga clic en Modificado .

   Ver imagen)

   

5. En el campo de la pestaña de variables, ingrese el nombre de cada variable que desee ocultar.Presione intro después de cada variable. Estos nombres deben corresponder a variables creadas en acciones Assign o SNIPPET en el script.

6. Haga clic en Modificado de nuevo para ocultar la lista de nombres DE variables.

7. Guardar el script.

En Desktop Studio:

1. En Desktop Studio, haga clic en el lienzo del script para asegurarse de que no haya nada seleccionado.
2. Haga clic en la pestaña Propiedades.
3. Haga clic en el botón de puntos suspensivos junto al campo VariableRedaction para abrir el String Collection editor.
4. Ingrese los nombres de las variables que desea redactar. Estos nombres deben corresponder a variables creadas en Assign en el script.
5. Haga clic en Aceptar.

Eliminar Datos confidenciales de un Variable

Además de configurar la modificación de variable, puede configurar su script para eliminar los datos confidenciales de una variable. Esto ayuda a garantizar que no persistan en el script más tiempo del necesario.

1. En su script, coloque una acción Snippet después de que los datos confidenciales se hayan usado y ya no se necesiten.
2. In the Snippet editor of the Snippet action, add the appropriate line for each variable you want to clear sensitive data from: 
   • Para un objeto de datos dinámicos: DYNAMIC <object name>
   • Para una variable regular: ASSIGN <var name> = ""
3. Guarde sus cambios.

Ver todas las variables en un script

Hay DOs formas de ver las variables en su script:

• La pestaña variables. Esta pestaña forma parte del panel de propiedades en el lado derecho del lienzo del script. Puede hacer clic en la flecha junto a una variable para expandir una lista de todas las Actions en el script que modifican dicha variable.
• You también puede ver las variables utilizadas en un script cuando ejecute un seguimiento. A medida que selecciona cada línea en la salida de seguimiento, las variables en el script en ese punto SOn visibles en el panel variables. Puede hacer clic en cada línea del rastreo para ver cómo cambia el contenido de las variables a medida que avanza el script.