Interface de ligne de commande de Functional Tester

La plupart des actions exécutées depuis l'interface graphique de Functional Tester peuvent l'être aussi à partir de l'interface de ligne de commande.

Il s'agit des actions suivantes :

Format principal de la ligne de commande

Les formats principaux de la ligne de commande sont les suivants :

java <options java standard> -classpath rational_ft.jar com.rational.test.ft.rational_ft <options Functional Tester> ou
java <options java standard> -jar rational_ft.jar <options Functional Tester>

La variable options java standard représente les options de ligne de commande Java™, telles que -classpath <cheminclasses>, utilisées pour définir un chemin d'accès aux classes correctement.

-classpath
Si vous utilisez le premier format de ligne de commande, vous devez inclure explicitement le fichier rational_ft.jar dans le chemin d'accès aux classes. Il se trouve dans le répertoire d'installation Functional Tester. Si vous utilisez le deuxième format de ligne de commande, indiquez le chemin d'accès complet au fichier rational_ft.jar après l'option -jar. Il n'est pas nécessaire de spécifier un chemin d'accès aux classes ni la classe à exécuter (com.rational.test.ft.rational_ft ). Si vous utilisez Functional Tester avec PurifyPlus, utilisez le premier format de ligne de commande.

Consultez les informations de référence des API de Functional Tester (com/rational/test/ft/rational_ft) pour prendre connaissance de la liste complète des options de ligne de commande.

-projectpath
Si vous avez des dépendances sur un projet, vous devez alors ajouter le chemin d'accès au projet à l'aide de l'option -projectpath. Si vous avez ajouté d'autres dépendances au projet de test fonctionnel, vous pouvez indiquer le nom du projet à l'aide de l'option -projectpath. Par exemple, imaginez un cas où un script de test fonctionnel utilise une classe d'un autre projet. Pour résoudre cette dépendance, lorsque vous invoquez une ligne de commande, vous devez indiquer le nom du projet dépendant à l'aide de l'option -projectpath.

Options les plus utilisées

Vous trouverez ci-après la liste des options les plus fréquemment utilisées.

-datastore <répertoire du magasin de données>
Utilisez cette option lorsqu'un script est spécifié, avec -record ou -playback par exemple.
-record <nom du script>
Utilisez cette option 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 nom et le nom de la classe. Vous pouvez utiliser -record <nom du script> pour enregistrer des scripts Java ou VB.NET, selon le type de projet.
-playback <nom du script>
Utilisez cette option pour lire un script Java. Vous devez indiquez l'option de lecture à la fin de la commande. Rational Functional Tester ignore tous les arguments spécifiés après l'option de lecture.
-edit <fichier> ou -display <fichier>
Utilisez cette option pour éditer ou afficher un point de vérification ou une mappe d'objets de Functional Tester. <fichier> peut être un nom de fichier complet (avec son chemin). Si le nom ou le chemin du fichier contient des espaces, placez-le entre guillemets.
-enable
Utilisez cette option pour ouvrir la boîte de dialogue Activation des environnements afin d'activer un environnement spécifique.
-appconfig
Utilisez cette option pour ouvrir la boîte de dialogue Outil de configuration d'application.
-inspector
Utilisez cette option pour ouvrir la boîte de dialogue Barre d'outils de l'Inspecteur d'objet de test.

Exemples de syntaxe de ligne de commande

Dans ces exemples, -classpath doit pointer sur les fichiers 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 nom respectant les conventions de dénomination .NET Espacenom.MonScript.

Enregistrer un nouveau script :

java -classpath <chemin d'accès aux classes> com.rational.test.ft.rational_ft -datastore <répertoire> [ -map <mappe partagée>] [options] -record <nom du script>

Enregistrer un script simplifié :

java -classpath <chemin d'accès aux classes> com.rational.test.ft.rational_ft -simplescript true -datastore <répertoire> [-map<nom de mappe partagée>] [options] -record <nom du script>

Insérer un enregistrement dans un script existant, avant ou après une ligne donnée :

java -classpath <chemin d'accès aux classes> com.rational.test.ft.rational_ft -datastore <répertoire> [ -insertbefore <ligne>] [ -insertafter <ligne>] [options] -map <mappe partagée>] [options] -record <nom du script>

Compiler un script :

Remarque : Vous devez activer l'environnement Java avant de compiler un script avec cette commande. Vous devez aussi installer le logiciel Java SDK et ajouter le répertoire bin au chemin d'accès.
java -classpath <chemin d'accès aux classes> com.rational.test.ft.rational_ft -datastore <répertoire> [options] -compile <nom du script>

Lire un script en lui transmettant des arguments de ligne de commande <valeurs> :

java -classpath <chemin d'accès aux classes> com.rational.test.ft.rational_ft -datastore <répertoire> -log <nom du journal> [options] -playback <nom du script> [ -args <valeurs>]

Exécuter un script qui utilise des classes d'autres projets de test fonctionnel :

java -classpath <chemin d'accès aux classes> com.rational.test.ft.rational_ft -datastore <répertoire> -projectpath <chemin d'accès au projet de référence> -playback <nom du script>

