Getvalue

Permet de récupérer une valeur précédemment enregistrée à l’aide de l’action Putvalue .

Types de scripts pris en charge

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
Add Caption	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 : Unité commerciale Regroupement organisationnel de haut niveau utilisé pour gérer le support technique, la facturation et les paramètres globaux pour votre environnement CXone (Locataire) Campagne Un regroupement de compétences utilisé pour exécuter des rapports. Compétence Utilisé pour automatiser la livraison des interactions en fonction des compétences, des capacités et des connaissances des agents Point d’accès Le point d’entrée qu’un contact entrant utilise pour lancer une interaction, tel qu’un numéro de téléphone ou une adresse courriel. 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.
Variable	Le nom de la variable que vous souhaitez conserver la valeur récupérée.
Default Value	La valeur que vous fourniriez pour tout dossier ne possédant pas de mappage correspondant. Ne peut pas dépasser 200 caractères.
Remove	True (par défaut), la valeur est supprimée de la propriété Scope une fois qu’elle a été récupérée. False permet un accès répétitif à la même valeur.

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.
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étés à Getvalue ou un seul appel à Getlist.
• Lorsque vous utilisez Getvalue pour récupérer plusieurs valeurs, définissez la propriété Remove sur True. Une fois que la dernière valeur a été récupérée, les appels suivants déclenchent la condition de branche No Data.
• Un exemple d’utilisation des actions Getvalue et Putvalue est un script de conférence. Pour créer un tel script, la partie initiatrice de la conférence doit enregistrer son ID de conférence à l’aide de Putvalue. Les appelants suivants peuvent se joindre à la conférence après avoir récupéré l’ID de la conférence à l’aide de Getvalue.