Interfaccia della riga comandi di Functional Tester

La maggior parte delle azioni che possono essere eseguite dalla GUI di Functional Tester possono essere eseguite anche dalla riga comandi specifica.

Tali azioni includono:

Formato riga comando principale

I formati della riga comandi principale sono:

java <opzioni java standard> -classpath rational_ft.jar com.rational.test.ft.rational_ft <Opzioni Functional Tester> o
java <opzioni java standard> -jar rational_ft.jar <Opzioni Functional Tester>

Le opzioni java standard fanno riferimento alle opzioni della riga comandi Java™, come ad esempio -classpath <classpath> per impostare appropriatamente il percorso classi (classpath).

-classpath
Se si utilizza il primo formato della riga comandi, è necessario includere esplicitamente il file rational_ft.jar nella variabile classpath. Esso si trova nella directory di installazione di Functional Tester. Se si utilizza il secondo formato della riga comandi, specificare il percorso completo del file rational_ft.jar dopo l'opzione -jar. Non è necessario specificare un percorso di classe o la classe da eseguire (com.rational.test.ft.rational_ft ). Se si sta utilizzando Functional Tester con PurifyPlus, utilizzare il primo formato della riga comandi.

Per un elenco completo delle opzioni della riga comandi, consultare Riferimento API Functional Tester (com/rational/test/ft/rational_ft).

-projectpath
Se si dispone delle dipendenze su un progetto, allora è necessario aggiungere il percorso del progetto utilizzando l'opzione -projectpath.

Opzioni utilizzate più comunemente

Di seguito è riportato l'elenco delle opzioni più comunemente utilizzate:

-datastore <directory datastore>
Utilizzare questa opzione ogni volta che viene specificato uno script, ad esempio utilizzarla con -record o -playback.
-record <nome script>
Utilizzare questa opzione per registrare un nuovo script (o insieme all'opzione -insertafter <numero riga> per inserire la registrazione in uno script esistente). Il nome script non è un nome file. È un nome di classe completo che utilizza un carattere punto (.) per separare il pacchetto/spazio nomi e il nome della classe di script. È possibile utilizzare -record <nome script>per registrare gli script Java o VB.NET, a seconda del tipo di progetto.
-playback <nome script>
Utilizzare questa opzione per riprodurre uno script Java. È necessario specificare l'opzione di riproduzione alla fine del comando. Rational Functional Tester ignora gli argomenti specificati dopo l'opzione di riproduzione.
-edit <file> oppure -display <file>
Utilizzare questa opzione per modificare o visualizzare un'associazione oggetti o un punto di verifica Functional Tester. <file> può essere un nome file completo (con il percorso della directory). Utilizzare le virgolette se il nome o il percorso include caratteri di spazio.
-enable
Utilizzare questa opzione per aprire la finestra di dialogo Abilita ambienti per abilitare un ambiente specifico.
-appconfig
Utilizzare questa opzione per aprire la finestra di dialogo Strumento di configurazione dell'applicazione.
-inspector
Utilizzare questa opzione per aprire la finestra di dialogo Strumento controllo oggetto di test.

Esempi relativi all'uso della riga comandi

In questi esempi, -classpath deve specificare i file rational_ft.jar.

Nota: I valori <nome-script> utilizzano le convenzioni di denominazioni del pacchetto Java o dello spazio nomi .NET, come ad esempio, package.MyScript o Namespace.MyScript.

Registrare un nuovo script:

java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> [ -map <sharedmap>] [options] -record <nome-script>

Registrare in uno script esistente, inserendo prima o dopo una determinata riga:

java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> [ -insertbefore <riga>] [ -insertafter <riga>] [options] -map <sharedmap>] [options] -record <nome-script>

Compilare uno script:

Nota: È necessario abilitare l'ambiente Java prima di compilare uno script con questo comando. È inoltre necessario installare Java SDK e aggiungere la directory bin al percorso.
java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> [options] -compile <nome-script>

Riprodurre uno script, passando gli argomenti di riga comandi <valori> allo script:

java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> -log <nome registro> [options] -playback <nome-script> [ -args <valori>]

Riprodurre uno script che utilizza classi da altri oggetti di test funzionali:

java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> -projectpath <reference-project-path> -playback <script-name>

Riprodurre uno script che utilizza altre classi per i progetti di test funzionali:

java -projectpath <projectpath> com.rational.test.ft.rational_ft -datastore <directory> -projectpath <reference-project-path> -playback <script-name>

Riprodurre uno script con un pool di dati associato:

java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> -iterationCount <iteration value> -playback <script-name>

Registrare, compilare e riprodurre uno script:

