Play Options
Parameter | Description |
username=USERNAME |
CloudTest user name |
password=PASSWORD |
CloudTest password |
url=URL |
CloudTest URL to connect |
httpproxyhost=SERVER |
HTTP proxy server name (optional) |
httpproxyport=PORT |
HTTP proxy port (optional) |
name=NAME |
The name of the object to play. |
type=TYPE |
The type of object to play. Valid types are
composition
or
playlist
. If the 'type' option is omitted, then
composition
is assumed. |
wait=[yes|no] |
Specify whether to wait for the object to finish playing. If the 'wait' option is omitted, then 'no' is assumed. |
format=FORMAT |
The display format to use (i.e. 'text', 'xml', or 'junitxml'). If the 'format' option is omitted, then 'text' is assumed. When the format is junitxml, users can also use the validation parameter to specify a transaction name, a transaction metric to use, and to set a threshold value to validate. |
file=FILE |
The file to write the output to (optional). If the 'file' option is omitted, then the output will be written to the command line (standard out). |
seeddatakey[NAME]=password |
Specify a password for the given encrypted seed data file. |
systemproperty="PROPERTY PATH=VALUE" |
Specify a system property's path and its value (optional). |
customproperty="PROPERTY PATH=VALUE" |
Specify a custom property's path and its value (optional). |
failonerror=[yes|no] |
This parameter will fail the test on error in Continuous Integration (CI) environments. When this parameter is set to yes, if the composition playback fails on a validation or any clip-related error, then Jenkins or Bamboo will also fail the job and note the scommand return code as an error. |
validation=/transactionname/transactionmetric/transactionthreshold |
This parameter will validate the specified transaction by name, using one of the supported metrics (supported metrics are listed below) and a value in milliseconds. |
loadonserver=SERVERNAME |
Name of the server where the composition will be loaded (optional).[Requires CloudTest build 8744.49 or later.] |
resultsdatabase=RSDBNAME |
Name of the Results Database that will collect the results (optional). [Requires CloudTest build 8744.49 or later.] |
resultname=RESULTNAME |
Name of the result to create. |
errorretrycount=ERRORRETRYCOUNT |
If an error is ecountered when playing a composition, then this is the amount of retries that will be attempted until it passes or hits that count. |
For example, to play the composition named "/Load Tests/Comp 1":
scommand cmd=play name="/Load Tests/Comp 1" username=bob \
password=secret url=
http://
<CloudTest URL>/concerto
For example, to play the playlist named "/Load Tests/Complete Set of Tests":
scommand cmd=play type=playlist name="/Load Tests/Complete Set of Tests" \
username=bob password=secret url=
http://
<CloudTest URL>/concerto
For example, to play the composition named "/Load Tests/Comp 1" while specifying passwords for two encrypted seed data objects:
scommand cmd=play name="/Load Tests/Comp 1" username=bob password=secret url=
http://
<CloudTest URL>/concerto \
seeddatakey[/Data/List1]=password1 seeddatakey[/Data/List2]=password2
For example, to play the composition named "/Load Tests/Comp 1" while specifying the target "Load Test on Mobile" to use for the composition:
scommand cmd=play name="/Load Tests/Comp 1" username=bob \
password=secret url=
http://
<CloudTest URL>/concerto
systemproperty="Band 1/Track 1/Clip 1/Load Test on Mobile/DeviceAgent=iPad"
For example, to set a transaction threshold on a transaction named
t1
in order to validate a given metric (i.e. AverageResponseTime) using a value specified in milliseconds:
scommand url=<CloudTest URL>/concerto/ username=soasta password=secret cmd=play wait format=junitxml name=/Demo/comp1 validation=t1/AverageResponseTime/100 \
password=secret url=
http://
<CloudTest URL>/concerto