LR Recording Options
Recording Levels Overview
VuGen lets you specify what information to record and which functions to use when generating a Vuser script by selecting a recording level in the General Recording Levels node of the Recording Options dialog box. The recording level you select depends on your needs and environment. The available levels are GUI-based script, HTML-based script, and URL-based script.
Recording Options image
General > Recording Node
GUI-based script : Recommended for most applications, including those with JavaScript. Also recommended for PeopleSoft Enterprise and Oracle Web Applications.
HTML-based script: This is the default recording level for Web (HTTP/HTML) Vusers. It instructs VuGen to record HTML actions in the context of the current Web page. It does not record all resources during the recording session, but downloads them during replay. This options is recommended for browser applications with applets and VB script.
URL-based script: Record all requests and resources from the server. It automatically records every HTTP resource as URL steps (web_url statements), or in the case of forms, as web_submit_data. It does not generate the web_link, web_image, and web_submit_form functions, nor does it record frames. This options is recommended For non-browser applications.
Advanced HTML
Non-HTML generated elements : Many Web pages contain non-HTML elements, such as applets, XML, ActiveX elements, or JavaScript. These non-HTML elements usually contain or retrieve their own resources. Using the following options, you can control how VuGen records non HTML-generated elements.
- Record within the current script step. Does not generate a new function for each of the non HTML-generated resources. It lists all resources as arguments of the relevant functions, such as web_url, web_link, and web_submit_data. The resources, arguments of the Web functions, are indicated by the EXTRARES flag.
- Record in separate steps and use concurrent groups. Creates a new function for each one of the non HTML-generated resources and does not include them as items in the page’s functions (such as web_url and web_link). All of the web_url functions generated for a resource are placed in a concurrent group (surrounded by web_concurrent_start and web_concurrent_end).
- Do not record. Does not record any non-HTML generated resources.
Script type
- A script describing user actions. Generates functions that correspond directly to the action taken. It creates URL (web_url), link (web_link), image (web_image), and form submission (web_submit_form) functions. The resulting script is very intuitive and resembles a context sensitive recording.
- A script containing explicit URL’s only. Records all links, images and URLs as web_url statements, or in the case of forms, as web_submit_data. It does not generate the web_link, web_image, and web_submit_form functions. The resulting script is less intuitive. This mode is useful for instances where many links within your site have the same link text. If you record the site using the first option, it records an ordinal (instance) for the link, but if you record using the second option, each link is listed by its URL. This facilitates parameterization and correlation for that step.
Advanced URL
Create concurrent groups for resources after their source HTML page : Records the resources in a concurrent group (enclosed by web_concurrent_start and web_concurrent_end statements) after the URL. Resources include files such as images and js files. If you disable this option, the resources are listed as separate web_url steps, but not marked as a concurrent group.
Enable EUC-Encoded Web Pages: (For Japanese windows only) Instructs VuGen to use EUC encoding.
Use web_custom_request only: Records all HTTP requests as custom requests. VuGen generates a web_custom_request function for all requests, regardless of their content. Recommended for non-browser applications.
General > Protocol Node
Active Protocols List : A list of the protocols which comprise your multiple protocol script. VuGen lets you modify the protocol list for which to generate code during the recording session. Select the check boxes adjacent to the protocols you want to record in the next recording session. Clear the check boxes adjacent to the protocols you do not want to record in the next recording session.
General > Code Generation
Correlations Scan:Instructs VuGen to analyze the Vuser script to locate dynamic values that may need to be correlated. This scan is performed after a new script is recorded and after an existing script is regenerated.
Async Scan:Instructs VuGen to analyze the Vuser script to locate asynchronous communication. This scan is performed after a new script is generated and after an existing script is regenerated.
General > Script Node
| UI Element | Description |
|---|---|
| Close all AUT processes when recording stops |
Automatically closes all of the AUT’s (Application Under Test) processes when VuGen stops recording.
Default value: disabled.
|
| Correlate arrays |
Tracks and correlates arrays of all data types, such as string, structures, numbers, and so on.
Default value: enabled.
|
| Correlate large numbers |
Correlates long data types such as integers, long integers, 64-bit characters, float, and double.
Default value: disabled.
|
| Correlate simple strings |
Correlates simple, non-array strings and phrases.
Default value: disabled.
|
| Correlate small numbers |
Correlates short data types such as bytes, characters, and short integers.
Default value: disabled.
|
| Correlate structures |
Tracks and correlates complex structures.
Default value: enabled.
|
| Declare primitives as locals |
Declares primitive value variables as local variables rather than class variables (C, C#, and .NET only).
Default value: enabled.
|
| Explicit variant declaration |
Declares variant types explicitly in order to handle ByRef variants (Visual Basic for Applications only).
Default value: enabled.
|
| Generate fixed think time after end transaction |
Adds a fixed think time, in seconds, after the end of each transaction. When you enable this option, you can specify a value for the think time.
Default value: disabled, 3 seconds when enabled.
|
| Generate recorded events log |
Generates a log of all events that took place during recording.
Default value: disabled.
|
| Generate think time greater than threshold |
Uses a threshold value for think time. If the recorded think time is less than the threshold, VuGen does not generate a think time statement. You also specify the threshold value.
Default value: enabled, 3 seconds.
|
| Insert output parameters values |
Inserts output parameter values after each call (C, C#, and .NET only).
Default value: disabled.
|
| Insert post-invocation info |
Insert informative logging messages after each message invocation (non-C only).
Default value: enabled.
|
| Insert pre-invocation info |
Insert informative logging messages before each message invocation (non-C only).
Default value: enabled.
|
| Maximum number of lines in action file |
Create a new file if the number of lines in the action exceeds the specified threshold. The default threshold is 60000 lines (C, C#, and .NET only).
Default value: disabled.
|
| Replace long strings with parameter |
Save strings exceeding the maximum length to a parameter. This option has an initial maximum length of 100 characters. The parameters and the complete strings are stored in the lr_strings.h file in the script’s folder in the following format:
const char <paramName_uniqueID> =”string”.
This option allows you to have a more readable script. It does not effect the performance of the script.
Default value: enabled.
|
| Reuse variables for primitive return values |
Reuse the same variables for primitives received from method calls. This overrides the Declare primitives as locals setting.
Default value: enabled.
|
| Track processes created as COM local servers |
Track the activity of the recorded application if one of its sub-processes was created as a COM local server (C and COM only).
Default value: enabled.
|
| Use full type names |
Use the full type name when declaring a new variable (C# and .NET only).
Default value: disabled.
|
| Use helpers for arrays |
Use helper functions to extract components in variant arrays (Java and VB Scripting only).
Default value: disabled.
|
| Use helpers for objects |
Use helper functions to extract object references from variants when passed as function arguments (Java and VB Scripting only).
Default value: disabled.
|
| Use protected application recording | Use this option if VuGen is unable to record your application. Your application may block access to VuGen, and recording with this option selected may enable access. Default value: disabled. |
HTTP > Advanced Node
|
UI Element
|
Description
|
||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Headers |
|
||||||||||||
| Content Types |
|
||||||||||||
| Non-Resources |
List of items which should not be recorded as resources. Each item can be selected or deselected using its individual checkbox.
|
||||||||||||
| Add comment to script for HTTP errors while recording |
Adds a comment to the script for each HTTP request error. An error request is defined as one that generated a server response value of 400 or greater during recording.
|
||||||||||||
| Generate steps with missing responses | Enable the generation of steps for HTTP requests that are missing server responses.
This option is not selected by default. |
||||||||||||
| Generate web_reg_find functions for page titles |
Generates web_reg_find functions for all HTML page titles. VuGen adds the string from the page’s title tag and uses it as an argument for web_reg_find.
Note: This option is available only for Web and Oracle NCA protocols
|
||||||||||||
| Parameterize server names | VuGen identifies server names and IP addresses when you regenerate a Vuser script. These server names and IP addresses are contained in specific arguments associated with specific functions in the Vuser script.
Note: To identify data for parameterization, VuGen searches the arguments that are listed for the following functions:
By default, this option is not selected. |
||||||||||||
| Record script using earlier recording engine |
Record using the single-protocol recording engine. By default, for Web (HTTP/HTML) Vusers, VuGen uses the multi-protocol recording engine for all recordings even if you are only recording a single protocol.
|
||||||||||||
| Record think time |
Records the think times and generate lr_think_time functions. You can also set a Think-time Threshold value to only generate lr_think_time .
Note: This option is available only for Wireless Protocols scripts.
|
||||||||||||
| Reset context for each action |
This option resets the HTML context.It also clears the cache and resets the user names and passwords.
Note: This option is available only for Web and Oracle NCA protocols
|
||||||||||||
| Save snapshot resources locally |
Saves a local copy of the snapshot resources during record and replay, thereby creating snapshots more accurately and displaying them quicker.
|
||||||||||||
| Support charset |
|
Venkat Matta 