GETVALUE
![]() |
Retrieves a value previously stored using PUTVALUE. |
Supported Script Types
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
Generic | Chat | Phone | Voicemail | Work Item |
Properties
- Scope
-
This property is a drop down list to select one of the following:
- Business UnitHigh-level organizational grouping used to manage technical support, billing, and global settings for your NICE inContact environment
- CampaignA grouping of skills used to run reports.
- SkillClassification used to facilitate the delivery of contacts; assigned to agents based on abilities, specialties, and knowledge
- Point of Contact
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.