Welcome to the Ranorex Support Portal

Test suite

The test suite is where you build, organize, and run your tests in Ranorex Studio. A test suite consists primarily of test cases, which are in turn built from modules. You can add smart folders to structure your test. The test suite is also where you configure variables and data binding for ⇢ data-driven testing. You can run test suites in Ranorex Studio or the stand-alone Ranorex Test Suite Runner.

In this chapter

Download the sample solution

The explanations in the test suite chapter are based on a sample solution. You can download it below.


Sample solution

Theme: Test suite

Time: Less than 10min

Install the sample solution:

  1. Unzip to any folder on your computer.

  2. Start Ranorex Studio and open the solution file RxDatabase.rxsln

The test suite file

Each test suite is contained in a special file with the extension .rxtst (for Ranorex test suite). Test suite files are always part of a project, and you can find them in the projects view. A project may contain multiple test suite files. On your hard drive, test suite files are stored in the corresponding project’s folder, e.g.:

%USERPROFILE%RanorexRanorexStudio ProjectsRxDatabaseRxDatabase.rxtst

Test suite files are XML files and can be opened in any XML viewer or editor.

Test suite file in the projects view

Add a test suite

Some projects don’t contain a test suite by default, or you may want to add multiple test suites to your project. Follow the instructions below to do so.

  1. In the Studio toolbar, click the Add test suite button.

  2. If your solution contains multiple projects, select the desired project and click OK.

  3. In the next dialog, give the test suite a name and

  4. Click Create.



Multiple test suites are explained in: Ranorex Studio fundamentals > Test suite > ⇢ Manage multiple test suites

The test suite view

To open the test suite, double click the test suite file. The test suite view appears. This is where you work on your test suite.

  1. The ADD button. Click this to display a drop-down list of items to add to the test suite, such as a test case or smart folder. You can also add items by right-clicking within the test suite hierarchy. Items are greyed out in the drop-down list if they cannot be added at the current level of the test suite hierarchy.

  2. The RUN button. Click this button to run the test suite in the selected run configuration.

  3. The run configuration selector. This is where you can select and manage run configurations (see below).

  4. The maintenance mode switch. Enables or disables the maintenance mode (see below).

  5. The MANAGE DATA SOURCES… button. Add and manage test data sources. Ranorex Studio supports using a simple data table, as well as connectors to CSV, Excel, or SQL data files.

  6. The test suite toolbar, which includes:

  • The cut/copy/paste/delete and undo/redo buttons.
  • The Data source… button brings up the data source dialog for a test case or smart folder.
  1. The search box. Use the search box to locate items in the test suite.

  2. The test suite workspace, which includes:.

  • The Item column. Displays the test suite and the items it contains. Build your test here.
  • The Data binding/ iterations columnDisplays data bindings and iterations that apply to the respective item (see below).
  • The Description column. Enter an optional description for an item here, such as what aspect of the AUT a test case covers.


Running test suites, run configurations and iterations are explained in Ranorex Studio fundamentals > Test suite > ⇢ Execute a test suite.



Data binding and data sources are advanced topics explained in Ranorex Studio advanced > ⇢ Data-driven testing.



Maintenance mode is an advanced topic that’s explained in Ranorex Studio advanced > ⇢ Maintenance mode.



Get the latest test automation information right in your mailbox.


© 2024 Ranorex GmbH. All Rights Reserved