Link types in requirements projects

Requirements projects include several predefined link types for traceability.
Administrators can view the link types for a project and create link types on the Link Types page, which they can access by clicking the Administration menu and then clicking Manage Project Properties > Link Types.
Note: If you have configuration management enabled for your project, on the Administration menu, click Manage Component Properties.
The following table provides descriptions of most of the traceability link types in the Requirements Management (RM) application. For more information about OSLC link type definitions, see The OSLC Requirements Management (RM) Vocabulary and RM Resource Definitions. For more information about other Rational solution for Collaborative Lifecycle Management (CLM) link types, see the related links at the end of this topic.
Important: When you create an RM project by using a project template, not all of the link types that are described in the following table are automatically shown. Whether a link type is shown in the Create Link window depends on project association definitions and on whether RM is integrated with other products, such asIBM® Rational® Rhapsody® Design Manager, or IBM Rational DOORS®. In addition, some link types, such as Affected By, are shown only if the corresponding link is created by another application, such as a change management application.
Table 1. Requirements management link types
Link type Description
Affects/Affected By Captures the relationship between a requirement artifact and a change management item that affects the implementation of the requirement artifact. For example, a defect in the Change and Configuration Management (CCM) application can affect the implementation of a requirement artifact. In the CCM application, links of this type are shown as Affects links.

This link type is available only through an OSLC integration with IBM Rational Team Concert™. The Affected By link is the link from the RM application to Rational Team Concert. The Affects link is the link from Rational Team Concert to the RM application.

Artifact Term Reference (References Term/Term Referenced From Captures glossary-based relationships between requirement artifacts. This type of link is created during term-based operations for text artifacts, such as when you create a term.
Constrains/Constrained By Captures the relationship between requirement artifacts when one artifact limits or holds back the other artifact. For example, an artifact can be constrained by a requirement that it must conform to.
Decomposition (Parent Of/Child Of) Captures part-whole relationships between requirement artifacts. Typically, these types of links represent artifact hierarchies.
Derives Architecture Element/Derives From Architecture Element Captures the relationship between a requirement artifact and an architecture management item that represents a model of the requirement artifact. For example, a UML use case in an architecture management application can represent a requirement artifact. In architecture management applications, links of this type are shown as Derives From Architecture Element links.

This link type is available only through an OSLC integration with Rational Rhapsody Design Manager.

Embeds/Embedded In Tracks a containment relationship between RM artifacts. These types of relationships occur when you complete operations such as inserting an artifact and inserting an image for a text artifact.
Extraction (Extracted/Extracted From) Captures when the content of a requirement artifact was created from the contents of another requirement artifact. This type of link is created during extraction-based operations; for example, when you create an artifact by saving an existing artifact as a new artifact.
Illustrates/Illustrated By Illustrates the relationships between graphical and text artifacts.
Implements/Implemented By Captures the relationship between a requirement artifact and a change management item that describes the implementation of the requirement artifact. For example, a story in the CCM application can describe the implementation of a requirement artifact. In the CCM application, links of this type are shown as Implements links.

This link type is available only through an OSLC integration with Rational Team Concert. "Implemented By" links point from the RM application to Rational Team Concert. "Implements" links point from Rational Team Concert to the RM application.

Link (To/From) Tracks a general relationship between requirement artifacts.
Mitigates Captures the relationship between requirements and risks. A requirement mitigates one or more risks, and a risk is mitigated by one or more requirements.
References/Referenced By Tracks a relationship between requirement artifacts. These types of relationships occur when creating links between artifacts.

This link type is available only through an OSLC integration with another RM instance or project area.

Refines Architecture Element/Refined By Architecture Element Is available only through an OSLC integration with Rational Rhapsody Design Manager.
Satisfies/Satisfied By Captures how the different levels of requirements are elaborated. For example: an approved vision statement in a vision document can be satisfied by one or more stakeholder requirements.
Satisfies Architecture Element / Satisfied By Architecture Element Only available through OSLC integration with Rational Rhapsody Design Manager.
Synonym Relates requirement term artifacts that are synonymous.

This link type is bidirectional. The link is shown as "Synonym" from either endpoint.

Trace Architecture Element/Traced By Architecture Element Is available only through an OSLC integration withRational Rhapsody Design Manager.
Tracks/Tracked By Captures the relationship between a requirement artifact and a change management item that tracks the implementation of the requirement artifact. For example, a task in the CCM application can track the implementation of a requirement artifact. In the CCM application, links of this type are shown as Tracks links.

This link type is available only through an OSLC integration with Rational Team Concert. Tracked By links point from the RM application to Rational Team Concert. Tracks links point from Rational Team Concert to the RM application.

Validates/Validated By Captures the relationship between a requirement artifact and a test artifact that validates the implementation of the requirement artifact. For example, a test plan in the Quality Management (QM) application can validate the implementation of a requirement artifact. In the QM application, links of this type are displayed as Validates links.

This link type is available only through an OSLC integration with IBM Rational Quality Manager. Validated By links point from the RM application to Rational Quality Manager. Validates links point from Rational Quality Manager to the RM application.


video icon Watch videos

CLM playlist
Jazz.net channel
User Education channel

learn icon Learn more

CLM learning circle
Agile learning circle
Learning circles

ask icon Ask questions

Jazz.net forum
developerWorks forums

support icon Get support

Support Portal
Deployment wiki
Support blog