Handbuch

52
Doctags

Neben den Eigenschaften der unterschiedlichen Knoten bietet QF-Test noch weitere Konfigurationsmöglichkeiten an, um das Verhalten bei der Testausführung bzw. die Darstellung von Knoten im Report zu beeinflussen. Dies erfolgt über so genannte Doctags. Doctags sind Texte, die Sie in das Attribut 'Bemerkung' von Knoten eintragen können und mit bestimmten Werten versehen können, z.B. @teststep oder @noreport node.

52.1
Doctags für Reporting und Dokumentation

Diese Doctags beeinflussen die Darstellung von Knoten im Report. Die wichtigsten sind bereits umfassend im Kapitel 17 beschrieben.

Neben diesen Doctags gibt es allerdings noch eine Reihe weiterer Doctags, die verwendet werden können.

Doctag Knoten Beschreibung
@teststep [name] Alle Knoten Ist dieser Doctag gesetzt, so wird dieser Knoten als 'Testschritt' im Report behandelt. Es kann ein optionaler Name angegeben werden.
@report Check Knoten, Sequenz mit Zeitlimit, Request Knoten Ist dieser Doctag gesetzt, so wird dieser Knoten auf jeden Fall im Report als Check aufgeführt.
@noreport [type],[errorlevel] Alle Sequenzknoten wie 'Testfallsatz','Testfall' oder 'Testschritt' sowie alle Check Knoten, Sequenz mit Zeitlimit, Request Knoten Ist dieser Doctag gesetzt, so wird dieser Knoten nicht im HTML Report aufgeführt. Details zur Konfiguration, siehe Abschnitt 52.1.1.
Tabelle 52.1:  Doctags für Report und Dokumentation
4.2+52.1.1
@noreport Doctag

Der @noreport Doctag kann bestimmte Knoten aus dem Report herausfiltern. Um die Filterung genauer zu spezifizieren, können Sie auch die zwei Parameter [type] und errorlevel konfigurieren.

type
Hier können Sie entweder 'tree' oder 'node' angeben. 'tree' ist hier auch die Standardbelegung, falls nichts angegeben wurde. Die Angabe von 'tree' filtert diesen Knoten und alle Kindknoten aus der Reporterstellung. 'node' filtert nur diesen einen Knoten aus dem Report heraus, die Kindknoten werden aber wieder im Report dargestellt.
errorlevel
Dieser Parameter ist nur bei Sequenzknoten wie 'Testfallsatz','Testfall' oder 'Testschritt' aktiv. Mit diesem Parameter ist es möglich, Knoten nur zu filtern, wenn eine Fehlerstufe erreicht wurde. Hier können Sie die Fehlerstufen EXCEPTION, ERROR, WARNING oder MESSAGE angeben, entweder exakt (mit =) oder mit >,<,<= oder >=. Mit errorlevel<ERROR wird der Knoten nur gefiltert, wenn kein Fehler und keine Exception aufgetreten ist, dies ist auch die Standardbelegung. errorlevel>=MESSAGE wird der Knoten immer gefiltert, egal, welches Ergebnis. Das ist natürlich sehr gefährlich und sollte nur bei sehr guten Gründen verwendet werden.
52.2
Doctags für die Ausführung

Diese Doctags beeinflußen das Verhalten von Knoten während der Testausführung.

Doctag Knoten Beschreibung
@rerun [parameters] Alle Knoten Hiermit wird die sofortige Neuausführung von Knoten im Fehlerfall konfiguriert. Details, siehe Abschnitt 18.3.2.
Tabelle 52.2:  Doctags für die Ausführung
52.3
Doctags für das Editieren

Diese Doctags beeinflußen das Verhalten von QF-Test während des Editierens.

Doctag Knoten Beschreibung
@blue Alle Knoten Setzt eine blaue Marke auf diesen Knoten beim nächsten Öffnen der Testsuite.
@breakpoint Alle Knoten Setzt einen Breakpoint auf diesen Knoten beim nächsten Öffnen der Testsuite.
@green Alle Knoten Setzt eine grüne Marke auf diesen Knoten beim nächsten Öffnen der Testsuite.
@red Alle Knoten Setzt eine rote Marke auf diesen Knoten beim nächsten Öffnen der Testsuite.
@yellow Alle Knoten Setzt eine gelbe Marke auf diesen Knoten beim nächsten Öffnen der Testsuite.
Tabelle 52.3:  Doctags für das Editieren
Videos Downloads Dokumentation Kaufen Gratis Testen