Next: , Previous: The RTAv1 file format, Up: The ARTE RTA Test Files

5.2 The RTAv2 file format

The ‘RTAv2’ file format is just an extension of ‘RTAv1’ to include an additional mandatory file (description.xml):

‘TCL script (whatever.tcl)’
The TCL script to be executed in the RTA test. Note that the filename is not important, but it must have the proper tcl extension. Also, only one single file with tcl extension must be available inside the RTA.
‘test.conf’
The test-specific configuration file, to include test-specific environment variables as specified in section The test.conf test configuration.
‘version’
The file specifying the version of this RTA. For ‘RTAv2’, it must contain: 

          
          version 2

‘description.xml’
This additional file is mandatory in ‘RTAv2’, and contains the description of the test in an easily computer-parseable XML format. The format of the XML file is fixed, and specified by the description-rta.xsd XML Schema available in the etc directory of the source code. Note that an invalid ‘description.xml’ indicates a wrong RTA file, and ARTE will reject it, so it is very important to make sure that the file validates against the provided XSD. 

          
          <?xml version=”1.0” encoding=”UTF-8”?>
            <ARTE-TEST xmlns=”http://arte/description-rta”>
              <ModuleID>generic</ModuleID>
              <TestGroupID>generic-test-hello</TestGroupID>
              <Author>aleksander</Author>
              <Date>Sun Feb 15 20:59:03 2009</Date>
              <TestDescription>
                  This test does this and that, to test problem
                  reported in ticket #12345
              </TestDescription>
              <ExpectedResult>
                  The test should pass if whatever thing happened
              </ExpectedResult>
          </ARTE-TEST>

In addition to the previous mandatory parameters, the ‘RTAv2’ file may contain any additional file needed to in the test.