The test suite is where you build, organize, and run your tests in Ranorex Studio. It primarily consists of test cases built from modules. You can add smart folders to structure your tests.
The test suite is also where you configure variables and data binding for data-driven testing. You can test suites in Ranorex Studio or the stand-alone Ranorex Test Suite Runner.
Reference: The screencast Introduction to the Ranorex Studio test suite walks you through information found in this chapter.
The explanations in the test suite chapter are based on a sample solution. You can download it below.
Sample solution
- Unzip to any folder on your computer
- Start Ranorex Studio and open the solution file RxDatabase.rxsln
Hint: The sample solution is available for Ranorex versions 8.0 or higher. You must accept 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; 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.
Note: In the User Guide, let's use the term “test suite” for both the test suite itself and the .rxtst file. We’ll point it out when we only mean one or the other.
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.
-
Click Create.
Reference: Multiple test suites are explained in 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.
-
ADD: 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.
-
RUN: Click this button to run the test suite in the selected run configuration.
-
Run configuration selector: Here, you can select and manage run configurations. Review Execute a test suite article.
-
Maintenance mode switch: Enables or disables the maintenance mode. For more information on this option, review Maintenance mode.
-
MANAGE DATA SOURCES…: Add and manage test data sources. Ranorex Studio supports using a simple data table, and connectors to CSV, Excel, or SQL data files.
-
Test suite toolbar, which includes, the cut/copy/paste/delete and undo/redo buttons and the Data source… button brings up the data source dialog for a test case or smart folder.
-
Search: 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. Review Data-driven testing for more information.
- The Description column: Enter an optional description for an item here, such as what aspect of the AUT a test case covers.