stolp / klaros-testrail-migration

Software for migrating test cases from TestRail via XML export files to Klaros Test Management.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

TestRail Migration to Klaros Test Management

1. Introduction

This project offers software for importing test cases from TestRail XML export files to Klaros Test Management.

1.1. About TestRail

TestRail is a web-based test management tool used by testers, developers and other stake holders to manage, track and organize software testing efforts.

1.2. About Klaros Test Management

Klaros Test Management is a professional web-based test management software. It contains components for resource management and evaluation of test activity. Tracking of test requirements is supported, as well as agile development processes. Numerous interfaces with issue trackers, test automation tools and continuous integration servers allow seamless integration into existing development environments.

Klaros Test Management is available free of charge in the Community Edition and can also be used for commercial purposes without restrictions.

The Enterprise Edition offers you the full range of functions, including one-year support and free access to all software updates. An overview of the features of both editions can be found here.

To receive your free 30-day trial license for the Enterprise Edition, you can request your license key here.

Detailed information, extensive documentation and a freely accessible online demo can be found under Klaros Test Management.

2. Exporting a TestRail XML File

Export your TestRail test specification to XML format as shown here: TestRail Support - Exporting test cases to XML

3. Importing a TestRail XML File

The import process consist of two steps:

  1. Transform the TestLink XML file to the Klaros import format using the provided Java archive file

  2. Upload the transformed file to the Klaros REST API

3.1. Transforming the TestRail XML File

The transformation process requires an installed Java 11 or better Runtime Environment (JRE) and a current release of this software.

In the command line execution example below the following placeholder are present:

<TESTRAIL_XML>: The path to the TestRail XML file to import <KLAROS_XML>: The path to the Klaros XML import file to convert these test cases to

java -Xmx512m -jar testrail-migration-1.0.1.jar -t <TESTRAIL_XML> -T <KLAROS_XML>

3.2. Uploading the Transformed XML File

For uploading the result file to Klaros you may use the command line tool Curl which is available as a package under Linux or Cygwin for Windows.

Of course, using GNU wget or any other tool for sending HTTP requests is possible here as well.

curl -v -T klaros-testcases.xml "http://localhost:18080/klaros-web/seam/resource/rest/import/testcase/xml?config=P0000X&username=admin&password=admin"

Please substitute 'P0000X' wwith the project id of the project you want to import to. Likewise make sure to add the correct credentials in the username/password attributes. The credentials must identify a user with role Testmanager for the above project.

The import interface is described in detail in the Klaros User Manual, Section "Importing Test Cases from XML"

3.3. Test Case Sections

If your TestRail test cases are using sections, this information will be automatically be mapped to Klaros test case categories upon import. This requires the Enterprise Edition, as categories are only available there.

3.4. Scope and Limitations

This migration is able to transfer mostly all of the test case information, including test step descriptions and expected results.

Test case attachments will currently not be transferred.

About

Software for migrating test cases from TestRail via XML export files to Klaros Test Management.

License:Apache License 2.0


Languages

Language:Java 97.8%Language:Shell 2.2%