Ausführungsvariablen

Wenn Sie in Ihren Testscripts während eines Testlaufs bestimmte Werte verwenden möchten, definieren Sie Ausführungsvariablen in Testscripts oder Schlüsselwörtern. Sie können Ausführungsvariablen auch von einer Testsuite oder einem Testfall an zugehörige Testscripts oder Schlüsselwörter übergeben. Wenn Sie ein Administrator oder ein Testleiter sind, können Sie Ausführungsvariablen auf Projektebene festlegen.

Sie können Ausführungsvariablen bei allen manuellen Scripts, Befehlszeilenscripts und JUnit Selenium-Scripts verwenden. Wenn Sie einen Adapter verwenden, der Ausführungsvariablen unterstützt, können Sie sie bei automatisierten Testscripts verwenden. Lesen Sie die Dokumentation zum jeweiligen Adapter, um festzustellen, ob ein Adapter Ausführungsvariablen unterstützt.

Ausführungsvariablen auf Artefakt- und Projektebene

Ausführungsvariablen können auf der Projekt- oder der Artefaktebene definiert werden. Wenn Sie ein Projektadministrator sind und über die Berechtigung verfügen, Projektausführungsvariablen zu speichern, können Sie Projektausführungsvariablen definieren. Projektausführungsvariablen verfügen über für die Verwendung in Testartefakten definierte Gruppen von Werten. Testersteller können Artefaktausführungsvariablen im Kontext von Testsuites, Testfällen und Testscripts definieren. Diese Testartefaktausführungsvariablen können jeden beliebigen Wert annehmen.
  • Sollen Werte durchgängig in einer Testsuite oder einem Testfall verwendet werden, definieren Sie die Artefaktausführungsvariablen im Abschnitt "Ausführungsvariablen" des betreffenden Testfalls bzw. der betreffenden Testsuite.
  • Wenn eine Ausführungsvariable in einem manuellen Testscript oder in einem Schlüsselwort verwendet werden soll, definieren Sie die Variable im Abschnitt "Ausführungsvariablen" des Editors für manuelle Tests. Nachdem Sie eine Variable definiert haben, können Sie Verweise darauf in einen Schritt eines manuelles Testscripts oder in einen Schlüsselwortschritt einfügen. Während der Testausführung ersetzt der aktuelle Wert der Ausführungsvariablen den Verweis im Schritt.
  • Zum Festlegen des Wertes einer bestimmten Ausführungsvariable können Sie Ausführungvariablenschritte in einen manuellen Test oder in ein Schlüsselwort einfügen. Sie können Ausführungsvariablenschritte vom Fenster "Ausführungsvariablen" aus erstellen und einfügen. Während des Testlaufs werden Sie aufgefordert, der Ausführungsvariablen einen Wert zuzuordnen. Nachdem Sie den Wert festgelegt haben, weisen alle Verweise auf die betreffende Ausführungsvariable den von Ihnen bereitgestellten Wert auf.
Auf Artefaktebene gilt: Wenn Werte für dieselbe Variable an mehreren Stellen definiert werden, überschreiben die Variablenwerte der höheren Ebene die Werte der unteren Ebene. Beispiel: Eine Variable wird in einer Testsuite und in einem Testfall innerhalb der Testsuite definiert. Der in der Testsuite definierte Variablenwert überschreibt den ursprünglichen Variablenwert, der im Testfall definiert ist. Ein anderes Beispiel: Eine Variable wird in einem Testfall und in einem Testscript innerhalb des Testfalls definiert. Der im Testfall definierte Variablenwert überschreibt den ursprünglichen Variablenwert, der im Testscript definiert ist.
  • Die Werte von Testsuiteausführungsvariablen überschreiben die Werte von Ausführungsvariablen in Testfällen, Testscripts und Schlüsselwörtern
  • Die Werte von Testfallausführungsvariablen überschreiben die Werte von Ausführungsvariablen in Testscripts und Schlüsselwörtern
  • Die Werte von Testscriptausführungsvariablen überschreiben die Werte von Ausführungsvariablen in Schlüsselwörtern

