Manual | Tutorial | Standard Library | Release Notes

Release Notes

53
Doctags

Beside node attributes, QF-Test provides another way to influence the behavior of nodes during test-execution or during report generation. That can be achieved by utilizing so-called doctags. Doctags represent text which you can specify in the 'Comment' attribute of nodes and parse parameters to them, e.g. @teststep or @noreport node.

53.1
Doctags for reporting and documentation

Those doctags influence the reporting of nodes. The most important nodes are already described in chapter 18.

Besides those there are a couple of doctags which can be used as well.

Doctag Nodes Description
@teststep [name] All nodes If this doctag is set, the node will be treated as 'Test-step' in the report. You can specify an optional name.
@report Checks, Sequence with time-limit or request steps If this is set the node will be reported as check in the report in any case.
@noreport [type],[errorlevel] All sequences like 'Test-case', 'Test-set' or 'Test-step', all Checks, Sequence with time-limit or request steps If this doctag is set, the node won't be mentioned in the report. See subsection 53.1.1 for details.
Table 53.1:  Doctags for reporting and documentation
4.2+53.1.1
@noreport Doctag

You can use the @noreport doctag to filter several nodes from the reports. You can make use of two parameters to specify the filtering. Those parameters are [type] and errorlevel.

type
You can use either 'tree' or 'node'. 'tree' is the default in case nothing is specified. Using 'tree' filters the entire node and all children from the report. 'node' filters just that particular node from the report. The children will be in the report.
errorlevel
This parameter is only activate for sequence nodes like 'Test-set','Test-case' or 'Test-step'. Using this parameter enables you to filter nodes only if dedicated error level have been reached. You can configure the error levels EXCEPTION, ERROR, WARNING or MESSAGE. For comparison you can either use =,>,<,<= or >=. errorlevel<ERROR filters the node only if no error and no exception occurred. That's the default setting. errorlevel>=MESSAGE filters the node in any case. That's very dangerous of course and should only be used if there are very good reasons.
53.2
Doctags for test execution

Using those doctags influences the execution of tests.

Doctag Nodes Description
@rerun [parameters] All nodes You can configure the instant re-run in case of errors. Please see subsection 19.3.2 for details.
Table 53.2:  Doctags for test execution
53.3
Doctags for Editing

Using those doctags can influence the behavior of QF-Test during editing.

Doctag Nodes Description
@blue All nodes Add a blue mark when opening the test-suite the next time.
@breakpoint All nodes Add a breakpoint when opening the test-suite the next time.
@green All nodes Add a green mark when opening the test-suite the next time.
@red All nodes Add a red mark when opening the test-suite the next time.
@yellow All nodes Add a yellow mark when opening the test-suite the next time.
Table 53.3:  Doctags for editing