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
The explanations in the test suite chapter are based on a sample solution. You can download it below.
Theme: Test suite
Time: Less than 10min
Unzip to any folder on your computer.
Start Ranorex Studio and open the solution 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.
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
Multiple test suites are explained in: Ranorex Studio fundamentals > Test suite > ⇢ Manage multiple test suites
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 search box. Use the search box to locate items in the test suite.
The test suite workspace, which includes:.
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.