La plupart des actions exécutées depuis l'interface graphique de Functional Tester peuvent l'être aussi à partir de l'interface ligne de commande. Vous pouvez notamment :
enregistrer un script ;
compiler un script ;
lire (exécuter) un script en lui passant des arguments de ligne de commande ;
visualiser et éditer des fichiers de point de vérification et de mappe d'objets ;
appeler l'outil d'activation Java/HTML (Enabler) ;
appeler l'Outil de configuration d'application.
Le format principal de la ligne de commande est le suivant :
java <options Java standard> com.rational.test.ft.rational_ft <options Functional Tester>
options Java standard représente ici les options de la ligne de commande Java, telles que -classpath <chemin de classes> (pour définir le chemin de classes approprié) ou -D (pour définir une propriété système). Le JRE associé à cette commande doit être activé par Functional Tester, ou alors les options suivantes doivent être définies :
-classpath
doit être spécifiée pour inclure explicitement le fichier rational_ft.jar
situé dans le répertoire d'installation de Functional Tester.
-Drational_ft.install.dir=<répertoire d'installation de Functional Tester>
doit être définie pour permettre l'initialisation correcte de Functional Tester.
Si le JRE est activé par Functional Tester, ces options ne sont pas nécessaires.
Pour la liste complète des options de la ligne de commande, consultez le guide de référence des API de Functional Tester (com/rational/test/ft/rational_ft).
Les options les plus utilisées sont les suivantes :
-datastore
<répertoire projet>
est nécessaire dès lors qu'un script est spécifié, par exemple avec l'option -record
ou -playback
.
-record
<nom de script>
pour enregistrer
un nouveau script (ou, conjointement avec -insertafter
<numéro de ligne>
, pour insérer un enregistrement
dans un script existant). Le nom du script n'est pas un nom
de fichier. Il s'agit d'un nom de classe qualifié complet, utilisant le point (.) comme caractère de séparation
entre le package/espace de noms et le nom de la classe. Vous pouvez utiliser -record <nom de
script>
pour enregistrer un
script Java ou VB.NET, selon le type de projet.
-playback
<nom de script>
pour lire
un script Java particulier.
-edit
<fichier>
ou -display <fichier>
pour éditer ou visualiser un point de vérification ou une mappe d'objets Functional Tester.
<fichier>
peut être un nom de
fichier complet (avec son chemin). Si le nom ou le chemin du fichier contient des espaces, utilisez
des guillemets.
-enable
pour lancer l'outil d'activation d'environnement ou activer un
environnement spécifique.
-appconfig
pour lancer l'Outil de configuration d'application.
-inspector
pour lancer l'outil Inspecteur d'objet de test.
Voici quelques exemples d'utilisations de la ligne de commande :
Dans ces exemples, -classpath
doit pointer sur le
fichier rational_ft.jar.
Remarque : Les valeurs symbolisées par <nom-script>
sont des noms de package respectant les conventions de dénomination Java
(par exemple, package.MonScript
ou des espaces de noms respectant les
conventions de dénomination .NET (par exemple, Espacenoms.MonScript
).
Enregistrer un nouveau script :
java -Drational_ft.install.dir=<rép. install Rational FT> -classpath <chemin de classes> com.rational.test.ft.rational_ft -datastore <répertoire> [-map <nom-mappe-partagée>] [options] -record <nom-script>
Insérer un enregistrement dans un script existant, avant ou après une ligne donnée :
java -Drational_ft.install.dir=<rép. install Rational FT> -classpath <chemin de classes> com.rational.test.ft.rational_ft -datastore <répertoire> [-insertbefore <ligne>] [-insertafter <ligne>] [options] -record <nom-script>
Compiler un script :
Remarque : Le compilateur Java n'est plus installé avec cette version de Functional Tester. Vous devez installer un JRE et ajouter son répertoire bin à votre variable d'environnement PATH.
java -Drational_ft.install.dir=<rép. install Rational FT> -classpath <chemin de classes> com.rational.test.ft.rational_ft -datastore <répertoire> [options] -compile <nom-script>
Lire un script en lui passant des <valeurs> d'arguments de ligne de commande :
java -Drational_ft.install.dir=<rép. install Rational FT> -classpath <chemin de classes> com.rational.test.ft.rational_ft -datastore <répertoire> -log <nom-journal> [options] -playback <nom-script> [-args <valeurs>]
Enregistrer, compiler et lire un script :
java -Drational_ft.install.dir=<rép. install Rational FT> -classpath <chemin de classes> com.rational.test.ft.rational_ft -datastore <répertoire> [options] -record <nom-script> -compile -playback [-args <valeurs>]
Créer un script vide :
java -Drational_ft.install.dir=<rép. install Rational FT> -classpath <chemin de classes> com.rational.test.ft.rational_ft -datastore <répertoire> -map <nom-mappe-partagée> [options] -create <nom-script>
Exécution de Functional Tester sans surveillance en mode batch
Si TestManager est installé et que vous souhaitiez exécuter Functional Tester sans surveillance en mode batch (traitement par lots) avec un journal TestManager, vous devez inclure les options suivantes sur la ligne de commande rational_ft :
-user nom_utilisateur
Nom d'utilisateur pour la connexion à TestManager.
-password mot_de_passe
Optionnel. Mot de passe pour la connexion à TestManager. N'utilisez pas cette option si aucun mot de passe n'est défini.
-project chemin et nom complets du projet
Nom du projet TestManager, précédé de son chemin complet. Respectez la casse des caractères.
-build génération
Nom d'une génération (build) TestManager existante. Voir la remarque plus bas.
-logfolder nom_dossier
Nom d'un dossier de journaux TestManager (voir la remarque plus bas) ou spécification de fichier dans le cas d'un journal au format HTML ou texte. Si vous utilisez un dossier de journaux HTML ou texte, vous n'avez pas besoin de spécifier la génération.
Remarque : Si vous voulez créer un journal TestManager, veillez à d'abord créer les dossiers de génération (Build) et de journaux (Log) TestManager. Voir la remarque à propos de l'intégration de Functional Tester avec TestManager, à la fin de cette rubrique. Si ces deux dossiers n'existent pas, l'exécution de Functional Tester sans surveillance en mode batch échouera.
-log nom_journal
Nom du journal TestManager, HTML ou texte. Si vous utilisez un journal HTML ou texte, vous n'avez pas besoin de spécifier la génération.
Exemple :
java
-Drational_ft.install.dir="C:\Program Files\IBM\Rational\Software
Development Platform\6.0\FunctionalTester\eclipse\plugins\com.rational.test.ft.wswplugin_6.1.0"
-classpath "C:\Program Files\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
Si vous ne souhaitez pas que TestManager affiche automatiquement le journal après la lecture du script, vous devez inclure l'option suivante sur la ligne de commande rational_ft :
-rt.bring_up_logviewer
false
Remarque à propos de l'intégration avec TestManager
Functional Tester est intégré avec Rational TestManager version 2003.06.13. Si vous avez cette version de TestManager, vous pourrez utiliser les fonctions intégrées de Functional Tester et TestManager. Consultez la rubrique Intégration entre Functional Tester et les autres produits Rational, car elle contient des informations clés sur l'utilisation des produits ensemble.
Conditions d'utilisation | Appréciations en retour
(C) Copyright IBM Corporation 2002, 2004. All Rights Reserved.