Engineering Test Management and Engineering Requirements Management DOORS integration

When you integrate IBM® Engineering Test Management with Engineering Requirements Management DOORS® (DOORS), you can link requirements from DOORS with the Requirements view in a test plan or test case.

The integration is made possible by:

Open Services for Lifecycle Collaboration (OSLC) specification: Starting with QM Version 5.x and DOORS Version 9.6, you can upgrade to the OSLC integration.
Note: When upgrading to the latest version of DOORS, you might be required to migrate to the OSLC integration. For more information about upgrading, see the Engineering Requirements Management DOORS documentation.

OSLC integration

Starting in DOORS Version 9.6 and QM Version 5.x, you can integrate DOORS and QM using the Open Services for Lifecycle Collaboration (OSLC) specification. OSLC enables you to create bidirectional links between test and requirement artifacts and display rich hover text when viewing DOORS requirements in test cases and DOORS requirement collections in test plans. In DOORS, you can also link from certain DOORS objects, such as requirements, to test plans , test script steps, and test cases in QM.

In order to leverage the OSLC, you must either upgrade from the earlier RQMi integration, or configure the integration for the first time with OSLC.
Note: QM version 5.x and higher do not support the RQMi integration with DOORS.

Artifact linking when using OSLC

When you create a link to external artifacts in a Engineering Lifecycle Management workbench source application, a link is automatically created back to the source artifact in the target application, called a back link. When a link has been created from a source artifact to an external artifact and a resulting back link has been created from the external artifact to the source artifact, the links are referred to as bidirectional links.

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 in the source application server. In these cases, corresponding back links in artifacts in the target application are not automatically added or removed. There can also be instances where back links are intentionally removed in the target application without removing the corresponding link in 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 differently based upon your starting view point.

The accuracy of traceability reports could be affected if bidirectional links are not in a synchronized state. For example, a report run against artifacts in the target application might provide different results than a report run in the source application against the same artifacts. Links to the following artifacts are included in this limitation:
  • Requirement collections
  • Development plans
  • Requirements
  • Change requests, such as Defects, Tasks, Plan Items, and Stories
Note: With DOORS 9.6.1.4 or later, the Link Discovery service is used instead of backlinks between DOORS to QM. A state of synchronization between bidirectional links and the traceability between source and target artifacts are not guaranteed.

Links to locked artifacts

If a requirement or requirement collection is locked in DOORS when you attempt to create or delete a link to the artifact, you might receive a message that the changes to the link cannot be saved. When this happens, the Quality Management application prompts you to choose how to proceed. In the prompt, there are three options: Try again, Cancel, and Save partial changes. Option Try again attempts to create or delete the back link again. If the requirement or requirement collection is still locked, the operation will fail. Option Cancel cancels the change to the link on the test artifact and the back link on the DOORS requirement or requirement collection. Option Save partial changes only changes the link on the Quality Management test artifact but does not change the link on DOORS requirement or requirement collection. You must repair the link later in DOORS for it to function correctly.

Tip: If you want the application to remember an option, you can check Remember my choice and do not show this message again. Your selected options are configurable in the My Preferences for Quality Management, OSLC Settings page.

Refer to the Engineering Requirements Management DOORS user documentation for information about exporting requirements from DOORS to QM.

OSLC integration support matrix

Product Rational® Quality Manager v5.x Rational Quality Manager v6.x
Engineering Requirements Management DOORS v9.6 Yes* Yes
Engineering Requirements Management DOORS v9.6.1 No Yes*
Note: * These are the recommended version combinations.

video icon Video

Jazz.net channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community

Jazz.net
Jazz.net forums
Jazz.net library

support icon Support

IBM Support Community
Deployment wiki