dataset Literal Substitution dialog box

You can use the dataset Literal Substitution dialog box to find or replace literal values in a test script with a dataset reference (an associated dataset). You can set the options in this dialog box to find and replace all, number, string, or boolean literals in a script with a dataset reference.

You can also add a literal from a script to a dataset. If you do not use an existing dataset variable, the same literal values (the values that were captured when you recorded the test script) are used each time that you run the script.

Literal Type
Click to set the type of literal that you want to find; either all, number, string, or boolean literals in a script. A literal is a letter or symbol that stands for itself as opposed to a feature, function, or entity associated with it in a programming language: $ can be a symbol that refers to the end of a line, but as a literal, it is a dollar sign. This setting works with the Search up setting. Click Find Next or Replace to move to the next type of literal in a script starting from the insertion point of your cursor.
All Types
Click to find all literals in a script.
Numbers
Click to find number literals in a script. A number includes integers (a whole number, not a fractional number, that can be positive, negative, or zero)or floating numbers (positive and negative decimal numbers).
Strings
Click to find string literals in a script. A string stores alphanumeric values such as name, city, or state.
Booleans
Click to find boolean literals in a script. Any use of the boolean literals true or false are flagged for substitution.
Search up
Click to move up through script to the next literal in the script from the insertion point. Clear to move forward through the script to the next literal. This setting works with the Literal Type setting, and with the Find Next or Replace settings.
Literal
Displays the name of a selected literal in a script.
dataset Variable
Type the name of the dataset variable with which you want to replace a literal or click the dataset Variable arrow to select the existing dataset variable that you want the script to reference. The default type for a new dataset column is string. You can change the variable type later.
Add Literal to dataset
Click to add a selected literal to a dataset variable when you click Replace. The selected literal is added to the dataset in the variable that you specify in dataset Variable. A dataset reference replaces the selected literal when you click Replace.
Find Next
Click to find the next literal in a script. This setting works with Search up and Literal Type settings.
Replace
Click to replace the selected literal with a dataset reference. The dataset reference is made to the dataset variable that you specify in dataset Variable. When you click Add literal to dataset, Functional Test adds a selected literal to the dataset variable that you specify in dataset Variable . Automatically moves to the next literal in the test script after replacing a literal. This setting works with Search up and Literal Type settings.
Close
Click to close the dialog box without finding a literal or replacing a literal with a dataset reference.

To open: Click Script> Find Literals and Replace with dataset Reference.

Related Topics:

Replacing Literals with dataset References

Associating a dataset with a Test Script