The test suite is where you build, organize, and run your tests in Ranorex Studio. It primarily contains test cases, which are built from modules. To keep larger projects tidy, you can use smart folders to structure and group related tests.
The test suite is also where you configure variables and data binding for data-driven testing. You can run test suites either directly in Ranorex Studio or with the stand-alone Ranorex Test Suite Runner. For details about running tests (including run configurations and the Test Suite Runner), see Execute a test suite.
Reference: The screencast Introduction to the Ranorex Studio test suite walks you through the concepts found in this article.
Further Reading: How to Organize Your Ranorex Solution: Projects, Test Suites, and Data Structure.
The explanations in the test suite chapter are based on a sample solution. Download it from the link in this article, then install it as described below.
Sample solution
Theme: Test suite
Time: Less than 10min
Installation
- Unzip to any folder on your computer
- Start Ranorex Studio and open the solution file
RxDatabase.rxsln
Hint: When you open the sample solution in a newer version of Ranorex Studio, you may be prompted to upgrade it. Accept the upgrade to continue.
The test suite file
Each test suite is stored in a file with the extension .rxtst (Ranorex test suite).
Test suite files are always part of a project. You can find them in the Projects view. A project can contain multiple test suite files.
On disk, test suite files are stored in the corresponding project folder. For example:%USERPROFILE%\Ranorex\RanorexStudio Projects\RxDatabase\RxDatabase.rxtst
Test suite files are XML files and can be opened in any XML viewer or editor.
Note: In the User Guide, the term Test suite is used 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 include a test suite by default, or you may want to add multiple test suites to a project.
- In Ranorex Studio toolbar, click the Add test suite icon.
- If your solution contains multiple projects, select the project and click OK.
- Enter a name for the new test suite and click Create.
Reference: For details about working with multiple test suites (including running them in sequence), see Manage multiple test suites.
The test suite view
To open a test suite, double-click the test suite file (.rxtst). The test suite view appears. This is where you work with the structure of your test and the items inside it.
-
ADD: Use ADD to insert items into the test suite (for example, a test case or a smart folder). You can also add items by right-clicking inside the test suite hierarchy.
Note: Items are disabled in the drop-down list if they can’t be added at the currently selected hierarchy level. - RUN: Use RUN to run the test suite in the currently selected run configuration.
- Run configuration selector: Use the run configuration drop-down to select and manage run configurations. Review Execute a test suite article.
- Maintenance mode: Turns maintenance mode on or off. For more information on this option, review Maintenance mode.
- MANAGE DATA SOURCES…: Use Manage data sources to add and manage test data sources. Ranorex Studio supports a simple data table and connectors to CSV, Excel, or SQL data sources.
- Test suite toolbar and Data source...: The test suite toolbar includes standard actions such as cut/copy/paste/delete and undo/redo. Use Data source to open the data source dialog for the currently selected test case or smart folder.
- Search: Use Search 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.