Lire un script qui utilise d'autres classes pour les projets Functional Tester :

java -projectpath <chemin d'accès au projet> com.rational.test.ft.rational_ft -datastore <répertoire> -projectpath <chemin d'accès au projet de référence> -playback <nom du script>

Lire un script auquel un pool de données est associé :

java -classpath <chemin d'accès aux classes> com.rational.test.ft.rational_ft -datastore <répertoire> -iterationCount <valeur de l'itération> -playback <nom-script>

Enregistrer, compiler et lire un script :

java -classpath <chemin d'accès aux classes> com.rational.test.ft.rational_ft -datastore <répertoire> [options] -record <nom du script> -compile -playback [ -args <valeurs>]
Remarque : Pour lire vos scripts avec des points de vérification dynamiques, ajoutez -rt.interative true avant -playback sur la ligne de commande.

Créer un script vide :

java -classpath <chemin d'accès aux classes> com.rational.test.ft.rational_ft -datastore <répertoire> -map <nom de la mappe partagée> [options] -create <nom du script>

Régénérer le fichier d'auxiliaire d'un script :

java -classpath <chemin d'accès aux classes> com.rational.test.ft.rational_ft -datastore <répertoire> -helper <nom du script>

Régénérer tous les fichiers d'auxiliaire d'un magasin de données :

java -classpath <chemin d'accès aux classes> com.rational.test.ft.rational_ft -regenHelpers <nom du script>

Afficher un fichier de mappe d'objets :

java -classpath <chemin d'accès aux classes> com.rational.test.ft.rational_ft -datastore <répertoire> -display <nom du fichier de la mappe d'objets>

Afficher le fichier des points de vérification :

java -classpath <chemin d'accès aux classes> com.rational.test.ft.rational_ft -datastore <répertoire> -display <nom du fichier des points de vérification>

Editer un fichier de mappe d'objets :

java -classpath <chemin d'accès aux classes> com.rational.test.ft.rational_ft -datastore <répertoire> -edit <nom du fichier de la mappe d'objets>

Editer un fichier de points de vérification :

java -classpath <chemin d'accès aux classes> com.rational.test.ft.rational_ft -datastore <répertoire> -edit <nom du fichier des points de vérification>

Créer et modifier une mappe d'objets partagée :

java -classpath <chemin d'accès aux classes> com.rational.test.ft.rational_ft -datastore <répertoire> -fromMap <nom du fichier de mappe d'objets 1> -createMap <nom du fichier de mappe d'objets 2>

Fusionner une version ultérieure d'une mappe d'objets et la version actuelle (modifiée) de la même mappe :

java -classpath <chemin d'accès aux classes> com.rational.test.ft.rational_ft -datastore <répertoire> -from <nom du fichier de mappe d'objets 1> -to <nom du fichier de mappe d'objets 2> -original <nom du fichier de mappe d'objets> -mergeMap

Comparer le résultat d'un point de vérification réel et celui d'un point de vérification attendu :

java -classpath <chemin d'accès aux classes> com.rational.test.ft.rational_ft -datastore <répertoire> -baseline <nom du fichier des points de vérification de référence> -compare <nom du fichier des points de vérification attendu> <nom du fichier des points de vérification réel>

Activer un navigateur configuré, l'environnement Java ou une plateforme Eclipse :

java -classpath <chemin d'accès aux classes> com.rational.test.ft.rational_ft -enableName <navigateur/environnement Java/Eclipse>

Désactiver tous les navigateurs configurés, les environnements Java et les plateformes Eclipse :

java -classpath <chemin d'accès aux classes> com.rational.test.ft.rational_ft -disableall

Exécuter l'outil de configuration d'application :

java -classpath <chemin d'accès aux classes> com.rational.test.ft.rational_ft -appConfig <nom de l'application>

Exécuter l'inspecteur d'objet de test :

java -classpath <chemin d'accès aux classes> com.rational.test.ft.rational_ft -inspector

Exécuter l'outil de configuration des propriétés d'objet :

java -classpath <chemin d'accès aux classes> com.rational.test.ft.rational_ft -objectlibraryou

Exécution de Functional Tester sans surveillance en mode batch

Si TestManager est installé et que vous souhaitez 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
Facultatif. Mot de passe pour la connexion à TestManager. N'utilisez pas cette option si aucun mot de passe n'a été 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 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. Si ces deux dossiers n'existent pas, l'exécution de Functional Tester sans surveillance en mode batch échoue.
-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.

Exemples :

Exécuter un script sous 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

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

Syntaxe de ligne de commande sous Linux

Le format de ligne de commande est : /opt/IBM/RFT/jre/bin/java /opt/IBM/RFT/FunctionalTester/bin/rational_ft.jar<options Functional Tester>

Si vous utilisez le format de ligne de commande ci-dessus, vous devez explicitement définir les variables d'environnement de Functional Tester. Vous pouvez aussi utiliser le script Functional Tester ft_cmdline.

Exemples :

Activer tous les environnements sous Linux®

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

Exécuter un script avec des arguments de ligne de commande sous Linux

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

Retour d'informations