How to Manage Requirements, Execute Test Cases and Generate Reports Using TestLink – Tutorial #2

This is a Part-2 of the “Learning TestLink Test Management Tool” tutorial’s series. If you missed part-1 you can check it here: Getting started with the TestLink Test Management tool.

In the last tutorial, we learned TestLink installation, creating Test Plan and writing Test Cases.

Today, let’s learn important features of TestLink including requirements management, test case execution and generating test reports.

_Manage Requirements, Execute Test Cases

Let’s start.

Creating Users And Assigning Roles In TestLink

TestLink restricts some access rights depending upon user roles. A list of default roles defined in TestLink is discussed below.

  • Guest: who has the right to only view test cases and metrics. They cannot edit or view anything apart from that.
  • Tester: can execute test cases and view Test Metrics.
  • Senior Tester: who can view, modify, create and delete test cases. And they can also execute test cases and view metrics. But they have no right to create a Test Plan.
  • Leader & Admin: both Test Lead and Admin have the same rights such as view/modify/create/delete Test plan and Build, executing test cases, deleting a project, assigning user roles and permissions. In addition to that admin user has rights to modify product i.e. create, delete, and update project.

You can even create new custom roles with different permissions as shown in the below image: 

TestLink user rights

The below section clearly, explains how to create a user and assign user rights. Follow these steps to create a user and assign user roles:

Step #1) Click on Users/Roles link in the TestLink navigation bar. It will navigate to the Users/Roles page.


Step #2) Click on the “Create” button on that page.

Step #3) Enter the username, user details and role in the form displayed and click on the “Save” button.


Step #4) To assign a Test project role to a user, switch to the “Assign Test Project Roles” tab.

Step #5) Select Project name and Role for User in the drop-down, as shown in Fig.


Similarly, we can switch to the “Assign Test Plan Roles” tab and can assign roles for users to a particular Test Plan.

Writing Requirements

The requirement is a constraint/need that the software should satisfy/perform.

This section clearly explains how to write requirements in TestLink:

Step #1) Click on the Requirements link on the navigation bar. It will navigate to the Requirements page.

Step #2) Click on the “Create” button on that page.


Step #3) Enter Document ID, Title and Description about the requirement, as shown in the below figure and click on the “Save” button.


Step #4) Requirement specification should be created and displayed on the left side panel.

Step #5) Click on Requirements Operations “Create” button.

Step #6) Enter all the details as shown in the figure and click on the “Save” button.


Assigning Requirement To Test Case

Requirements can be linked to test cases in TestLink. This is a very important feature to track test coverage based on requirements. In test reports, you can check which requirements are not covered and work on them to add in test suites for maximum test coverage.

This section explains how to assign a requirement to a test case:

Step #1) Open any one Test case from the Test specification section.


Step #2) Click on “Requirements” icon on the test case as shown in above figure. It will open requirements dialogue.

Step #3) Select requirements specification from the drop-down box, and click on the requirement checkbox, as shown in the figure.


Step #4) Click on the “Assign” button. Now you can find the selected requirement in the assigned requirements section.

The requirement gets successfully added to the test case.

Executing A Test case

We can execute a test case and can change the execution status of a test case in TestLink. Status of a Test case can be changed to “passed”, “failed” or “blocked”. Initially, it will be in the “not run” state, but once you update it, it cannot be changed to “not run” status again.

Follow these steps to execute a Test case:

Step #1) Click on the “Test Execution” link in the navigation bar. It will navigate to the Test Execution panel.

Step #2) Select the Test case you want to Execute from the left side panel.


Step #3) Select the execution status (pass/fail/blocked), and then enter the test execution notes as shown in below figure.


Step #4) Click on the “Save execution” button. It will update the Test case execution status as selected.


Generating Test Reports

Test Reports are the evidence of Testing, TestLink provides a built-in feature to generate test reports in various formats such as HTML, MS Word, MS Excel, OpenOffice Writer, and OpenOffice Calc.

This section explains how to generate a Test report in TestLink. Follow these steps to generate a test report:

Step #1) Click on the “Test Reports” link on the navigation bar. It will navigate to the test reports page.

Step #2) Click on the “Test Report” link on the left side panel. As shown in Figure


Step #3) Select the contents to be added to the test report by checking the Checkboxes.


Step #4) You can change the report format by changing the highlighted dropdown value as shown in the above figure.

Step #5) Click on the Test project folder structure, appearing on the right-side panel. The test report will be generated successfully.


Same way, you can generate the Test plan report.

Export Test Case/Test Suite

Let’s assume you are using TestLink and you have already created some projects under it.

What if you want to install TestLink in some other server and you want to have all the Test projects in your TestLink on that server?

Export test cases or test suites feature comes handy in that case. You can simply export Test projects/ test suites in your TestLink and then you can import them into another TestLink project on a different system for instance.

Export/Import feature helps to avoid the overhead of writing all the test projects and test cases again.

Follow below-mentioned steps to export and import test cases:

Step #1) Select the Test case that you want to export in the Test specification page.


