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 unter
Optionen->Allgemein->Programmstart definiert werden (siehe auch Aufruf von QF-Test).
- Interaktiver Modus
-
Die Aufrufsyntax für den interaktiven Modus lautet:
qftest [-dbg
]
[-java <Programm>
] [-noconsole
]
[-J<Java-Argument>]*
[-allowkilling
]
[-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 50). 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>
] [-noconsole
]
[-J<Java-Argument>]*
[-allowkilling
]
[-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-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
]
[-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>
- 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 21 genauer beschrieben. Die Kommandozeilen Syntax lautet:
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
]
[-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>
] [-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-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 50 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>
]*
- 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
- Stoppt den Testlauf auf diesem System
-
qftest -batch -kill-running-instances
- 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 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
-
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 42).
-
-java <Programm>
-
Das Java Programm, das die Ausführung von QF-Test
übernimmt. Standard sind
java
unter Unix und
javaw.exe
unter Windows, sofern während der
Installation nichts anderes angegeben wurde.
-
-noconsole
(nur Windows)
-
Verhindert das Öffnen eines Konsolenfensters unter Windows für den Fall, dass
-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
(nur Batchmodus)
-
Nur wenn dieser Schalter gesetzt ist, ist es möglich den Testlauf mit
-kill-running-instances
zu stoppen.
-
-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)
-
Sind mehrere Testsuiten zur Ausführung angegeben, führt dieses Argument dazu, dass
vor der Ausführung jeder Testsuite die globalen Variablen und Ressourcen gelöscht
werden.
-
-compact
(nur Batchmodus)
-
Erstellt ein kompaktes Protokoll, das nur die Äste und Knoten
enthält, in denen Warnungen, Fehler oder Exceptions aufgetreten
sind. Hat keine Bedeutung, wenn das Protokoll mittels
-nolog
unterdrückt wird.
-
-compress
(nur Batchmodus)
-
Komprimiert die Abbilder in einer bestehenden Testsuite verlustfrei.
-
-daemon
-
Startet QF-Test im Daemon Modus. Weitere Informationen finden Sie in Kapitel 50.
-
-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 50.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 37.1.7.
-
-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.
-
-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 50.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 50.3.
-
-kill-running-instances
(nur Batchmodus)
-
Stoppt den Testlauf auf den aktuellen System, wenn dieser mit
-allowkilling
gestartet wurde.
-
-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
Unix. 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 8.1.7.
-
-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.
-
-noupdatecheck
-
Mit diesem Argument kann die automatische Suche nach Updates deaktiviert werden.
Hierdurch werden die Update-Optionen (siehe Abschnitt 37.1.8) ü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 Dokumentation. 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 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 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 45.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 40.2.4 beschrieben, angegeben werden.
-
-report-checks
(nur Batchmodus)
-
Legt fest, ob Checks im Report aufgelistet werden. Standard ist nein.
-
-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 40.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 40.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 40.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-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 40.2.4 beschrieben, angegeben werden.
-
-reuse
(nur interaktiver Modus)
-
Dieses Argument findet vor allem beim Start von QF-Test über ein
Desktop Icon oder mittels einer Dateiverknüpfung aus dem Windows
Explorer Anwendung. 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 40.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 40.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 40.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
'Shellkommando ausführen' Knotens verwendet wird. Vorgegeben
sind
/bin/sh
unter Unix 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 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.
-
-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 8.1.4)
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 Datei |
Bedeutung |
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 40.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 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 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 28.
-
-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 7). 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.
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.
|
Zeichen |
Bedeutung |
% |
'%'-Zeichen. |
+ |
'+'-Zeichen. |
i |
Die 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.
|
b |
Der Name der Testsuite ohne Verzeichnis oder die Endung .qft . |
r |
Der Rückgabewert des Testlaufs (nur -runlog ). |
w |
Die Anzahl der Warnungen im Testlauf (nur -runlog ). |
e |
Die Anzahl der Fehler im Testlauf (nur -runlog ). |
x |
Die Anzahl der Exceptions im Testlauf (nur -runlog ). |
y |
Das aktuelle Jahr (2 Ziffern). |
Y |
Das aktuelle Jahr (4 Ziffern). |
M |
Der aktuelle Monat (2 Ziffern). |
d |
Der aktuelle Tag (2 Ziffern). |
h |
Die aktuelle Stunde (2 Ziffern). |
m |
Die aktuelle Minute (2 Ziffern). |
s |
Die aktuelle Sekunde (2 Ziffern). |
|
| | 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:
|
Wert |
Bedeutung |
0 |
Alles OK |
1 |
Beim Testlauf sind Warnungen aufgetreten |
2 |
Beim Testlauf sind Fehler aufgetreten |
3 |
Beim Testlauf sind Exceptions aufgetreten |
-1 |
Unerwartete Exception |
-2 |
Falsche Kommandozeilenargumente |
-3 |
Keine oder ungültige Lizenz |
-4 |
Fehler beim Aufbau der RMI Verbindung |
-5 |
Fehler beim Laden der Suite |
-6 |
Die Suite enthält keine Tests |
-12 |
Der Prozess wurde von außen über das -kill-running-instances Batch-Kommando beendet |
|
| | Tabelle 40.3: Rückgabewerte von QF-Test | |
Daneben gibt es spezielle Rückgabewerte, wenn QF-Test mit dem Argument
-calldaemon
ausgeführt wird:
|
Wert |
Bedeutung |
-7 |
Der Daemon konnte nicht gefunden werden |
-8 |
Fehler beim Erstellen eines TestRunDaemon-Objekts |
-9 |
Fehler beim Erstellen eines Context-Objekts |
-10 |
Der Test konnte nicht gestartet werden |
-11 |
Der Test wurde innerhalb des angegeben Timeouts nicht beendet |
|
| | Tabelle 40.4: calldaemon -Rückgabewerte von QF-Test | |