STAX is a simple XML language that can be used to write
automation code. The automation code is executed on a central STAX
server and can use STAF commands to interact with test machines.
A task is considered to be a single piece of automation.
It has a title and a list of arguments. Each task corresponds to a
single STAX XML file located in the staxPath configured in the integration_config.xml
file.
- The STAX files in the staxPath folder must have the following
format:
- The STAX file must specify the <defaultCall> element,
pointing to the main function of the task. The XML file can contain
multiple functions, but only the defaultcall is executed by IBM® Rational® Quality
Manager.
- The default function must specify the <function-prolog> element,
which must contain a short title for the task that displays in the
user interface.
- The default function can optionally specify the <function-epilog> element
that contains a detailed description of the task. This value is not
currently used in the user interface but might be used in the future.
- The default function must specify the <function-list-args> element.
- Rational Quality Manager always
passes the hostname of the target machine as the first argument. The
first argument in <function-list-args> must be:
- You can specify additional arguments by using <function-optional-arg> elements.
Use these instead of <function-required-arg> (even
if the argument is required) because they allow a default value to
be specified. This default value is displayed in the user interface.
The default attribute must be a python string (enclosed in single
quotes):
- The final element of the task should be a <return> element
that returns 0 for pass, or non-zero for fail.