Associating test cases with requirements

In the Quality Management application, you can associate test cases with requirements in the Requirements Management application. Then you can include the test cases in test plans to ensure thorough test coverage of product requirements.

About this task

  • If configuration management is enabled for your project, the current configuration must be a global configuration to link to artifacts such as requirements or development plans in other Engineering Lifecycle Management applications.
  • If you have not enabled configuration management, when you create a link to external artifacts in a ELM application, a link is automatically created back to the source artifact in the target application, which is called a back link. However, the synchronization between bidirectional links and the traceability between source and target artifacts are not guaranteed.
When a source artifact and target artifact link to each other, this is known as bidirectional linking. The source and target applications store their links in separate databases, and the source application does not have access to the database in the target application. Certain transactional operations, such as when artifacts are copied or deleted, can occur on the source application server. In these cases, corresponding back links in artifacts in the target application are not automatically added or removed. Also, instances occur where back links are intentionally removed from the target application without removing the corresponding link from the source application. As a result, if bidirectional links are not in a state of synchronization, traceability between the source and target artifacts can appear different based on your starting viewpoint.


  1. Open or create a test case, and in the table of contents, click Requirement Links.
  2. Click the Add new links icon (Add). The Requirement links page opens.
  3. The requirement projects are displayed on the right. Select the requirement to associate with the test case. To select more than one requirement, press and hold the Ctrl key and select the requirements. You can link requirements and requirements within Modules to test cases:
    1. If you select Folder, the link is created with the base artifact. If the artifact is also part of a Module, select Include links, tags and comments from base artifacts icon on the top right corner, to view this link from the module.
    2. If you select This module the link is created in the context of the module and not the base artifact.
  4. Click OK. The requirements are displayed in the Requirement Links section of the test case.
  5. Click Save to save the changes that you made to the test case.

video icon Video channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community forums library

support icon Support

IBM Support Community
Deployment wiki