Request Chaining

Help Topics
Chaining items enable execution engine to use data of the previous request with the current request. For example, you can define chaining with the type 'Complete RESPONSE URL' and then use it in the URL field of particular request item. This will ensure that every execution of the request item will use response URL obtained from the previous execution for its request URL.

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

Add chaining

To add chaining, click 'Add' button in the toolbar located above the chaining list. New chaining with default name is automatically added to the list. Name of chaining must contain only alphanumeric characters or underscore, you can safely rename chaining even after it is in use by request items and name will be changed everywhere chaining is used. Names of chaining items 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 properties of chaining

Properties of the chaining are managed in the box located next to the chaining list. You have to select chaining type and specify possible chaining values, for example, regular expression to extract data.

Obtain chaining data only once and then reuse it

Whenever execution engine encounters new usage of the chaining item, it tries to obtain relevant data for it from the execution data of the previous request. This behavior can be overriden with the corresponding option in chaining definition. If this option is turned on, execution engine will obtain relevant data only at the first chaining item use and will maintain this value during the whole execution batch. If execution engine will then encounter any further use of this chaining item in the execution batch, it will immediately use this stored value and will not try to extract anything from the execution data of the previous request. This behavior can be useful in some cases, for example, if you need to obtain some authentication token in the first request and then reuse it in all subsequent batch requests.

Using chaining items

When you will use chaining items in the fields that accept them, you will have to enclose them in curly braces. To show the list of currently available chaining items, press 'Crtl+Shift+Space' when cursor is inside the field that accepts chaining. One such field, for example, is URL of the request item.

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