sebb 2005/07/09 17:05:55
Modified: xdocs/usermanual component_reference.xml
Log:
Try to clarify While/If controller conditions
Revision Changes Path
1.120 +15 -10 jakarta-jmeter/xdocs/usermanual/component_reference.xml
Index: component_reference.xml
===================================================================
RCS file: /home/cvs/jakarta-jmeter/xdocs/usermanual/component_reference.xml,v
retrieving revision 1.119
retrieving revision 1.120
diff -u -r1.119 -r1.120
--- component_reference.xml 22 Jun 2005 22:44:56 -0000 1.119
+++ component_reference.xml 10 Jul 2005 00:05:54 -0000 1.120
@@ -1013,6 +1013,13 @@
<property name="Name" required="No">Descriptive name for this controller
that is shown in the tree.</property>
<property name="Condition" required="yes">Javascript code that returns
"true" or "false"</property>
</properties>
+ <p>Examples:
+ <ul>
+ <li>${COUNT} < 10</li>
+ <li>"${VAR}" == "abcd"</li>
+ </ul>
+ If there is an error interpreting the code, the condition is
assumed to be false, and a message is logged in jmeter.log.
+ </p>
</component>
<component name="Random Order Controller" index="§-num;.2.10"
screenshot="">
@@ -1121,7 +1128,6 @@
</component>
<component name="While Controller" index="15.2.13" screenshot="">
<description>
-<note>ALPHA CODE</note>
<p>
The While Controller runs its children until the condition is "false".
</p>
@@ -1131,20 +1137,20 @@
<li>blank - exit loop when last sample in loop fails</li>
<li>LAST - exit loop when last sample in loop fails.
If the last sample just before the loop failed, don't enter loop.</li>
-<li>Otherwise - exit (or don't enter) the loop when the condition is
"false"</li>
+<li>Otherwise - exit (or don't enter) the loop when the condition is equal
to the string "false"</li>
</ul>
-<p>Note: unlike the IfController, the condition is not evaluated as a
JavaScript expression.
-The condition can be any variable or function that eventually evaluates to
"false".
-This allows one to use JavaScript, BeanShell, properties or variables as
needed.
+<note>In contrast to the IfController, the condition is not evaluated as a
JavaScript expression.
+The condition can be any variable or function that eventually evaluates to
the string "false".
+This allows the use of JavaScript, BeanShell, properties or variables as
needed.
+</note>
<br></br>
For example:
<ul>
<li>${VAR} - where VAR is set to false by some other test element</li>
<li>${__javaScript(${C}==10,dummy)}</li>
- <li>${_P(property)}</li>
- <li>etc</li>
+ <li>${__javaScript("${VAR2}"=="abcd",dummy)}</li>
+ <li>${_P(property)} - where property is set to "false" somewhere
else</li>
</ul>
-</p>
</description>
<properties>
<property name="Name" required="Yes">Descriptive name for this
controller that is shown in the tree, and used to name the
transaction.</property>
@@ -1154,7 +1160,6 @@
<component name="Switch Controller" index="§-num;.2.14" screenshot="">
<description>
-<note>ALPHA CODE</note>
<p>
The Switch Controller acts like the <complink name="Interleave Controller"/>
in that it runs one of the subordinate elements on each iteration, but
rather than
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
