TestCase

Schema Diagram

TOP

Description

A TestCase has all of the characteristics of an AbstractTest; in addition, a TestCase adds the following information:

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.

TOP