Use parameters in scripts

You can use parameters to create a more realistic script. Instead of passing the same value each time to a step argument or Eval JavaScript step, you create a list of values to pass. Different values are taken from the list as the load test runs.

Parameters can also be used in property values of descriptors. For details, see Descriptors for scripts.

The name of a parameter points to a file containing a value on each row. The parameter definition defines when to start using a new value and in what order to use the values in the list.

Manage parameters

You manage parameters and set parameter values using the VuGen interface. For details on managing parameters in VuGen, see Parameterization.

After you record a script, you can convert existing argument values to parameters directly from the Development window. For details, see Convert an argument value to a parameter.

Alternatively, you can work with Virtual Table Server (VTS) to assign parameter values from a single set of values to multiple Vusers. For details, see Use VTS in TruClient scripts.

Back to top

Use a parameter as an argument value

In the Step editor, for some arguments, you can select a parameter to use as an argument value.

To use a parameter as an argument value:

  1. Select a field in the step Arguments area.

  2. Click the argument type arrow, and select Parameter.

    The value is cleared, allowing you to enter the name of the parameter to use.

  3. Enter the name of the parameter to use.

    When running the script, the parameter’s value is evaluated as defined in the step argument.

Back to top

Convert an argument value to a parameter

You can convert an argument value or part of an argument value from a literal (plain text or JavaScript code) to a parameter, either an existing parameter or a new parameter created on the spot.

To convert an argument value or part of an argument value from a literal to a parameter:

  1. Select a field in the step Arguments area.

  2. Highlight either the entire argument value or part of the argument value.

  3. Right-click and select Create new parameter from selection or Replace selection with parameter.

    1. If you select Replace selection with parameter, a list is displayed. Select the parameter from the list.

      If you select Create new parameter from selection, enter the name of the new parameter, and click OK.

      If the type of the argument value is Plain text, the entire value (regardless of whether you select the entire or part of the value) is replaced with the name of the parameter you selected or created, and the value type becomes Parameter automatically.

      If the type of the argument value is JavaScript code, only the selected value is replaced with TC.getParam (“ParameterName”), and the value type remains JavaScript code.

      Note: You must save the script in the Development window before you can see the new parameter in VuGen.

Back to top

Set how to apply parameter values during replay

You use the VuGen interface to set when and how the values of each parameter are applied during the test. Alternatively, you can add a TC.advanceParam(name) step in your script to update the parameter value.

Back to top

See also: