Software
Testing Automation Framework Execution Engine (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 Software
Testing Automation Framework (STAF) commands
to interact with test machines.
About this task
A task is 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.
Procedure
- 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.