Linking to requirements artifacts in lifecycle applications

By integrating the applications of the IBM® Engineering Lifecycle Management and other lifecycle applications, you can create links to artifacts in Change and Configuration Management, Quality Management, Rhapsody Model Manager, and IBM Engineering Requirements Management DOORS® Next applications. You can link requirements artifacts, collections, modules, or module views to artifacts in other Engineering Lifecycle Management lifecycle applications.

When you link from module views, you have more control over which artifacts in a module are available for test case development and execution.

You can also sort, group, or filter artifact links in the Links section for an artifact.

Before you begin

The Engineering Lifecycle Management integration must be configured before you can do this task. For more information, see IBM Engineering Lifecycle Management and Running the setup wizard.
Important:
  • If you are linking a module view to artifacts in other Engineering Lifecycle Management applications, the module view must be Shared and the view must not be used in other modules. For more information, see Filters and views.
  • If link results exceed the maximum allowed value and all the links are not displayed, a warning message is displayed. In Link Index Provider, you can set a maximum links result restriction to display more links, if necessary.

Procedure

  1. Open a requirement or other DOORS Next artifact and expand the Links section in the sidebar and click the down arrow by the Add Link to Artifact icon .
  2. Select the link type that corresponds to the integrated lifecycle application. For more information, see Link Types.
    • Implemented By, Tracked By, or Affected By to link to development plan items, work items, and defects in CCM.
    • Validated By to link to QM test cases.
    • Derives Architecture From Element, Refined By Architecture Element, Satisfied By Architecture Element, and Traced By Architecture Element to link to RMM models and design resources.
    • References to link to DOORS Next objects in another DOORS Next instance or in another DOORS Next project area.

    If you are linking from a module view, from the view menu, select Add a Link.

  3. In the Create Link window, select an Artifact Container (project area).
    1. Click Choose Existing to select an existing artifact to link to.
    2. Click Create New to create a new artifact to link to.
      • If you are linking to the Change and Configuration Management application, you can choose a work item or create a new one.
      • If you are linking to the Quality Management application, you can choose a test case or create a new one.
    3. Click OK.
    Restriction: For modules and collections:
    • Implemented By link type is only available to plan items in the CCM application.
    • Affected By and Tracked By link types are not available.
  4. To sort the artifacts by name, type, ID, or last modified date, click the Sort Links icon.
    Sorting or grouping Links
    Note: The IBM Engineering Requirements Management DOORS Next application does not manage artifacts that are associated with Open Services for Lifecycle Collaboration (OSLC) and external. When you sort these types of links, the following rules apply to each sorting option:
    Sort by Artifact Name
    The full OSLC or external link label is used, which might or might not start with an artifact name.
    Sort by Artifact Type
    An external link is used as the artifact type name.
    Sort by Artifact ID
    The full OSLC or external link label is used, which might or might not start with an ID.
    Sort by Date Last Modified
    The last modified date of the link is used instead of the modified date of the linked artifact.
  5. To filter artifacts by link type, artifact type, or project or component, click the Filter Links icon.
    Filtering Links

What to do next

To view a summary of the linked plan, hover over the link in the Links section of the sidebar. To open the plan in the related product, click the link. In development projects, you can generate plan items that correspond to each artifact in the collection, module, or module view. In test projects, you can generate test cases that correspond to each artifact in the collection, module, or module view.