Getvalue

Cette page d'aide concerne CXone Studio. Ces informations sont également disponibles pour Desktop Studio.

Récupère une valeur stockée précédemment à l'aide de l’action Putvalue.

Types de scripts pris en charge

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

Générique

Email Conversation 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 la présente 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 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

Add Caption

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.

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 et 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.
Variable Le nom de la variable que vous voulez mettre en attente. la valeur récupérée.
Default Value La valeur que vous fourniriez à n'importe quel enregistrement sans mappage correspondant. Ne peut pas dépasser 200 caractères.
Remove True (valeur par défaut) entraîne la suppression de la valeur de la propriété Scope après sa récupération. False permet un accès répétitif à la même valeur.

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.

NoData

Chemin emprunté s'il n'y a pas de valeurs pour les propriétés spécifiées.

Conseils & Astuces

  • Une liste stocke temporairement plus d'un élément en fonction d'un nom donné. Pour récupérer tous les éléments de la liste, utilisez des appels répétitifs pour Getvalue ou un appel unique pour Getlist.
  • Si vous utilisez Getvalue pour récupérer plusieurs valeurs, définissez la propriété Remove sur True. Une fois que la valeur a été récupérée, les appels ultérieurs déclencheront la condition de branche No Data.
  • Un script de conférence est un exemple d'utilisation des actions Getvalue et Putvalue. Pour créer un script de ce type, la partie initiatrice de la conférence doit enregistrer son ID de conférence à l'aide de Putvalue. Les appelants peuvent rejoindre la conférence après avoir récupéré l’ID de conférence à l’aide de Getvalue.