Initialisation de variables à partir de la ligne de commande

Pour initialiser des variables de test d'un fichier XML, vous pouvez exécuter le test à partir de l'interface de ligne de commande à l'aide de l'option varfile.

Avant de commencer

Pourquoi et quand exécuter cette tâche

Si une variable est initialisée à plusieurs emplacements, notamment dans les tests, les tests composites, les plannings ou les groupes d'utilisateurs, le produit suit l'ordre suivant pour initialiser la valeur de la variable lors de l'exécution du test. La variable définie dans la table de variables de l'éditeur de test composite possède la priorité la plus forte, suivie des autres :
  1. Paramètre du test composite dans l'interface utilisateur de la table de variables
  2. Test composite spécifié dans un fichier var
  3. Paramètre du groupe d'utilisateurs dans l'interface utilisateur de la table de variables
  4. Groupe d'utilisateurs spécifié dans un fichier var
  5. Paramètre du planning spécifié dans l'interface utilisateur de la table de variables
  6. Planning spécifié dans un fichier var
  7. Ligne de commande
Remarque : Vous devez sélectionner Tous les tests de cet utilisateur depuis la liste déroulante Visible dans pour prévaloir sur l'initialisation de la variable.

Procédure

  1. Accédez au répertoire qui contient les fichiers cmdline.bat et cmdline.sh. Dans les systèmes d'exploitation Windows, ce répertoire est généralement productInstallationDirectory/cmdline. Par exemple, C:\Program Files\IBM\SDP\cmdline.
  2. Exécutez la commande suivante :

    cmdline -workspace workspace_full_path -project proj_rel_path -eclipsehome eclipse_full_path -plugins plugin_full_path -suite suite_rel_path -importzip file_name.zip -varfile variable_file_full_path -servicename service -serviceargs service_args -configfile file_full_path -results result_file -overwrite {"true" | "false"} -quiet -users nn -vmargs JVM_args -rate RateRunnerGroupName=iterationNumber/duration, iterationNumber/duration -duration Stage1=durationOfStage; Stage2=durationOfStage -publish serverURL#project.name=projectName -publish_for {ALL,PASS,FAIL,ERROR, INCONCLUSIVE} -exportlog log_full_path -exportstats local_dir_path -timerange "all, 5 Users, 10 Users" -exportstatshtml local_dir_path -compare "result_path1, result_path2" -exportstatreportlist stats_list -execsummary local_dir_path -execsummaryreport reportID -usercomments "any user comment" -publishreports "FUNCTIONAL, MOBILE_WEBUI, STATS, TESTLOG" -stdout -swapdatsets existing_dataset_file_path:new_dataset_file-path

    Remarque :
    • L'espace de travail est verrouillé une fois la commande émise. Pour vérifier l'avancement du test lors de son exécution, accédez à un autre espace de travail et ouvrez le projet dans ce dernier.
    • Dans les systèmes d'exploitation Linux, la commande doit commencer par cmdline.sh.
    • La ligne de commande ne permet pas d'indiquer le mot de passe de stockage sécurisé pour le contrôle de ressources. Vous devez indiquer le mot de passe dans le plan de travail et vous assurer qu'il est stocké et conservé dans le planning avant de tenter d'exécuter ce dernier à partir de la ligne de commande.
    Si une valeur contient des espaces, placez-la entre guillemets. Pour afficher l'aide en ligne de cette commande, entrez cmdline -help quand vous vous trouvez dans le répertoire qui contient le fichier .bat.

    Le tableau suivant décrit chaque option :

    Option Description
    -workspace Obligatoire. Chemin d'accès complet à l'espace de travail Eclipse.
    -project Obligatoire. Chemin (incluant le nom de fichier) du projet par rapport à l'espace de travail.
    -eclipsehome Facultatif. Chemin complet d'accès au répertoire qui contient eclipse.exe.
    -plugins Facultatif. Chemin complet du dossier qui contient les plug-ins. Dans les systèmes d'exploitation Windows, il s'agit généralement du dossier C:\Program Files\IBM\IBMIMShared\plugins.

    Obligatoire. Cette option est requise uniquement si le dossier se trouve dans un autre emplacement.
    -suite Facultatif. Toutefois, dans une commande, il est obligatoire d'utiliser l'une des options ci-dessous :
    • -suite
    • -schedule
    • -aftsuite
    • -servicename

    Vous ne devez pas utiliser l'option -suite avec les autres options. Le chemin inclut le nom de fichier de la suite à exécuter spécifiée par rapport au projet.

    Depuis Rational Functional Tester 9.2.1.1, vous pouvez exécuter plusieurs tests simultanément.

    Par exemple, -suite test1:test2:test3.
    -aftsuite Facultatif. Toutefois, dans une commande, il est obligatoire d'utiliser l'une des options ci-dessous :
    • -suite
    • -aftsuite
    • -servicename
    Vous ne devez pas utiliser l'option -aftsuite avec les autres options. L'option -aftsuite accepte aft XML comme valeur de paramètre. Elle prend uniquement en charge une entrée aft XML.

    Par exemple, -aftsuite aftinput
    -importzip Facultatif. Pour importer le projet en tant que ressources de test avec des dépendances dans votre espace de travail, utilisez l'option -importzip. Cette commande est disponible à partir de la version 9.2.1.1 et des versions ultérieures.

    Facultatif. Vous pouvez exécuter des ressources de test à partir du fichier zip importé, mais vous devez spécifier l'option -importzip, ainsi que l'option -schedule ou l'option -suite. Par exemple, -importzip script.zip
    -varfile Facultatif. Cette option vous permet de spécifier le chemin complet d'accès au fichier XML qui contient les paires nom-valeur des variables.

    Pour exécuter un test d'interface Web sur un autre navigateur que celui utilisé pour l'enregistrement, spécifiez la variable prédéfinie. Pour plus d'informations, voir Définition d'une variable pour l'exécution d'un test à l'aide d'un navigateur sélectionné
    -servicename Facultatif. Toutefois, dans une commande, il est obligatoire d'utiliser l'une des options ci-dessous :
    • -suite
    • -schedule
    • -aftsuite
    • -servicename

    Vous ne devez pas utiliser l'option -servicename avec les autres options. Le chemin inclut le nom de fichier du service à exécuter spécifié relativement au projet. Au lieu d'un test de performances, le service spécifié est exécuté lorsqu'il est disponible.
    -serviceargs Facultatif. Cette option vous permet de spécifier une série d'arguments à transmettre au service spécifié. Par exemple, -serviceargs"-myserviceparm1 myserviceparm1value". Les valeurs sont placées entre guillemets, car elles contiennent des espaces.
    -configfile Facultatif. Cette option vous permet de spécifier le chemin complet d'accès à un fichier qui contient les paramètres pour une exécution de test . Chaque paramètre doit figurer sur une ligne à part. Pour créer un fichier de configuration, utilisez un éditeur qui ne force pas le retour à la ligne. Tous les paramètres, qu'ils soient obligatoires ou facultatifs, peuvent être définis dans le fichier de configuration. Les paramètres de ligne de commande remplacent les valeurs figurant dans ce fichier.
    Remarque : Le fichier doit être au format UTF-8. Vous ne devez pas utiliser de guillemets dans ce fichier, même pour les valeurs qui contiennent des espaces.
    -results Facultatif. Cette option vous permet de spécifier le nom du fichier de résultats. Par défaut, il s'agit du nom du test , auquel un horodatage est accolé. Indiquez un nom de dossier en rapport avec le projet pour stocker les résultats de test. Par exemple, -results folder/resultname.
    -overwrite Facultatif. Détermine si un fichier de résultats portant le même nom sera remplacé. La valeur par défaut, false, indique que le nouveau fichier de résultats est créé. Si la valeur est true, le fichier est remplacé et conserve le même nom de fichier. Vous devez utiliser des guillemets doubles pour les valeurs "true" et "false".
    -quiet Facultatif. Désactive l'émission de messages par le programme de lancement et revient à l'interpréteur de commandes une fois l'exécution ou la tentative d'exécution terminée.
       
    -vmargs Facultatif. Pour définir la taille de segment Java™ maximale pour le processus Java qui contrôle la lecture de la ligne de commande, utilisez l'option -vmargs avec l'argument -Xmx. Par exemple, lorsque vous utilisez -vmargs -Xmx4096m, vous définissez une taille de segment maximale de 4 096 m. Cette méthode revient à définir -Xmx4096m dans le fichier eclipse.ini pour le plan de travail lors de la lecture du test à partir de l'interface utilisateur.

    Pour capturer des données de surveillance des ressources, utilisez -vmargs "-Drm.collect=true -Drm.collect.interval=numeric value more than 1000".

    Pour recueillir les temps de réponse de l'appli elle-même ainsi que du serveur et du réseau, et pour les faire figurer dans des graphiques à barres différents, utilisez -vmargs "-De2e.collect=true". Dans le cas des applications Web pour ordinateur de bureau (type PC), les temps de réponse sont capturés et affichés par défaut.

    Pour exécuter des tests en parallèle sur tous les périphériques mobiles qui sont en mode passif, connectés au plan de travail et prêts à la lecture, utilisez -vmargs "-Dall.available.targets.in.parallel=true".

    Pour exécuter des tests en parallèle sur tous les navigateurs d'ordinateur de bureau pris en charge et les périphériques mobiles connectés, utilisez -vmargs "-Dall.available.targets.in.parallel=all".

    Pour exécuter des tests en parallèle sur des navigateurs d'ordinateur de bureau sélectionnés et des périphériques mobiles connectés, utilisez -vmargs "-Dall.available.targets.in.parallel=browser1,browswer2,browser3". Vous devez séparer les noms de navigateur par une virgule. Par exemple, firefox, ff, chrome, ie, ie64, safari, "-Dall.available.targets.in.parallel=browser1,browser2,browser3". Séparez les noms de navigateur à l'aide d'une virgule, par exemple firefox, ff, chrome, ie, ie64, safari, edge.
    - protocolinput Facultatif. Ce paramètre vous permet d'exécuter un test d'interface Web en parallèle sur différents navigateurs.

    -protocolinput "all.available.targets.in.parallel=all"

    -protocolinput "all.available.targets.in.parallel=chrome,ff,ie"

    Vous pouvez aussi spécifier les préférences d'interface Web dans cet argument.

    Par exemple, -protocolinput "webui.highlight=<value>;webui.report.screenshots=<value>"

    où

    webui.highlight indique si l'élément de page doit être mis en évidence.

    webui.report indique si les captures d'écran doivent être effectuées lors de la lecture du test dans le navigateur.

    Remarque : Si vous utilisez l'argument -protocolinput, vous ne devez pas utiliser les arguments -vmargs équivalents : 
    -vmargs "-Dall.available.targets.in.parallel=all"
