Kommandozeilenargumente und Rückgabewerte

Aufrufsyntax

Die Aufrufsyntax für interaktiven und Batchmodus unterscheidet sich deutlich, da einige Kommandozeilenargumente für den interaktiven, andere für den Batchmodus oder einen Sub-Modus davon spezifisch sind. Beachten Sie, dass alle Argumente sinnvolle Voreinstellungen besitzen und nur in besonderen Fällen angegeben werden müssen. Im Allgemeinen verwenden Sie lediglich qftest [<Suite> | <Protokoll>]* für den interaktiven Modus oder qftest -batch [-runlog [<Datei>]] [-report <Verzeichnis>] <Suite> für den Batchmodus.

5.2+ Für maximale Flexibilität wird bei den Namen der QF-Test Kommandozeilenargumente Groß-/Kleinschreibung ebenso ignoriert, wie enthaltene '-', '_', '.' oder ':'-Zeichen. Somit ist -report.html äquivalent zu --reportHtml oder -report-html. Letzteres ist die offiziell dokumentierte Form, da sie Konflikte mit der Windows PowerShell vermeidet.

WindowsDas Programm qftest.exe ist eine Windows GUI-Anwendung. Wird diese von der Eingabeaufforderung gestartet, wartet sie nicht darauf, dass QF-Test beendet wird, sondern kehrt sofort zurück. Wenn also ein Test im Batchmodus ausgeführt wird, kann man nicht erkennen, ob QF-Test bereits beendet ist oder nicht (man könnte dem Abhelfen, indem man die Anweisung in eine .bat Datei packt). Außerdem werden bei Verwendung von qftest.exe keine Ausgaben von QF-Test in der Konsole angezeigt. Besser geeignet für die Ausführung von der Eingabeaufforderung ist daher die Konsolen-Anwendung qftestc.exe: Sie wartet, bis QF-Test sich beendet und wenn 'Server-Skripte' print-Ausgaben vornehmen, werden diese auf der Konsole angezeigt. Ansonsten gilt was in diesem Kapitel über qftest.exe gesagt wird auch für qftestc.exe.

Mac Falls die macOS App verwendet wird können diese Parameter auch direkt via »Bearbeiten«-»Optionen« unter Allgemein->Programmstart definiert werden (siehe auch Aufruf von QF-Test).

Interaktiver Modus

Die Aufrufsyntax für den interaktiven Modus lautet:

qftest [-dbg] [-java <Programm>(abgekündigt)] [-noconsole] [-J<Java-Argument>]* [-allow-shutdown [<Shutdown-ID>]] [-daemon] [-daemonhost <Host>] [-daemonport <Port>] [-daemonrmiport <Port>] [-dontkillprocesses] [-engine <Engine>] [-groovydir <Verzeichnis>] [-help] [-ipv6] [-javascriptdir <Verzeichnis>] [-jythondir <Verzeichnis>] [-jythonport <Nummer>] [-keybindings <Wert>] [-keystore <Keystore-Datei>] [-keypass <Kennwort>] [-libpath <Pfad>] [-license <Datei>] [-license-waitfor <Sekunden>] [-logdir <Verzeichnis>] [-noplugins] [-noupdatecheck] [-option <Name>=<Wert>] [-options <Datei>] [-plugindir <Verzeichnis>] [-port <Nummer>] [-reuse] [-run] [-runlogdir <Verzeichnis>] [-runtime] [-serverhost <Host>] [-shell <Programm>] [-shellarg <Argument>] [-splitlog] [-suitesfile <Datei>] [-systemcfg <Datei>] [-systemdir <Verzeichnis>] [-tempdir <Verzeichnis>] [-test <Index>|<ID>]* [-usercfg <Datei>] [-userdir <Verzeichnis>] [-variable <Name>=<Wert>]* [-version] [<Testsuite> | <Protokoll>]*

Es gibt mehrere Sub-Modi für die Ausführung von QF-Test im Batchmodus. Standardfall ist die Durchführung von Tests aus einer oder mehreren Testsuiten. Alternativ können Test-Dokumentation aus Testsuiten oder Reports aus Protokollen generiert werden. Außerdem kann QF-Test im Daemon-Modus gestartet werden in dem es von außen gesteuert werden kann (siehe Kapitel 54). Und schließlich kann auch die Anzeige von Hilfs- oder Versionsinformationen als Sub-Modus angesehen werden.

Tests durchführen

Um eine oder mehrere Testsuiten auszuführen und dabei ein Protokoll und/oder einen Report zu erstellen, verwenden Sie:

qftest -batch [-run] [-dbg] [-java <Programm>(abgekündigt)] [-noconsole] [-J<Java-Argument>]* [-allow-shutdown [<Shutdown-ID>]] [-clearglobals] [-compact] [-engine <Engine>] [-exitcode-ignore-exception] [-exitcode-ignore-error] [-exitcode-ignore-warning] [-groovydir <Verzeichnis>] [-ipv6] [-javascriptdir <Verzeichnis>] [-jythondir <Verzeichnis>] [-jythonport <Nummer>] [-keystore <Keystore-Datei>] [-keypass <Kennwort>] [-libpath <Pfad>] [-license <Datei>] [-license-waitfor <Sekunden>] [-logdir <Verzeichnis>] [-nolog] [-nomessagewindow] [-noplugins] [-option <Name>=<Wert>] [-options <Datei>] [-plugindir <Verzeichnis>] [-port <Nummer>] [-report <Verzeichnis>] [-report-checks] [-report-customdir <Verzeichnis>] [-report-doctags] [-report-errors] [-report-exceptions] [-report-html <Verzeichnis>] [-report-ignorenotimplemented] [-report-ignoreskipped] [-report-junit <Verzeichnis>] [-report-name <Name>] [-report-nodeicons] [-report-passhtml] [-report-piechart] [-report-include-suitename] [-report-scale-thumbnails <Prozent>] [-report-teststeps] [-report-thumbnails] [-report-warnings] [-report-xml <Verzeichnis>] [-runid [<ID>]] [-runlogdir <Verzeichnis>] [-runlog [<Datei>]] [-runtime] [-serverhost <Host>] [-shell <Programm>] [-shellarg <Argument>] [-sourcedir <Verzeichnis>] [-suitesfile <Datei>] [-splitlog] [-systemcfg <Datei>] [-systemdir <Verzeichnis>] [-test <Index>|<ID>]* [-threads <Anzahl>] [-userdir <Verzeichnis>] [-variable <Name>=<Wert>]* [-verbose [<level>]] <Testsuite>+
Ausführen eines Test durch einen QF-Test Daemon

Die folgenden Parameter steuern die Ausführung eines QF-Test Daemon-Tests:

qftest -batch -calldaemon [-cleanup] [-clearglobals] [-dbg] [-java <Programm>(abgekündigt)] [-noconsole] [-J<java-argument>]* [-daemonhost <Host>] [-daemonport <Port>] [-exitcode-ignore-exception] [-exitcode-ignore-error] [-exitcode-ignore-warning] [-ipv6] [-keystore <Keystore-Datei>] [-keypass <Kennwort>] [-nomessagewindow] [-ping] [-options <Datei>] [-runid [<ID>]] [-runlogdir <Verzeichnis>] [-runlog [<Datei>]] [-startclean] [-startsut] [-stopclean] [-stoprun] [-suitedir <Verzeichnis>] [-systemdir <Verzeichnis>] [-terminate] [-timeout <Millisekunden>] [-userdir <Verzeichnis>] [-variable <Name>=<Wert>]* [-verbose [<level>]] <suite#test-case>
XML-Format bestehender Testsuiten ändern
qftest -batch -convertxml [-convertxml-indent <Anzahl>] [-convertxml-linelength <Anzahl>] [-convertxml-utf8 <true|false>] (<Testsuite> | <Verzeichnis>)+
Test-Dokumentation erstellen
Package oder Testfall Dokumentation kann für eine oder mehrere Testsuiten oder ganze Verzeichnisse in einem Durchgang erstellt werden. Dies wird in Kapitel 23 genauer beschrieben. Die Kommandozeilen Syntax lautet:
qftest -batch -gendoc [-dbg] [-java <Programm>(abgekündigt)] [-noconsole] [-J<Java-Argument>]* [-license <Datei>] [-license-waitfor <Sekunden>] [-option <Name>=<Wert>] [-options <Datei>] [-nomessagewindow] [-pkgdoc <Verzeichnis>] [-pkgdoc-doctags] [-pkgdoc-dependencies] [-pkgdoc-html <Verzeichnis>] [-pkgdoc-includelocal] [-pkgdoc-nodeicons] [-pkgdoc-passhtml] [-report-piechart] [-report-include-suitename] [-pkgdoc-sortpackages] [-pkgdoc-sortprocedures] [-pkgdoc-xml <Verzeichnis>] [-sourcedir <Verzeichnis>] [-systemdir <Verzeichnis>] [-testdoc <Verzeichnis>] [-testdoc-doctags] [-testdoc-followcalls] [-testdoc-html <Verzeichnis>] [-testdoc-nodeicons] [-testdoc-passhtml] [-testdoc-sorttestcases] [-testdoc-sorttestsets] [-testdoc-teststeps] [-testdoc-xml <Verzeichnis>] (<Testsuite> | <Verzeichnis>)+
Einen Report aus Protokollen erstellen

