View | Details | Raw Unified | Return to bug 50475
Collapse All | Expand All

(-)test_plan.xml (-1 / +9 lines)
Lines 83-89 Link Here
83
	 Note that delay overrides start-time, and duration over-rides end-time.</p>
83
	 Note that delay overrides start-time, and duration over-rides end-time.</p>
84
</subsection>
84
</subsection>
85
85
86
<subsection name="&sect-num;.2 Controllers" anchor="controllers">
86
<subsection name="&sect-num;.2 Test Fragments" anchor="test_fragments">
87
<p>Test Fragment element is a special type of <a href="#controllers">controller</a> that
88
exist on the Test Plan tree at the same level as the Thread Group element.  They are distinguised
89
from the Thread Group in that they are not executed with the Test Plan unless they are 
90
reference by either a <complink name="Module Controller"/> or an <complink name="Include_Controller"/>.
91
</p>
92
<p>This element is purely for code re-use within Test Plans and was introduced in Version 2.5</p>
93
</subsection>
94
<subsection name="&sect-num;.3 Controllers" anchor="controllers">
87
95
88
<p>
96
<p>
89
JMeter has two types of Controllers: Samplers and Logical Controllers.
97
JMeter has two types of Controllers: Samplers and Logical Controllers.
(-)component_reference.xml (-5 / +8 lines)
Lines 2025-2037 Link Here
2025
<component name="Include Controller" index="&sect-num;.2.14"  width="419" height="118" screenshot="includecontroller.png">
2025
<component name="Include Controller" index="&sect-num;.2.14"  width="419" height="118" screenshot="includecontroller.png">
2026
	<description>
2026
	<description>
2027
<p>
2027
<p>
2028
The include controller is designed to use an external jmx file. To use it, add
2028
The include controller is designed to use an external jmx file. To use it, create a Test Fragment 
2029
samples to a simple controller, then save the simple controller as a jmx file.
2029
underneath a Test Plan and add any desired samplers, controller etc below it.  Then save the Test Plan.  
2030
The file can then be used in a test plan.
2030
The file is now ready to be included as part of other Test Plans.
2031
The included test plan must not include a Thread Group.
2032
It should only contain the Simple Controller and any samplers, controllers etc below it.
2033
</p>
2031
</p>
2034
<p>
2032
<p>
2033
For convience purposes, a Thread Group can also be added in the external JMX file for debugging purposes.
2034
A Module Controller can be used to reference the Test Fragment.  The Thread Group will be ignored during the 
2035
include process.
2036
</p>
2037
<p>
2035
If the test uses a Cookie Manager or User Defined Variables, these should be placed in the top-level
2038
If the test uses a Cookie Manager or User Defined Variables, these should be placed in the top-level
2036
test plan, not the included file, otherwise they are not guaranteed to work.
2039
test plan, not the included file, otherwise they are not guaranteed to work.
2037
</p>
2040
</p>

Return to bug 50475