Index: test_plan.xml =================================================================== --- test_plan.xml (revision 1048910) +++ test_plan.xml (working copy) @@ -83,7 +83,15 @@ Note that delay overrides start-time, and duration over-rides end-time.
-Test Fragment element is a special type of controller that
+exist on the Test Plan tree at the same level as the Thread Group element. They are distinguised
+from the Thread Group in that they are not executed with the Test Plan unless they are
+reference by either a
This element is purely for code re-use within Test Plans and was introduced in Version 2.5
+
JMeter has two types of Controllers: Samplers and Logical Controllers.
Index: component_reference.xml
===================================================================
--- component_reference.xml (revision 1048910)
+++ component_reference.xml (working copy)
@@ -2025,13 +2025,16 @@
-The include controller is designed to use an external jmx file. To use it, add
-samples to a simple controller, then save the simple controller as a jmx file.
-The file can then be used in a test plan.
-The included test plan must not include a Thread Group.
-It should only contain the Simple Controller and any samplers, controllers etc below it.
+The include controller is designed to use an external jmx file. To use it, create a Test Fragment
+underneath a Test Plan and add any desired samplers, controller etc below it. Then save the Test Plan.
+The file is now ready to be included as part of other Test Plans.
+For convience purposes, a Thread Group can also be added in the external JMX file for debugging purposes.
+A Module Controller can be used to reference the Test Fragment. The Thread Group will be ignored during the
+include process.
+
If the test uses a Cookie Manager or User Defined Variables, these should be placed in the top-level
test plan, not the included file, otherwise they are not guaranteed to work.