Getvalue

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

Supported Script Types

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

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

Related Actions

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

Input Properties

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

Propriété

Description

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. 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 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, and 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 the retrieved value.
DefaultValue 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.

Result Branch Conditions

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.

Tips & Tricks

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