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.

Note: Currently aqua supports only xml format as it is the best option for the most accurate results when importing test cases from TestRail. Its nested structure ensures a more precise and reliable import in comparison to csv or excel.

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

Once key is addded, please don’t forget to click ‘Save settings’, otherwise the API key won’t be preserved and activated.

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.

The migration process depends on the size of your project and may take for a few minutes.

Please note that only one import per instance is allowed at a time.

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

Additional information:

• Currently aqua supports:

  • the default Testrail templates:

    • Test case (text)

      • Test case (steps)

      • Exploratory session

  • Sections hierarchy in Testrail will be mapped to the folder structure in aqua.

  • Conversion from markdown to html

• Currently import doesn’t support:

  • Test plans migration

  • Fields mapping

• Enabled fields in the test cases are added to the description of a test case to ensure you don’t lose important data.