Design Studio - Correlation Tab

The Design Studio's Correlation tab enables you to scan for, correlate, and view information about dynamic values in your script.

UI example
To access

Click the Design Studio button on the VuGen toolbar > Correlation tab

The Design Studio button is enabled when you have a recorded script in the Solution Explorer.

Relevant tasks Correlate Scripts Using Design Studio
See also Correlating Values

Correlation Tab - Main Area

UI Element Description
Replay&Scan Design studio scans for dynamic values using all enabled types: rule, record, and replay.
Correlate Replace a dynamic value in the script with a correlation parameter.
Add as Rule

Add dynamic value definition as a rule:

Rule name. Enables you to specify a rule name.

Application Name. Enables you to associate the rule to a specific application.

For details, see Correlations > Rules Recording Options.

Undo Correlation Replace the correlation parameter with the original dynamic value.
Discard

Delete the selected dynamic values from the correlation grid. You can only use the discard action when the dynamic value has a status of New.

In addition, this action adds the text to the list of excluded strings. You can edit the list in Recording Options > Correlation > Configuration > Excluded string list.

View

Filter values found for correlation by the following types:

  • All
  • New
  • Correlated
Correlations grid Displays details about each dynamic value in the script.
Details Displays details about the dynamic value in the snapshot/script selected in the grid.

Back to top

Correlations grid

Displays details about each dynamic value in the script.

Type

Displays which engine found the dynamic value for correlations:

  • Record
  • Rules
  • Replay
  • Manual
Replace/Found

Displays information about the number of dynamic values found with the same definitions. Since you can perform partial correlation, meaning you can replace specific occurrences, the information displayed depends on if you have correlated the value or not.

  • Before correlation, this represents: Number of values that can be replaced / Number of values found

  • After correlation, this represents: Number of values that have been replaced / Number of values found.

Status

Displays correlation status of the dynamic value from the script: New or Correlated

Text in Response Displays the string of the dynamic value from the script.
Correlation Parameter Displays the correlation parameter name of the dynamic value.

Back to top

Details area

Displays details about the dynamic value in the snapshot/script selected in the grid:

Original Snapshot Step Tab

Step in Scrips

Name. Displays the step name in the script where the dynamic value was found

Line. Displays the line of the script where the dynamic value was found.

Action Name. Displays the name of action from the script where the dynamic value was found.

Description. Displays a description of the step.

Correlation Definition

Type. Display API function that will be used to correlate the value.

  • Attribute based: web_reg_save_param_attrib
  • Regular expression: web_reg_save_param_regexp
  • Boundary based: web_reg_save_param_ex

Definition. Displays the definition of the dynamic value.

  • Attribute Based. Dynamic value correlation is defined by an input text value. Returns a warning if the text is not found.
  • Regular Expression. Dynamic value correlation is defined by a regular expression. A regular expression is a special text string for describing a search pattern.
  • Boundary Based. Dynamic value correlation is defined by left and right boundary text strings.
Apply Enables you to select which definition to apply to the dynamic value. You can scroll through the definition of the dynamic value in Occurrences in Snapshot by clicking Prev or Next buttons.
Occurrences in Snapshot

Record snapshot. Displays all the occurrences of the dynamic value in the record snapshot once the script as been replayed. You can scroll to view each occurrence in the snapshot.

Replay snapshot. If the scan type of Replay has been selected, Design Studio displays all the occurrences of the dynamic value in the replay snapshot once the script as been replayed. You can scroll to view each occurrence in the snapshot.

Note: After the value has been correlated, the replay snapshot is blank. If you modify the Correlation Definition, the replay snapshot will be blank.

Options

Opens the Recording Options dialog box.

For details, see:

Occurrences in Script tab

Displays the occurrences of the dynamic value in your script. You can correlate all the values or select individual values to correlate by selecting the check box adjacent to the occurrence.

Back to top