Pour utiliser des valeurs spécifiques dans vos scripts de test pendant une exécution de test, définissez des variables d'exécution dans des scripts de test ou des mots clés. Vous pouvez aussi transmettre des variables d'exécution depuis une suite de tests ou un scénario de test à des scripts de test ou des mots clés associés. Si vous êtes un administrateur ou un responsable de test, vous pouvez définir des variables d'exécution au niveau du projet.
Vous pouvez utiliser des variables d'exécution avec tous les scripts manuels, scripts de ligne de commande et scripts JUnit Selenium. Si vous utilisez un adaptateur qui prend en charge les variables d'exécution, vous pouvez les utiliser dans des scripts de test automatisés.
Pour déterminer si un adaptateur prend en charge les variables d'exécution, consultez sa documentation.
Variables d'exécution au niveau du projet et au niveau de l'artefact
Les variables d'exécution peuvent être définies au niveau du projet ou au niveau de l'artefact. Si vous êtes un administrateur de projet et que vous disposez des droits permettant de sauvegarder des variables d'exécution de projet, vous pouvez définir des variables d'exécution de projet. Les variables d'exécution de projet possèdent des ensembles de valeurs qui sont définies pour une utilisation dans des artefacts de test.
Les auteurs de test peuvent définir des variables d'exécution d'artefact dans le contexte des suites de tests, des scénarios de test et des scripts de test. Ces variables d'exécution d'artefact de test peuvent prendre n'importe quelle valeur.
- Pour utiliser des valeurs qui sont présentes tout au long d'une suite de tests ou d'un scénario de test, définissez des variables d'exécution d'artefact dans la section Variables d'exécution de ce scénario de test ou de cette suite de tests.
- Pour utiliser une variable d'exécution dans un script de test manuel ou mot clé, définissez la variable dans la section Variables d'exécution de l'éditeur de test manuel. Une fois la variable définie, vous pouvez insérer des références à cette variable dans une étape de script de test manuel ou de mot clé. Pendant une exécution de test, la valeur en cours de la variable d'exécution remplace la référence dans l'étape.
- Pour définir la valeur d'une variable d'exécution particulière, vous pouvez insérer des étapes de variable d'exécution dans un test manuel ou un mot clé. Vous pouvez créer et insérer une étape de variable d'exécution à partir de la fenêtre Variables d'exécution. Au cours d'une exécution de test, vous êtes invité à affecter une valeur à la variable d'exécution. Une fois que vous avez défini cette valeur, toutes les références à cette variable d'exécution reçoivent la valeur que vous avez fournie.
Au niveau de l'artefact, si des valeurs pour la même variable sont définies à plusieurs endroits, les valeurs de la variable au niveau le plus haut remplace les valeurs de la variable au niveau le plus bas. Par exemple, une variable est définie dans une suite de tests et dans un scénario de test qui se trouve dans la suite de tests. La valeur de la variable qui est définie dans la suite de tests remplace la valeur initiale de la variable définie dans le scénario de test. Dans un autre exemple, une variable est définie dans un scénario de test et dans un script de test qui se trouve dans le scénario de test. La valeur de la variable qui est définie dans le scénario de test remplace la valeur initiale de la variable qui est définie dans le script de test.
- Les valeurs des variables d'exécution de suite de tests remplacent les valeurs des variables d'exécution de scénario de test, de script de test et de mot clé.
- Les valeurs des variables d'exécution de scénario de test remplacent les valeurs des variables d'exécution de script de test et de mot clé.
- Les valeurs des variables d'exécution de script de test remplacent les valeurs des variables d'exécution de mot clé.
Un artefact peut incorporer des variables d'exécution de projet ainsi que des variables d'exécution d'artefact. Toutefois, si plusieurs de ces variables ont le même nom, un conflit survient, qui empêche la sauvegarde de l'artefact. Vous pouvez changer le nom d'une variable d'exécution au niveau du projet pour qu'il corresponde au nom d'une variable d'exécution au niveau de l'artefact. Dans ce cas, la valeur de la variable au niveau de l'artefact remplace la valeur de la variable au niveau du projet lorsque le test est exécuté.
Variables d'exécution dans des exécutions de suites de tests séquentielles
Si vous exécutez des suites de tests séquentielles, vous pouvez transmettre des variables d'exécution d'un script de test à l'autre. Par exemple, la première étape dans une suite de tests exécute un script de test qui crée un utilisateur et définit une variable d'exécution appelée userID. Les étapes suivantes dans la suite de tests exécutent des scripts de test qui référencent la valeur de la variable d'exécution userID, mettent à jour les informations de l'utilisateur et vérifient que les informations de l'utilisateur sont correctes. Vous pouvez activer ce comportement dans la section Scénario de test d'une suite de tests ou dans la fenêtre Exécuter une suite de tests.
Variables d'exécution dans les scripts de ligne de commande
Lorsque vous exécutez un test par ligne de commande qui inclut des variables d'exécution, les valeurs des variables d'exécution sont fournies sous forme de variables d'environnement au processus qui exécute le test par ligne de commande. Les noms de ces variables d'environnement commencent par "RQM_", pour les distinguer des autres variables d'environnement.
Par exemple, si une suite de tests contient une variable d'exécution appelée
myVar, une variable d'environnement appelée
RQM_myVar est créée.
A faire : Dans l'idéal, les noms de variable d'exécution n'incluent que des identificateurs Java valides : A à Z,
a à z, 0 à 9, _ et $. Si une variable d'exécution contient un identificateur qui n'est pas dans Java, un trait de soulignement (_) le remplace dans le nouveau nom de variable d'environnement. Par exemple, si une variable d'exécution s'appelle user.Name, la variable d'environnement résultante est RQM_user_Name.
De plus, une variable d'environnement qui s'appelle
RQM_ExecutionVariablesFile est créée et sa valeur est un nom de chemin d'accès absolu à un fichier texte, par exemple
RQM_ExecutionVariablesFile=C:\Users\tneal.DEV\AppData\Local\Temp\QMAdapter1220694107401772431.vars.
Ce fichier contient des paires nom-valeur : une pour chaque variable d'exécution qui est définie lorsque le script de ligne de commande s'exécute. Exemple :
#Execution Variables
#Wed Mar 02 15:48:54 EST 2011
testcase2Var=set statically in testcase2
testcase1Var=set statically in testcase1
testsuite1Var=set statically in testsuite1
Lorsque le test de ligne de commande est terminé, le fichier texte est lu. Si la suite de tests permet la transmission de variables d'exécution, le contenu est utilisé pour transmettre les valeurs des variables d'exécution au script de test suivant.
Vous pouvez modifier le fichier texte pour créer des variables d'exécution ou pour changer la valeur des variables d'exécution qui sont transmises à d'autres scripts de test.
Variables d'exécution intégrées
Dans certains cas, votre test peut avoir besoin d'extraire des informations supplémentaires sur l'environnement d'exécution de test dans lequel il s'exécute. Par exemple, il peut avoir besoin de connaître le nom de la suite de tests ou du scénario de test en cours d'exécution. Les variables d'exécution intégrées fournissent des informations d'environnement.
Pour activer les variables intégrées, cochez la case Inclure les variables intégrées dans la section Variables d'exécution de l'éditeur de script de test.
Lorsque cette case à cocher est sélectionnée, les variables d'exécution supplémentaires suivantes sont créées :
RQM_TESTSCRIPT_NAME
RQM_TESTSCRIPT_WEBID
RQM_TESTCASE_NAME
RQM_TESTCASE_WEBID
RQM_TESTCASE_RESULT_WEBID
RQM_TESTCASE_RESULT_NAME
RQM_TESTSUITE_NAME
RQM_TESTSUITE_WEBID
RQM_TESTSUITE_RESULT_WEBID
RQM_TESTSUITE_RESULT_NAME
RQM_TESTPLAN_NAME
RQM_TESTPLAN_WEBID
RQM_TESTPHASE_NAME
RQM_TESTPHASE_WEBID
RQM_TESTCASE_EXECUTIONRECORD_NAME
RQM_TESTCASE_EXECUTIONRECORD_WEBID
RQM_SUITEEXECUTIONRECORD_NAME
RQM_SUITEEXECUTIONRECORD_WEBID
RQM_PROJECT_NAME
RQM_PROJECT_ALIAS
RQM_BUILDRECORD_NAME
RQM_BUILDRECORD_WEBID
RQM_BUILDDEFINITION_NAME
RQM_BUILDDEFINITION_WEBID
RQM_CONFIGURATION_NAME
RQM_CONFIGURATION_CPU
RQM_CONFIGURATION_BROWSER
RQM_CONFIGURATION_ADAPTER
RQM_CONFIGURATION_DATABASE
RQM_CONFIGURATION_APPLICATIONSERVER
RQM_CONFIGURATION_MANAGEMENTAGENT
RQM_CONFIGURATION_OS
RQM_CREATEDBY_USERID
RQM_CREATEDBY_NAME
RQM_LABRESOURCE_NAME
RQM_LABRESOURCE_WEBID