Before you get started, take a look at the following table to get an overview of how elements in the two programs are mapped to each other in the importing and exporting processes.
Project with test suite
Smart folder outside a test case
Smart folder inside a test case
In this chapter
Importing allows you to import test suites from a TestRail project into a solution in Ranorex Studio.
Select Import into Ranorex Studio in the TestRail wizard and click Continue. The Import screen will appear.
To import one or more test suites:
Select the TestRail project you want to import from.
Select whether you want to import all test suites in the project or only the selected ones. If the latter, select your test suites.
Select the programming language you want your project to use in Ranorex Studio.
Exporting allows you to export test suites from a Ranorex Solution to a TestRail project.
Select Export to TestRail in the TestRail wizard and click Continue. The Export screen will appear.
Select the TestRail project you want to export to. It can be a new or existing project. If the former, Ranorex Studio will automatically create a new project on TestRail with the name of the Ranorex solution.
Select whether you want to export all test suites in the solution or only the selected ones. If the latter, select your test suites.
Once you have imported from or exported to a TestRail project, the Ranorex solution is connected to it. This has the following effects:
The TestRail sync file contains all information required for the connection between the Ranorex solution and the TestRail project. It’s created after importing/exporting and stored as TestRail.trsd in the Solution Items folder of your solution. You can access it from the projects view.
Once you’ve imported or exported a test, the Synchronize button will appear in the TestRail section of the Ranorex Studio menu bar.
Click it to synchronize. Synchronizing carries out an import and an export for the currently connected test suites to update them with changes made in either program.
Not synchronizing these changes makes it easier to work and collaborate between the two programs, as they serve different purposes and therefore may require different structures.
There are several ways to remove the connection to TestRail.
This error occurs when exporting or syncing if a required custom field in TestRail doesn’t have a default value set.
There are two ways to fix this.
This fixes the issue for everyone using the integration with your TestRail instance. However, you will need to have rights to edit custom fields.
In TestRail, find the field and assign it a valid default value.
Repeat the export/sync in Ranorex Studio.
Alternatively, if you can’t or don’t want to edit custom fields, you can also change the value of the field in the TestRail.trsd sync file. This only fixes the problem for your machine. Others will still get the error.
In the projects view in the Solution Items folder of your solution, double-click TestRail.trsd.
Find the custom field mentioned in the error message, i.e. custom_myfield in our case.
Change its Value parameter to a valid value of the custom field.
Save your solution and repeat the export/sync option.