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.
Install the sample solution:
Unzip to any folder on your computer.
Start Ranorex Studio and open the solution file
The sample solution is available for Ranorex versions 8.0 or higher. You must to agree to the automatic solution upgrade for versions 8.2 and higher.
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.:
Test suite files are XML files and can be opened in any XML viewer or editor.
In the User Guide, we’ll use the term “test suite” for both test suite itself and the .rxtst file. We’ll point it out when we only mean one or the other.
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.
In the Studio toolbar, click the Add test suite button.
If your solution contains multiple projects, select the desired project and click OK.
In the next dialog, give the test suite a name and
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.
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.
The RUN button. Click this button to run the test suite in the selected run configuration.
The run configuration selector. This is where you can select and manage run configurations (see below).
The maintenance mode switch. Enables or disables the maintenance mode (see below).
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.
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.
The search box. Use the search box to locate items in the test suite.
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 column. Displays 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.