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

    tipp icon

    Screencast

    The screencast “introduction to the Ranorex Studio test suite” walks you through information found in this chapter.

    Watch the screencast now

    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

    Download sample solution

    Install the sample solution:

    Unzip to any folder on your computer.
    Start Ranorex Studio and open the solution file RxDatabase.rxsln

    tipp icon

    Hint

    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.:

    %USERPROFILE%RanorexRanorexStudio ProjectsRxDatabaseRxDatabase.rxtst

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

    Note icon

    Note

    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

    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.

    Adding a test suite

    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

    Click Create.

    Reference

    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.

    Explanation of test suite view

    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.

    Reference

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

    Reference

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

    Reference

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