Handbuch
Version 8.0.1 |
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>
(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.
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>+
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>
qftest -batch -convertxml
[-convertxml-indent <Anzahl>
] [-convertxml-linelength <Anzahl>
] [-convertxml-utf8 <true|false>
] (<Testsuite> | <Verzeichnis>)+
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>)+
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>)+
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>
]*
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 -help
Kommandozeilenargumente 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 Linux stehen diese in
der Datei launcher.cfg
in QF-Tests Systemverzeichnis,
unter Windows heißt die Datei launcherwin.cfg
.
-batch
-dbg
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)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)-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.
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)-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)-convertxml
(nur Batchmodus)-convertxml-indent <Anzahl>
(Nur im Modus zur Konvertierung des XML-Formats)-convertxml-linelength <Anzahl>
(Nur im Modus zur Konvertierung des XML-Formats)-convertxml-utf8 <true|false>
(Nur im Modus zur Konvertierung des XML-Formats)-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)-ipv6
-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)-noplugins
-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 49.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 43.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 Linux 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 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)-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 43.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 32.
-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 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.
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 43.3: Rückgabewerte von QF-Test |
Daneben gibt es spezielle Rückgabewerte, wenn QF-Test mit dem Argument
-calldaemon
ausgeführt wird:
| |||||||||||||||
Tabelle 43.4: calldaemon -Rückgabewerte von QF-Test |
Letzte Änderung: 10.9.2024 Copyright © 1999-2024 Quality First Software GmbH |