Protokoll - QF-Test

Version 8.0.1

Die folgenden Optionen haben Einfluss darauf, welche Informationen in einem Protokoll aufgezeichnet werden, wann dieses angezeigt und wie es gespeichert wird.

Abbildung 40.38: Protokoll-Optionen

Protokoll anzeigen (User)

Hier lässt sich einstellen, ob und unter welchen Bedingungen das Protokoll, das für jeden Testlauf erzeugt wird, angezeigt werden soll. Die Protokolle der letzten Testläufe sind in jedem Fall über das Menü »Wiedergabe« abrufbar. Die Tastenkombination [Strg-L] ruft das jeweils letzte Protokoll ab.

Zu Beginn
Legt fest, dass das Protokoll bereits beim Start eines Testlaufs angezeigt wird.

Nach dem Ende
Bei dieser Einstellung wird das Protokoll angezeigt, nachdem ein Testlauf beendet ist.

Nur bei Exception
In diesem Fall wird das Protokoll nur angezeigt, wenn ein Testlauf durch eine Exception abgebrochen wird.

Nicht anzeigen
Hier wird das Protokoll nicht automatisch angezeigt, ist aber dennoch über das »Wiedergabe« Menü oder mittels [Strg-L]. zugänglich.

6.0+Relative Dauer anzeigen (User)

Server Skript Name: OPT_LOG_DURATION_INDICATORS

Um das Laufzeitverhalten eines Tests zu analysieren hilft ein schneller Blick darauf, in welchen Zweigen die meiste Zeit verbracht wird. Zu diesem Zweck kann über diese Option die Anzeige der relativen Dauer im Protokoll aktiviert werden. Die Option ist auch direkt über das »Anzeige« Menü im Protokoll zugänglich.

Die Länge der angezeigten Balken entspricht dem relativen Anteil der Dauer des Knotens an der Dauer seines Parentknotens.

6.0+Anzeigeform für relative Dauer (User)

Server Skript Name: OPT_LOG_DURATION_INDICATORS_KIND
Mögliche Werte: VAL_LOG_DURATION_INDICATORS_KIND_DURATION, VAL_LOG_DURATION_INDICATORS_KIND_REALTIME, VAL_LOG_DURATION_INDICATORS_KIND_BOTH

Über diese Option wird festgelegt, ob sich die Anzeige der relativen Dauer im Protokoll auf die Dauer, die Echtzeit oder beides bezieht.

HinweisUnterschiede zwischen den Werten "Dauer" und "Echtzeit" entstehen zum Beispiel durch explizite Verzögerungen in Knoten mittels 'Verzögerung vorher/nachher' oder bei Unterbrechungen durch den Benutzer.

Wie viele alte Protokolle im Menü (User)

Hier können Sie einstellen, wie viele Protokolle im »Wiedergabe« Menü aufgehoben werden sollen. Werden mehr Testläufe durchgeführt als Protokolle aufgehoben werden sollen, werden die jeweils ältesten Protokolle verworfen. Sofern sie nicht gespeichert wurden, sind sie damit unwiederbringlich verloren.

3.0+Protokolle automatisch speichern (User)

Um übermäßigen Speicherverbrauch zu vermeiden und außerdem die letzten Protokolle zwischen verschiedenen QF-Test Sessions persistent zu machen, werden die aktuellen Protokolle im »Wiedergabe« Menü automatisch im benutzerspezifischen Konfigurationsverzeichnis gespeichert, bzw. in dem Verzeichnis, das in der Option Verzeichnis für Protokolle spezifiziert wurde. Der Dateiname für ein Protokoll wird aus einem Zeitstempel gebildet. QF-Test sperrt diese Dateien, um Konflikte und versehentliches Löschen bei mehreren parallelen QF-Test Sessions zu vermeiden und hält das benutzerspezifische Konfigurationsverzeichnis durch regelmäßiges Löschen der unbenutzten Protokolle sauber. Es sollte also keinen Grund geben, diese Funktion auszuschalten, aber wenn Sie darauf bestehen, können Sie es mittels dieser Option tun.

4.0+Verzeichnis für Protokolle (User)

Standardmäßig werden bei interaktiver Ausführung von QF-Test Protokolle im benutzerspezifischen Konfigurationsverzeichnis. Mit dieser Option können Sie ein alternatives Zielverzeichnis angeben.

Hinweis Diese Option wird von QF-Test bei jedem Start eines Tests ausgewertet. Zu diesem Zeitpunkt sind globale Variablen und Variablen der Testsuite bereits definiert und im Gegensatz zu andere Option darf hier die QF-Test Variablensyntax verwendet werden, einschließlich spezieller Variablen wie ${env:HOME} um Umgebungsvariablen auszuwerten oder sogar ${qftest:suite.dir} um das Protokoll neben der Testsuite abzulegen. Falls das Verzeichnis, wie im letzten Fall, dynamisch ist, kann QF-Test eventuell alte Protokolle nicht regelmäßig aufräumen. Fehler bei der Expansion von Variablen werden ohne Meldung ignoriert und das benutzerspezifische Konfigurationsverzeichnis stattdessen verwendet.

