Remvalue

This help page is for Desktop Studio. This information is also available for CXone Studio.

Removes a specific list value that was previously stored using the 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.

Generic

Email Chat Phone Voicemail Work Item SMS Digital

Comparison of Similar Actions

This action is one of several actions that store and retrieve data from a database table in order to make the data accessible to other scripts; it behaves like a list of fields or values. Use them for storing multiple values, or values needed further along in other scripts. The complete list of actions, including this action, is: Putvalue, Getvalue, Remvalue, Getlist, and Clearlist.

These actions use a unique data type that can only be accessed using this set of Studio actions. The data are not accessible any other way. Users cannot get to this database and use it, regardless of their permissions.

The values are listed in a database table for a limited amount of time, as configured in the TTL hrs property of the Putvalue action. The default is 24 hours, but it an range from one hour to 168 hours (seven days). You can use the Remvalue action to delete data before the TTL time. This gives you complete control over the data within your scripts.

Notes:

  • If several variables need to be accessed by other scripts or contacts, a database is generally the best solution.
  • Non-persistent public variables can be shared by other scripts or contacts throughout the life of the script that sets those variables. The variables are automatically cleaned up once they are released.

Input Properties

These properties define data that the action uses when executing.

Property

Description

Caption

Enter a short phrase that uniquely identifies this action in the script. The caption appears on the script canvas under the action icon. The default is the action name.

Scope

Select the level that the values this action handles are visible to other contacts. Only contacts that share the same scope will be able to access the same data. Options are: 

The Scope you select must match the Scope set in all other list actions that you include in your script. The list actions are Putvalue, Getvalue, Remvalue, Getlist, and Clearlist. Even when the Name of the list is the same, they will not be recognized if the Scope settings do not match.

Name

Used to identify the value. This can be any name or number. Names are not case sensitive. When the value is retrieved using Getvalue, Name must be the same. If the Name property does not match, they will not recognize each other, even if the Scope setting is the same.

Value

The value or data to be removed from the list.

Occurrence

Select an option to define which occurrence of Value to remove if there's more than one instance of that Value.

  • First
  • Last
  • All

When multiple values of the same name are stored, they create a list. To remove from the end of the list, set Occurrence to Last. To remove from the start of the list, set Occurrence to First.

Result Branch Conditions

Result branch conditions allow you to create branches in your script to handle different outcomes when an action executes.

Condition

Description

Default

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.
NotFound Path taken if a data value is not found in the call suppression table and therefore the call should be made.