!!!TestCaseTable

Alternatively to sequential test cases ([Doc TestCase]) there is another way to define a test case using the TestCaseTable markup.

{{{
%%TestCaseTable 
|| Time	|| Engine noises|| "Check: Ignition timing."||"Average mileage /100km"|| Checks	
|  0s	|  ringing	|   	                     |                         | Bad ignition timing = Suggested
|  1s	|  ringing	|              ok            |              10.0       | Bad ignition timing = Excluded
@name: TableTestCase
%
}}}

Renders as:

[{Image src='TestCaseTable-screenshot.png' caption='Screenshot of a TestCaseTable markup' width='..' height='..' style='margin-left: 20px' class='..' }]

It is possible to specify a name and a time for each row of the line in the first two columns (name must occur before time). If a column header is named "Checks" this column specifies checks being executed in that line. All conditions from the rule markup can be used as checks. On all other columns a question must be referenced in the header cell and a compatible value in the table cells.

The annotation name optionally specifies a name of the table, if no name is specified, the tables gets numbered.


!!Defining a Test Case with a another Test Case as its Prefix

The TestCaseTable markup allows to define any other named TestCaseTable as its prefix. When viewed in the [TestCasePlayer|Doc TestCasePlayer], both cases are stitched together and are viewed and run as one. This is useful, if you have many test cases for the same knowledge base, that for example share a common initialization or start sequence. This common initialization can then be defined as a prefix test case to be prepended to all the actual test cases.

The last row of the prefix test case and the first row of actual test case are merged into one, so it is advisable to define the last row in the prefix test case (or the first of the actual test case) empty with just a time stamp. This way, it is possible to define the time gap between the prefix and the actual test case. All time stamps in the actual test case are shifted to the future by the time it takes to run the prefix test case (defined by the timestamps of the prefix).

The prefix mechanism works recursively, so it is possible to set a test case that has a prefix as the prefix of yet another test case (and so forth).


!Example for usage of prefixes:

First, we define our prefix test case where we initialize some variables like weight, height, and age. They will not change during the test case, so they can easily be extracted to the prefix. We add a second line, where we set the time stamp to 5 min. In the screenshot below, you will see, that all the time stamps will be shifted by 5 minutes because of this. (Since this is a simple example, the 5 minutes are not really necessary for this test case. They are for demonstration purposes only.)

{{{
%%TestCaseTable
|| Name			|| Time	|| Checks || Weight || Height	|| Age	
|  Normal adult values	|  0s	|   	  |  75	    |  1.8	|  21	
|   			|  5min	|   	  |   	    |   	|   	
@name: Initial Questions
%
}}}

{{{
%%TestCaseTable
|| Name	|| Time	|| Checks	|| Heart rate	|| Physical activity of last 5 minutes	
|  Being at rest for 5 minutes	|  0s	|  Heart rate monitor = Normal	|  65	|  Non	
|   	|  1s	|  Heart rate monitor = Too high	|  110	|   	
|   	|  2s	|  Heart rate monitor = Too low	|  45	|   	
@name: At Rest
@prefix: Initial Questions
%
}}}

{{{
%%TestCaseTable
|| Name			 || Time || Checks			  || Heart rate	|| Physical activity of last 5 minutes	
|  Hard physical activity|  0s	 |  Heart rate monitor = Normal	  |  160	|  Hard	
|   			 |  1s	 |  Heart rate monitor = Too high |  210	|   	
|		    	 |  2s	 |  Heart rate monitor = Too low  |  90		|   	
@name: Hard physical activity
@prefix: Initial Questions
%
}}}

Together with a [TestCasePlayer|Doc TestCase] it renders like this:

[{Image src='PrefixedTestCases.png' caption='Screenshot of test cases using prefixes' width='900' height='..' style='margin-left: 10px' class='..' }]


!! Related Doc Pages

* [Doc TestCasePlayer]
* [Doc TestCase]
* [Doc TestCaseSessionRecord]

%%tags
Documentation testcase tables
%