Parameters

Help Topics
Parameters can be used to dynamically generate data for the request. For example, you can define integer parameter with minimum and maximum value of 1 and 10, respectively and an increment of 1. If you then include this parameter in, for example, URL of particular request item, ten different requests will be executed.

Parameters can be managed in the 'Parameters' tab of project properties.

Add parameter

To add parameter, click 'Add' button in the toolbar located above parameter list. New parameter with default name is automatically added to the list. Name of the parameter must contain only alphanumeric characters or underscore, you can safely rename parameter even after it is in use by request items and name will be changed everywhere parameter is used. Parameter names in particular project must be unique.
Because parameters and chaining items can be used in the same properties of request item, HttpMaster does not allow project parameters and chaining items to share the same name.

Specify parameter properties

Properties of the parameter are managed in the box located next to the parameter list. You have the following options:
  • Parameter data source.
  • Parameter data type.
  • Format; only available when parameter data source is set to increasing values.

Manually provided single value

For all parameters of this type, you have two options:
  • Provide their values before the execution; HttpMaster will display special window immediately before the execution where you will be able to specify parameter values. Specified values are maintained while the project is opened; once parameter values are provided, you won't be prompted again for their values on subsequent executions. To change already provided parameter values, click corresponding button in the execution window toolbar and specify new values.
  • Use specified value; HttpMaster will use the specified value, but you will be able to change it in the execution window.

Values obtained from a disk file

If you have selected disk file as a data source, you have to specify the following properties:
  • File path; path relative to the opened project file can be used to specify disk location of the file.
  • File encoding.
  • How to extract values from the file; it is possible to extract complete file contents or only part of it with the regular expression. You can specify multiple capturing groups in regular expression effectively creating multi-value parameter.

Specified list of values

If you have selected list values as a data source, you can enter new values in the corresponding text field (one value per row).

Runtime generated increasing values

If you have selected increasing values as a data source, you have to specify the following properties:
  • Data type; 'Number' and 'Date' data types are available.
  • Format; select desired format from the dropdown.
  • Decimal symbol; only available with 'Number' data type.
  • Digit grouping symbol; only available with 'Number' data type.
  • Start value; specify start value for the parameter. You can specify negative value if the parameter data type is 'Number'.
  • End value; specify end value for the parameter. You can specify negative value if the parameter data type is 'Number'.
  • Increment; specify increment value. Only positive value can be specified.
  • Increment unit; only available if parameter data type is 'Date'.

Using parameters

When you will use parameters in the fields that accept them, you will have to enclose them in curly braces, for example, 'http://www.example.com?size={size}'. To show the list of currently available parameters, press 'Crtl+Space' when cursor is inside the field that accepts parameters. One such field, for example, is URL of the request item.

For more information about using parameters, see corresponding topic in 'How to' section.