-vmargs "-Dall.available.targets.in.parallel=browser1,browswer2,browser3"
    -publish Facultatif. Cet argument vous permet de publier les résultats de test sur le IBM Rational Test Automation Server. Les paramètres que vous pouvez utiliser sont les suivants :
    • serverURL#project.name=projectName- Cette option vous permet de spécifier le nom du projet. Si le nom du projet n'est pas spécifié, le nom du projet en cours est alors utilisé.
    • no - Cette option vous permet de ne pas publier les résultats de test après l'exécution. Cette option est utile si les préférences du plan de travail sont définies de manière à publier les résultats, mais que vous ne souhaitez toutefois pas les publier.
    -publish_for Facultatif. Cette option vous permet de publier les résultats de test sur la base de l'état d'achèvement du test :
    • ALL - Il s'agit de l'option par défaut. Cette option vous permet de publier les résultats de test pour tout verdict d'exécution de test.
    • PASS - Cette option vous permet de publier les résultats des tests réussis.
    • FAIL - Cette option vous permet de publier les résultats des tests échoués.
    • ERROR - Cette option vous permet de publier les résultats des tests qui contenaient des erreurs.
    • INCONCLUSIVE - Cette option vous permet de publier les résultats des tests qui ne se sont pas révélés concluants.
    Vous pouvez ajouter plusieurs paramètres séparés par une virgule.
    -exportlog Facultatif. Ce paramètre vous permet de spécifier le chemin du répertoire de fichier où stocker le journal de test HTTP exporté.

    À partir de IBM Rational Functional Tester 10.0.1, le paramètre -exportlog vous permet de fournir plusieurs entrées de paramètre lors de l'exécution de plusieurs tests. Les entrées de paramètre doivent être séparées par une virgule.

    Par exemple : -exportlog c:/logexport.txt:c:/secondlogexport.txt

    S'il existe plusieurs entrées de paramètre -suite avec une seule entrée de paramètre -exportlog, le paramètre -exportlog génère le bon nombre de journaux de test en ajoutant 0, 1, 2, etc. au nom de l'entrée de paramètre -exportlog.

    Par exemple : -suite "sampletest1:sampletest2:sampletest3" -exportlog c:/logexport.txt La commande génère les journaux de test suivants :

    • logexport_0.txt
    • logexport_1.txt
    • logexport.txt

    Le dernier journal de test généré possède le même nom que l'entrée -exportlog initiale.

    Remarque : S'il existe plusieurs entrées de paramètre -suite et -exportlog, le nombre d'entrées suite doit correspondre au nombre d'entrées -exportlog. Dans le cas contraire, le message d'erreur suivant apparaît :

    Erreur, le nombre d'entrées dans -suite et -exportlog ne correspond pas.
    -exportstats Facultatif. Cette option vous permet d'exporter des rapports au format CSV (comma-separated values), avec le nom de fichier tiré du nom du rapport. Ce répertoire peut être relatif au projet ou peut être un répertoire de votre système de fichiers. Si l'option -exportstatreportlist n'est pas spécifiée, les rapports exportés sont ceux qui sont indiqués sur la page Exportation de rapports des préférences Rapport de test de performances.
    -timerange Facultatif. Cette option vous permet, avec -exportstats, -exportstatshtml et -execsummary, d'exporter des résultats de test sur une ou plusieurs plages de temps. La valeur correspond à l'intervalle de temps que vous spécifiez dans le planning. Par exemple, "tous, 5 utilisateurs,10 utilisateurs". Vous devez séparer les intervalles de temps par une virgule et utiliser des guillemets lorsqu'un intervalle de temps comporte une espace.
    -exportstatshtml Facultatif. Cette option vous permet d'exporter uniquement les résultats d'analyse Web. Les résultats sont exportés dans le répertoire spécifié. Vous pouvez alors analyser les résultats sur un navigateur Web sans à avoir à utiliser le plan de travail de test.
    -compare Cet argument vous permet, avec -exportstatshtml et -execsummary, d'exporter le résultat en mode comparaison. La valeur peut correspondre à des chemins d'accès aux exécutions qui sont relatifs à l'espace de travail. Vous devez séparer les chemins à l'aide d'une virgule.
    -exportstatreportlist Facultatif. Avec exportstats ou exportstatshtml, cette option vous permet de spécifier une liste d'ID de rapports séparés par une virgule pour répertorier les rapports que vous souhaitez exporter à la place des rapports par défaut, ou les rapports sélectionnés dans Préférences. Pour afficher ce paramètre, accédez à Fenêtre > Préférences > Test > Rapports de test de performances > Exporter les rapports.

    Pour copier la liste d'ID de rapports dans votre ligne de commande, accédez à Fenêtre > Préférences > Test > Rapports de test de performances > Exporter les rapports. DansSélectionner les rapports à exporter, sélectionnez les rapports de votre choix, puis cliquez sur Copier l'ID dans le presse-papiers. Vous pouvez ensuite coller le contenu du presse-papiers dans votre éditeur de ligne de commande.
    -execsummary Facultatif. Cette option vous permet d'exporter, sur l'ordinateur local, tous les rapports de l'exécution du test dans un format imprimable, également appelé récapitulatif exécutif. Vous devez spécifier le chemin de l'emplacement dans lequel le récapitulatif exécutif doit être stocké.
    -execsummaryreport Facultatif. Cette option vous permet d'exporter, sur l'ordinateur local, un rapport spécifique en tant que récapitulatif exécutif pour l'exécution de test. Vous devez spécifier l'ID du rapport à exporter. Par exemple, pour exporter un rapport de performance HTTP, spécifiez http. Vous devez utiliser cette option conjointement avec -execsummary.

    Pour copier la liste d'ID de rapports dans votre ligne de commande, accédez à Fenêtre > Préférences > Test > Rapports de test de performances > Exporter les rapports. Dans Sélectionner les rapports à exporter, sélectionnez les rapports de votre choix, puis cliquez sur Copier l'ID dans le presse-papiers. Vous pouvez ensuite coller le contenu du presse-papiers dans votre éditeur de ligne de commande.
    -usercomments Facultatif. Vous pouvez ajouter du texte entre guillemets doubles pour l'afficher sur la ligne Commentaires de l'utilisateur du rapport.
    Remarque : Le fichier CommandLine.exe vous permet d'exécuter la commande pour ajouter des commentaires dans une langue qui ne prend pas en charge les caractères Unicode sur les systèmes d'exploitation Windows.
    -publishreports Facultatif. Cette option vous permet de publier des résultats de test dans Rational Test Automation Server. Les paramètres que vous pouvez utiliser sont les suivants :
    • FUNCTIONAL
    • MOBILE_WEBUI
    • STATS
    • TESTLOG
    Par exemple, -publishreports "STATS, TESTLOG".

    Ajoutez le préfixe "!" pour publier tous les rapports, sauf celui spécifié.

    Par exemple, -publishreports "! TESTLOG".

    Tous les rapports, sauf le rapport TESTLOG, sont publiés sur Rational Test Automation Server après exécution de la commande.
    -stdout Facultatif. Cette option vous permet d'afficher les informations concernant le test ou le planning dans la ligne de commande.

    Après avoir exécuté un test ou un planning depuis la ligne de commande, les sorties suivantes s'affichent afin de vous donner les informations générales du test ou du planning :

    • --VERDICT : Le verdict du test ou du planning.
    • --REMOTE_RESULT : L'URL du résultat publié sur Rational Test Automation Server.
    • --REMOTE_RESULT_UI : L'URL du résultat publié sur Rational Test Automation Server qui peut s'ouvrir dans un navigateur afin d'analyser le résultat.
    • --LOCAL_RESULT : Le chemin du résultat enregistré localement.

    Par exemple, -workspace workspace_full_path -project proj_rel_path -schedule sched_rel_path -publish publish_url -stdout
    -swapdatasets Facultatif. Cette option vous permet de remplacer des valeurs d'un jeu de données lors de l'exécution d'un test ou d'un planning. Si un test ou un planning est associé à un jeu de données, vous pouvez remplacer le jeu de données lors de l'exécution, tout en démarrant l'exécution depuis la ligne de commande.

    Vous devez vous assurer que le nouveau jeu de données et le jeu de données d'origine se trouvent tous les deux dans le même espace de travail et disposent tous les deux des mêmes noms de colonne. Vous devez aussi inclure le chemin vers le jeu de données lorsque vous exécutez la commande -swapdatasets. Par exemple, -swapdatsets /project_name/ds_path/ds_filename.csv:/project_name/ds_path/new_ds_filename.csv

    Vous pouvez échanger plusieurs jeux de données qui sont enregistrés dans un projet différent en ajoutant plusieurs chemins de jeux de données, séparés par un point-virgule. Par exemple, -swapdatsets /project_name1/ds_path/ds_filename.csv:/project_name1/ds_path/new_ds_filename.csv;/project_name2/ds_path/ds_filename.csv:/project_name2/ds_path/new_ds_filename.csv
    Pour arrêter l'exécution du test, vous pouvez ouvrir une autre fenêtre d'invite de commande et utiliser l'une des options suivantes avec l'option cmdline :
    Commande Description
    -stoprun Facultatif. Arrête l'exécution du test après le nombre de secondes indiqué. Le bloc est exécuté et le journal de test est transféré avant l'arrêt de l'exécution. Vous devez utiliser la commande -workspace et spécifier l'emplacement de l'espace de travail.
    -abandonrun Facultatif. Arrête immédiatement l'exécution du test. Vous devez utiliser la commande -workspace et spécifier l'emplacement de l'espace de travail.
    Remarque : Des messages indiquant à quel moment le test est lancé et terminé s'affichent, sauf si vous précisez l'option –quiet.

Exemple

cmdline -workspace C:/RPTWorkspace -project testProj -eclipsehome C:\Program Files\HCL\HCLOneTest\eclipse.exe -schedule MySchedule -varfile C:/Assets/testProjVar.xml

Rubrique parent : Variables de test
Tâches associées:
Déclaration et affectation des variables de test
Initialisation de variables à partir de Rational Quality Manager