Disable portions of a test or schedule

Disable portions of a test or schedule

+
Search Tips | Advanced Search

Overview

Disabled portions of tests and schedules are visible in a test, but not executed during a run.
You can also disable secondary HTTP requests.

Disable an element in a schedule or test for any protocol

In the Test Navigator, browse to the schedule or test, and double-click it.
Right-click the element to disable, and select Disable.

The element and the dependent child elements, which are disabled automatically, are shaded and preceded by two forward slashes (//) to remind you that they are disabled.

To change the color or symbol that represents disabled elements, click...
Windows | Preferences | Test | Test Editor | Colors and Fonts tab

Although a disabled test element does not run, you can still work with it.
For example, you can insert a test into a disabled user group for later use.
To enable a disabled element, right-click it, and select Enable.
Select Enable All to enable all disabled elements.

Example

Disable an element in a test or schedule affects other elements in the following ways:
Disabled element Result
User group (percentage) Percentages in the remaining user groups are recalculated.
When you enable the user group again, return affected user groups to their original percentage.
User group (absolute) Number of users in the remaining groups might not match the total number of users specified in the schedule. If so, new virtual users are redistributed among the remaining user groups so that the numbers will match. When you enable the user group again, return all of the affected user groups to their original totals.
Data correlation reference request Substitution in the remaining actions that depend on this request does not work.
Data correlation substituter request Substitution does not occur because the entire action is omitted. The substituter that uses the disabled data source is also disabled.
To re-enable the substituter, select an enabled data source for substitution.
HTTP request containing a server connection No effect. The connection is automatically created in the next request.
Portion of custom code Custom code with disabled arguments is flagged. If the disabling causes an unexpected number of arguments passed to custom code elements, you receive an error at runtime.
To fix this, modify the custom code to check the number of arguments.
IF data_source construct An IF construct is marked as invalid if it contains a disabled data source.
Test element and child are disabled
If you disable a child element and then disable its parent (for example, a request and then a page), the disabled child element will have two prefixes:

One created manually
One inherited

In the following example, the first request has inherited the disabled state. The second request has been manually disabled and has also inherited the disabled state:
//disabled page
//request
////disabled request
Do one of the following to re-enable the second request:

Re-enable the request, and then re-enable the page.
Right-click the page and select Enable All.
A data source or a range of text that will be replaced In HTTP, the Data table displays this text in gray.
Related

About test variables
Add test elements
Editing Kerberos tests
Search within tests
Run test elements in random order
Rename test assets
Delete test assets
Provide tests with variable data (datapools)
Viewing binary data
Correlating response and request data

Disabled element	Result
User group (percentage)	Percentages in the remaining user groups are recalculated. When you enable the user group again, return affected user groups to their original percentage.
User group (absolute)	Number of users in the remaining groups might not match the total number of users specified in the schedule. If so, new virtual users are redistributed among the remaining user groups so that the numbers will match. When you enable the user group again, return all of the affected user groups to their original totals.
Data correlation reference request	Substitution in the remaining actions that depend on this request does not work.
Data correlation substituter request	Substitution does not occur because the entire action is omitted. The substituter that uses the disabled data source is also disabled. To re-enable the substituter, select an enabled data source for substitution.
HTTP request containing a server connection	No effect. The connection is automatically created in the next request.
Portion of custom code	Custom code with disabled arguments is flagged. If the disabling causes an unexpected number of arguments passed to custom code elements, you receive an error at runtime. To fix this, modify the custom code to check the number of arguments.
IF data_source construct	An IF construct is marked as invalid if it contains a disabled data source.
Test element and child are disabled	If you disable a child element and then disable its parent (for example, a request and then a page), the disabled child element will have two prefixes: One created manually One inherited In the following example, the first request has inherited the disabled state. The second request has been manually disabled and has also inherited the disabled state: //disabled page //request ////disabled request Do one of the following to re-enable the second request: Re-enable the request, and then re-enable the page. Right-click the page and select Enable All.
A data source or a range of text that will be replaced	In HTTP, the Data table displays this text in gray.