Migration from Testrail

Import of the test cases from Testrail with attachments

This feature is designed to make your migration process from Testrail smooth and efficient, helping you save time and effort.

With this migration tool, you can:

• Quickly import test cases from TestRail to aqua.

• Include screenshots and attachments during the import, ensuring all your data stays intact.

• Eliminate the need for manual work, streamlining the transition to aqua.

Preparation for the import

Open your Testrail instance and navigate to the project you want to migrate to aqua.

Once you open it, click on the export icon and select export in XML format.

If you want to import test cases to aqua without any attachments, then no extra steps on the Testrail side are needed.

In case you want to migrate test cases with screenshots and attachments, you need to perform following steps:

Step 1: Enable usage of API on the Testrail side if it’s not yet allowed.

First, navigate to the user settings.

Then select the ‘Administration’ tab

Under the administration tab, select the ‘Site Settings’ option

Then click on the ‘API’ option.

And enable both settings.

Press the ‘Save settings’ button.

Then navigate back to the ‘Dashboard’ and then jump to your settings again,

Go to the 'API keys' tab and click 'Add key'.

Once the pop up appears, give it a unique name that you can user later to define for what it is used for.

Then click 'Generate key' and you will get a unique key. Copy it and save it to the notes. The clicks 'Add key'.

All is done, now you can go to aqua.

Import to aqua

First, you need to create a project in aqua. You can do it from the main page by clicking on the ‘Add’ icon.

You can also import the test cases to the specific folder. Just create new under the project

Or select an existing one to which you want to import your test cases.

Once you have a project or a needed folder, click on the 3-dot menu next to the project or folder and select the ‘Import’ option.

When a pop up appears, select the ‘Testrail file (xml)’ button.

As it was mentioned before, if you want to import test cases only, just upload the XML file and the test cases will be added to aqua project.

If you want to migrate attachments too, you need to enable ‘Include all images and files during import’.

Then fill out the form with your credentials and add the API key that you have generated in Testrail.

You can test connection, to ensure everything works before migration.

When all is set, click the ‘Import’ button and the migration will start.

If you need to migrate multiple projects, you need to wait until the previous one is finished.