Author: sebb
Date: Mon Apr 27 00:55:32 2009
New Revision: 768844
URL: http://svn.apache.org/viewvc?rev=768844&view=rev
Log:
UDV clarifications
Modified:
jakarta/jmeter/trunk/xdocs/usermanual/component_reference.xml
Modified: jakarta/jmeter/trunk/xdocs/usermanual/component_reference.xml
URL:
http://svn.apache.org/viewvc/jakarta/jmeter/trunk/xdocs/usermanual/component_reference.xml?rev=768844&r1=768843&r2=768844&view=diff
==============================================================================
--- jakarta/jmeter/trunk/xdocs/usermanual/component_reference.xml (original)
+++ jakarta/jmeter/trunk/xdocs/usermanual/component_reference.xml Mon Apr 27
00:55:32 2009
@@ -2883,11 +2883,24 @@
</component>
<component name="User Defined Variables" index="§-num;.4.13" width="690"
height="394" screenshot="user_defined_variables.png">
-<description><p>The User Defined Variables lets you define an initial set of
variables, just as in the <complink name="Test Plan" />.
+<description><p>The User Defined Variables element lets you define an
<b>initial set of variables</b>, just as in the <complink name="Test Plan" />.
<b>
Note that all the UDV elements in a test plan - no matter where they are - are
processed at the start.
+</b>
So you cannot reference variables which are defined as part of a test run,
e.g. in a Post-Processor.
+</p>
+<p>
+<b>
+UDVs should not be used with functions that generate different results each
time they are called.
+Only the result of the first function call will be saved in the variable.
</b>
+However, UDVs can be used with functions such as __P(), for example:
+<pre>
+HOST ${__P(host,localhost)}
+</pre>
+which would define the variable "HOST" to have the value of the JMeter
property "host", defaulting to "localhost" if not defined.
+</p>
+<p>
For defining variables during a test run, see <complink name="User
Parameters"/>.
UDVs are processed in the order they appear in the Plan, from top to bottom.
</p>
@@ -2908,7 +2921,7 @@
<note>
If you have more than one Thread Group, make sure you use different names for
different values, as UDVs are shared between Thread Groups.
Also, the variables are not available for use until after the element has been
processed,
-so you cannot re-use variables that are defined in the same element.
+so you cannot reference variables that are defined in the same element.
You can reference variables defined in earlier UDVs or on the Test Plan.
</note>
<properties>
---------------------------------------------------------------------
To unsubscribe, e-mail: jmeter-dev-unsubscr...@jakarta.apache.org
For additional commands, e-mail: jmeter-dev-h...@jakarta.apache.org
