Putvalue

This help page is for Desktop Studio. This information is also available for CXone Studio.

Almacena y recupera datos en una NICE CXone tabla de la base de datos para que sea accesible a otros scripts y contactos. Estos datos se pueden recuperar con la GETvalueactionacción.

Si varias variables necesitan ser accedidos por otros scripts o contactos, una base de datos es generalmente la mejor solución.

Dependencias

  • Putvalue utiliza un tipo de datos único al que se debe ingresar mediante las Studio acciones Getvalue, Remvalue, Getlist, and Clearlist. adecuadas:
  • Cuando la propiedad Persistent se pone en False, se eliminan automáticamente todos los valores públicos que agregó un contacto específico cuando se libera el contacto. Esta función se suele utilizar cuando una secuencia de comandos padre necesita mantener un seguimiento de la secuencia de comandos hijo. Cada script derivado pondrá a Putvalue con la propiedad Name como "{MasterID}List" y un valor de {ContactID}. Como la "{MasterID}List" es pública, el script principal puede ejecutar Getlist periódicamente para descubrir cuántos scripts secundarios se están ejecutando actualmente. Dado que la propiedad Persistent=false, se eliminará automáticamente el valor público del script secundario cuando se publique. No se requiere ningún trabajo adicional para mantener un conteo de secuencia de comandos hijo.
  • Las variables no persistentes públicas pueden compartirse por otras secuencia de comandos/contactos por toda la vida de la secuencia de comandos la cual establece dichas variables. Las variables se limpian automáticamente una vez que se liberan.
  • Las variables Persistent deben eliminarse manualmente al ejecutar Getvalue (con la propiedad Eliminar definida en true), Remvalue o Clearlist. No es recomendable utilizar Putvalue para grandes cantidades de datos ni para datos que vaya a necesitar durante largos períodos de tiempo. Si necesita guardar datos, se recomienda utilizar el DB Connectory conectarse a una base de datos que usted controle.

Tipos de secuencias de comandos compatible

The icon for a Generic script type - a rectangle with < and > symbols inside it.

The icon for the Email script type - a large @ symbol in a diamond.

The icon for the Chat script type - a chat bubble with an ellipsis inside (...), in a diamond shape.

The icon for the Phone script type - an old-style phone handset with curved lines indicating sound coming out of it.

The icon for the Voicemail script type - a symbol that looks like a cassette tape - two circles sitting on a horizontal line.

The icon for the Work Item script type-a piece of paper with one corner folded down and a bullet list on it.

The icon for the SMS script type - a smart phone with a chat bubble coming out of it.

The icon for the Digital script type - a computer monitor with a smartphone next to it.

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, and 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.

Las propiedad

Descripción

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. The default is the action name.

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, and 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.

Value

El valor o los datos que se van a almacenar.

Method

Cuando se almacenan valores múltiples con el mismo nombre, se ponen en una lista. Seleccione uno de los siguientes métodos:

  • ReplaceAll: Este es el valor predeterminado y se seleccionará automáticamente.
  • Append: Coloca el nuevo valor al final de la lista. Al agregar valores, si el número supera los 1000 agregados en menos de 24 horas, ya no se agregará hasta que se eliminen algunos de los agregados (después de 24 horas).
  • Insert: Coloca el valor al principio de la lista. Las llamadas posteriores a Getvalue recuperarán datos desde el principio de la lista.
Persistent

Seleccionar True si desea que permanezcan los datos almacenados por un contacto determinado después de que se libere el contacto. El valor predeterminado es que se eliminen los datos cuando se libera el contacto (False).

TTL (hrs)

Establezca esta propiedad en la cantidad de tiempo en horas que desea que los datos estén disponibles. Cuando se alcanza el TTL (tiempo de vida), los datos se borran. El tiempo real en que se borran los datos puede ser hasta una hora después de que expire el TTL. Esto se debe a que el proceso que verifica el TTL se ejecuta una vez por hora, al comienzo de la hora. Por ejemplo, si el TTL vence a las 10:03, el proceso que verifica el vencimiento del TTL no se ejecutará hasta las 11:00, lo que significa que los datos seguirán existiendo hasta las 11:00.

El valor mínimo para esta propiedad es de una hora y el máximo es de 168 horas (siete días). El valor predeterminado es 24 horas. Establecer valores fuera de los límites permitidos hace que la acción use el valor permitido más cercano.

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.