Um einen Report aus einem oder mehreren Protokollen oder ganzen Verzeichnissen zu erstellen verwenden Sie:

qftest -batch -genreport [-dbg] [-java <Programm>(abgekündigt)] [-noconsole] [-J<Java-Argument>]* [-license <Datei>] [-license-waitfor <Sekunden>] [-nomessagewindow] [-option <Name>=<Wert>] [-options <Datei>] [-report <Verzeichnis>] [-report-checks] [-report-customdir <Verzeichnis>] [-report-doctags] [-report-errors] [-report-exceptions] [-report-html <Verzeichnis>] [-report-ignorenotimplemented] [-report-ignoreskipped] [-report-junit <Verzeichnis>] [-report-name <Name>] [-report-nodeicons] [-report-passhtml] [-report-piechart] [-report-include-suitename] [-report-scale-thumbnails <Prozent>] [-report-teststeps] [-report-thumbnails] [-report-warnings] [-report-xml <Verzeichnis>] [-runlogdir <Verzeichnis>] [-systemdir <Verzeichnis>] (<Protokoll> | <Verzeichnis>)+
Daemon-Modus

Um QF-Test im Daemon-Modus wie in Kapitel 54 beschrieben zu starten verwenden Sie:

qftest -batch -daemon [-dbg] [-java <Programm>(abgekündigt)] [-noconsole] [-J<Java-Argument>]* [-daemonhost <Host>] [-daemonport <Port>] [-daemonrmiport <Port>] [-engine <Engine>] [-groovydir <Verzeichnis>] [-ipv6] [-javascriptdir <Verzeichnis>] [-jythondir <Verzeichnis>] [-jythonport <Nummer>] [-keystore <Keystore-Datei>] [-keypass <Kennwort>] [-libpath <Pfad>] [-license <Datei>] [-license-waitfor <Sekunden>] [-logdir <Verzeichnis>] [-nolog] [-nomessagewindow] [-noplugins] [-option <Name>=<Wert>] [-options <Datei>] [-plugindir <Verzeichnis>] [-port <Nummer>] [-runtime] [-serverhost <Host>] [-shell <Programm>] [-shellarg <Argument>] [-systemcfg <Datei>] [-systemdir <Verzeichnis>] [-usercfg <Datei>] [-variable <Name>=<Wert>]*
Eine Testsuite in eine andere importieren
qftest -batch -import [-import-from <Testsuite>] [-import-into <Testsuite>] [-import-components] [-import-procedures] [-import-tests]
Referenzen einer Testsuite analysieren
qftest -batch -analyze [-analyze-target <Verzeichnis>] [-suitedir <Verzeichnis>] [-analyze-references] [-analyze-duplicates] [-analyze-invalidchar] [-analyze-emptynodes] [-analyze-components] [-analyze-procedures] [-analyze-dependencies] [-analyze-tests] [-analyze-packages] [-remove-unused-callables] [-remove-unused-components] [-analyze-transitive] [-analyze-followincludes] (<Testsuite> | <Verzeichnis>)+
Protokolle zusammenführen
qftest -batch -mergelogs [-mergelogs-mode [<Modus>]] [-mergelogs-usefqn] [-mergelogs-resultlog [<Datei>]] [-mergelogs-masterlog [<Datei>]] (<Protokoll> | <Verzeichnis>)+
Versionsinformationen ausgeben
qftest -batch -version
Beendet eine spezifische QF-Test Instanz auf diesem System (siehe -allow-shutdown [<Shutdown-ID>])
qftest -batch -shutdown <ID> 4711
Pausiert den Testlauf auf diesem System
qftest -batch -interrupt-running-instances [-timeout <Millisekunden>]
Abbilder in einer bestehenden Testsuite komprimieren
qftest -batch -compress <suite>+
Hilfe anfordern
qftest -batch -help

Kommandozeilenargumente

Kommandozeilenargumente für QF-Test fallen in drei Kategorien, wobei es nicht auf die Reihenfolge ankommt.

Argumente für das Startskript

Diese Argumente werden direkt vom qftest Skript bzw. Programm ausgewertet und heben die Werte auf, die während der Installation von QF-Test ermittelt wurden. Unter Linux stehen diese in der Datei launcher.cfg in QF-Tests Systemverzeichnis, unter Windows heißt die Datei launcherwin.cfg.

-batch
Startet QF-Test im Batchmodus. Dadurch lädt QF-Test eine Testsuite, führt sie direkt aus und beendet sich mit einem Rückgabewert, der das Ergebnis des Testlaufs widerspiegelt.
-dbg
Schaltet Debug-Ausgaben für das Startskript ein. Den selben Effekt erreichen Sie, wenn Sie die Umgebungsvariable QFTEST_DEBUG auf einen nicht leeren Wert setzen. Sofern nicht zusätzlich -noconsole angegeben ist, öffnet QF-Test unter Windows in diesem Fall ein Konsolenfenster, da die Ausgaben ansonsten nicht sichtbar wären. Falls der alte Verbindungsmechanismus zum SUT eingesetzt wird, schaltet diese Option gleichzeitig Debug-Ausgaben für das qfclient Programm und QF-Tests java Hülle ein (vgl. Kapitel 45).
-java <Programm>(abgekündigt)
Das Java-Programm, das die Ausführung von QF-Test übernimmt. Standard sind java unter Linux und javaw.exe unter Windows, sofern während der Installation nichts anderes angegeben wurde. Dieses Argument wird in einer zukünftigen Version von QF-Test entfernt.
-noconsole (nur Windows)
Verhindert das Öffnen eines Konsolenfensters unter Windows für den Fall, dass -dbg ebenfalls angegeben ist.

Argumente für die Java-VM

Sie können durch das Startskript Argumente an die Java-VM weiterreichen, indem Sie diesen -J voranstellen, z.B. -J-Duser.language=en, um eine Systemvariable zu setzen. Um den classpath anzugeben, fügen Sie -J nur dem -cp oder -classpath Argument zu, nicht dem eigentlichen Wert, z.B. -J-classpath myclasses.jar. Auch wenn Sie den classpath auf diese Weise angeben, brauchen Sie QF-Tests eigene jar Archive nicht zu berücksichtigen.

Argumente für QF-Test

