Include Controller Tutorial

This is a short tutorial explaining the basics of the include controller. The include controller provides an easy way to include modules in a test plan. It is different than the module controller in a couple of ways.

the include controller loads a simple controller with all it's samples, where as the module controller can use any controller

the include controller doesn't use the workbench

the module controller doesn't load from a file

the include controller loads the module at runtime and doesn't display the contents of the simple controller

There are a couple of reasons why one might want to use the include controller.

break a test plan into resusable modules

reduce the cost of maintaining test plans

reduce duplication of common process

For example, say you need to test an application that requires login. If each test plan had the login requests, a change in the login process would require updating all test plans. By making the login a module, all other test plans can reuse it. When the login process changes, the change is made to the module and all other test plans get the change. One limitation of the current implementation is the contents of the module are only loaded at runtime, so users can't view or edit the contents of an included module.

The include controller has 2 properties. The name and the filename. The name is the descriptive name for the controller in the test plan. The filename is the name of the .jmx file.

Step-by-step

start jmeter

select the workbench

add -> logic controller -> simple controller

enter “module1” in the name

now add one or more samples to the controller

once the samples are added, right click on “module1”

select “save as” and save it as module1.jmx

Module1.jmx can now be used with any test plan. The include controller hasn't been tested with other controllers as the root element. If you need to use other controllers, use simple controller as the root and add other controllers to it.

peter lin

2005-10-10T14:18:53