Putvalue

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

Stocke et récupère les données dans une NICE CXone table de base de données afin de la rendre accessible à d'autres scripts et contacts. Ces données peuvent être récupérées avec l’GETvalueactionaction.

Si plusieurs variables doivent être consultées par d'autres scripts ou contacts, une base de données est généralement la meilleure solution.

Dépendances

  • Putvalue utilise un type unique de données qui doit être accessible en utilisant les actions Studio appropriées : Getvalue, Remvalue, Getlist, and Clearlist.
  • Lorsque la propriété Persistent est réglée sur False, toutes les valeurs publiques qui ont été ajoutées par un contact spécifique sont automatiquement supprimées lorsque le contact est libéré. Cette fonctionnalité est couramment utilisée lorsqu'un script parent doit suivre les scripts enfants générés. Chaque script enfant Putvalue avec la propriété Name tel que « {MasterID}List » et une valeur de {ContactID}. Étant donné que la « {MasterID}List » est publique, le script parent peut périodiquement exécuter Getlist pour découvrir le nombre de scripts enfants en cours d'exécution. En vertu de la propriété Persistent = false, la valeur publique du script enfant sera automatiquement supprimée lorsqu'elle sera libérée. Aucun travail supplémentaire n'est requis pour maintenir un nombre exact de scripts enfants.
  • Les variables publiques non persistantes peuvent être partagées par d'autres scripts/contacts tout au long de la vie du script qui définit ces variables. Les variables sont automatiquement supprimées une fois qu'elles sont libérées.
  • Les variables Persistent doivent être supprimées manuellement en exécutant Getvalue (avec la propriété Supprimer définie sur vrai), Remvalue ou Clearlist. Il n’est pas recommandé d’utiliser Putvalue pour de grandes quantités de données ou de données dont vous aurez besoin pendant de longues périodes. Si vous devez enregistrer des données, il est recommandé d'utiliser un connecteur DB et de vous connecter à une base de données que vous contrôlez.

Types de scripts pris en charge

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.

Générique

Email Conversation Téléphone Messagerie vocale Élément de travail SMS Digital

Actions associées

Cette action est l'une des nombreuses actions qui stockent et récupèrent les données d'une table de base de données afin de rendre les données accessibles à d'autres scripts ; il se comporte comme une liste de champs ou de valeurs. Utilisez-les pour stocker plusieurs valeurs ou des valeurs nécessaires plus loin dans d'autres scripts. La liste complète des actions, y compris la présente action, est la suivante : Putvalue, Getvalue, Remvalue, Getlist, and Clearlist.

Ces actions utilisent un type de données unique accessible uniquement à l'aide de cet ensemble deStudio Actions. Les données ne sont pas accessibles autrement. Les utilisateurs ne peuvent pas accéder à cette base de données et l'utiliser, quelles que soient leurs autorisations.

Les valeurs sont répertoriées dans une table de base de données pour une durée limitée, comme configuré dans la propriété TTL hrs de l'action Putvalue . La valeur par défaut est 24 heures, mais elle est comprise entre une heure et 168 heures (sept jours). Vous pouvez utiliser l'action Remvalue pour supprimer les données avant l'heure TTL. Cela vous donne un contrôle total sur les données de vos scripts.

Remarques:

  • Si plusieurs variables doivent être consultées par d'autres scripts ou contacts, une base de données est généralement la meilleure solution.
  • Les variables publiques non persistantes peuvent être partagées par d'autres scripts ou contacts tout au long de la vie du script qui définit ces variables. Les variables sont automatiquement supprimées une fois qu'elles sont libérées.

Propriétés d'entrée

Ces propriétés définissent les données que l'action utilise lors de son exécution.

Propriété

Description

une légende

Entrez une courte phrase qui identifie cette action dans le script de manière unique. La légende est affichée sur le canevas de script sous l’icône de l’action. The default is the action name.

Scope

Sélectionnez le niveau auquel les valeurs gérées par cette action sont visibles pour les autres contacts. Seuls les contacts partageant le même périmètre pourront accéder aux mêmes données. Les options sont :

La Scope que vous sélectionnez doit correspondre à la Scope définie dans toutes les autres actions de liste que vous incluez dans votre script. Les actions de listes sont Putvalue, Getvalue, Remvalue, Getlist, and Clearlist. Même lorsque le Name de la liste est le même, ils ne seront pas reconnus si les paramètres Scope ne correspondent pas.

Name

Permet d’identifier la valeur. Il peut s'agir de n'importe quel nom ou numéro. Les noms ne sont pas sensibles à la casse. Lorsque la valeur est récupérée à l'aide de Getvalue, Name doit être identique. Si la propriété Name ne correspond pas, ils ne se reconnaîtront pas, même si le réglage Scope est le même.

Value

La valeur ou les données à stocker.

Method

Lorsque plusieurs valeurs portant le même nom sont stockées, elles sont placées dans une liste. Sélectionnez l'une des méthodes suivantes :

  • ReplaceAll : il s'agit de la valeur par défaut, qui sera automatiquement sélectionnée.
  • Append : place la nouvelle valeur à la fin de la liste. Lors de l'ajout de valeurs, si le nombre dépasse 1000 ajouts en moins de 24 heures, il ne sera plus ajouté jusqu'à ce que certains des ajouts soient effacés (après 24 heures).
  • Insert : place la valeur au début de la liste. Les appels ultérieurs à Getvalue récupéreront les données du début de la liste.
Persistent

Sélectionnez True si vous souhaitez que les données stockées par un contact donné restent après la libération du contact. Par défaut, les données sont supprimées lorsque le contact est libéré (False).

TTL (hrs)

Définissez cette propriété sur la durée en heures pendant laquelle vous souhaitez que les données soient disponibles. Lorsque le TTL (Time to Live) est atteint, les données sont effacées. L'heure réelle à laquelle les données sont effacées peut aller jusqu'à une heure après l'expiration de la durée de vie. En effet, le processus qui vérifie la durée de vie s'exécute une fois par heure, au début de l'heure. Par exemple, si la durée de vie expire à 10h03, le processus qui vérifie l'expiration de la durée de vie ne s'exécutera qu'à 11h00, ce qui signifie que les données continueront d'exister jusqu'à 11h00.

La valeur minimale pour cette propriété est d'une heure et la valeur maximale est de 168 heures (sept jours). La valeur par défaut est 24 heures. Si vous définissez des valeurs en dehors des limites autorisées, l'action utilise la valeur autorisée la plus proche.

Conditions de branche résultantes

Les conditions de branche de résultat vous permettent de créer des branches dans votre script afin de gérer différents résultats lors de l'exécution d'une action.

Condition

Description

Default

Chemin parcouru sauf si le script remplit une condition qui l'oblige à emprunter l'une des autres branches. Il est également suivi si les autres branches de l’action ne sont pas définies.