Die restlichen Argumente werden von QF-Test selbst ausgewertet, wenn es von der Java-VM ausgeführt wird. Diese Argumente können auch in eine Datei geschrieben werden. Das Format lautet <Name>=<Wert> für Argumente mit Parametern und <Name>=true oder <Name>=false, um ein einfaches Argument ein- oder auszuschalten. Normalerweise heißt diese Datei qftest.options, liegt im bin Verzeichnis von QF-Test und wird nur für interne Zwecke verwendet. Wenn Sie Änderungen an dieser Datei vornehmen, ist es sinnvoll, sie in das Systemverzeichnis von QF-Test zu kopieren, da diese Änderungen dadurch auch nach einem Update gültig bleiben. Alternativ können Sie über das -options <Datei> Argument eine andere Datei angeben. Argumente auf der Kommandozeile haben Vorrang vor Argumenten aus der Datei. Für Argumente, die mehrfach angegeben werden können, werden sowohl Angaben von der Kommandozeile, als auch aus der Datei übernommen.

-allowkilling
Abgekündigt, verwenden Sie stattdessen -allow-shutdown ohne Shutdown-ID.
-allow-shutdown [<Shutdown-ID>]
Erlaubt explizit, dass diese QF-Test Instanz über einen Batch-Aufruf mit dem Argument -shutdown <ID> kontrolliert beendet werden darf. Optional kann als Argument eine Zeichenkette als Shutdown-ID angegeben werden, welche ein individuelles Beenden von QF-Test Prozessen ohne die Kenntnis deren Prozess-ID erlaubt. Die Shutdown-ID muss dabei mindestens ein nicht-numerisches Zeichen enthalten, damit sie von der rein numerischen Prozess-ID unterschieden werden kann. Wurde -allow-shutdown [<Shutdown-ID>] nicht angegeben, so kann die QF-Test Instanz nur mit Hilfe der Prozess-ID kontrolliert beendet werden. Das Argument -allow-shutdown false verbietet grundsätzlich das kontrollierte Beenden dieser QF-Test Instanz, selbst wenn -shutdown <ID> mit der korrekten Prozess-ID aufgerufen wird.
-analyze (nur Batchmodus)
Modus, um statische Analyse von Testsuiten vorzunehmen. Das Ergebnis wird für Analyseschritte in eine angegebene Datei geschrieben.
-analyze-target <Verzeichnis> (nur Batchmodus)
Das Zielverzeichnis, in welches die Ergebnisdatei gespeichert wird.
-analyze-references (nur Batchmodus)
Schalter, um Referenzen zu analysieren.
-analyze-duplicates (nur Batchmodus)
Schalter, um Duplikate zu analysieren.
-analyze-invalidchar (nur Batchmodus)
Schalter, um auf ungültige Zeichen in Knoten zu prüfen.
-analyze-emptynodes (nur Batchmodus)
Schalter, um auf leere Knoten zu prüfen.
-analyze-components (nur Batchmodus)
Schalter, um Komponentenverweise zu analysieren.
-analyze-dependencies (nur Batchmodus)
Schalter, um Verweise auf Abhängigkeiten zu analysieren.
-analyze-procedures (nur Batchmodus)
Schalter, um Aufrufe von Prozeduren zu analysieren.
-analyze-tests (nur Batchmodus)
Schalter, um Aufrufe von Testfällen zu analysieren.
-analyze-packages (nur Batchmodus)
Schalter, um Packages zu analysieren.
-remove-unused-callables (nur Batchmodus)
Schalter, um ungenutzte aufrufbare Knoten zu löschen.
-remove-unused-components (nur Batchmodus)
Schalter, um ungenutzte Komponenten zu löschen.
-analyze-transitive (nur Batchmodus)
Schalter, um die gefundenen Referenzen transitiv zu analysieren, d.h. auch deren Inhalt und Verweise zu prüfen.
-analyze-followincludes (nur Batchmodus)
Schalter, um alle inkludierten Testsuiten der angegebenen Testsuite zu analysieren.
-calldaemon (nur Batchmodus)
Verbinden mit einem laufenden QF-Test Daemon, um einen Test(fall) auszuführen.
-cleanup (nur Calldaemon-Modus)
Mit diesem Argument werden alle TestRunDaemon-Objekte einer Daemon-Instanz aufgeräumt und alle Clients beendet bevor der Test ausgeführt wird.
-clearglobals (nur Batchmodus und Calldaemon-Modus)
Sind mehrere Testsuiten zur Ausführung im Batchmodus angegeben, führt dieses Argument dazu, dass vor der Ausführung jeder Testsuite die globalen Variablen und Ressourcen gelöscht werden. Es kann außerdem im Calldaemon-Modus verwendet werden, um die globalen Variablen vor Setzen der Kommandozeilen-Variablen und Start des Tests zu löschen und, in Kombination mit -stopclean, zum Löschen der globalen Variablen am Ende des Tests.
-compact (nur Batchmodus)
Erstellt ein kompaktes Protokoll, das nur die Äste und Knoten enthält, in denen Warnungen, Fehler, Exceptions oder für den Report relevante Informationen enthalten sind - analog zum Aktivieren der Option Kompakte Protokolle erstellen im interaktiven Modus. Hat keine Bedeutung, wenn das Protokoll mittels -nolog unterdrückt wird.
-compress (nur Batchmodus)
Komprimiert die Abbilder in einer bestehenden Testsuite verlustfrei.
-convertxml (nur Batchmodus)
Ausführung im Batchmodus zur automatischen Konvertierung des XML-Formats von Testsuiten gemäß nachfolgender Argumente bzw. Optionen.
-convertxml-indent <Anzahl> (Nur im Modus zur Konvertierung des XML-Formats)
Anzahl von Leerzeichen pro Einrückungsstufe. Falls nicht angegeben, wird der Wert der Option Anzahl der Leerzeichen für das Einrücken beim Speichern von Testsuiten verwendet.
-convertxml-linelength <Anzahl> (Nur im Modus zur Konvertierung des XML-Formats)
Maximale Länge von Zeilen mit XML-Attributen. Falls nicht angegeben, wird der Wert der Option Zeilenlänge beim Speichern von Testsuiten verwendet.
-convertxml-utf8 <true|false> (Nur im Modus zur Konvertierung des XML-Formats)
Entscheidet, ob die konvertierten Testsuite mit UTF-8 (Wert true) oder ISO-8859-1 (Wert false) kodiert gespeichert werden. Falls nicht angegeben, wird der Wert der Option Testsuiten UTF-8 kodiert speichern verwendet.
-daemon
Startet QF-Test im Daemon-Modus. Weitere Informationen finden Sie in Kapitel 54.
-daemonhost <Host> (nur Daemon-Modus oder Calldaemon-Modus)
Legt im Calldaemon-Modus den Rechner fest, auf dem nach einem laufenden QF-Test Daemon gesucht wird (Standard ist localhost). Beim Start des Daemon - interaktiv oder im Batchmodus - definiert dieser Parameter den Hostnamen oder die IP-Adresse, welche Daemon-Objekte auf RMI Ebene nutzen. Der Standard in diesem Fall wird von Java bestimmt, typischerweise die IP-Adresse der primären Netzwerkschnittstelle des Rechners.
-daemonport <Port>
Legt den Registry Port für den QF-Test Daemon fest. Standard ist 3543 oder der mittels -port <Nummer> festgelegte Port.
-daemonrmiport <Port>
Legt den Port für die RMI Kommunikation des QF-Test Daemon fest. Nur sinnvoll, wenn der Daemon hinter einer Firewall betrieben wird. Beim ungeschützten Betrieb ohne SSL (vgl. Abschnitt 54.3) kann dies der selbe Port sein wie beim Argument -daemonport <Port>. Wird SSL verwendet, sind zwei verschiedene Ports erforderlich.
-dontkillprocesses (nur Batchmodus)
Ist dieses Argument angegeben, beendet QF-Test vor dem Ende des Batchlaufs die im Verlauf der Tests gestarteten Prozesse nicht explizit. Ob diese Unterprozesse das Ende von QF-Test überleben ist allerdings Systemabhängig.
-engine <Engine>
Legt fest, welche Engine-Lizenzen verwendet werden. Diese Option ist nur sinnvoll, wenn Ihre QF-Test Lizenz eine Mischung von Engine-Lizenzen in unterschiedlicher Anzahl unterstützt. In diesem Fall kann es nötig sein, die benötigte GUI-Engine zu spezifizieren, um so Lizenz-Konflikte mit Kollegen zu vermeiden, welche die selbe Lizenz nutzen. Mögliche Werte sind "all" für alle unterstützten Lizenzen, "ask" um einen Dialog zur Auswahl der Engine anzuzeigen sowie eine beliebige Kombination von "awt" für AWT/Swing, "fx" für JavaFX, "swt" für SWT oder "web" für Web, z.B. "awt,web". Weitere Informationen hierzu finden Sie in Abschnitt 40.1.9.
-exitcode-ignore-exception (Batch- und Calldaemon-Modus)
Exceptions, Fehler und Warnungen werden bei der Berechnung des Rückgabewertes von QF-Test ignoriert. Das bedeutet, dass bei einem Testlauf mit Exceptions, Fehlern oder Warnungen 0 geliefert wird. Diese Option ist hilfreich für die Integration von QF-Test mit Build-Tools, die abhängig vom Rückgabewert den Build als fehlgeschlagen interpretieren.
-exitcode-ignore-error (Batch- und Calldaemon-Modus)
Fehler und Warnungen werden bei der Berechnung des Rückgabewertes von QF-Test ignoriert. Das bedeutet, dass bei einem Testlauf mit nur Fehlern oder Warnungen 0 geliefert wird. Diese Option ist hilfreich für die Integration von QF-Test mit Build-Tools, die abhängig vom Rückgabewert den Build als fehlgeschlagen interpretieren.
-exitcode-ignore-warning (Batch- und Calldaemon-Modus)
Warnungen werden bei der Berechnung des Rückgabewertes von QF-Test ignoriert. Das bedeutet, dass bei einem Testlauf mit nur Warnungen 0 geliefert wird. Diese Option ist hilfreich für die Integration von QF-Test mit Build-Tools, die abhängig vom Rückgabewert den Build als fehlgeschlagen interpretieren.
-gendoc (nur Batchmodus)
Teilt QF-Test mit, dass dieser Batch-Lauf zur Erstellung von Test-Dokumentation aus Testsuiten dient.
-genreport (nur Batchmodus)
Teilt QF-Test mit, dass dieser Batch-Lauf zur Erstellung von Reports aus Protokollen dient.
-groovydir <Verzeichnis>
Mit diesem Argument das Verzeichnis für zusätzliche Groovy Module überschrieben werden. Dieses Verzeichnis heißt normalerweise groovy und liegt im Systemverzeichnis von QF-Test.
-help
Zeigt Hilfe zu den verfügbaren Kommandozeilenargumenten an.
-import (nur Batchmodus)
Importiert eine Testsuite in eine andere.
-import-from <Testsuite> (nur Batchmodus)
Die Testsuite, welche importiert werden soll.
-import-into <Testsuite> (nur Batchmodus)
Die Zieltestsuite, in die importiert werden soll.
-import-components (nur Batchmodus)
Schalter, um Komponenten zu importieren.
-import-procedures (nur Batchmodus)
Schalter, um Packages und Prozeduren zu importieren.
-import-tests (nur Batchmodus)
Schalter, um Testfallsätze und Testfälle zu importieren.
-interrupt-running-instances (nur Batchmodus)
Unterbricht den aktuellen Testlauf auf dem lokalen System und zeigt einen Dialog, der die Pausierung bzw. das Stoppen des Testlaufes erlaubt.
-ipv6
QF-Test kommuniziert normalerweise nur via IPv4, daher ist die IPv6 Unterstützung standardmäßig auf Java Ebene deaktiviert, was die Startzeit spürbar verkürzen kann. Fall Sie Unterstützung für IPv6 in QF-Test benötigen, z.B. in einem Plugin, verwenden Sie dieses Argument um diese zu aktivieren.
-javascriptdir <Verzeichnis>
Mit diesem Argument das Verzeichnis für zusätzliche JavaScript Module überschrieben werden. Dieses Verzeichnis heißt normalerweise javascript und liegt im Systemverzeichnis von QF-Test.
-jythondir <Verzeichnis>
Mit diesem Argument das Verzeichnis für zusätzliche Jython Module überschrieben werden. Dieses Verzeichnis heißt normalerweise jython und liegt im Systemverzeichnis von QF-Test.
-jythonport <Nummer>
Weist den eingebetteten Jython Interpreter an, auf der angegebenen Portnummer auf TCP Verbindungen zu lauschen. Sie können dann telnet verwenden, um sich mit diesem Port zu verbinden und eine interaktive Jython Kommandozeile zu erhalten.
-keybindings <Wert> (nur interaktiven Modus)
Aktuell nur unter macOS interessant, um zwischen den neuen Mac Standard-Kürzeln (Wert system) oder den alten, an Windows orientierten QF-Test Kürzeln (Wert classic) umzuschalten.
-keystore <Keystore-Datei>
Eine alternative Keystore-Datei zur Absicherung der Kommunikation mit dem Daemon über SSL. Details hierzu finden Sie in Abschnitt 54.3. Um SSL zu deaktivieren, indem Sie keine Keystore-Datei angeben, verwenden Sie dieses Argument in der Form -keystore=.
-keypass <Kennwort>
Das Passwort für die Keystore-Datei, die zur Absicherung der Kommunikation mit dem Daemon über SSL verwendet wird. Details hierzu finden Sie in Abschnitt 54.3.
-kill-running-instances
Abgekündigt, verwenden Sie stattdessen -shutdown all.
-libpath <Pfad>
Dieser Wert entspricht der Option Verzeichnisse mit Testsuite-Bibliotheken und setzt diese außer Kraft. Die Verzeichnisse des Bibliothekspfads sollten durch das dem System entsprechende Trennzeichen getrennt werden, d.h. ';' für Windows und ':' für Linux. Das include Verzeichnis von QF-Test wird automatisch an das Ende des Bibliothekspfads gestellt.
-license <Datei>
Gibt den Ort der Lizenzdatei an, falls dieser vom Standard abweicht (vgl. Abschnitt 1.5).
-license-waitfor <Sekunden>;
Legt eine Zeitspanne in Sekunden fest, die beim Start von QF-Test gewartet wird, falls gerade keine Lizenz verfügbar ist. Diese Zeitspanne findet auch Anwendung, wenn bei der Verlängerung einer Lease vom QF-Test Lizenzserver dieser temporär nicht verfügbar ist.
-logdir <Verzeichnis>
Mit diesem Argument kann der Ort für das Verzeichnis für überschrieben werden, in dem QF-Test seine internen Protokolle ablegt. Dieses Verzeichnis heißt normalerweise log und liegt im Systemverzeichnis von QF-Test.
-mergelogs (nur Batchmodus)
Teilt QF-Test mit, dass dieser Batch-Lauf zum Zusammenführen von Protokollen dient. Details hierzu finden Sie unter Abschnitt 7.1.9.
-mergelogs-masterlog [<Datei>] (nur Batchmodus)
Der Pfad zum Hauptprotokoll, welches beim Zusammenführen von Protokollen verwendet wird. Dieses Protokoll beinhaltet den gesamten Testlauf. Einzelne enthaltene Testfälle können mit den Ergebnissen des Nachtests ersetzt werden.
-mergelogs-mode [<Modus>] (nur Batchmodus)
Diese Option gibt den Modus an, wie Ergebnisse von Testfällen aus den neuen Protokollen in das Hauptprotokoll, das mit -mergelogs-masterlog [<Datei>] spezifiziert wurde, eingegliedert werden sollen. Hier stehen die Werte "replace", "merge" und "append" zur Verfügung. Mit "replace" werden die bestehenden Testfälle ersetzt, mit "merge" werden die neuen Ergebnisse hinzugefügt und mit "append" wird das neue Protokoll an das Hauptprotokoll angehängt.
-mergelogs-resultlog [<Datei>] (nur Batchmodus)
Der Pfad zu einem Protokoll, welches nach der Zusammenführung von Protokollen das Ergebnis der Zusammenführung beinhaltet.
-mergelogs-usefqn (nur Batchmodus)
Diese Option gibt an, ob beim Zusammenführen von Protokollen auch die Testfallsatzhierarchie eines Testfalles miteinbezogen werden soll. Ohne diese Option wird nur der Name des Testfalles für das Zusammenführen herangezogen.
-nolog (nur Batchmodus)
Verhindert die automatische Erstellung eines Protokolls. Falls -runlog [<Datei>], -report <Verzeichnis>, -report-html <Verzeichnis>, -report-xml <Verzeichnis> oder -report-junit <Verzeichnis> angegeben ist, wird dieses Argument ignoriert. Diese Option ist nur noch aus Gründen der Rückwärtskompatibilität vorhanden. Um den Speicherverbrauch im Griff zu halten sollten geteilte Protokolle verwendet werden (vgl. -splitlog).
-nomessagewindow (nur Batchmodus)
Wenn schwere Fehler im Batchmodus auftreten, gibt QF-Test eine Fehlermeldung in der Konsole aus und öffnet zur besseren Sichtbarkeit zusätzlich für ca. 30 Sekunden einen Fehlerdialog. Das Öffnen des Dialogs kann mit diesem Argument verhindert werden. Batch Kommandos die keine Anzeige benötigen, also alle Kommandos, die keine Tests ausführen, laufen im AWT Headless Modus falls dieses Argument angegeben wird.
-noplugins
Laden von Plugins in QF-Test und Clients verhindern. Dies kann nützlich sein, um Problemen mit Plugins auf die Spur zu kommen.
-noupdatecheck
Mit diesem Argument kann die automatische Suche nach Updates deaktiviert werden. Hierdurch werden die Update-Optionen (siehe Abschnitt 40.1.10) überschrieben.
-option <Name>=<Wert>
Setzt Optionen. Mit -option <Name>=<Wert> wird die Option mit dem Name <Name> auf den Wert <Wert> gesetzt. Dieses Argument kann mehrfach angegeben werden, um mehrere Optionen zu setzen.
-options <Datei>
Legt die Datei fest, aus der weitere Argumente gelesen werden. Dieses Argument kann mehrfach angegeben werden, um Argumente aus mehreren Dateien zu lesen.
-ping (nur Calldaemon-Modus)
Prüft, ob ein Daemon erreichbar ist.
-pkgdoc <Verzeichnis> (nur Batchmodus)
Mit diesem Argument erstellt QF-Test HTML- und XML-Pkgdoc-Dokumentationen. Ist kein Verzeichnis angegeben wird der Name aus dem Namen der Testsuite gebildet.
-pkgdoc-dependencies (nur Batchmodus)
Legt fest, ob 'Abhängigkeiten' in pgkdoc Dokumenten aufgeführt werden. Standard ist ja, mit -pkgdoc-doctags=false können diese ausgeschaltet werden.
-pkgdoc-doctags (nur Batchmodus)
Legt fest, ob die doctags Erweiterungen von QFS verwendet werden. Standard ist ja, mit -pkgdoc-doctags=false können die doctags ausgeschaltet werden.
-pkgdoc-html <Verzeichnis> (nur Batchmodus)
Mit diesem Argument erstellt QF-Test eine HTML-Pkgdoc-Dokumentation. Ist kein Verzeichnis angegeben, wird der Name aus dem Namen der Testsuite gebildet.
-pkgdoc-includelocal (nur Batchmodus)
Legt fest, ob lokale Packages und Prozeduren, d.h. solche, deren Name mit einem '_' beginnt, einbezogen werden. Standard ist nein.
-pkgdoc-nodeicons (nur Batchmodus)
Legt fest, ob Icons für Knoten in der Pkgdoc-Dokumentation angezeigt werden. Standard ist ja, mit -pkgdoc-nodeicons=false können die Icons ausgeschaltet werden.
-pkgdoc-passhtml (nur Batchmodus)
Legt fest, ob HTML Tags in Kommentaren unverändert an die HTML-Dokumentation durchgereicht werden. Standard ist ja, mit -pkgdoc-passhtml=false können die Tags ausgeschaltet werden.
-pkgdoc-sortpackages (nur Batchmodus)
Legt fest, ob Packages alphabetisch sortiert werden. Standard ist ja, mit -pkgdoc-sortpackages=false kann die Sortierung ausgeschaltet werden.
-pkgdoc-sortprocedures (nur Batchmodus)
Legt fest, ob Prozeduren alphabetisch sortiert werden. Standard ist ja, mit -pkgdoc-sortprocedures=false kann die Sortierung ausgeschaltet werden.
-pkgdoc-splitparagraph (nur Batchmodus)
Legt fest, ob Kommentare an Leerzeilen in Absätze aufgeteilt werden. Standard ist ja, mit -pkgdoc-splitparagraph=false können Sie die Option ausschalten.
-pkgdoc-stylesheet <Datei> (nur Batchmodus)
Optionales XSLT Stylesheet für die zweite Stufe der Transformation.
-pkgdoc-xml <Verzeichnis> (nur Batchmodus)
Mit diesem Argument erstellt QF-Test eine XML-Pkgdoc-Dokumentation. Ist kein Verzeichnis angegeben, wird der Name aus dem Namen der Testsuite gebildet.
-plugindir <Verzeichnis>
Mit diesem Argument kann der Ort für das Plugin Verzeichnis für jar Dateien, auf die per Skript zugegriffen werden soll, überschrieben werden. Dieses Verzeichnis heißt normalerweise plugin und liegt im Systemverzeichnis von QF-Test. Weitere Informationen über Plugins finden Sie in Abschnitt 49.2.
-port <Nummer>
Der TCP-Port auf dem QF-Test mit dem SUT kommuniziert. Normalerweise sucht sich QF-Test einen freien dynamischen Port, um dort seine eigene RMI-Registry anzulegen. Ein spezieller Port sollte nur dann angegeben werden, wenn es erforderlich ist, um das SUT zu starten.
-report <Verzeichnis> (nur Batchmodus)
Erstellt einen kombinierten XML/HTML-Report. Im Verzeichnisnamen können Platzhalter, wie in Abschnitt 43.2.4 beschrieben, angegeben werden.
-report-checks (nur Batchmodus)
Legt fest, ob Checks im Report aufgelistet werden. Standard ist nein. Bitte beachten Sie, dass dies nur für Checks greift, für deren Ergebnisbehandlung weder eine Variable gesetzt noch eine Exception geworfen wird. Weitere Informationen finden sie unter Abschnitt 23.1.2.
-report-customdir <Verzeichnis> (nur Batchmodus)
Verzeichnis für eigene CSS-Stylesheets und Icons für angepasste Reports.
-report-doctags (nur Batchmodus)
Legt fest, ob die doctags Erweiterungen von QFS verwendet werden. Standard ist ja, mit -report-doctags=false können die doctags ausgeschaltet werden.
-report-errors (nur Batchmodus)
Legt fest, ob Fehler im Report aufgelistet werden. Standard ist ja, mit -report-errors=false können die Fehler ausgeschaltet werden.
-report-exceptions (nur Batchmodus)
Legt fest, ob Exceptions im Report aufgelistet werden. Standard ist ja, mit -report-exceptions=false können die Exceptions ausgeschaltet werden.
-report-html <Verzeichnis> (nur Batchmodus)
Erstellt einen HTML-Report. Im Verzeichnisnamen können Platzhalter, wie in Abschnitt 43.2.4 beschrieben, angegeben werden.
-report-ignorenotimplemented (nur Batchmodus)
Legt fest, ob nicht implementierte Knoten im Report ignoriert werden sollen. In diesem Fall werden auch die Legende und die Spalten für nicht implementierte Tests nicht angezeigt. Standard ist nein, d.h. nicht implementierte Tests werden angezeigt.
-report-ignoreskipped (nur Batchmodus)
Legt fest, ob übersprungene Knoten im Report ignoriert werden sollen. In diesem Fall werden auch die Legende und die Spalten für übersprungene Tests nicht angezeigt. Standard ist nein, d.h. übersprungene Tests werden angezeigt.
-report-junit <Verzeichnis> (nur Batchmodus)
Erstellt einen Report im JUnit XML-Format, wie ihn viele Continuous Integration Tools verstehen. Im Verzeichnisnamen können Platzhalter, wie in Abschnitt 43.2.4 beschrieben, angegeben werden.
-report-name <Name> (nur Batchmodus)
Legt den Reportnamen fest (nicht den Dateinamen). Standard ist die Runid. Im Reportnamen können Platzhalter, wie in Abschnitt 43.2.4 beschrieben, angegeben werden.
-report-nodeicons (nur Batchmodus)
Legt fest, ob Icons für Knoten im Report angezeigt werden. Standard ist ja, mit -report-nodeicons=false können die Icons ausgeschaltet werden.
-report-passhtml (nur Batchmodus)
Legt fest, ob HTML-Tags in Kommentaren unverändert an den HTML-Report durchgereicht werden. Standard ist ja, mit -report-passhtml=false können die Tags ausgeschaltet werden.
-report-piechart (nur Batchmodus)
Legt fest, ob im Kopfbereich des HTML Reports ein Tortendiagramm angezeigt werden soll. Standard ist ja, mit -report-piechart=false kann das Erzeugen des Diagramms verhindert werden.
-report-include-suitename (nur Batchmodus)
Legt fest, ob für den Bezeichner einer Testsuite im HTML-Report der Wert des 'Name'-Attributs des 'Testsuite'-Knotens verwendet werden soll. Standard ist ja, mit -report-include-suitename=false wird der Dateiname verwendet.
-report-scale-thumbnails <Prozent> (nur Batchmodus)
Bestimmt die Skalierung von Miniaturbildern für Screenshots in der Fehlerübersichten von Reports, angegeben in Prozent. Standard ist 20.
-report-teststeps (nur Batchmodus)
Legt fest, ob Testschritte im Report aufgelistet werden. Standard ist ja, mit -report-teststeps=false können die Testschritte ausgeschaltet werden.
-report-thumbnails (nur Batchmodus)
Legt fest, ob Miniaturbilder für Screenshots in den Fehlerübersichten des Reports dargestellt werden. Standard ist nein.
-report-warnings (nur Batchmodus)
Legt fest, ob Warnungen im Report berücksichtigt werden. Standard ist ja.
-report-xml <Verzeichnis> (nur Batchmodus)
Erstellt einen XML-Report. Im Verzeichnisnamen können Platzhalter, wie in Abschnitt 43.2.4 beschrieben, angegeben werden.
-reuse (nur interaktiver Modus)
Dieses Argument kommt vor allem beim Start von QF-Test über ein Desktop Icon oder mittels einer Dateiverknüpfung aus dem Windows Explorer zum Tragen. Es veranlasst QF-Test zunächst nach bereits laufenden QF-Test Programmen zu suchen und diese zu bitten, die angegebenen Dateien zu öffnen. Im Erfolgsfall wird die neu gestartete Version sofort wieder beendet und das bereits laufende Programm öffnet die Dateien in neuen Fenstern.
-run (interaktiver und Batchmodus)
Bei Verwendung im interaktiven Modus werden sofort nach dem Start die angegebene Testsuite bzw. die angegebenen Tests ausgeführt. Im Batchmodus teilt dieser Parameter QF-Test explizit mit, dass dieser Batch-Lauf zur Durchführung von Tests dient und nicht zur Erstellung von Test-Dokumentation oder Reports. Da dies der Standard-Fall ist kann dieses Kommandozeilenargument wegfallen.
-runid [<ID>] (Batch- und Calldaemon-Modus)
Legt die ID eines Testlaufs fest. In der ID können Platzhalter, wie in Abschnitt 43.2.4 beschrieben, angegeben werden. Sie dient selbst wiederum als Ersatz für den Platzhalter %i/+i.
-runlog [<Datei>] (Batch- und Calldaemon-Modus)
Schreibt das Protokoll in die angegebene Datei. Im optionalen Dateinamen können Platzhalter, wie in Abschnitt 43.2.4 beschrieben, angegeben werden. Ist keine Endung angegeben, wird automatisch .qrz angehängt und das Protokoll komprimiert geschrieben. Andernfalls entscheidet die Endung .qrl oder .qrz über die Kompression. Ist gar keine Datei angegeben, wird der Name aus dem Namen der Testsuite sowie dem aktuellen Datum und Uhrzeit gebildet. Ein Protokoll wird immer erstellt, sofern es nicht durch Angabe von -nolog unterdrückt oder ein Report generiert wird. Im Calldaemon-Modus wird das Protokoll nur bei Angabe eines (lokalen) Dateinames gespeichert.
-runlogdir <Verzeichnis>
Im interaktiven Modus überschreibt dieses Argument die Option Verzeichnis für Protokolle in einer speziellen Ebene für Optionen von der Kommandozeile, so dass das interaktive Ändern dieser Option keinen Effekt hat. Auf Skriptebene kann sie nach wie vor überschrieben werden. Im Batchmodus dient das Verzeichnis als Basis zum Speichern von Protokollen, sofern im Argument -runlog [<Datei>] kein absoluter Pfad angegeben ist. Wird dieses Argument bei der Erstellung eines Reports angegeben, werden die Dateien im Report entsprechend der Struktur der Protokolle relativ zu diesem Verzeichnis angelegt. Im Verzeichnisnamen können Platzhalter, wie in Abschnitt 43.2.4 beschrieben, angegeben werden.
-runtime
Mit diesem Argument verwendet QF-Test ausschließlich Runtime Lizenzen. Im Batch Modus wird QF-Test normalerweise mit einer Runtime Lizenz gestartet (oder mehreren bei der Angabe von -threads <Anzahl>). Sind nicht ausreichend Runtime Lizenzen vorhanden, verwendet QF-Test stattdessen volle Entwicklerlizenzen. Dies wird durch die Angabe von -runtime verhindert, so dass sich QF-Test bei mangelnden Runtime Lizenzen mit einem Fehler beendet. Im interaktiven Modus verwendet QF-Test bei Angabe von -runtime eine Runtime statt einer Entwicklerlizenz. Damit können Tests normal oder unter Verwendung des Debuggers ausgeführt werden. Testsuite können allerdings nicht gespeichert werden, selbst wenn sie für experimentelle Tests verändert wurden.
-shell <Programm>
Das Shell Programm, das zur Ausführung eines 'Shell-Kommando ausführen' Knotens verwendet wird. Vorgegeben sind /bin/sh unter Linux und COMMAND.COM bzw. cmd.exe unter Windows.
-shellarg <Argument>
Das Argument, das der mittels -shell <Programm> angegebenen Shell mitteilt, dass sie das darauf folgende Argument als Kommando ausführen soll. Standard für Linux Shells ist -c, während COMMAND.COM und cmd.exe/c erwarten. Wenn Sie Linux Tools unter Windows verwenden und z.B. sh oder bash als Shell angeben, dürfen Sie nicht vergessen, hier -c anzugeben.
-shutdown <ID> (nur Batchmodus)
Beendet kontrolliert die QF-Test Instanz mit der angegebenen Prozess-ID (nur Ziffern) oder Shutdown-ID auf dem aktuellen System, soweit dies erlaubt ist (siehe -allow-shutdown [<Shutdown-ID>]). Im Batchmodus wird dabei der laufende Test abgebrochen, verbundene Clients werden beendet, das Protokoll wird geschrieben und der angegebene Prozess wird mit dem Exit-Code -12 terminiert. Bei einem interaktiven QF-Test werden zusätzlich alle Testsuiten ohne weitere Rückfrage geschlossen, etwaige Änderungen werden nicht gespeichert - dies kann in einigen Fällen dennoch nützlich sein, insbesondere wenn die automatische Speicherung sinnvoll konfiguriert ist (siehe Zeitabstand für automatische Speicherung (s)). Die spezielle Shutdown-ID all beendet alle QF-Test Prozesse, die mit dem Argument -allow-shutdown [<Shutdown-ID>] gestartet wurden, um dies explizit zu erlauben.
-serverhost <Host>
Legt den Hostnamen oder die IP-Adresse für die Kommunikation zwischen QF-Test und dem SUT fest. Eventuell müssen Sie diese angeben, wenn QF-Test und das SUT auf unterschiedlichen Rechnern laufen oder wenn Probleme mit der Namensauflösung auftreten. Ohne Angabe wird die Loopback Netzwerk-Schnittstelle verwendet. Um die primäre Netzwerk-Schnittstelle des lokalen Rechners zu verwenden, geben Sie -serverhost= mit leerem Wert an.
-sourcedir <Verzeichnis> (nur Batchmodus)
Wird dieses Argument bei der Erstellung eines Reports angegeben, werden die Dateien im Report entsprechend der Struktur der Testsuiten relativ zu diesem Verzeichnis angelegt, sofern nicht gleichzeitig -runlogdir <Verzeichnis> angegeben wird. In jedem Fall wird das Verzeichnis einer Testsuite im Report nur dann aufgelistet, wenn dieses Argument angegeben ist und die Testsuite sich unterhalb dieses Verzeichnis befindet.
-splitlog (batch mode only)
Im Batchmodus sind geteilte Protokolle (vgl. Abschnitt 7.1.6) standardmäßig aktiviert. Sie können durch Angabe von -splitlog=false ausgeschaltet werden. Wird -splitlog explizit ohne Parameter angegeben, ändert sich die Standard-Endung für Protokolle von .qrz in .qzp, um geteilte Protokolle im ZIP Format zu erzeugen. Unabhängig davon kann die Endung kann durch explizite Angabe beim Namen der Protokolls festgelegt werden.
-startclean (nur Calldaemon-Modus)
Mit diesem Argument werden alle Context-Objekte des gemeinsamen TestRunDaemons aufgeräumt bevor der Test ausgeführt wird.
-startsut (nur zum internen Gebrauch)
Dieses Argument wird zum Starten eines Clients auf einem entfernten Rechner verwendet. Sie sollten es nicht direkt verwenden, sondern ggf. auf die Prozedur qfs.daemon.startRemoteSUT aus der Standardbibliothek qfs.qft zurückgreifen.
-stopclean (nur Calldaemon-Modus)
Mit diesem Argument werden alle Context-Objekte des gemeinsamen TestRunDaemons aufgeräumt nachdem der Test ausgeführt wurde.
-stoprun (nur Calldaemon-Modus)
Stoppt ein laufenden Test auf dem Daemon mit dem angegebenen Hostnamen und Port. Dieses Argument kann mit -cleanup oder -stopclean kombiniert werden.
-suitedir <Verzeichnis> (nur Calldaemon-Modus)
Geben Sie ein Verzeichnis auf dem Daemon-Rechner an, wo der QF-Test Daemon nach Testsuiten sucht. Andernfalls kann beim auszuführenden Test auch ein absoluter Pfad angegeben werden.
-suitesfile <Datei> (interaktiver und Batchmodus)
Gibt eine Textdatei an, welche Testsuiten und ggf. Testfälle für die Ausführung beinhaltet. Hierzu können Sie pro Zeile einen Pfad zur Testsuite angeben. Einzelne Tests können wie beim Parameter -test <Index>|<ID> angegeben werden. In der unten stehenden Tabelle finden Sie weitere Beispiele.
Eintrag in DateiBedeutung
pfad/suite1.qft
pfad/suite2.qft
Es werden die beiden Testsuiten ausgeführt.
pfad/suite1.qft
pfad/suite2.qft#id-tc1
Es wird suite1.qft vollständig und der Testfall 'id-tc1'
aus suite2.qft ausgeführt.
pfad/suite1.qft
-test tc1
-test tc2
Es werden die Testfälle tc1 und tc2 aus suite1.qft ausgeführt.
Tabelle 43.1:  Beispiele -suitesfile <Datei>
-systemcfg <Datei>
Legt die Konfigurationsdatei für Systemeinstellungen fest (siehe Abschnitt 1.6).
-systemdir <Verzeichnis>
Überschreibt das Verzeichnis mit den systemspezifischen Konfigurationsdateien (siehe Abschnitt 1.6) inklusive optionalen Plugins und Skript-Modulen. Falls die Argumente -systemcfg <Datei>, -plugindir <Verzeichnis>, -jythondir <Verzeichnis>, -groovydir <Verzeichnis> oder -javascriptdir <Verzeichnis> zusätzlich angegeben sind, haben diese Vorrang.
-tempdir <Verzeichnis> (nur interaktiver Modus)
Kann unter Windows benötigt werden, um temporäre Dateien für die kontextsensitive Hilfe anzulegen. Normalerweise werden die Umgebungsvariablen TEMP und TMP ausgewertet.
-terminate (nur Calldaemon-Modus)
Mit dieser Option wird der QF-Test Daemon (nach Ausführung des Tests) beendet.
-test <Index>|<ID> (interaktiver und Batchmodus)
Ohne diese Angabe werden die Tests der Suite einer nach dem anderen ausgeführt. Durch die Angabe von -test <Index>|<ID> können Sie gezielt einzelne Tests herauspicken. Einen beliebigen Knoten der Testsuite, der sich nicht auf der obersten Ebene befinden muss, können Sie über seine 'QF-Test ID' auswählen, einen 'Testfall' oder 'Testfallsatz' Knoten auch über seinen qualifizierten Namen. Die Tests auf der obersten Ebene sind zudem über einen numerischen Wert ansprechbar, wobei der erste Test den Index 0 hat. Sie können -test <Index>|<ID> beliebig oft angeben, auch mehrfach mit demselben Wert.
-testdoc <Verzeichnis> (nur Batchmodus)
Mit diesem Argument erstellt QF-Test HTML- und XML-Testdoc-Dokumentation. Ist kein Verzeichnis angegeben wird der Name aus dem Namen der Testsuite gebildet.
-testdoc-doctags (nur Batchmodus)
Legt fest, ob die doctags Erweiterungen von QFS verwendet werden. Standard ist ja, mit -testdoc-doctags=false können die doctags ausgeschaltet werden.
-testdoc-followcalls (nur Batchmodus)
Normalerweise ignoriert QF-Test 'Testaufruf' Knoten bei der Testdoc-Generierung. Mit diesem Argument werden die referenzierten Ziele, also 'Testfall', 'Testfallsatz' oder ganze Testsuite, so eingebunden, als wären sie Teil der Ausgangssuite. Hierdurch ist es möglich, partielle Testdoc Dokumente mit Hilfe einer dedizierten Testsuite zu erstellen, die 'Testaufrufe' für die benötigten Teile enthält.
-testdoc-html <Verzeichnis> (nur Batchmodus)
Mit diesem Argument erstellt QF-Test eine HTML-Testdoc-Dokumentation. Ist kein Verzeichnis angegeben, wird der Name aus dem Namen der Testsuite gebildet.
-testdoc-nodeicons (nur Batchmodus)
Legt fest, ob Icons für Knoten in der Testdoc-Dokumentation angezeigt werden. Standard ist ja, mit -testdoc-nodeicons=false können die Icons ausgeschaltet werden.
-testdoc-passhtml (nur Batchmodus)
Legt fest, ob HTML-Tags in Kommentaren unverändert an die HTML-Dokumentation durchgereicht werden. Standard ist ja, mit -testdoc-passhtml=false können die Tags ausgeschaltet werden.
-testdoc-sorttestcases (nur Batchmodus)
Legt fest, ob Testfälle alphabetisch sortiert werden. Standard ist ja, mit -testdoc-sorttestcases=false kann die Sortierung ausgeschaltet werden.
-testdoc-sorttestsets (nur Batchmodus)
Legt fest, ob Testfallsätze alphabetisch sortiert werden. Standard ist ja, mit -testdoc-sorttestsets=false kann die Sortierung ausgeschaltet werden.
-testdoc-splitparagraph (nur Batchmodus)
Legt fest, ob Kommentare an Leerzeilen in Absätze aufgeteilt werden. Standard ist ja, mit -testdoc-splitparagraph=false können Sie die Option ausschalten.
-testdoc-stylesheet <Datei> (nur Batchmodus)
Optionales XSLT Stylesheet für die zweite Stufe der Transformation.
-testdoc-teststeps (nur Batchmodus)
Legt fest, ob Testschritte in der Testdoc-Dokumentation aufgelistet werden. Standard ist ja, mit -testdoc-teststeps=false können die Testschritte ausgeschaltet werden.
-testdoc-xml <Verzeichnis> (nur Batchmodus)
Mit diesem Argument erstellt QF-Test eine XML-Testdoc-Dokumentation. Ist kein Verzeichnis angegeben, wird der Name aus dem Namen der Testsuite gebildet.
-threads <Anzahl> (batch mode only)
Führt des selbe Testsuite in einer Anzahl von parallelen Threads zur Durchführung von Lasttests aus. Pro Thread wird eine Lizenz benötigt, daher sollte normalerweise das Argument -runtime ebenfalls angegeben werden. Näheres zu Lasttests finden Sie in Kapitel 32.
-timeout <Millisekunden> (nur Batchmodus oder Calldaemon-Modus)
Maximale Dauer eines Tests, der im Batchmodus oder über den QF-Test Daemon ausgeführt wird (in Millisekunden, Vorgabe ist unendlich).
-usercfg <Datei> (nur interaktiver Modus)
Legt die Konfigurationsdatei für Benutzereinstellungen fest (siehe Abschnitt 1.6).
-userdir <Verzeichnis>
Überschreibt das Verzeichnis mit den benutzerspezifischen Konfigurationsdateien (siehe Abschnitt 1.6). Falls -usercfg <Datei> oder -runlogdir <Verzeichnis> zusätzlich angegeben sind, haben diese Vorrang.
-variable <Name>=<Wert>
Durch die Angabe von -variable <Name>=<Wert> geben Sie der Variable <Name> den Wert <Wert> (vgl. Kapitel 6). Sie können beliebig viele Variablen definieren.
-verbose [<level>]
Ausgabe von Fortschritts- und Statusinformationen während eines Testlaufs auf der Konsole. Diese Option ist insbesondere dann sinnvoll, wenn der Test via -calldaemon auf einem anderen Rechner ausgeführt wird und daher die Ausführung u.U. nicht so einfach verfolgt werden kann. Unter Windows muss man allerdings qftestc.exe (anstelle von qftest.exe) verwenden, um die Ausgaben zu sehen. Die Angabe eines Levels ist optional, mögliche Werte sind all (alle Knoten ausgeben) und tests (Vorgabe; nur 'Testfallsatz' und 'Testfall' Knoten werden ausgegeben). Jeder dieser Werte kann zusätzlich mit errors (Ausgabe von Fehler- und Exceptionmeldungen) kombiniert werden, etwa tests,errors.
-version
Hiermit gibt QF-Test Versionsinformationen aus und beendet sich dann.