Ein Artefakt kann sowohl Projekt- als auch Artefaktausführungsvariablen umfassen. Wenn allerdings zwei oder mehr dieser Variablen den gleichen Namen haben, kommt es zu einem Konflikt, wodurch ein Speichern des Artefakts verhindert wird. Sie können den Namen einer Ausführungsvariablen auf Projektebene so ändern, dass er mit dem Namen einer Ausführungsvariablen auf Artefaktebene übereinstimmt. In diesem Fall überschreibt der Wert der Variablen auf Artefaktebene bei Ausführung des Tests den Wert der Variablen auf Projektebene.

Ausführungsvariablen bei sequenzieller Ausführung von Testsuites

Bei der sequenziellen Ausführung von Testsuites können Sie Ausführungsvariablen von einem Testscript an das nächste weitergeben. Beispiel: Im ersten Schritt einer Testsuite wird ein Testscript ausgeführt, das einen Benutzer erstellt und eine Ausführungsvariable mit dem Namen userID festlegt. In nachfolgenden Schritten der Testsuite werden Testscripts ausgeführt, die auf den Wert der Ausführungsvariablen userID verweisen, Benutzerdaten aktualisieren und überprüfen, ob die Benutzerdaten stimmen. Dieses Verhalten können Sie im Abschnitt "Testfall" einer Testsuite oder im Fenster Testsuite ausführen aktivieren.

Ausführungsvariablen in Befehlszeilenscripts

Wenn Sie einen Befehlszeilentest ausführen, der Ausführungsvariablen enthält, werden die Werte der Ausführungsvariablen als Umgebungsvariablen für den Prozess bereitgestellt, der den Befehlszeilentest ausführt. Die Namen dieser Umgebungsvariablen beginnen mit "RQM_", damit sie von anderen Umgebungsvariablen unterschieden werden können.

Wenn eine Testsuite beispielsweise eine Ausführungsvariable mit Namen myVar enthält, wird eine Umgebungsvariable mit dem Namen RQM_myVar erstellt.
Hinweis: Ausführungsvariablennamen sollten nur gültige Java-IDs enthalten: A-Z, a-z, 0-9, _ und $. Wenn eine Ausführungsvariable eine ID enthält, die in Java nicht verwendet wird, wird diese ID im neuen Umgebungsvariablennamen durch einen Unterstrich (_) ersetzt. Bei einer Ausführungsvariablen mit dem Namen user.Name lautet der Name der resultierenden Umgebungsvariablen beispielsweise RQM_user_Name.
Zusätzlich wird eine Umgebungsvariable mit dem Namen RQM_ExecutionVariablesFile erstellt, deren Wert ein absoluter Pfadname zu einer Textdatei ist. Beispiel: RQM_ExecutionVariablesFile=C:\Users\tneal.DEV\AppData\Local\Temp\QMAdapter1220694107401772431.vars. Diese Datei enthält für jede Ausführungsvariable, die bei Ausführung des Befehlszeilen-Scripts definiert ist, ein Name-Wert-Paar. Beispiel:

# Ausführungsvariablen
# Wed Mar 02 15:48:54 EST 2011
testcase2Var=set statically in testcase2
testcase1Var=set statically in testcase1
testsuite1Var=set statically in testsuite1

Wenn der Befehlszeilentest abgeschlossen ist, wird die Textdatei gelesen. Wenn die Testsuite das Übergeben von Ausführungsvariablen zulässt, wird der Inhalt dazu verwendet, die Werte von Ausführungsvariablen an das nächste Testscript zu übergeben. Sie können die Textdatei modifizieren, um Ausführungsvariablen zu erstellen oder den Wert von Ausführungsvariablen zu ändern, die an andere Testscripts übergeben werden.

Integrierte Ausführungsvariablen

In bestimmten Fällen muss Ihr Test möglicherweise weitere Informationen zur Testausführungsumgebung abrufen, in der er ausgeführt wird. Der Test könnte beispielsweise den Namen der Testsuite oder den Testfall, der gerade ausgeführt wird, benötigen. Integrierte Ausführungsvariablen stellen Informationen zur Umgebung bereit. Zum Aktivieren von integrierten Variablen wählen Sie das Kontrollkästchen Integrierte Variablen einbeziehen im Abschnitt "Ausführungsvariablen" des Testscripteditors aus.

Bei Auswahl dieses Kontrollkästchens werden die folgenden zusätzlichen Ausführungsvariablen erstellt:
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


Haben Sie ein Problem oder eine Frage? Veröffentlichen Sie sie im Jazz.net Forum.