TestLink Tutorial 4 – Test Metrics, Keyword Management, Custom Fields and Test Report Charts

By Vijay

By Vijay

Image
I'm Vijay, and I've been working on this blog for the past 20+ years! I’ve been in the IT industry for more than 20 years now. I completed my graduation in B.E. Computer Science from a reputed Pune university and then started my career in…

Learn about our editorial policies.
Updated April 1, 2025

TestLink Tutorial 4 – How to Effectively Manage Test Metrics, Keyword Management, Custom Fields and Test Report Charts

This is the 4th tutorial in the TestLink test management tool series. Check out all the tutorials in this series here:

=> TestLink Tutorials

Test Metrics provides a full overview of the execution status of test cases (in percentage) for a build.

TestLink

Step-1:
To view the execution status of all test cases (in percentage), click “Metrics Dashboard”.Test Metrics 1

Step -2:
It will navigate to the Metrics dashboard page, where you can find the execution status of all test cases for a build.

(Click on image enlarge)

Test Metric 2

Keyword Management:

We can assign keywords to a test case and by using those keywords we can filter test cases.
Step -1:
Click on the “Keyword Management” link on the Desktop page. This will navigate you to the Keywords page.

Test Metric 3

Step -2:
Click on “Create Keyword” button.

 Step -3:
Give the Keyword name and Description as shown in the Figure, and click on “save” button.

(Click on image enlarge)

Test Metric 4

The keyword will be created and displayed as shown in the figure

(Click on image enlarge)

Test Metric 5

Step -4:
Click on “Assign to Test cases” button, It will navigate to the test specification panel.
Select a particular test case from the left side panel.
Select desired keywords from the right side panel and assign it the test case by clicking ”arrow ” button.

(Click on image enlarge)

Test Metric 6

Click on “Save” button.
Keyword will be assigned to the Test case, we can verify it by going to the specific test case in Test Specification.

Filtering test cases based on Keyword:

Users can filter test cases based on the keyword assigned to it.
Step -1:
 Go to Test Specification Panel Select the keyword from the Filters section and then click on the “apply” button.
It will filter test cases with the specified keyword and shows in the left side panel.

Test Metrics 6

(Click on image enlarge)

Test Metric 7

Custom Fields:

User can create and assign their custom fields to test cases. It involves the following steps,
Step-1:
Click on the “Define custom fields” link on the Desktop page. As shown in the figure,

(Click on image enlarge)

Test Metric 9

It will navigate to custom fields creation page.

Step -2:
Click on the “Create” button on that page.

Step -3 :
Enter the Name of your custom field and label and select the Type of the custom field (either Radio, Checkbox, String etc.) in the custom field definition page.

(Click on image enlarge)

Test Metric 10

Click on “Add” button. A custom field will be created and shown in the list.

(Click on image enlarge)

Test Metric 11

Assigning Custom Fields:

Step -1:
Click on “Assign Custom Fields” link on the Desktop page.

Test Metrics 11

Step -2:
Check the check box of the custom field to be assigned and click on the assign button. It will be assigned and displayed, as shown in figure

(Click on image enlarge)

Test Metric 13

Step -3:
You can even change the display order in the list, based on the display order, a custom field will appear in the test case.

 Step -4:
To verify whether the custom fields were added successfully, go to the Test specification panel and open a Test case.

Where you can find a custom field appearing on the test case.

(Click on image enlarge)

Test Metric 14

You can add custom field values by editing the test case.

(Click on image enlarge)

Test Metric 15

[Note: this is an example for creating and assigning string custom fields, similarly you can add a checkbox, and radio button fields by changing the type in custom fields]

Test Report Charts:

Test execution status can be presented in graphical charts. But to use this feature we need to enable php_gd2 in your php.ini file.
Step -1:
Open php.ini file in the php installation directory, and remove “;” before gd2 extension. As shown in the Figure,

(Click on image enlarge)

Test Metric 16

Save the configuration file. And restart Apache from “services” panel.

(Click on image enlarge)

Test Metric 17

Step -2:
After Restart, Open Testlink URL in the browser and Go to “Test Reports” Panel in Testlink.

Step -3:
Click on “Charts” option from the left side panel.

Test Metrics 17

Results will be displayed in graphical charts on the right side, as shown in the figure.

(Click on image enlarge)

Test Metric 20

Test Metric 21

Test Metric 22

Was this helpful?

Thanks for your feedback!

READ MORE FROM THIS SERIES: