Sync data between Rational DOORS and Rational ClearCase

Using the IBM Rational DOORS for ClearCase Interface

IBM® Rational® DOORS® for ClearCase Interface is a bridge between these two products to enable complete lifecycle traceability from requirements through configuration management. This article explains how it synchronizes configuration management and establishes traceability between information managed in Rational DOORS and versions managed by Rational® ClearCase®.

Share:

Guru Prasad Ramesh (gururprasad@in.ibm.com), Staff Software Engineer, IBM

Author1 photoGuru Prasad Ramesh has worked with IBM Rational DOORS for the past year and has more than eight years of experience in the IT industry. His areas of interest include cloud computing and Open Services Lifecycle Collaboration. He loves listening to music, watching movies, and playing cricket.



22 January 2013

Also available in Chinese Spanish

The IBM® Rational® DOORS® for ClearCase Interface is a bridge between the two products so you can have complete lifecycle traceability from requirements through configuration management. You can use the interface for several tasks, each of which are described further in this article:

  • Importing data from Rational® ClearCase® into Rational DOORS
  • Viewing new information
  • Reviewing imported information to understand it better
  • Using Rational DOORS traceability features

Importing data from ClearCase into Rational DOORS

A complete structure of a versioned object base (VOB) is read into a Rational DOORS module, creating a Rational DOORS object for each element, version, and branch. Properties, attributes, and labels are also imported.

The Rational DOORS for ClearCase Interface uses Microsoft Windows drive letters to select views. You can choose to use either the Dynamic views drive, normally M, or a view that represents specific dynamic or snapshot view. The Dynamic views drive allows you to select any view of any VOB without needing to choose a drive letter, thus simplifying the import operation

To import from ClearCase:

  1. Open the target Rational DOORS module.
  2. From the DOORSConnect menu, select ClearCase > Synchronize / Import, as shown in Figure 1.
Figure 1. DOORS – ClearCase synchronization menu
Menu used to import - ClearCase to Rational DOORS

Note:

If you want to import from a dynamic view, make sure that the Drive field contains the correct drive. M: is the ClearCase default, as shown in Figure 2.

Figure 2. DOORS Connect ClearCase Import structure - DOORS
Importing data - ClearCase to Rational DOORS
  1. Select the view in the View field.
  2. Select the VOB in the VOB field. The Path field shows the composite path that you created.
  3. Click Import to start the import operation, as shown in Figure 3.
Figure 3. DOORS Connect ClearCase Import Report - DOORS
Report after import data to Rational DOORS

Viewing new information

Rational DOORS provides many ways of viewing imported ClearCase information.

All of the relevant information can be put into a single screen. Any updated information is clearly shown, using the standard Rational DOORS change bars. After an import, change bars for new or updated items are set to red, but the rest of the objects remain unmodified, as shown in Figure 4.

Figure 4. IBM Rational DOORS view
Red change bars under VOB1 after importing

ClearCase information can also be shown in graphics mode, where colors distinguish the different kinds of objects. Merge links are clearly shown if you click View> Show > Graphics Links, as shown in Figures 5 and 6.

Figure 5. DOORS Connect ClearCase Import Report - DOORS
Report, Graph after importing the data to DOORS

Version structure

Rational DOORS stores this information as a hierarchy of objects that contain the names of the elements, branches, and versions as headings, with check-in comments as the text. Figure 7 shows an example.

Figure 6. ClearCase version tree
Hierarchy of objects with branches and versions

Graphics colors

When each item is imported, it is assigned a color for use in graphics mode. Table 1 provides a key to the color assignments.

Table 1. Color allocations
ItemColor
VOBRed
DirectoryGreen
FileBlue
VersionLight Blue
BranchYellow
Derived ObjectPink
Private FileOrange

As Figure 8 shows, this helps provide instant visual recognition of the structure of your data.

Figure 7. Color-coded diagram, shown in DOORS
Diagram shown after importing data to DOOR

ClearCase attributes

All user-defined ClearCase attributes are imported into Rational DOORS as string attributes with the same name, prefixed with CC Attr.

Attribute values are imported for all ClearCase elements, versions, and branches. If the values of attributes are subsequently changed in ClearCase, the values in Rational DOORS are updated the next time that the file is imported.

Labels

ClearCase labels are typically used to mark which files were included in a particular release. Labels have names, such as Patch_1.1, as shown in Figure 9.

Figure 8. Label shown as CC Label Patch 9.4.0.1 equals True
Importing a label from ClearCase to Rational DOORS

Merge links

ClearCase uses hyperlinks to indicate where files have been merged. These can be imported into Rational DOORS as regular Rational DOORS links. This import process is optional, and it can be turned off by using the Create merge links check box, as shown in Figures 10, 11, and 12.

Figure 9. ClearCase version tree browser
ClearCase version merging.
Figure 10. ClearCase links merge report to DOORS
Pop-up Report window after importing data
Figure 11. Graphical links merge report after importing links to DOORS
Graphical color code with link

Resources

Learn

Get products and technologies

  • Get the free trial download for Rational DOORS Web Access.
  • 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.

Discuss

Comments

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


static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=1
Zone=Rational
ArticleID=855367
ArticleTitle=Sync data between Rational DOORS and Rational ClearCase
publish-date=01222013