How to link requirements to the test cases?

You can link requirements with their relevant test cases. You can link a requirement to a test case only once. When a requirement is linked to a test case, it is linked with all versions of that test case.

Use Case:Users link requirements with related test cases for testing. Testers get idea of what is developed by studying requirements and on that basis, they write test cases to describe how to test the developed application. Thus, linking test case with requirement gives relevance between the two what is developed and what to test.

Requirements can be linked to test case through the Requirements tab available on Test Case details page and Test Case edit screen.

Steps

  1. Go to the Requirements tab of the test case details page or requirement edit page.
  2. Click on the Link button.
  3. It opens the Link Requirements pop-up with the list of test cases on it.

Selecting Requirements Across Projects:

Users can link requirements from other projects as well. The Project drop-down is provided to select the project. The requirements for the project are displayed on the screen.

  • You can select a particular Versionof the requirement to link to the test case. Requirements with multiple versions are expandable.
  • Use Case: Each version of the requirement is expandable so that users can view details of all versions at one place.

    Expand the requirement and select the required version to link with the test case.

  • Filter: When you click on Filter, it displays multiple criteria to filter the records within and across projects. Labels and Folder path filters are also added for the ease of searching the records.
  • Requirement of Release & Cycle of this Test Case: Checkbox will not be available when you are viewing test assets of other project. Select the check box to view only those test cases that are associated with the same Release and Cycle to which the test case is linked.



If you want to link requirements from multiple projects, then first select one project. Search records and link them before moving to other projects. For example, User A is in Project 1 and searches for some records and link them before moving to Project 2. Else, all the selection of Project 1 will be wiped off.


A. Linking a Single Requirement:Click on the icon to link the individual requirement to the test case.

B. Linking Multiple Requirements: Select requirements that you want to link and click on the Link Selected Requirements button at the bottom.

The selected requirements are linked to the test case. The linked requirement records are shown on the lower grid pane.



If requirements from other project are linked, then the requirements show Entity Key of the corresponding project.

To view the requirement of other project, click on the Requirement Entity Key. It opens the requirement detail page in the respective project and will change your current project.

Link Requirements By Entity Key 

The feature allows you to link the latest version of the requirement to a test case using the requirement key separated by a comma. Maximum 500 entities can be linked at a time.

Use Case: The feature is useful to link requirements to a test case without searching them individually. For example, users have the list of requirement keys to be linked to a test case, they can use this option to link the requirements directly. This feature will save the users' time in searching requirements in different folders to link them.

Notes:

  • Requirement key will be ignored if a relevant requirement with that key is not found.

  • If a single key is mentioned multiple times, it will be linked only once.

  • If an older version of the requirement is already linked and you are linking the same requirement key, then the latest version will not replace the older version. It will be skipped.

  • Archived versions will be skipped from linking. Only the latest unarchived version of entities will be linked.

Steps

  1. Go to the Requirements tab of the test case.

  2. Click on the Link By Entity Key button.



  3. It opens the Link Requirements pop-up. Mention comma separated Requirement keys.

  4. Click Link.

    The requirements with mentioned keys get linked to the test case.


How to Unlink Requirements Linked to a Test Case

Open the Requirements tab on the test case details page.

A. To unlink a single requirement, click on the Unlink icon for the requirement. The requirement is unlinked after confirmation.

B. To unlink multiple requirements, select the requirements you want to unlink from the test case and click on the Unlink Selected button. 

Sync Latest Test Case Version with Requirements

You can sync the latest version of the test case to its linked requirements individually or in bulk. The sync feature in the Test Case > Requirement tab allows you to sync the test case version with individual requirements or with multiple requirements in bulk.

For example, the current version of the test case is v2. All the requirements are linked to this version of the test case. Now, a new version of the test case is created i.e., v3. Users can sync the v3 of test case with the linked requirements.

(A) Sync Latest Test Case Version with a Single Requirement

When a new version of test case is available, the sync icon under the Test Case Version column turns Blue in color. You can just click on the icon to sync the latest version of the test case with the requirement in the row.


(B) Sync Latest Test Case Version with Multiple Requirements in Bulk

When there is a new version is available for the test case, the sync icon under the Test Case Version column turns Blue in color. Select the requirements to which you want to sync the latest test case version and then click on the Sync Latest Version of Test Case button.

After following (A) or (B) above, the confirmation message pops up.

Click Yes to proceed.

The success message appears.

For bulk sync, the progress will be shown in the Scheduled Task.

You can see the selected requirement(s) are synced with the latest version of the test case.