3.1+Expandierte Variablenwerte in Baumknoten anzeigen (User)

Die Knoten der Baumansicht eines Protokolls können entweder mit expandierten Variablen - mit Werten vom Zeitpunkt der Ausführung - dargestellt werden, oder mit den Variablen selbst. Beide Ansichten sind nützlich, daher können Sie mittels dieser Option, oder einfacher über den Menüeintrag »Ansicht«-»Knoten expandiert darstellen«, zwischen ihnen wechseln.

7.0+Rückgabewerte von Prozeduren anzeigen (User)

Ist diese Option aktiv, werden Rückgabewerte von 'Prozedur' Knoten im Baum neben dem entsprechenden 'Prozeduraufruf' Knoten angezeigt. In einem Protokoll kann der Wert dieser Option auch einfach über den Menüeintrag »Ansicht«-»Rückgabewerte von Prozeduren anzeigen«.

Unterdrückte Fehler überspringen (User)

Wie die vorhergehende, bezieht sich auch diese Option auf die Suche nach Fehlern im Protokoll. Ist sie aktiviert, werden nur solche Warnungen, Fehler oder Exceptions gefunden, die im Protokoll nach oben durchgereicht wurden. Exceptions, die durch ein 'Try'/'Catch' Konstrukt abgefangen oder Meldungen, die durch das 'Maximaler Fehler' Attribut unterdrückt wurden, werden übersprungen.

Diese Option kann sowohl über den Optionen-Dialog, als auch direkt über den Menüeintrag »Bearbeiten«-»Unterdrückte Fehler überspringen« verändert werden.

3.0+ Nach Sprung zum nächsten oder vorhergehenden Fehler Baum aufräumen (User)

Werden mehrfach Fehler in einem Protokoll angesprungen, kann dieses leicht durch die vielen expandierten Knoten unübersichtlich werden. Ist diese Option aktiviert, räumt QF-Test automatisch nach jedem Sprung zu einem Fehler den Baum auf, so dass nur die Parent-Knoten des aktuellen Fehlers expandiert sind.

Hinweis Beim Bearbeiten von geteilten Protokollen werden Teil-Protokolle, die einen Fehler enthalten, so lange im Speicher gehalten wie ihre Knoten expandiert sind. Durch Aktivieren dieser Option können Sie sicherstellen, dass Teil-Protokolle so bald wie möglich freigegeben werden und der Speicherverbrauch auch beim Betrachten der Fehler eines sehr großen Protokolls im Rahmen bleibt.

Protokolle komprimiert speichern (*.qrz) (System)

Server Skript Name: OPT_LOG_SAVE_COMPRESSED

Protokolle können als normale oder als komprimierte XML-Datei gespeichert werden. Für große Protokolle ohne Bildschirmabbilder kann der Kompressionsfaktor durchaus 10 und mehr betragen, so dass es ratsam ist, Kompression zu verwenden. Das einzige Argument dagegen ist, wenn Sie die XML-Protokolle nachträglich transformieren wollen. Da QF-Test aber den Standard gzip Algorithmus zur Kompression verwendet, können komprimierte und normale Protokolle jederzeit mittels gzip ineinander umgewandelt werden.

Wenn Sie ein Protokoll interaktiv speichern, können Sie jederzeit über die Kompression entscheiden indem Sie im Dialog den entsprechenden Filter auswählen oder der Datei die Entsprechende Endung .qrl oder .qrz geben.

Im Batch Modus werden Protokolle normalerweise komprimiert geschrieben. Um ein unkomprimiertes Protokoll zu erstellen geben Sie einfach mit dem Kommandozeilenargument -runlog [<Datei>] eine Datei mit der Endung .qrl an.

7.0+Protokoll in aktuellem XML-Format mit UTF-8-Kodierung speichern (System)

Server Skript Name: OPT_XML_LOG_NEW

Ab QF-Test Version 7.0 werden Protokolle im aktuellen XML-Format mit UTF-8-Kodierung, ohne Einrückung und beliebiger Zeilenlänge gespeichert. Falls Sie für die Auswertung in externen Programmen auf das alte Format für Protokolle mit ISO-8859-1 Kodierung, Einrückung von 2 Zeichen und Zeilenlänge 78 angewiesen sind, können Sie es durch Deaktivieren dieser Option wieder herstellen.

Abbildung 40.39: Optionen zur Aufteilung von Protokollen

3.0+Geteilte Protokolle erzeugen (User)

Server Skript Name: OPT_LOG_SAVE_SPLIT

Ein Protokoll kann durch setzen des Attributs 'Name für separates Protokoll' eines 'Datentreiber' Knotens oder eines der verschiedenen Test Knoten in mehrere Teile zerlegt werden. Sie können diese Funktion deaktivieren, indem Sie diese Option ausschalten. So müssen Sie keine 'Name für separates Protokoll' Attribute ändern, wenn Sie zwischendurch ein komplettes Protokoll erstellen wollen.