Linking work items to requirements

You can link work items to requirements that you create in a requirements application.

Before you begin

You must configure the change and configuration management application Jazz-based server and the requirements application Jazz-based server to communicate with each other. You must also link the change and configuration management project area with the requirements project area. For information about linking artifacts across project areas and lifecycle projects, see Getting started with project areas and lifecycle projects.
Note: Some applications support versioning of their artifacts by tracking the versions in configurations. A global configuration tracks multiple configurations. For example, a global configuration might include configurations from RM, QM, and Design Management (DM) project areas. If your organization uses the Global Configuration Management application to manage versioned artifacts in other applications, you can link work items to specific versions of those artifacts. To enable this linking, you must configure your project area accordingly. See Linking work items to artifacts in Configuration Management-enabled project areas.


  1. In the Work Item Editor, click the Links tab.
  2. In the Links section, click Add, then select one of the following options, as appropriate:
    • Add Implements Requirement
    • Add Affects Requirement
    • Add Tracks Requirement
  3. In the Artifact Link Dialog window, select the location of the requirement.
    If the requirement is on a remote repository, and you are prompted to authenticate, log in by using your credentials for the server of the remote repository, which is displayed in the Authorization Required window.
  4. Select Link to existing, then click OK.

    If the test case that you want to link to does not exist yet, select Create new, then click OK. Create a test case in the project that you selected, and then link to the test case.

  5. In the Requirements Selection window, select the requirement that you want to link to the work item. Click OK.


The Links section of the work item is updated to show the Implements Requirement, Related Requirement, or Tracks Requirement link. You can also see the link in the Quick Information section of the Overview tab.