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:
- Install the Rational DOORS server by following online installation instructions from the DOORS information center (see the Resources section for a link).
- 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.
- 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
- 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
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:
- Launch the DOORS Client and log in to DOORS.
- Create a new module in one of the DOORS projects that you want to integrate with Rose.
- 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
- Create new objects in the module by selecting Insert > Object menu item.
- Provide an appropriate name and Rose type for each object that you create.
- Save the module.
Link Rose elements to DOORS requirements
After Rose elements are created in DOORS, you can link them to requirements in DOORS by following these steps:
- Select a Rose Element in the module.
- Right-click, and from context menu, select Link > Start Link.
- Select the module where the requirement needs to be linked.
- 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:
- Launch Rational Rose and open the target model.
- Using Rational DOORS, open the module that contains the model data that you want to send to Rational Rose.
- Click DOORSconnect > Rose> Export Items to Rose on the menu.
- 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:
- Launch Rational Rose and open the Rose model.
- From the Tool menu, select Tool > DOORS > Send to DOORS.
Figure 4. Send to DOORS dialog window
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.
- 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.
- 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.
Link requirements to Rational Rose items
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
- Select one or more items from your diagram.
- Select a Rational DOORS requirement object in DOORS.
- 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
- Select one or more items from your Rational Rose browser tree.
- 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:
- Open the DOORS surrogate module if it is not already open.
- Select the item that you want to find in Rational Rose.
- 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 out more about the Rational DOORS for Rational Rose Interface.
- Consult the instructions mentioned in this article:
- Browse the Rational DOORS developerWorks page for links to technical articles and many related resources, and explore the instructions in the Rational DOORS Information Center.
- Visit the Rational software area on developerWorks for technical resources and best practices for Rational Software Delivery Platform products.
- Explore the Rational Rose overview, the developerWorks Rational Rose page, and download the data sheet to learn more.
- Subscribe to the developerWorks weekly email newsletter, and choose the topics to follow.
- Stay current with developerWorks technical events and webcasts focused on a variety of IBM products and IT industry topics.
- Improve your skills. Check the Rational training and certification catalog, which includes many types of courses on a wide range of topics. You can take some of them anywhere, any time, and many of the "Getting Started" ones are free.
Get products and technologies
- Get the free trial download for Rational DOORS Web Access.
- Downloads free trial versions of other Rational software.
- Evaluate IBM software in the way that suits you best: Download it for a trial, try it online, use it in a cloud environment, or spend a few hours in the SOA Sandbox learning how to implement service-oriented architecture efficiently.
- Join the Rational DOORS forum to ask questions and participate in discussions.
- Join the discussion in the Rational Rose forum.
- Rate or review Rational software. It’s quick and easy.
- Share your knowledge and help others who use Rational software by writing a developerWorks article. Find out what makes a good developerWorks article and how to proceed.
- Follow Rational software on Facebook, Twitter (@ibmrational), and YouTube, and add your comments and requests.
- Ask and answer questions and increase your expertise when you get involved in the Rational forums, cafés, and wikis.
- Get social about thought leadership. Join the Rational community to share your Rational software expertise and get connected with your peers.