Configure test variables

To enhance the effectiveness, flexibility, and maintainability of your tests, you can use test variables. Variables allow you to store and reuse values across multiple test cases or test steps. They also make it easy to change input data or expected values without modifying the entire test. This is helpful when you need to run the same test with different inputs or adapt tests to changing application features or test senarios.

As your test suite grows, variables also help you maintain consistency, which is important for scalability.

Each test variable consists of the following attributes:

  • Name: Any string that contains letters, numbers, and the underscore character '_' . It cannot begin with a number.

  • Type: Test variable types are: Boolean, DataTable, Device, Number, Media, Secured String, and String.

  • Value: Depends on the selected variable type. For example, if Type = Device, the value will be set using the Select Device dialog box and if Type = Media, the value is selected from the repository or the local computer.

By default, a DUT (Device Under Test) variable is available for every test. A DUT variable is essential to execute a test. By default, the DUT variable selects the opened device as its value. You can select a device as a value for the variable.

  • On the top toolbar, click the Configure test variables icon .

  1. In the Configure test variables dialog box, click Add New Variable.
  2. Select the type of variable.
  3. Enter the name of the variable.
  4. Enter a value for the variable.

  5. Click APPLY.

  1. In the Configure test variables dialog box, click Add New Variable.

  2. Select the type of variable as Secured string.

  3. Enter the name of the variable.

  4. Enter a value for the variable.

  5. (Optional) Click the encryption icon .

  6. (Optional) To copy the encrypted value to clipboard, click .

  1. In the Configure test variables dialog box, click Add New Variable.

  2. Select the type of variable as Media.

  3. Change the name of the variable.

  4. In the Value column, click the Select media link.

  5. In the dialog box that opens, select the location of your app file: Repository (default) or Computer.

  6. Depending on your selection in step 5, do the following:

    • Repository: Search for and select the repository file you want to use and then click SELECT.

      Tip: You can search by tag name, if applicable. If a file is associated with tags, a tag symbol appears below the file name, along with the number of tags associated with the file. To view the tag names, move the pointer over the tag icon .

    • Computer:

      1. Click ADD MEDIA FILE.

      2. Browse to the file you want to use.

      3. Select the file and click Open.

      4. Click SELECT.

  7. Click APPLY.

Important: Make sure that the DataTable you want to use here already exists. To create a DataTable, see Create a new DataTable.

  1. In the Configure test variables dialog box, click Add New Variable.

  2. Select the type of variable as DataTable.

  3. Change the name of the variable.

  4. In the Value column, click the Select DataTable link.

  5. In the dialog box that opens, expand the folders and select the desired DataTable.

  6. Click LOAD.

  7. Click APPLY.

  1. In the Configure test variables dialog box, select the desired Type of variable.

  2. In the Replace variable type dialog box, click YES to confirm your change.

  3. Change the name and/or value of the variable.

  4. Click APPLY.