TestLink Migration to Klaros Test Management

Table of Contents

• 1. Introduction
  • 1.1. About TestLink
  • 1.2. About Klaros Test Management
• 2. Exporting a TestLink XML File
• 3. Importing a TestLink XML File
  • 3.1. Transforming the TestLink XML File
  • 3.2. Uploading the Transformed XML File
  • 3.3. Defining Custom Fields
  • 3.4. Scope and Limitations

1. Introduction

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

1.1. About TestLink

TestLink is a web-based test management system that facilitates software quality assurance. It is developed and maintained by Teamtest. The platform offers support for test cases, test suites, test plans, test projects and user management, as well as various reports and statistics.

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 TestLink XML File

Export your TestLink test specification to XML format as shown below. You may start at any node in your tree.

Figure 1. TestLink XML Export 1

Starting at the root node you get download a file like TEST.testproject-deep.xml.

Figure 2. TestLink XML Export 2

3. Importing a TestLink XML File

The import process consist of two steps:

1. Transform the TestLink XML file to the Klaros import format using the provided style sheet testlink2klaros.xsl

2. Upload the transformed file to the Klaros REST API

3.1. Transforming the TestLink XML File

The easiest way to transform the XML source via a style sheet is using the libxml library,which is available as a package under Linux or Cygwin for Windows.

Other alternatives include XSLT processors like Saxon or Xalan.

xsltproc testlink2klaros.xsl TEST.testproject-deep.xml > klaros-testcases.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"

❗	Importing custom attributes Importing custom attributes will only work, if the project already contains matching custom field definitions.

This step is described in detail in the next section.

3.3. Defining Custom Fields

As mentioned above, your Klaros project must already contain all custom field definitions matching the custom fields of your TestLink project. The name match is case-sensitive so the field names must match exactly.

For more information on creating custom field definitions, see the Klaros User Manual, Section User Defined Properties.

🔥	Custom field support is only available in the Klaros-Testmanagement Enterprise Edition. If you are using the Community Edition, please disable the custom fields option for the TestLink export.

3.4. Scope and Limitations

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

The following fields are currently not being transferred, as there is no directly matching field available in Klaros:

1. Keywords

2. Platform Information

3. Test Case Relation