Read the test results from a file specified in the PinDown XML file format.

This command must be called before the diagnosis command.

You can either read all test results or limit the read to only failures, ignoring passes. You can also limit the number of test results that are read. Note that if you only don’t read in all test results then you must use clear_results_database, because otherwise bugs risk staying open forever. This is because a bug is only closed when a test passes that was previously failing, but if we don’t read in all test results then we may miss these passing tests.

When using the read_result command in test phase, the environment variables BUILD_PASSES, BUILD_FAILS, TEST_PASSES and TEST_FAILS will be created and assigned values. Related to these variables are the OPEN_BUGS variable. The variables can e.g be used in user defined scripts.

Syntax

read_results "file.xml" [-type "failures"/"all"] [-max N];

"file.xml"

A file containing the test results, specified in the PinDown XML format.

‑type

Defines whether "all" test results should be read, or only "failures". If not set then the default value is "all".

‑max

Limits the number of test results to read. If not set then there is no limit.

Examples

read_results "xta_result.xml"; // Reads all test results in xta_result.xml
read_results "xta_result.xml" -type "failures"; // Only read test failures from xta_result.xml
read_results "xta_result.xml" -max "3"; // Reads max 3 test results, either passes or failures, from xta_result.xml
read_results "xta_result.xml" -type "failures" -max "2"; // Reads max 2 test failures, and ignore passes, from xta_result.xml