Share this page

# Correlations > Rules recording options

This pane enables you to manage correlation rules that automatically correlate dynamic values during code generation. You can add and delete applications. You can also add, delete, import, export, and test correlation rules.

To access the pane:

- Record > Recording Options > Correlations tab > Rules

- Design Studio> Options >Correlations tab > Rules

User interface elements are described below (unlabeled elements are shown in angle brackets):

UI Element | Description
--- | ---
<Application List > | A list of applications and their rules. Select the check box adjacent to the application to activate it during recording. Expand the application tree to select the check box adjacent to the rules to activate them during recording.
New Application | Add a new application to <Application List>.
New Rule | Enter a new rule for the selected application in Correlation Rules. For details, see New Rule Pane.
Delete | Delete the selected application or rule from the list.
Import | Import a file containing correlation rule definitions.
Export | Export a file containing a correlation rule definition.
Test… | Test a correlation rule. For details, see Token Substitution Testpad dialog box.

### New Rule Pane

Enables you to define a new custom rule.

User interface elements are described below:

UI Element | Description
--- | ---
Advanced… | Opens the Advanced Correlation Properties dialog box.
Action | Specify the type of action for the rule from the following options: Search for Parameters in all of the body Text. Searches the entire body—not just links, form actions or cookies. It searches the text for a match using the borders that you specify. Search for parameters in links and form actions. Searches within links and forms' actions for the text to parameterize. This method is for application servers where you know the context rules. You define a left boundary, a right boundary, an alternate right boundary, and an instance of the left boundary within the current link. Search for parameters in cookie headers. Similar to the previous rule, except that the value is extracted from cookie text (exactly as it appears in the recording log) instead of from a link or form action. Parameterize form field value. Saves the named form field value to a parameter. It creates a parameter and places it in the script before the form's action step. For this option, you need to specify the field name. Text to enter a web_reg_add_cookie function by method inserts a web_reg_add_cookie function if it detects a certain string in the buffer. It only adds the function for those cookies with the specified prefix. For this option, you need to specify the search text and the cookie prefix.
Scan Type | The scan type. Select a scan type, and fill in the relevant details: Regular Expression: RegExp String. A regular expression to which this rule will apply. Boundary Based: Left boundary. The left-most boundary where the rule will apply. Right boundary. The right-most boundary where the rule will apply. Use the drop-down menu to define this boundary as either the end of a string, a newline character, or a user-defined text. Match Case. Matches the case when looking for boundaries Use '#' for any digit. Replaces all digits with a hash sign. The hash signs serve as wildcard, allowing you to find text strings with any digit. Example: If you enable this option and specify ABC### as the left boundary, ABC193 and ABC284 are valid matches. Attribute Based: Available for Search for Parameters in all of the Body Text actions only. TagName. The name of HTML element. Extract. The name of HTML attribute whose value is saved to the parameter. Name/ID. The value of the HTML element's "name”/"Id" attributes. Class. The value of the HTML element's “class” attribute. Type. The value of the HTML element's “type” attribute. For example, for the INPUT element, Type can be "hidden". XPath query: XPath string. An XPath expression to which this rule will apply. This element only applies to a XPath query scan type. When VuGen detects a value that matches this expression, it creates a web_reg_save_param_xpath function. JSON query: JSONPath String. A JSON query expression to which this rule will apply. This element only applies to a JSON query scan type. When VuGen detects a value that matches this expression, it creates a web_reg_save_param_json function. For details about creating a JSON query, see Internet resources on JSONPath expressions.
Parameter prefix | Uses a prefix in all automatically generated parameters based on this rule. Prefixes prevent you from overwriting existing user parameters. In addition, prefixes allow you to recognize the parameter in your script. For example, in Siebel Web, one of the built-in rules searches for the Siebel_row_id prefix.

## See also

- Correlate scripts
- Correlate scripts using Design Studio

https://admhelp.microfocus.com VuGen,Professional Performance Engineering,Performance Engineering for Developers 8942
Tips to improve your search results... OpenText™ Virtual User Generator Help Center OpenText™ VuGen Help 26.1-26.3 All View Local Help Center View Online Help Center Version: