Linking between AM artifacts and local work items

You can link a work item to another work item that is stored in a remote repository.

Before you begin

Open Services for Lifecycle Collaboration (OSLC) must be enabled. For more information, see Enabling Open Services for Lifecycle Collaboration.
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 and QM 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 Affects Plan Item
    • Add Affected by Defect
    • Add Related Change Request
  3. In the Artifact Link Dialog window, select the location of the remote artifact. If 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. If the test case that you want to link to does not exist yet, select Create new. Create a test case in the project that you selected, and then link to the test case.
  5. Click OK. The Work Item Selection window opens, with the name of the remote project area pre-populated.
  6. Find and select the test case to link to.
  7. Click OK.


The Links section of the work item is updated to show the Related Test Case link. You can also see the Tested by link on the Overview tab in the Quick Information section.

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