java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> [options] -record <nome-script> -compile -playback [ -args <valori>]
Nota: Per riprodurre gli script con VP dinamici, aggiungere -rt.interative true prima di -playback nella riga di comando.

Creare uno script vuoto:

java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> -map <nome_associazione_condivisa> [options] -create <nome-script>

Rigenerare il file helper per uno script:

java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> -helper <nome-script>

Rigenerare tutti i file helper per un datastore:

java -classpath <classpath> com.rational.test.ft.rational_ft -regenHelpers <nome-script>

Visualizzare un file associazione oggetti:

java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> -display <nomefile-associazione-oggetti>

Visualizzare un file punto di verifica:

java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> -display <nomefile punto di verifica>

Modificare un file associazione oggetti:

java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> -edit <nomefile associazione oggetti>

Modificare un file punto di verifica:

java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> -edit <nomefile punto di verifica>

Creare e modificare un'associazione oggetti condivisa:

java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> -fromMap <nomefile1 associazione oggetti> -createMap <nomefile2 associazione oggetti>

Unire una versione più recente di un'associazione oggetti con una versione corrente (modificata) della stessa associazione:

java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> -from <nomefile1 associazione oggetti> -to <nomefile2 associazione oggetti> -original <nomefile1 associazione oggetti> -mergeMap

Confrontare un risultato reale del punto di verifica con un risultato previsto del punto di verifica:

java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> -baseline <nome file punto di verifica base> -compare <nome file punto di verifica previsto> <nome file punto di verifica effettivo>

Abilitare un browser configurato, un ambiente Java o una piattaforma Eclipse:

java -classpath <classpath> com.rational.test.ft.rational_ft -enableName <browser/ambiente Java/Eclipse>

Disabilitare tutti i browser configurati, gli ambienti Java e le piattaforme Eclipse:

java -classpath <classpath> com.rational.test.ft.rational_ft -disableall

Eseguire lo strumento di configurazione dell'applicazione:

java -classpath <percorso di classe> com.rational.test.ft.rational_ft -appConfig <nome dell'applicazione>

Eseguire la funzione Controllo oggetto di test:

java -classpath <percorso di classe> com.rational.test.ft.rational_ft -inspector

Eseguire lo strumento di configurazione delle proprietà degli oggetti:

java -classpath <classpath> com.rational.test.ft.rational_ft -objectlibraryou

Esecuzione di Functional Tester in modalità di batch non presidiata

Se TestManager è installato e si desidera eseguire Functional Tester in modalità batch non presidiata mediante un registro di TestManager, è necessario includere le seguenti opzioni nella riga comandi rational_ft:

-user nome utente
Il nome utente TestManager per l'accesso.
-password password
Facoltativo. La password TestManager per l'accesso. Non utilizzare questa opzione se non è stata impostata alcuna password.
-project percorso completo e nome progetto completo
Il nome del progetto TestManager, preceduto dal percorso completo. È sensibile al maiuscolo/minuscolo.
-build build
Il nome del build TestManager esistente. Consultare la nota successiva.
-logfolder nome cartella
Il nome di una cartella di registro TestManager esistente (consultare nota successiva) o la specifica file per un registro di testo o HTML. Se si utilizza un nome di cartella di registro di testo o HTML, non è necessario specificare il build.
Nota: Se si desidera creare un registro TestManager, accertarsi di creare prima il build TestManager e le relative cartelle di registro. Se queste due cartelle non esistono, l'esecuzione avrà esito negativo quando Functional Tester viene eseguito in modalità batch non presidiata.
-log nome registro
Il nome del registro di testo o HTML di TestManager. Se si utilizza un nome di registro di testo o HTML, non è necessario specificare il build.

Esempi:

Eseguire uno script su Windows®

	java -classpath "C:\IBM\RFT\FunctionalTester\bin\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

Se non si desidera che TestManager visualizzi il registro dopo la riproduzione dello script, è necessario includere la seguente opzione nella riga comandi rational_ft:

-rt.bring_up_logviewer false

Utilizzo della riga comandi in Linux

Il formato della riga comandi è: /opt/IBM/RFT/jre/bin/java /opt/IBM/RFT/FunctionalTester/bin/rational_ft.jar<opzioni di Functional Tester>

Se si utilizza questo formato della riga comandi, è necessario impostare esplicitamente le variabili d'ambiente di Functional Tester. In alternativa, è possibile utilizzare lo script ft_cmdline.

Esempi:

Abilita tutti gli ambienti in Linux®

	/opt/IBM/SDP7.0/ft_cmdline -enable ALL

Esegui uno script con gli argomenti della riga comandi su Linux

/opt/IBM/SDp7.0/ft_cmdline -datastore 
/opt/IBM/RFT/workspace/Project1 -log testscript -playback Script2 -args arg1 arg2

Feedback