Functional Test, Java Scripting - Befehlszeilenschnittstelle

Die Mehrzahl der Aktionen, die gewöhnlich über die grafische Benutzerschnittstelle von Functional Test ausgeführt werden, können Sie auch über die Befehlszeile ausführen. Dazu zählen:

Das zentrale Befehlszeilenformat lautet:

java <standard_java_optionen> com.rational.test.ft.rational_ft <functional_test_optionen>

Unter den standard_java_optionen sind Java-Befehlszeilenoptionen wie -classpath <klassenpfad> zum Definieren des Klassenpfads oder -D zum Definieren einer Systemeigenschaft zu verstehen. Entweder muss die zu diesem Befehl gehörende Java Runtime Environment (JRE) durch Functional Test aktiviert werden, oder Sie müssen die folgenden Optionen definieren:

Wenn die Java Runtime Environment (JRE) durch Functional Test aktiviert wird, sind diese Optionen nicht erforderlich.

Eine komplette Liste der Befehlszeilenoptionen finden Sie in der API-Referenz zu Functional Test (com/rational/test/ft/rational_ft).

Gängigere Optionen sind u. a.:

Beispiele für die Verwendung der Befehlszeile:

In diesen Beispielen muss -classpath auf die rational_ft.jar-Dateien verweisen.

Hinweis: Für die Werte unter <scriptname> gelten die standardmäßigen, für Java-Pakete oder .NET-Namensbereiche gültigen Namenskonventionen wie package.MyScript oder Namespace.MyScript.

Neues Script aufzeichnen:

java -Drational_ft.install.dir=<rational_ft_installationsverzeichnis> -classpath <klassenpfad> com.rational.test.ft.rational_ft -datastore <verzeichnis> [-map <gemeinsam_genutzte_übersicht>] [optionen] -record <scriptname>

In vorhandenes Script aufzeichnen, vor oder hinter bestimmter Zeile einfügen:

java -Drational_ft.install.dir=<rational_ft_installationsverzeichnis> -classpath <klassenpfad> com.rational.test.ft.rational_ft -datastore <verzeichnis> [-insertbefore <zeile>] [-insertafter <zeile>] [options] -record <scriptname>

Script kompilieren:

Hinweis: Der Java-Compiler wird nicht mehr zusammen mit Functional Test installiert. Sie müssen die JRE installieren und das Bin-Verzeichnis zum Pfad hinzufügen.

java -Drational_ft.install.dir=<rational_ft_installationsverzeichnis> -classpath <klassenpfad> com.rational.test.ft.rational_ft -datastore <verzeichnis> [optionen] -compile <scriptname>

Script wiedergeben und <Werte> von Befehlszeilenargumenten an das Script weitergeben:

java -Drational_ft.install.dir=<rational_ft_installationsverzeichnis> -classpath <klassenpfad> com.rational.test.ft.rational_ft -datastore <verzeichnis> -log <protokollname> [optionen] -playback <scriptname> [-args <werte>]

Script aufzeichnen, kompilieren und wiedergeben:

java -Drational_ft.install.dir=<rational_ft_installationsverzeichnis> -classpath <klassenpfad> com.rational.test.ft.rational_ft -datastore <verzeichnis> [optionen] -record <scriptname> -compile -playback [-args <werte>]

Leeres Script erstellen:

java -Drational_ft.install.dir=<rational_ft_installationsverzeichnis> -classpath <klassenpfad> com.rational.test.ft.rational_ft -datastore <verzeichnis> -map <name_gemeinsam_genutzte_übersicht> [optionen] -create <scriptname>

Functional Test im automatischen Stapelbetrieb ausführen

Wenn Sie TestManager installiert haben und Functional Test mit einem TestManager-Protokoll automatisch im Stapelbetrieb ausführen möchten, müssen Sie die folgenden Optionen in die rational_ft-Befehlszeile eingeben:

-user benutzername

TestManager-Benutzername zum Anmelden.

-password kennwort

Optional; TestManager-Kennwort zum Anmelden; nur verwenden, wenn Kennwort verfügbar.

-project vollständiger_pfad_und_vollständiger_projektname

Name des TestManager-Projekts inkl. vorangestelltem vollständigen Pfad unter Berücksichtigung der Groß-/Kleinschreibung.

-build build

Name eines vorhandenen TestManager-Builds; siehe Hinweis unten.

-logfolder ordnername

Der Name eines vorhandenen TestManager-Protokollordners (siehe Hinweis unten) oder die Dateispezifikation für ein HTML- oder Textprotokoll. Wenn Sie den Ordnernamen für das HTML- oder Textprotokoll verwenden, müssen Sie den Build nicht angeben.

Hinweis: Wenn Sie ein TestManager-Protokoll erstellen möchten, müssen Sie vorher die beiden Ordner für TestManager-Build und TestManager-Protokoll erstellen. Weitere Informationen hierzu finden Sie in dem Hinweis zur TestManager-Integration am Ende dieses Abschnitts. Sind die genannten beiden Ordner nicht vorhanden, kann die Ausführung von Functional Test im automatischen Stapelbetrieb nicht funktionieren.

-log protokollname

Name des TestManager-, HTML- oder Textprotokolls. Wenn Sie den Namen für das HTML- oder Textprotokoll verwenden, müssen Sie den Build nicht angeben.

Beispiel:

java -Drational_ft.install.dir="C:\Programme\IBM\Rational\Software Development Platform\6.0\FunctionalTester\eclipse\plugins\com.rational.test.ft.wswplugin_6.1.0" -classpath "C:\Programme\IBM\Rational\Software Development Platform\6.0\FunctionalTester\eclipse\plugins\com.rational.test.ft.wswplugin_6.1.0\rational_ft.jar" com.rational.test.ft.rational_ft -datastore \\My_project\AUser\RobotJProjects -user admin -project \\My_project\AUser\TestManagerProjects\Test.rsp -build "Build 1" -logfolder "Default" -log "Al_SimpleClassicsA#1" -rt.log_format "TestManager" -rt.bring_up_logviewer true -playback basetests.SimpleClassicsA_01

Wenn TestManager das Protokoll nach Abspielen des Scripts nicht anzeigen soll, müssen Sie zusätzlich folgende Option über die rational_ft-Befehlszeile eingeben:

-rt.bring_up_logviewer false

Hinweis zur TestManager-Integration

Functional Test ist in Rational TestManager Version 2003.06.13 integriert. Wenn Sie mit der Version 2003.06.13 von TestManager arbeiten, können Sie die integrierten Funktionen Functional Test und TestManager nutzen. Wichtige Informationen zur kombinierten Verwendung der beiden Produkte finden Sie unter Functional Test-Produktpakete und -integration.

Nutzungsbedingungen | Feedback
(C) Copyright IBM Corporation 2002, 2004. Alle Rechte vorbehalten.