Getvalue

Esta página de ayuda es para CXone Studio. Esta información también está disponible para Desktop Studio.

Recupera un valor almacenado previamente utilizando la Putvalue acción.

Tipos de secuencias de comandos compatibles

Un cuadrado del que sale una línea que va a otros tres cuadrados.

Genérico

Correo electrónico Conversación Teléfono Correo de voz Elemento de trabajo SMS Digital

Acciones relacionadas

Esta acción es una de varias acciones que almacenan y recuperan datos de una tabla de base de datos para que otros scripts puedan acceder a los datos; se comporta como una lista de campos o valores. Úselos para almacenar múltiples valores, o valores necesarios más adelante en otros scripts. La lista completa de acciones, que incluye esta acción, es: Putvalue, Getvalue, Remvalue, Getlist y Clearlist.

Estas acciones usan un tipo de datos único al que solo se puede acceder usando este conjunto de Studio comportamiento. Los datos no son accesibles de otra forma. Los usuarios no pueden acceder a esta base de datos y utilizarla, independientemente de sus permisos.

Los valores se enumeran en una tabla de la base de datos durante un período limitado, según lo configurado en la TTL hrspropiedad de la Putvalue acción. El valor predeterminado es 24 horas, pero tiene un rango de una hora a 168 horas (siete días). Puede usar la acción Remvalue para eliminar datos antes del tiempo TTL. Esto le da un control completo sobre los datos dentro de sus scripts.

Notas:

  • Si varias variables necesitan ser accedidos por otros scripts o contactos, una base de datos es generalmente la mejor solución.
  • Las variables públicas no persistentes las pueden compartir otros scripts o contactos durante toda la vida del script que define dichas variables. Las variables se limpian automáticamente una vez que se liberan.

Propiedades de entrada

Estas propiedades definen los datos que utiliza la acción al ejecutarse.

Propiedad

Descripción

Agregar Leyenda

Ingrese una frase corta que identifique de forma única esta acción en el script. La leyenda aparece en el lienzo del script debajo del ícono de acción.

Scope

Seleccione el nivel en el que los valores que maneja esta acción son visibles para otros contactos. Sólo los contactos que comparten el mismo Ámbito pueden acceder a los mismos datos. Las opciones son:

El Scope que seleccione debe coincidir con el Scope definido en todas las demás acciones de la lista que incluya en su script. Las acciones de la lista son Putvalue, Getvalue, Remvalue, Getlist y Clearlist. Aun cuando el Name de la lista sea el mismo, no se reconocerá si no coincide la configuración Scope.

Name Se utiliza para identificar el valor. Esta puede ser cualquier nombre o número. Los nombres no se distingue entre mayúsculas y minúsculas. Cuando se recupera el valor usando Getvalue, Name debe ser el mismo. Si no coincide la propiedad Name, no se reconocerán entre sí, incluso si es la misma configuración de Scope.
Variable El nombre de la variable que desea retener. el valor inicial.
Default Value El valor que proporcionará a cualquier registro sin el correspondiente mapeo. No puede superar los 200 caracteres.
Remove True (el valor predeterminado) hace que se elimine el valor de la propiedad Scope después de que se recupera. False permite el acceso repetitivo al mismo valor.

Condiciones de la rama de resultados

Las condiciones de las ramas de resultados le permiten crear ramas en su script para manejar diferentes resultados cuando se ejecute una acción.

Condición

Descripción

Default

Recorrido a menos que el script cumple una condición que requiere uno de los otros poderes. También se considera si no están definidas las demás ramas de la acción.

NoData

Recorrido si no hay valores para las propiedades especificadas.

Consejos y trucos

  • Una lista almacena temporalmente más de un artículo sobre la base de un nombre determinado. Para recuperar todos los elementos de la lista, utilice las llamadas repetitivas para Getvalue o una sola llamada a Getlist.
  • Al usar Getvalue para recuperar varios valores, defina la propiedad Remove como True. Una vez recuperado el último valor, las llamadas posteriores activarán la condición de rama No Data.
  • Un ejemplo del uso de las acciones Getvalue y Putvalue es un script de conferencias. Para crear dicho script, la parte que inicia la conferencia debe guardar su ID de conferencia usando Putvalue. Las personas que llaman siguientes pueden unirse a la conferencia después de recuperar la ID de conferencia usando Getvalue.