Putvalue

Cette page d’aide concerne CXone Studio. Cette information est également disponible pour Desktop 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 à l’aide de l’GETvalueaction .

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

Dépendances

  • Putvalue utilise un type de données unique auquel il faut accéder en utilisant les actions Studio appropriées :Getvalue, Remvalue, Getlist et Clearlist.
  • Lorsque la propriété Persistent est définie 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 utilisera Putvalue avec la propriété Name telle 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’il sera libéré. 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 pour des 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

Un carré d’où part une ligne qui va vers trois autres carrés.

Générique

courriel Clavardage Téléphone Messagerie vocale Élément de travail SMS Numérique

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 cette action, est la suivante : Putvalue, Getvalue, Remvalue, Getlist et Clearlist.

Ces actions utilisent un type de données unique accessible uniquement à l’aide de cet ensemble deStudio Actions. Les données ne sont accessibles d’aucune autre manière. 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 la base de données pendant 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 Remvaluepour supprimer des 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 accessibles à 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 pendant toute la durée de 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

Ajouter Légende

Saisissez une courte phrase qui identifie de manière unique cette action dans le script. La légende apparaît dans le canevas de script sous l’icône d’action.

Scope

Sélectionnez le niveau auquel les valeurs gérées par cette action sont visibles pour les autres contacts. Seuls les contacts qui partagent le même Scope (portée) pourront accéder aux mêmes données. Les options sont :

Le Scope que vous sélectionnez doit correspondre au Scope défini dans toutes les autres actions de liste que vous incluez dans votre script. Les actions de la liste sont Putvalue, Getvalue, Remvalue, Getlist et Clearlist. Même si les Name de la liste est le même, il ne sera pas reconnu si les paramètres Scope ne correspondent pas.

Name

Utilisé pour identifier la valeur. Il peut s’agir de n’importe quel nom ou nombre. Les noms ne sont pas sensibles à la casse. Lorsque la valeur est récupérée en utilisant Getvalue, Name doit être identique. Si la propriété Name ne correspond pas, ils ne se reconnaîtront pas l’un l’autre, même si le paramètre Scope est le même.

Value

La valeur ou les données à stocker.

Method

Lorsque plusieurs valeurs avec le même nom sont stockées, elles sont mises 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 1 000 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èrent les données à partir du début de la liste.
Persistent

Sélectionnez True si vous souhaitez que les données stockées par un contact donné soient conservées 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 la branche de résultat

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 emprunté à moins que le script ne remplisse une condition exigeant qu’il prenne l’une des autres branches. Elle est également prise si les autres branches de l’action ne sont pas définies.