Correlate scripts using Design Studio

This topic describes the basic flow for correlation scripts with VuGen's Design Studio.

Prepare a script for correlation

To prepare a script for correlation, make sure that all correlation scan types are enabled for the script.

To enable all correlation scan types:

  1. Open the script in VuGen.
  2. In the toolbar, open the Record > Recording Options > Correlations > Configuration and make sure that all scan types are enabled in the Scan for correlations applying section.

    • Rules Scan

      • Automatically correlate values found

    • Record Scan

    • Replay Scan

  • The Scan for correlations applying section of the recording options is available only for protocols that support automatic correlation.
  • You can correlate the Web HTTP/HTML steps only within your Oracle NCA script when the Web HTTP/HTML protocol is active. To activate, select Recording Options > Protocol > Active Protocols > Web HTTP/HTML. For more information, see Oracle NCA correlation.

Back to top

Perform the correlation

After you have prepared your script for correlation, you use Design Studio to perform the correlation.

To perform the correlation:

  1. In the Correlation tab, click the Design Studio button to perform an initial scan. This opens the Design Studio dialog box, which scans for response (or record-based) correlations and applies correlation rules. The progress bar in the dialog box indicates whether the initial scan was successful. For details on the Correlation tab, see Correlating values.

  2. Select a value to correlate by clicking the value in the grid, and click Correlate. Design Studio begins the correlation. When a value is correlated, VuGen adds a web_reg_save_param_* function, and saves the original value in a comment within the script.

  3. Examine the details of the correlation by expanding the Details section. For details, see Correlating values.

  4. Click the Add as Rule button to add a rule type. In addition, you can click the Edit rule button to view and edit the corresponding rule if the dynamic value was correlated by a rule. For details, see Correlations > Rules recording options.

  5. Optionally modify the correlation definitions for the current script. You can modify correlation definitions to help eliminate dynamic values that do not require correlation.

    1. Expand the Details section, and view the Original Snapshot Step tab.

    2. In the Correlation Definition section, select the definition type, such as Boundary Based, Regular Expression, or JSONPath type.

    3. Edit the relevant values, such as boundaries, regular expression, or query.

    4. Click Apply.

    For details about modifying WinSock correlation definitions, see Winsock correlation.

  6. Click the Replay & Scan button. The Correlation tab progress bar indicates whether additional correlations have been found. Again, you can select which values you would like to correlate by selecting the value in the grid and clicking the Correlate button.
  7. Repeat this step several times until the Design Studio can no longer find new correlations. The progress bar indicates Design Studio Scan Complete.

Tip: If Design Studio does not resolve all correlation-based errors, try to resolve them using manual correlation. For details, see Manually correlate scripts.

Back to top

See also: