XML parser

A test suite XML parser

XML elements

In this section all defined test suite XML elements are presented. If an element allows or needs child elements these are listed in brackets behind the element name. Each child element can be followed by a character that describes its usage:


An email address


This element contains the test users authentication name. It can differ from the user name but often user name and authentication name are the same.


This element represents an attribute-value pair (AVP) of a test user.

configuration (global?, local?)

The configuration element stores test suite configuration (global) as well as the configuration of the test cases (local). For every test case the local configuration can be overwritten and will be used only for the run time of this test case.

dbadapter (type, arg*)

To use a database adapter it has to be specified with this element. It can be only one database adapter defined per test suite.


The domain a test user belongs to.

email (address, subject, smtpaddress, smtpport)

The data needed to send the test protocol by email.

global (users?, dbadapter?)

In the global element configuration data needed for setting up the test suite is stored.

local (target?, interface?, modules?)

In the local element configuration data needed for setting up test cases is stored. This element is defined as a container for any kind of sub elements. This means that sub elements can be defined by the user and used in the test cases. A number of sub elements is already defined because they are needed in the existing test cases.

logging (email?, logfilepath?)

This element stores the logging configuration data.


The password of a test user.


The realm of a test user.


The ip address or url of a smtp server.


The port of a smtp server.


The subject for an email.

testcase (configuration?, testuser*)

The testcase element contains the definition of a test cases environment. Therefore the local configuration of the test suite (or parts of it) can be overwritten. This new local configuration is only for this test case. Furthermore a number of test users can be defined. These users will be autmatically inserted into a database if this feature is active for the test suite and they will be written into files needed by this test case.

testgroup (testcase*)

A test group is a structural element containing a number of test cases. The semantical separation of test cases into test groups makes easier to handle them and the test protocol more readable. Test groups have neither effect on the behavior of test cases nor any influence to the performance of a test suite.

testsuite (configuration, logging, testgroup*)

This element is the top element of a test suite XML file. It contains the definition of a test suite and the definition of its test groups and test cases. The global and the default local configuration as well as parameters for logging can be set under this element.

testuser (uuid?, username*, authname?, domain?, realm?, password?, avp*)

This element contains the definition of test user needed by a test case. For every test user a mode can be set. The mode 'files_only' means that this user is only inserted into the files the test case needs, 'db_only' stands for inserting the user only into the database (if test suite supports this feature) and for 'all' the test user is inserted into files and database (if test suite supports writing into the database). If the feature "users.static" is active for a test suite the user is not written into a database even if the mode is 'db_only' or 'all'. The attribute 'prefix' stands for a prefix that is used to write the data into files: If more than one user has to be written into a file they can be distinguished by this prefix (e.g. prefix='u1' then the wildcards in the files have to look like [#U1_USERNAME#]).


This element specifies the type of the parent element.


One username of a test user. It can have any number of undefined attributes.


The uuid of a test user.

Generated on Mon Aug 11 17:28:32 2008 for TestEnv by  doxygen 1.5.5