Platzhalter im Dateinamen für Protokoll und Report

Im Dateinamen, der bei den Kommandozeilenargumenten -runid [<ID>], -runlog [<Datei>], -runlogdir <Verzeichnis>, -report <Verzeichnis>, -report-html <Verzeichnis>, -report-name <Name>, -report-xml <Verzeichnis> oder -report-junit <Verzeichnis> angegeben werden kann, können Platzhalter der Form %X oder +X verwendet werden (letzteres muss unter Windows verwendet werden, da % Zeichen dort besondere Bedeutung haben), wobei X für ein Zeichen aus der folgenden Tabelle steht. Wenn das Protokoll oder der Report erstellt werden, setzt QF-Test den entsprechenden Wert ein. Alle Zeitwerte beziehen sich auf die Startzeit des Testlaufs.

Hinweis Werden mehrere Testsuiten ausgeführt, sollten Sie auf jeden Fall den Namen der Suite als Teil des Namens für das Protokoll oder den Report verwenden, indem Sie %b angeben. Andernfalls wird eventuell nur ein Protokoll oder Report entsprechend der Ausführung der letzten Testsuite erstellt.

ZeichenBedeutung
%'%'-Zeichen.
+'+'-Zeichen.
iDie aktuelle Runid wie mit -runid [<ID>] angegeben.
p Das Verzeichnis der Testsuite relativ zu -sourcedir <Verzeichnis> oder absolut falls -sourcedir <Verzeichnis> nicht angegeben ist. Ist -sourcedir <Verzeichnis> angegeben, die Testsuite aber nicht darunter enthalten, ist dieser Wert leer.
P Das absolute Verzeichnis der Testsuite. Darf nur am Anfang stehen.
bDer Name der Testsuite ohne Verzeichnis oder die Endung .qft.
rDer Rückgabewert des Testlaufs (nur -runlog).
wDie Anzahl der Warnungen im Testlauf (nur -runlog).
eDie Anzahl der Fehler im Testlauf (nur -runlog).
xDie Anzahl der Exceptions im Testlauf (nur -runlog).
yDas aktuelle Jahr (2 Ziffern).
YDas aktuelle Jahr (4 Ziffern).
MDer aktuelle Monat (2 Ziffern).
dDer aktuelle Tag (2 Ziffern).
hDie aktuelle Stunde (2 Ziffern).
mDie aktuelle Minute (2 Ziffern).
sDie aktuelle Sekunde (2 Ziffern).
Tabelle 43.2:  Platzhalter im Dateinamen Parameter

