Improved Tracking of Automation Execution Results and Test Results with TestLink

Integrating Selenium Web Automation Framework with TestLink test management tool makes it possible to update test case statuses remotely.


TestLink is the most widely used web-based open source test management tool. With TestLink, it is possible to synchronize requirement specifications and test specifications together. Additionally, through its role-based access control, TestLink supports creation of multiple accounts for different roles.

The link below features an excellent guide to integrating Selenium Web Automation Framework with TestLink, Test Management Tool for updating test case status automatically.


Here are the steps suggested.

Getting Started

Selenium Web Automation Framework is written specifically for test cases which are written in TestLink, meaning that integration of this automation framework with TestLink enables manual as well as automated execution of test cases within TestLink. This allows generation of test plans and test reports in a fraction of the time that the process would otherwise require, and supports test reports in various formats like MS Excel, MS Word, and HTML.


Step 1: Install TestLink on local or cloud environment

  • Visit the below URL
  • Download:
  • Unzip and install TestLink

Step 2: Enable Automation in TestLink

On the TestLink HomePage, go to My Settings>Account Settings>API Interface Section, and Click on “Generate a new key”

Generate a new key
Generate a new key

Once this is done, you should have an API Key generated under the Project that you have created in TestLink.

Preparing Automation Environment in TestLink

Step 1:
Enable automated testing for the project

Step 2:
Edit the configuration file  in TestLink as follows:

  • Add the below two lines in file file
  • $tlCfg-> api-> enabled
  • $tlCfg-> exec_cfg-> enable_test_automation

Rename as

Restart Apache server after updating the file.

Step 3:
Configure the TestLink Client API Jar:

  • testlink-api-client-2.0.jar
  • xmlrpc-common-3.1.jar
  • xmlrpc-client-3.1.jar
  • ws-commons-util-1.0.2.jar

Step 4:
Add the above listed JARs as external JARs from the Java Build path.

Step 5:
Develop code to communicate with  TestLink from Selenium

Step 6:
Set up DEV_KEY & TESTLINK_URL as follows:

  • Replace the DEV_KEY field with your TestLink API Key.
  • Replace the TESTLINK_URL with your TestLink URL.
Test Link Integration
Test Link Integration

Step 7:
Set up a test case (and make a note that it was created on  TestLink):

  • TestLink API Key
  • TestLink URL
  • Test project name
  • Test plan name
  • Test case name and
  • Build name

These details need to be used in Java code, as seen below:

Java code

Step 8:
Create a Java class to specify the TestLink integration details and the method to update the test results on Testlink.

Step 9:
Execute Selenium test and update Test result in TestLink. Once you execute the script, the result for the particular test case is updated and automatically reflects on TestLink.

Selenium test and update Test result

Selenium test and update Test result

Find sample source code here