Keyword Test Variables

About

Create keyword test variables

Data types of keyword test variables

Set variable values

Use variables to specify operation parameters

Work with keyword test variables in scripts

Use variables to output data from test

Keyword test variables are like variables that you use in script functions. They store various values during the test execution and pass data from one operation to another. Variables can also be used to store the result of the keyword test.

To assign values to variables in keyword tests, you use the Set Variable Value operation. After you assigned the value, you can then use the variable to specify values of operation parameters. You can also obtain and set values of keyword test variables from scripts.

The keyword test variables are accessible from any operation of the test, to which they belong. They are accessible from scripts, but they are not accessible from other keyword tests.

Unlike project and project suite variables, keyword test variables do not store values between test runs. They are only used during the current test run (like variables in script code).

A keyword test variable can store values of the following types:

• String - Use this type for variables that will store characters and strings (including multi-line text).

• Integer - Use this type for variables that will store integer values.

• Double - Use this type for variables that will store floating-point values and dates.

• Boolean - Use this type for variables that will store True or False.

• Password - Use this type for variables that will store encrypted strings (passwords or other sensitive data).

• Object - Use this type for variables that will store object references (for instance, references to the process or window objects).

• Table - Use this type for variables that will store a two-dimensional array of values. You can see the contents of such variables on the Test Steps page of the Keyword Test editor.

• DB Table - Use this type for variables that will store tabular data from an external storage (a file or a database).

TestComplete checks the variable type when values are assigned to the variables. See the next section for details.

You can assign values to keyword test variables before the test run or during it.

• Assign values before the test run

  To assign a value before the test run, specify the desired data in the Default Value column of the Variables page. TestComplete will assign this value to the variable when it starts executing the test to which this variable belongs.

• Assign values during the test run

  To assign a value to a keyword test variable during the test execution, you can use any of the following:

  • Use the Set Variable Value operation (it belongs to the Test Actions category). In the Operation Parameters dialog you specify the name of the desired variable and its value. For detailed information, see Specifying Operation Parameters.

  • Call a script code that will change the variable. To access the variable from a script, you use the Variables property of the KeywordTest object that provides a scripting interface to your test. For detailed information about this, see the Working With Keyword Test Variables From Scripts section below.

    To call a script from your keyword test, you can use the Run Script Routine, Run Code Snippet or Run Test operations.

    Note:

    In VBScript projects, the Run Code Snippet operation treats the equals sign (=) as a comparison operator by default. To treat it as an assignment operator, put the assignment code into the Execute statement: VBScript VBScript Execute("KeywordTests.Test1.Variables.Var1 = 10")

  The script code variant lets you use all of the scripting languages features to check additional conditions and calculate the needed value. However, by using this operation you can also assign those values that cannot be assigned from scripts: values of test parameters and the result of the previous operation. The latter is useful if you need to check the result or store it for further processing (see Checking Operation Result).

When you assign a value to the variable (with script code or with the operation), TestComplete checks whether this value has the same type as the variable. If not, TestComplete attempts to typecast the value to the variable’s type. If this attempt fails, an error occurs.

A typical example that illustrates this statement is assignment of string values to integer variables. Suppose, you have a variable of the integer type. If you assign the string "77" to it, the variable will hold the number 77 (the string "77" can be easily converted to the numerical value 77). However, if you attempt to assign the string "qwerty", the assignment will fail and an error will occur.

Note: When converting string values to the numerical format, TestComplete implies that the string contains the numbers in decimal format. Hexadecimal, octal and binary formats are not supported.

1. Open the desired operation for editing.

2. Select the desired parameter in the Operation Parameters dialog.

3. Select Variable in the Mode column of the dialog.

4. Select the variable name in the Value column.

5. Press Enter to confirm the change.

Now, when executing the operation, TestComplete will pass the value of the specified variable to the parameter.

To access keyword test variables from scripts, use the Variables property of the KeywordTest scripting object that corresponds to your test. This property provides a scripting interface to the test’s variable. To address a variable, you can use the following syntax:

The following code snippet demonstrates how you can get and set the variable MsgVar of the test named KeywordTest1:

# Get the variable value 
s = KeywordTests.KeywordTest1.Variables.MsgVar
# -- or --
s = KeywordTests.KeywordTest1.Variables.VariableByName["MsgVar"]
  
# Set the variable value
KeywordTests.KeywordTest1.Variables.MsgVar = "New Value"
# -- or --
KeywordTests.KeywordTest1.Variables.VariableByName["MsgVar"] = "New Value"

A keyword test can be a part of a larger test. The keyword test variables are not deleted when the keyword test is over, they exist until the larger test is finished. This feature lets you use keyword test variables to pass data out of the test. For instance, you can check the test result. To do this, in your test you assign the output value to a keyword test variable and write script code that will be executed after the test and that will retrieve and check the variable value. For detailed information about this, see Setting and Checking a Keyword Test Result.