Menu

Import Test Cases from TestLink

These instructions show the steps to convert XML files exported from TestLink to qTest Manager.

Prerequisites

  • Windows 32 or 64bit is required.
  • Currently, we only support converting and importing Test Cases from TestLink to qTest.
  • The tool supports the following exported XML files from TestLink: Test Project, Test Suite and Test Case.
  • Time zone on the machine ifrom which you have exported a file from TestLink should be the same as in your qTest Manager instance.

IMPORTANT:

  • In this document, input file will be used as the exported XML file from TestLink; and output file will be used as the converted Excel file which is importable to qTest Manager.
  • All Test Cases in the same suite must be exported in the same XML file.

Modify qTest Field Settings

Since the field system in qTest and TestLink are quite different, you will need to customize our system fields and create new custom fields prior to importing to qTest Manager.

To configure field settings in qTest:

  1. Access the qTest Manager project to which you want to import Test Cases.
  2. Click the Gear icon on the top navigation pane and select Field Settings.
  3. Select the applicable Test Case from the left pane.
  4. Edit our system fields and create new custom fields.

Edit System Fields

Four system fields of Test Case in TestLink can be mapped with qTest system fields as shown here.

TestLink qTest
Status Status
Execution Type Type
Importance Priority
Estimated Exec Duration You will need to create a qTest custom field to map with this TestLink field

1. Status

In qTest, add Status values according to TestLink Status values.  Unfortunately, the input file does not contain the real Status value but is a number representing the status.  Therefore, you will need to configure the qTest Manager Status field with the numbers in the input file.

  1. In the input file, collect all distinct values of status element. 

    IMPORTANT: If you cannot find any status element, you are not using the test case Status field in TestLink and you can skip steps 6a, 6b and 6c.

  2. Access the qTest Manager project to which you want to import Test Cases.
  3. Click the Gear icon on the top navigation pane and select Field Settings.
  4. Select the Test Case from the left pane.
  5. Click the Status link. 
  6. On the Edit System Field pop-up, add status values according to the distinct status values you have found in the input file
      1. Click the Add Value button.
      2. Click on its Display name to edit it.
      3. Click the Delete icon to remove any unused values.
      4. Uncheck the Required checkbox if you are not using the Status field in your TestLink.

HINT: The following table is for reference.  If you are using the latest version of TestLink (v1.9), the default Status values and their representing numbers in the input file are as below.

Status value (in TestLink application) Number (in the input file)
Draft 1
Ready for review 2
Review in progress 3
Rework 4
Obsolete 5
Future 6
Final 7


2. Type

  1. In the input file, collect all distinct values of execution_type element. 

    IMPORTANT: If you cannot find any execution_type element, you are not using the test case Execution Type field in TestLink and you can skip steps 6a, 6b and 6c.

  2. Access the qTest Manager project to which you want to import Test Cases.
  3. Click the Gear icon on the top navigation pane and select Field Settings.
  4. Select a Test Case from the left pane.
  5. Click the Type link. 
  6. On the Edit System Field pop-up, add status values according to the values you have found from the input file
      1. Click the Add Value button.
      2. Click on its Display name to edit it.
      3. Click the Delete icon to remove any unused values.
      4. Uncheck the Required checkbox if you are not using the Execution type field in your TestLink.

HINT: The following table is for reference.  If you are using the latest version of TestLink (v1.9), the default Execution Type values and their representing numbers in the input file are as below.

Execution Type value (in TestLink application) Number (in the input file)
Manual 1
Automation 2


3. Priority

  1. In the input file, collect all distinct values of importance element. 
  2. IMPORTANT: If you cannot find any importance element, you are not using the test case Importance field in TestLink and you can skip steps 3 to 6.

  3. Access the qTest Manager project to which you want to import Test Cases.
  4. Click the Gear icon on the top navigation pane and select Field Settings.
  5. Select a Test Case from the left pane.
  6. Click the Priority link. 
  7. On the Edit System Field pop-up, add status values according to the values which you have found in the input file
      1. Click the Add Value button.
      2. Click on its Display name to edit it.
      3. Click the Delete icon to remove any unused values.

HINT: The following table is for reference.  If you are using the latest version of TestLink (1.9), the default Importannce values and their representing numbers in the input file are as below,

Importance value (in TestLink application) Number (in the input file)
Low 1
Medium 2
High 3

Create Custom Fields

If there are any Test Case custom fields in TestLink, you need to create corresponding custom fields in qTest Manager Test Case.

  1. Access the qTest Manager project to which you want to import Test Cases.
  2. Click the Gear icon on the top navigation pane and select Field Settings.
  3. Select a Test Case from the left pane.
  4. Click the Add Custom Field button and nnput the field name.  Select one field type; then click the OK button.
  5. On the Edit Custom Field pop-up, add the field values if needed. 

IMPORTANT: The input file does not include the custom fields' types.  For our conversion tool to convert your data correctly, you need to add prefixes to some of your custom fields as described in the table below.

TestLink field type Mappable qTest field type Additional prefix
Checkbox Check box Add qtlist_ prefix to your field name in TestLink
Multiselection Check box Add qtlist_ prefix to your field name in TestLink
String Text box  
Numeric Number  
Float Number  
Email Text box  
List Combo box Add qtlist_ prefix to your field name in TestLink
Date Date picker Add qtdate_ prefix to your field name in TestLink
Radio Check box Add qtlist_ prefix to your field name in TestLink
Date time Date and time picker Add qtdate_ prefix to your field name in TestLink
Text area Rich text editor  
Script Text box or Rich text editor Add qtscript_ prefix to your field name in TestLink
Server Text box  

Convert XML to Excel

  • Download TestLink's Test Cases Conversion Tool from the qTest Resources page. 
  • Put a downloaded file in a directory on your machine (e,g., : D:\qTest\Convert Tool)
  • Open the command line tool.  Access the directory above
    cd “E:\qTest\Convert Tool”
    
  • Execute the command to convert XML files.
    testlink2qtest [input file or directory]
    

    [input file or directory] is the directory path where input files are located or the path to a specific input file.

    Output files are located under the same directory as the convert tool. Output file names are the same with the input files.

Import into qTest

Once the output files are converted from XML to Excel, follow the instructions to import test cases into qTest Manager Test Design using the Test Case Import.

Modify Field Settings

Access the Field Settings section and modify the system fields’ values with the real values.  If you are using TestLink v1.9, you can refer to the following tables for default values of system fields.

Status value (in TestLink application) Number (in the input file)
Draft 1
Ready for review 2
Review in progress 3
Rework 4
Obsolete 5
Future 6
Final 7
Execution Type value (in TestLink application) Number (in the input file)
Manual 1
Automation 2
Importance value (in TestLink application) Number (in the input file)
Low 1
Medium 2
High 3

 

Subscribe To Our Blog
Powered by Zendesk