You can add multiple test suites per project and run them in sequence. This is especially useful when collaborating with others.
Create a new test suite
To add a test suite to an existing project, follow the instructions below:
- In the Studio toolbar, click the Add test suite.
- Enter a name for the test suite.
- Click Create.
Result
The new test suite appears in the project view. Usually, it also opens automatically in the test suite view.
- The initial test suite in the projects view.
- The newly added test suite in the projects view.
- The test suite tabs below the Ranorex Studio toolbar.
The new test suite file also appears in the Ranorex Studio Projects folder of your test solution.
Cut, copy, paste, delete, move multiple test suites
To ensure the integrity of your project, you cannot cut, copy, or paste an entire test suite.
However, you can delete and rename test suites. Select a test suite in the project view and open the context menu to use the delete and rename options:
- Cut, Copy, Paste: An entire test suite cannot be cut, copied, or pasted. Similarly, you cannot move an entire test suite to another project.
- Delete, Rename: These option are available for test suites.
Set the test sequence
When a project contains at least two test suites, you can specify a sequence for the test suites.
Open the test sequence configuration dialog
- Startup project selection: If you have multiple projects with multiple test suites.
- Select the project to configure here. By default, the current test project is pre-selected.
- Use the order buttons on the left to change the position of the test suites in the test sequence.
- Use the ON/OFF buttons to exclude selected test suites from the test run.
- Click Run to start the specified test sequence.
Manage the test sequence file and parameters
This section explains where Ranorex stores the sequence and how you can add run parameters.
Test sequence file
When a project contains at least two test suites, Ranorex creates a test sequence configuration file automatically and adds it to the project folder.
- Test sequence file in the project view
- Test sequence file in the project folder
Test sequence file content and syntax
The .rxsqc file uses JSON syntax. Each test suite has its own configuration object, and all test suites are listed in an array.
Key syntax basics
- Text content of the test sequence file:
-
[]enclose the test sequence file -
{}enclose all configurations for one test suite - Multiple test suites are separated by a
,(JSON formatting syntax) - Configuration arguments follow the syntax
"":"" - Multiple parameters are separated by a
,
Adding command line arguments
You can add command-line arguments to a test suite entry in the .rxsqc file so they are applied during the test run.
- Example command line argument
/testcase
- Command line arguments follow the previously introduced JSON syntax definition
- Two or more arguments must be separated by a ‘
,‘ - The example above calls the
/testcasecommand line argument with a test case namedInsertNameas parameter value
Multiple test suites: Feature list
This section describes the main features of multiple test suites within Ranorex Studio. It lists what can and can’t be done using multiple test suites.
Transferring test suite contents
You can copy or move contents from one test suite to another (within the same project or across projects). This includes test cases, smart folders, setup/teardown regions, modules, module groups, and other test suite items.
Data integrity
Variables and data binding can remain intact when transferring test content, but it depends on what you move.
TestRail integration
TestRail can also export/synchronize multiple test suites per project. The TestRail integration with Ranorex is described in TestRail integration.
Ranorex Remote
Test sequences can also be run on Ranorex Agents from the remote pad. For more information, review the article Overview.