run

The run command lets you run another test from this test, in a similar way to JUnit test-suites. This can be a useful way to view progress on a set of acceptance tests for a story.

The format is:

<a concordion:run="runner-name" href="relative-link">some link text</a>

The runner-name should normally be "concordion". However, it is possible to implement your own runners (e.g. to run tests implemented in another tool) by subclassing org.concordion.api.Runner and then either specifying the full name of your Runner class, or an alias with the full class name specified as a System parameter (concordion.runner.alias = full-class-name).

Example 1

Here we run the test for the set command using this HTML:

<a concordion:run="concordion.net" href="..\set\Set.html">set command</a>

Example 2

The following instrumentation:

<p>
   <a concordion:run="runtestrunner" href="PassingSpec.html">
      My spec
   </a>
</p> 

We get the following outcomes depending on the result of the RunTestRunner:

Expected Href Run Result Outcome
PassingSpec.html SUCCESS SUCCESS
FailingSpec.html FAILURE FAILURE