The RunTestPlan task is a plugin task for ant. To use it, download it and place the jar file in your Ant installation lib directory. Then include a taskdef element at the top of your ant build file like so:
<taskdef name="runTestPlan" classname="com.badboy.ant.WTMTask"/>
Adds a specified test plan to the script queue on a remote Wave Test Manager server.
Optionally the task can wait for the scripts belonging to the test plan to be processed on the server and only exit when they are finished. This behavior is specified by setting the "waitFor" property to "true" or "yes". When this behavior is enabled and the script fails (has errors or assertion failures) by default it will fail the build with an error. This can be disabled by setting the failOnError property to false.
Note: see the RunScript task if you want to run a script using Badboy directly instead of through Wave Test Manager.
| Attribute | Description | Required |
| name | The name of the test plan to run. It must be an existing test plan on the Wave Test Manager server. | Yes |
| server | The host name and port of the Wave Test Manager server that should run the test | No; Defaults to localhost:8030 |
| failOnError | true or false - controls whether errors or assertion failures in the script are treated as a build failure. | No; Defaults to true. |
| waitFor | true or false - controls whether ant will wait for the scripts in the test plan to execute and complete before allowing the build to continue. | No; Defaults to false. |
The following example runs a test plan called "Example" on server "myserver" and waits for it to finish. If the test fails, the build will also fail.
<runtestplan name="Example" waitFor="true" server="myserver"/>