Step #2) Click on the settings icon onTL16 the right-side panel. It will display some test case operations.

Step #3) Click the “Export” button.


Step #4) Check all the four checkboxes, and click on the “Export” button. It will export the selected test case in XML format and save it on your local drive. The same way we can export a Test suite also.

Importing Test Case/Test Suite

Step #1) Select the Test suite folder inside which you want to import the Test case.


Step #2) Click on the settings icon in the right-side panel. It will display all operations that can be performed on a Test case / Test suite.

Step #3) Click on “Import” button in the test case operations list as shown in below figure:


Step #4) Browse and attach the XML test case file that you’ve exported from TestLink and click on the “Upload file” button.


Step #5) Test case will be uploaded and displayed on the left side panel.

The same way we can import a Test suite also.


In this part, we have seen the only manual execution of test cases. TestLink also supports an API, through which we can easily update the test case execution status.

In the next and last part, we will see some advanced concepts like – updating test case execution status in TestLink remotely i.e. through Selenium WebDriver code using TestLink API. After all, automating these small repetitive tasks can save us a lot of time in the end!

PREV Tutorial | NEXT Tutorial

Recommended Reading

32 thoughts on “How to Manage Requirements, Execute Test Cases and Generate Reports Using TestLink – Tutorial #2”

  1. this is very simple to understand. Does this tool also support defect tracking?

  2. @Akreeti – this tool doesnt have defect tracking feature, but you can integrate different defect tracking tools like bug zilla, jira, trac, mantis etc with testlink

  3. can you please explain me how to integrate different defect tracking tool to testlink.(please use bugzilla to integrate it).


  4. Thanks for this article. It was very useful.

  5. thanks for this article, it was very useful.

  6. Helpful article. Thanks 🙂

  7. Looking forward to the 3rd article (integrate automated test execution into TestLink)

  8. @Amit – To do that, first you should have bug zilla installed in your machine/ any other server.

    Go to issue tracker management link in your Testlink , and select type as bugzilla, and then add the following configuration code ,



    There are defaults defined in bugzillaxmlrpcInterface.class.php.
    All –>

    Once you’ve defined everything, Go to Test Project section and check “Active” checkbox in issue tracker integration, and from the drop down select your bugzilla xmlrpc. Save the changes. you’re done!!!

  9. Hi..can anybody tell me what is the role of SDLC and what testing methodology is used to test a website application.

  10. Hi.. can anybody tell me , how to export test cases to spreadsheet in test link tool.

  11. Can i integrate testlink with any hardware,say any OMAP based board

  12. I was looking for report of test cases by created/updated date. Is it possible?

  13. HI,

    How can we have the Requirement coverage through Selenium.



  14. Hii….. When i am trying to execute Test cases, Not able to view note/Description and Results Page.
    Can any one provide solution on how to resolve this issue.?

  15. Hi please explain how do i generate test report in excel format. currently its just shows html or ms word format for report generation

  16. I was looking for report of test cases by created/updated date. Is it possible?

  17. Anyone please help me I want to upload multiple test cases in test link at the same time.

  18. creating users
    assigning roles
    Easy way of adding requirement
    linking them to the test cases
    changing of status

    Can’t we have custom status for test cases? I mean to say to have statuses other than pass, fail, block?

  19. Can any one help me for the following:
    1-I want to Link the requirements for the Test Plan, as i can link it to test case, but not all the requirement should has testcase
    2- when execute the test case have many cases inside, how to save the status for each cash individual
    3-after integrate testlink with Mantis, how to link specific bug with the case inside test case as i can report the bug link to the whole test case not a specific case.
    4-when try to assign user to test case and let testlink to send mail, it give me error in SMTP host, as i configure it and enter the SMTP server IP or Name and it not work.

  20. how can i execute test cases by choosing automation in testlink?

  21. While executing with more than one step in test case the page is simply loading for long time and doesn’t execute.
    This is happening only with multiple steps.

  22. can anyone plz tell me how to create an issue by using testlink and how can i log and track this bug to developer .
    please share me with step by step details.

  23. is it possible TestLink generate graph or chart for each requirement ?

  24. Hi

    After executing all test cases in test link, can we edit again those test cases. I mean if all the test cases passed if i want edit again any case.

    Please lem know is der any ways to edit again

    Version we are using-TestLink 1.9.16

  25. Hi
    Is it possible to use testLink for testing purspose as a standalone, without installing Server, sqL and php

  26. How to upload bulk requirements (~200) from DOORS to Testlink tool ? Also requirements are in csv format

  27. can you please explain me how to integrate JIRA defect tracking tool to testlink.


  28. Well Explained, Many Thanks

  29. Does this tool provide data migration from HPQC or any XML import.
    Is there any support provided for customization?

  30. when i am executing test cases the option to save execution button is not showing on my execution page as given on the above screen shots
    i am using TestLink Version 1.9.16
    Please adivise

  31. Is it possible to imprt test cases from JMeter directly

  32. how to export the complete test execution history for a particular test case?


Leave a Comment