Handbuch
Handbuch
 |  |  |  |  |  |  |  |
| Version 6.0.3 |
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 für
den Batchmodus.
-batch [-runlog [<Datei>]] [-report <Verzeichnis>] <Suite>
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).
Die Aufrufsyntax für den interaktiven Modus lautet:
qftest [-dbg]
[-java <Programm>] [-noconsole]
[-J<Java-Argument>]*
[-allow-shutdown [<Shutdown-ID>]]
[-daemon]
[-daemonhost <Host>]
[-daemonport <Port>]
[-daemonrmiport <Port>]
[-dontkillprocesses]
[-engine <Engine>]
[-groovydir <Verzeichnis>]
[-help]
[-javascriptdir <Verzeichnis>]
[-jythondir <Verzeichnis>]
[-jythonport <Nummer>]
[-keybindings <Wert>]
[-keystore <Keystore-Datei>]
[-keypass <Kennwort>]
[-libpath <Pfad>]
[-license <Datei>]
[-license-waitfor <Sekunden>]
[-logdir <Verzeichnis>]
[-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 51). Und schließlich kann auch die Anzeige von Hilfs- oder Versionsinformationen als Sub-Modus angesehen werden.
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>] [-noconsole]
[-J<Java-Argument>]*
[-allow-shutdown [<Shutdown-ID>]]
[-clearglobals]
[-compact]
[-engine <Engine>]
[-exitcode-ignore-exception]
[-exitcode-ignore-error]
[-exitcode-ignore-warning]
[-groovydir <Verzeichnis>]
[-javascriptdir <Verzeichnis>]
[-jythondir <Verzeichnis>]
[-jythonport <Nummer>]
[-keystore <Keystore-Datei>]
[-keypass <Kennwort>]
[-libpath <Pfad>]
[-license <Datei>]
[-license-waitfor <Sekunden>]
[-logdir <Verzeichnis>]
[-nolog]
[-nomessagewindow]
[-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>+
Die folgenden Parameter steuern die Ausführung eines QF-Test Daemon-Tests:
qftest -batch -calldaemon
[-cleanup] [-clearglobals]
[-dbg] [-java <Programm>] [-noconsole] [-J<java-argument>]*
[-daemonhost <Host>]
[-daemonport <Port>]
[-exitcode-ignore-exception]
[-exitcode-ignore-error]
[-exitcode-ignore-warning]
[-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>
qftest -batch -gendoc
[-dbg] [-java <Programm>] [-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>)+
Um einen Report aus einem oder mehreren Protokollen oder ganzen Verzeichnissen zu erstellen verwenden Sie:
qftest -batch -genreport
[-dbg] [-java <Programm>] [-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>)+
Um QF-Test im Daemon Modus wie in Kapitel 51 beschrieben zu starten verwenden Sie:
qftest -batch -daemon
[-dbg] [-java <Programm>] [-noconsole]
[-J<Java-Argument>]*
[-daemonhost <Host>]
[-daemonport <Port>]
[-daemonrmiport <Port>]
[-engine <Engine>]
[-groovydir <Verzeichnis>]
[-javascriptdir <Verzeichnis>]
[-jythondir <Verzeichnis>]
[-jythonport <Nummer>]
[-keystore <Keystore-Datei>]
[-keypass <Kennwort>]
[-libpath <Pfad>]
[-license <Datei>]
[-license-waitfor <Sekunden>]
[-logdir <Verzeichnis>]
[-nolog]
[-nomessagewindow]
[-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>]*
qftest -batch -import
[-import-from <Testsuite>] [-import-into <Testsuite>]
[-import-components] [-import-procedures] [-import-tests]
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>)+
qftest -batch -mergelogs
[-mergelogs-mode [<Modus>]]
[-mergelogs-usefqn]
[-mergelogs-resultlog [<Datei>]]
[-mergelogs-masterlog [<Datei>]]
(<Protokoll> | <Verzeichnis>)+
qftest -batch -version-allow-shutdown [<Shutdown-ID>])
qftest -batch -shutdown <ID> 4711
qftest -batch -interrupt-running-instances [-timeout <Millisekunden>]
qftest -batch -compress <suite>+
qftest -batch -helpKommandozeilenargumente für QF-Test fallen in drei Kategorien, wobei es nicht auf die Reihenfolge ankommt.
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 Unix stehen diese in
der Datei launcher.cfg in QF-Tests Systemverzeichnis,
unter Windows heißt die Datei launcherwin.cfg.
-batch-dbgQFTEST_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 42).
-java <Programm>java unter Unix und
javaw.exe unter Windows, sofern während der
Installation nichts anderes angegeben wurde.
-noconsole (nur Windows)-dbg ebenfalls angegeben ist.
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.
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-allow-shutdown ohne Shutdown-ID.
-allow-shutdown [<Shutdown-ID>]-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.
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)-analyze-target <Verzeichnis> (nur Batchmodus)-analyze-references (nur Batchmodus)-analyze-duplicates (nur Batchmodus)-analyze-invalidchar (nur Batchmodus)-analyze-emptynodes (nur Batchmodus)-analyze-components (nur Batchmodus)-analyze-dependencies (nur Batchmodus)-analyze-procedures (nur Batchmodus)-analyze-tests (nur Batchmodus)-analyze-packages (nur Batchmodus)-remove-unused-callables (nur Batchmodus)-remove-unused-components (nur Batchmodus)-analyze-transitive (nur Batchmodus)-analyze-followincludes (nur Batchmodus)-calldaemon
(nur Batchmodus)-cleanup
(nur Calldaemon-Modus)-clearglobals
(nur Batchmodus und Calldaemon-Modus)-stopclean, zum Löschen der globalen
Variablen am Ende des Tests.
-compact (nur Batchmodus)-nolog unterdrückt wird.
-compress (nur Batchmodus)-daemon-daemonhost <Host>
(nur Daemon-Modus oder Calldaemon-Modus)-daemonport <Port>-port <Nummer> festgelegte Port.
-daemonrmiport <Port>-daemonport <Port>. Wird SSL verwendet, sind zwei verschiedene Ports
erforderlich.
-dontkillprocesses
(nur Batchmodus)-engine <Engine>-exitcode-ignore-exception
(Batch- und Calldaemon-Modus)-exitcode-ignore-error
(Batch- und Calldaemon-Modus)-exitcode-ignore-warning
(Batch- und Calldaemon-Modus)-gendoc (nur Batchmodus)-genreport (nur Batchmodus)-groovydir <Verzeichnis>groovy und liegt im Systemverzeichnis von QF-Test.
-help-import (nur Batchmodus)-import-from <Testsuite> (nur Batchmodus)-import-into <Testsuite> (nur Batchmodus)-import-components (nur Batchmodus)-import-procedures (nur Batchmodus)-import-tests (nur Batchmodus)-interrupt-running-instances (nur Batchmodus)-javascriptdir <Verzeichnis>javascript und liegt im Systemverzeichnis von QF-Test.
-jythondir <Verzeichnis>jython und liegt im Systemverzeichnis von QF-Test.
-jythonport <Nummer>telnet verwenden, um sich mit diesem
Port zu verbinden und eine interaktive Jython Kommandozeile zu
erhalten.
-keybindings <Wert> (nur interaktiven Modus)-keystore <Keystore-Datei>-keystore=.
-keypass <Kennwort>-kill-running-instances-shutdown all.
-libpath <Pfad>include Verzeichnis von QF-Test wird
automatisch an das Ende des Bibliothekspfads gestellt.
-license <Datei>-license-waitfor <Sekunden>;-logdir <Verzeichnis>log und liegt im Systemverzeichnis von QF-Test.
-mergelogs (nur Batchmodus)-mergelogs-masterlog [<Datei>] (nur Batchmodus)-mergelogs-mode [<Modus>] (nur Batchmodus)-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)-mergelogs-usefqn (nur Batchmodus)-nolog (nur Batchmodus)-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)-noupdatecheck-option <Name>=<Wert>-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>-ping
(nur Calldaemon-Modus)-pkgdoc <Verzeichnis> (nur Batchmodus)-pkgdoc-dependencies
(nur Batchmodus)-pkgdoc-doctags=false können diese ausgeschaltet werden.
-pkgdoc-doctags=false können die doctags
ausgeschaltet werden.
-pkgdoc-html <Verzeichnis> (nur Batchmodus)-pkgdoc-includelocal
(nur Batchmodus)-pkgdoc-nodeicons
(nur Batchmodus)-pkgdoc-nodeicons=false können die Icons
ausgeschaltet werden.
-pkgdoc-passhtml
(nur Batchmodus)-pkgdoc-passhtml=false
können die Tags ausgeschaltet werden.
-pkgdoc-sortpackages
(nur Batchmodus)-pkgdoc-sortpackages=false kann die Sortierung ausgeschaltet werden.
-pkgdoc-sortprocedures
(nur Batchmodus)-pkgdoc-sortprocedures=false kann die Sortierung ausgeschaltet werden.
-pkgdoc-splitparagraph
(nur Batchmodus)-pkgdoc-splitparagraph=false können Sie
die Option ausschalten.
-pkgdoc-stylesheet <Datei>
(nur Batchmodus)-pkgdoc-xml <Verzeichnis> (nur Batchmodus)-plugindir <Verzeichnis>plugin und liegt im Systemverzeichnis von QF-Test.
Weitere Informationen über Plugins finden
Sie in Abschnitt 46.2.
-port <Nummer>-report <Verzeichnis>
(nur Batchmodus)-report-checks
(nur Batchmodus)-report-customdir <Verzeichnis> (nur Batchmodus)-report-doctags=false können die doctags
ausgeschaltet werden.
-report-errors
(nur Batchmodus)-report-errors=false können die Fehler
ausgeschaltet werden.
-report-exceptions
(nur Batchmodus)-report-exceptions=false können die
Exceptions ausgeschaltet werden.
-report-html <Verzeichnis>
(nur Batchmodus)-report-ignorenotimplemented
(nur Batchmodus)-report-ignoreskipped
(nur Batchmodus)-report-junit <Verzeichnis>
(nur Batchmodus)-report-name <Name>
(nur Batchmodus)-report-nodeicons
(nur Batchmodus)-report-nodeicons=false können die Icons
ausgeschaltet werden.
-report-passhtml
(nur Batchmodus)-report-passhtml=false können die Tags
ausgeschaltet werden.
-report-piechart
(nur Batchmodus)-report-piechart=false kann das Erzeugen des
Diagramms verhindert werden.
-report-include-suitename
(nur Batchmodus)-report-include-suitename=false wird der Dateiname verwendet.
-report-scale-thumbnails <Prozent>
(nur Batchmodus)-report-teststeps
(nur Batchmodus)-report-teststeps=false können die
Testschritte ausgeschaltet werden.
-report-thumbnails
(nur Batchmodus)-report-warnings
(nur Batchmodus)-report-xml <Verzeichnis>
(nur Batchmodus)-reuse (nur interaktiver Modus)-run (interaktiver und Batchmodus)-runid [<ID>]
(Batch- und Calldaemon-Modus)%i/+i.
-runlog [<Datei>]
(Batch- und Calldaemon-Modus).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>-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 40.2.4 beschrieben, angegeben
werden.
-runtime-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>/bin/sh unter Unix und COMMAND.COM
bzw. cmd.exe unter Windows.
-shellarg <Argument>-shell <Programm> angegebenen Shell
mitteilt, dass sie das darauf folgende Argument als Kommando
ausführen soll. Standard für Unix Shells ist -c,
während COMMAND.COM und cmd.exe/c erwarten. Wenn Sie Unix 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)-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>-serverhost= mit leerem Wert an.
-sourcedir <Verzeichnis>
(nur Batchmodus)-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)-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)-startsut
(nur zum internen Gebrauch)qfs.daemon.startRemoteSUT aus der Standardbibliothek
qfs.qft zurückgreifen.
-stopclean
(nur Calldaemon-Modus)-stoprun
(nur Calldaemon-Modus)-cleanup oder -stopclean kombiniert werden.
-suitedir <Verzeichnis>
(nur Calldaemon-Modus)-suitesfile <Datei>
(interaktiver und Batchmodus)-test <Index>|<ID> angegeben werden. In der unten stehenden Tabelle finden Sie weitere Beispiele.
| ||||||||||||||||||||
Tabelle 40.1: Beispiele -suitesfile <Datei> | ||||||||||||||||||||
-systemcfg <Datei>-systemdir <Verzeichnis>-systemcfg <Datei>, -plugindir <Verzeichnis>, -jythondir <Verzeichnis>, -groovydir <Verzeichnis> oder
-javascriptdir <Verzeichnis> zusätzlich angegeben sind, haben diese Vorrang.
-tempdir <Verzeichnis> (nur interaktiver Modus)TEMP und TMP
ausgewertet.
-terminate
(nur Calldaemon-Modus)-test <Index>|<ID> (interaktiver und Batchmodus)-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)-testdoc-doctags=false können die doctags
ausgeschaltet werden.
-testdoc-followcalls
(nur Batchmodus)-testdoc-html <Verzeichnis> (nur Batchmodus)-testdoc-nodeicons
(nur Batchmodus)-testdoc-nodeicons=false können die Icons
ausgeschaltet werden.
-testdoc-passhtml
(nur Batchmodus)-testdoc-passhtml=false
können die Tags ausgeschaltet werden.
-testdoc-sorttestcases
(nur Batchmodus)-testdoc-sorttestcases=false kann die Sortierung ausgeschaltet werden.
-testdoc-sorttestsets
(nur Batchmodus)-testdoc-sorttestsets=false kann die Sortierung ausgeschaltet werden.
-testdoc-splitparagraph
(nur Batchmodus)-testdoc-splitparagraph=false können Sie
die Option ausschalten.
-testdoc-stylesheet <Datei>
(nur Batchmodus)-testdoc-teststeps
(nur Batchmodus)-testdoc-teststeps=false können die
Testschritte ausgeschaltet werden.
-testdoc-xml <Verzeichnis> (nur Batchmodus)-threads <Anzahl> (batch mode only)-runtime ebenfalls angegeben werden. Näheres zu Lasttests
finden Sie in Kapitel 29.
-timeout <Millisekunden> (nur Batchmodus oder Calldaemon-Modus)-usercfg <Datei> (nur interaktiver Modus)-userdir <Verzeichnis>-usercfg <Datei> oder -runlogdir <Verzeichnis> zusätzlich angegeben sind,
haben diese Vorrang.
-variable <Name>=<Wert>-variable <Name>=<Wert> geben Sie der Variable
<Name> den Wert <Wert>
(vgl. Kapitel 6). Sie können beliebig viele
Variablen definieren.
-verbose [<level>]-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
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.
| |||||||||||||||||||||||||||||||||||||||
| Tabelle 40.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.
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:
| |||||||||||||||||||||||||||
| Tabelle 40.3: Rückgabewerte von QF-Test | |||||||||||||||||||||||||||
Daneben gibt es spezielle Rückgabewerte, wenn QF-Test mit dem Argument
-calldaemon ausgeführt wird:
| |||||||||||||||
Tabelle 40.4: calldaemon-Rückgabewerte von QF-Test | |||||||||||||||
| | | | | | | Letzte Änderung: 6.9.2022 Copyright © 1999-2022 Quality First Software GmbH |
