GETVALUE

Retrieves a value previously stored using PUTVALUE.

Supported Script Types

Generic Email Chat Phone Voicemail Work Item

Properties

Scope

This property is a drop down list to select one of the following:

This selection determines the level that this value will be visible to other contacts. Only contacts that share the same Scope will be able to access the same data.

The option selected for the PUTVALUE Scope property must match the Scope property for the GETVALUE action. Even when the names of the lists are the same, they will not be recognized if the Scope property options do not match.

Name

This property is the name or key used to identify the value. This can be any name or number. When the value is retrieved using GETVALUE, the same name as used in the PUTVALUE action must be supplied. Names are not case sensitive.

If the Name of the lists do not match, they will not recognize each other, even if the Scope property options are the same.

Variable
This property is the name of a variable that will receive the value.
DefaultValue
This property is the value to be used if the list name within the Scope property is empty. If data is not available from the list, this property is used.
Remove

If you select True (the default), it causes the value to be removed from the Scope property after it is retrieved.

If you select False, it allows repetitive access to the same value.

Branches

Default
The Default branch condition will be used unless another branch condition is met.
OnNoData
If the name in the selected Scope property doesn’t have a value, this branch condition will be triggered.

Tips and Tricks

  • A list temporarily stores more than one item based on a given name. To retrieve all items from the list, use repetitive calls to GETVALUE or a single call to GETLIST.
  • When using GETVALUE to retrieve multiple values, set the Remove property to “True”. Once the last value has been retrieved, subsequent calls will trigger the No Data branch condition.
  • An example of using the GETVALUE and PUTVALUE actions is a conferencing script. To create such a script, the initiating conference party must save its conference ID using PUTVALUE. Callers that follow can join the conference after they retrieve the conference ID using GETVALUE.