Wenn Sie also zum Beispiel das Protokoll in ein Verzeichnis namens logs unterhalb des Verzeichnisses der Testsuite schreiben und dabei einen Zeitstempel und den Rückgabewert erhalten wollen, verwenden Sie

-runlog %p/logs/%b-%y%M%d-%h%m%s-%r.qrl

Hinweis Die Platzhalter %b, %p und %P können auch für kollektive Parameter wir runid oder report verwendet werden. Wirklich Sinn macht das nur, falls nur eine einzelne Testsuite verarbeitet wird. Im Fall mehrerer Testsuiten wird für diesen Fall der Name der ersten Testsuite herangezogen.

Rückgabewerte von QF-Test

Wird QF-Test im interaktiven Modus ausgeführt, besitzt der Rückgabewert keine besondere Aussagekraft. Er ist entweder negativ, falls QF-Test nicht richtig startet, oder 0.

Im Batchmodus drückt der Rückgabewert dagegen das Ergebnis des Testlaufs aus. Negative Werte stehen für Fehler, die verhindern, dass der Test überhaupt gestartet wird, 0 für einen fehlerfreien Durchgang und positive Werte für Fehler während des Tests. Manche Systeme unterstützen nur Rückgabewerte zwischen 0 und 255. In diesem Fall sind alle Werte modulo 256 zu sehen, also -1=255, -2=254 etc.

Die folgenden Rückgabewerte sind zur Zeit definiert:

WertBedeutung
0Alles OK
1Beim Testlauf sind Warnungen aufgetreten
2Beim Testlauf sind Fehler aufgetreten
3Beim Testlauf sind Exceptions aufgetreten
-1Unerwartete Exception
-2Falsche Kommandozeilenargumente
-3Keine oder ungültige Lizenz
-4Fehler beim Aufbau der RMI Verbindung
-5Fehler beim Laden der Suite
-6Die Suite enthält keine Tests
-12Der Prozess wurde von außen über das -shutdown <ID> Batch-Kommando beendet
Tabelle 43.3:  Rückgabewerte von QF-Test

Daneben gibt es spezielle Rückgabewerte, wenn QF-Test mit dem Argument -calldaemon ausgeführt wird:

WertBedeutung
-7Der Daemon konnte nicht gefunden werden
-8Fehler beim Erstellen eines TestRunDaemon-Objekts
-9Fehler beim Erstellen eines Context-Objekts
-10Der Test konnte nicht gestartet werden
-11Der Test wurde innerhalb des angegeben Timeouts nicht beendet
Tabelle 43.4:  calldaemon-Rückgabewerte von QF-Test