Element |
Status |
Purpose |
inheritance |
Optional |
The degree to which property, and/or matcher
characteristics are inherited by this TestCase . For each of
these elements, one of the following values (case insensitive) may be
specified:
- NONE – the test case does not inherit any element values, but uses
only those specified within the scope of its own definition (this is the
default)
- PARENT – the test case inherits the values of all specified elements
from its immediate parent only (i.e. the containing
TestSuite
or TestScenario )
- ROOT – the test case cumulatively inherits the values of all the
specified elements from the root-level
TestScenario , with
overrides taking place as necessary all the way down to the test itself.
|
commandList |
Required |
A collection of text strings, each of which is interpreted
by the operative as a command, complete with whatever arguments it may
require. This list permits the specification of repeated sub-elements, each
of which must be one of the following choices: |
- file |
|
The name of an arbitrary text file. The contents of the
file are read one line at a time, and each line is stored internally as a
single command. |
- command |
|
A text string that represents a single command. |
resultFile |
Optional |
This element tells the operative about the location of
expected and actual results, each of which is stored in the form
of a text file that represents the output from a test run. The test case
generates an actual result file and then compares the actual to the
expected result (possibly by preprocessing each file through a designated
filter) in order to determine the success or failure of a test. There are
two mandatory sub-elements: |
- expected |
Required |
The name of a file containing text that represents the
output expected when the test case executes. Can be any string that ends
with ".exp" (case insensitive). If the name of the file is not an
absolute reference, then the file is expected to be located somewhere in
relation to the testFileRootPath, or "." if none is supplied. |
- actual |
Required |
The name of a file that will contain the textual output
that is generated when the test case executes. Can be any string that ends
with ".act" (case insensitive). If the file exists when the test case
is executed, it will be overwritten with new content. If the name of the
file is not an absolute reference, then the file is expected to be located
somewhere in relation to the testFileRootPath, or "." if none is
supplied. |