Integrate Rational DOORS and Rational Rose for traceability

Trace requirements to software design

Learn how you can use the IBM® Rational® DOORS® and IBM® Rational Rose® integration to trace requirement to software design. This article covers the entire process, from configuration to linking requirements to design elements. It helps you to assess how requirements affect your software design and shows you how to detect design elements that are not justified by requirements. This article is for readers who have an intermediate level of knowledge of Rational DOORS and Rational Rose.


Arti Saagar (, System Software Engineer, IBM

author photoArti Saagar has been working as a functional and system test engineer on various Rational tools, including Rational Doors, Rational Publishing Engine, Rational Rhapsody, Rational System Architect, Rational Project Console, and Rational Rose. She is an expert in integration of Rational DOORS with other system tools, including Rational Rose.

10 April 2012

Also available in Chinese

Install the Rational DOORS for Rational Rose Interface

This section provides instructions for installing the IBM® Rational® DOORS® server and DOORS client with the IBM® Rational Rose® interface so you can integrate the two:

  1. Install the Rational DOORS server by following online installation instructions from the DOORS information center (see the Resources section for a link).
  2. Install the Rational Doors client with following options. See the link in Resources to "Installing the Rational DOORS client on Windows" for general installation instructions.
  3. On the Setup Type page in the installation wizard, select the Custom option, as shown in Figure 1.
Figure 1. DOORS installation Setup Type page
Choose the setup type Custom
  1. On the Custom setup page, make sure that you select Rational Rose Interface program feature as shown in Figure 2.
Figure 2. DOORS installation Custom Setup page
Rational Rose Interface program feature selected

Install Rational Rose

Install Rational Rose 7.0 or a later version by following the product installation guide. There is no special step for integration with DOORS.

Trace DOORS requirements to a Rational Rose model

The Rational DOORS for Rational Rose Interface creates a Rational DOORS formal surrogate module to store the Rational Rose data. The surrogate module is an anchor point in DOORS so you can link the requirements in Rational DOORS to the software elements in Rational Rose. The surrogate module has the same name as the Rational Rose model.

The objects in the surrogate module are organized in a hierarchy that is based on the type of the model element. For example, all of the classes are grouped under the Class heading, all of the categories are grouped under the Category heading, and so forth. When you send class elements, you can also send the operations and attributes associated with the class. Each operation and attribute becomes a child of the class object.

The surrogate module serves as a bridge between the Rational Rose model and the Rational DOORS project.

Develop model elements in Rational DOORS

In this section, you will learn how you can use Rational DOORS to develop model elements and then send them to Rational Rose. For example, you may decide to generate your use cases in Rational DOORS while you are re developing the requirements for your project. You may find it helpful to create links between the requirements and use cases as you develop them. You can use the following steps to configure and create model elements in Doors module:

  1. Launch the DOORS Client and log in to DOORS.
  2. Create a new module in one of the DOORS projects that you want to integrate with Rose.
  3. From the menu, select DOORSconnect > Rose > Setup Module for creating Rose items.

Notice in Figure 3 that one new column is added to the module named Rose Type. You can choose the type of the Rose element that you want to create for this column, such as UseCase, Actor, Class, or Module, for example.

Figure 3. Setup Module for Rose Items
Setup module to create Rose items
  1. Create new objects in the module by selecting Insert > Object menu item.
  2. Provide an appropriate name and Rose type for each object that you create.
  3. Save the module.

After Rose elements are created in DOORS, you can link them to requirements in DOORS by following these steps:

  1. Select a Rose Element in the module.
  2. Right-click, and from context menu, select Link > Start Link.
  3. Select the module where the requirement needs to be linked.
  4. Right-click on the requirement object, and select Link > Make link from Start to create a link from Rose element to the requirement.

You can create a link from a DOORS requirement to a Rose element in a similar way.

Send model elements from Rational DOORS to Rational Rose

When you are ready to transfer the Rose design element to Rational Rose model, use the Rational DOORS for Rational Rose Interface to send the data from DOORS to Rational Rose. Each object that you send becomes an element in the target Rational Rose model.

To send data from Rational DOORS to Rational Rose:

  1. Launch Rational Rose and open the target model.
  2. Using Rational DOORS, open the module that contains the model data that you want to send to Rational Rose.
  3. Click DOORSconnect > Rose> Export Items to Rose on the menu.
  4. In the Send to Rose dialog window, click one of the Send these objects radio buttons to specify which objects you want to send to Rational Rose, and then click OK.

Send data from Rational Rose to Rational DOORS

Use this option when a Rose model already exists and, later, you want to link it with requirements in DOORS.

To send model data from Rose to DOORS:

  1. Launch Rational Rose and open the Rose model.
  2. From the Tool menu, select Tool > DOORS > Send to DOORS.
Figure 4. Send to DOORS dialog window
Select elements to send to DOORS

In the DOORS Rose Link dialog window (see Figure 4), use the radio buttons to specify which elements you want to send to Rational DOORS, and then click OK.

If this is the first time that the Rational Rose model has been sent to the Rational DOORS module, you will see the Locate Surrogate Module dialog window.

  1. Select the folder or project to which you want to send the Rational Rose model. If you are sending data for the first time, you need to have created access to this project or folder.

The Rational Rose Interface then creates a surrogate Rational DOORS module for the Rational Rose model, if the module does not already exist. The interface sends the data to the surrogate module and creates a new object for each item sent. At the end, it displays a Rational DOORS message that shows how many surrogate objects were created.

  1. Click OK to acknowledge the message.

Do not change the name of the surrogate Rational DOORS module, the Rational Rose model, nor any of the Rational DOORS attributes that the Rational Rose Interface creates, such as the Rose Type attribute. If you change these names, subsequent updates will not work properly.

You can link requirements to items in Rational Rose in either of two different ways:

  • In the currently open Rational Rose diagram
  • In the currently selected item in Rational Rose browser tree

Link to one or more items in a Rational Rose diagram

  1. Select one or more items from your diagram.
  2. Select a Rational DOORS requirement object in DOORS.
  3. Using Rational DOORS, click DOORSconnect > Rose > Link to item(s) in Rose Diagram.

Your selected items are imported into the local Rational Rose surrogate module, and a link is created between the Rational DOORS object and the imported objects.

Link to one or more items in a Rational Rose browser tree

  1. Select one or more items from your Rational Rose browser tree.
  2. Select a requirement object in Rational DOORS. Using Rational DOORS, select DOORSconnect > Rose> Link to item(s) in Rose browser tree.

Find items in Rose from a surrogate module in DOORS

After the surrogate module is created in DOORS to represent the placeholder for design items in Rose, you can find those items in Rose by following corresponding item in surrogate module.

To find Rose item in a surrogate module in the DOORS module:

  1. Open the DOORS surrogate module if it is not already open.
  2. Select the item that you want to find in Rational Rose.
  3. Click DOORSconnect > Rose> Find item in Rose, as shown in Figure 5, to open the corresponding item in Rational Rose.
Figure 5. Trace Rational Rose items from surrogate module to Rose
Find item in Rose selected on drop-down menu



Get products and technologies



developerWorks: Sign in

Required fields are indicated with an asterisk (*).

Need an IBM ID?
Forgot your IBM ID?

Forgot your password?
Change your password

By clicking Submit, you agree to the developerWorks terms of use.


The first time you sign into developerWorks, a profile is created for you. Information in your profile (your name, country/region, and company name) is displayed to the public and will accompany any content you post, unless you opt to hide your company name. You may update your IBM account at any time.

All information submitted is secure.

Choose your display name

The first time you sign in to developerWorks, a profile is created for you, so you need to choose a display name. Your display name accompanies the content you post on developerWorks.

Please choose a display name between 3-31 characters. Your display name must be unique in the developerWorks community and should not be your email address for privacy reasons.

Required fields are indicated with an asterisk (*).

(Must be between 3 – 31 characters.)

By clicking Submit, you agree to the developerWorks terms of use.


All information submitted is secure.

Dig deeper into Rational software on developerWorks

ArticleTitle=Integrate Rational DOORS and Rational Rose for traceability