GETVALUE

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

Icon of GetValue: gray table with a down arrow

Récupère la première valeur du tableau que l'action Putvalue action a créé. Vous pouvez configurer cette action pour supprimer la valeur du tableau ou la laisser dans celui-ci à l'aide de la propriété Portée.

Pour récupérer le tableau entier, utilisez l'action GETLIST.

Script Types pris en charge

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

Icon of gray-green envelope

\n Icon of dark green speech bubble\n

Icon of purple telephone handset

Icône du symbole de messagerie vocale de couleur rouille représentant deux cercles reliés par une ligne

Icon of pink document with lines of text

Icône d'un téléphone mobile vert avec une bulle de discussion sur l'écran

Icône d'un moniteur d'ordinateur violet avec un appareil mobile chevauchant son coin inférieur droit

Générique

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

Actions lié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 : 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 pendant une durée limitée, telle que configurée dans la propriété TTL en heures de l'action Putvalue .La valeur par défaut est 24 heures, mais elle peut aller d'une heure à 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 complet sur les données au sein de vos Scripts.

Remarques :

  • Si plusieurs variables doivent être accessibles par d'autres scripts ou contacts, une base de données est généralement la meilleure solution.
  • Les variables Public 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 de saisie

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

Propriété

Description

Ajouter 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.

Portée \n

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 les suivantes :

Important La Portée que vous sélectionnez doit correspondre à la Portée définie dans toutes les autres actions de liste que vous incluez dans votre script. Les actions de liste sont Putvalue, Getvalue, Remvalue, Getlist, et Clearlist. Même lorsque le nom de la liste est identique, elles ne seront pas reconnues si les paramètres de Portée ne correspondent pas.

Nom Utilisé pour 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 le même. Si la propriété Name ne correspond pas, ils ne se reconnaîtront pas mutuellement, même si le paramètre Portée est identique.
Variable The name of the variable that you want to hold the retrieved values.
Valeur par défaut The value you would provide to any record without a matching mapping. Cannot exceed 200 characters.
Remove True (the default) causes the value to be removed from the Scope property after it is retrieved. False allows repetitive access to the same value.

Conditions de la branche 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

Par défaut

Path taken unless the script meets a condition that requires it to take one of the other branches. It is also taken if the action's other branches are not defined.

NoData

Path taken if there are no values for the specified properties.

Astuces et conseils

  • Une liste stocke temporairement plus qu'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é Supprimer sur True. une fois la dernière valeur récupérée, les appels suivants déclencheront l'état Pas de données de la branche.
  • Un exemple d'utilisation des actions Getvalue et Putvalue est un script de conférence. Pour créer un tel script, la partie de conférence à l'origine 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.