Guideline: ClearCase / Rhapsody / RTC Workflows
This guideline describes the main workflows covering the ClearCase/Rhapsody/RTC operations.
Relationships
Related Elements
Main Description

Connect to ClearCase

  • Start the Eclipse-based Rational Team Concert
  • Open the ClearCase Explorer Perspective
  • Select ClearCase > Connect

  • Enter Server information, including servername and port number 

  • Provide username and password 

Join Project

  • Select ClearCase > Join Project

  • Choose the Project you want to join
  • Fill in the fields and click Finish

  • In the View Configuration, select the relevant source containers and click Add

  • Wait for the load process the end (copying files from server to local drive)

Share Code and Model

  • Assumption: Both the model and the source code will be added to configuration control
  • Import Rhapsody model into Eclipse - Open Rhapsody Modeling Perspective
  • File > Import
  • Select Rhapsody Project

  • Browse to the location of the Rhapsody project - Eclipse will find the projects under that directory
  • In the C++ Perspective, right click to the imported project and select Team > Share Project

  • Select ClearCase Remote Client, then the view and then the appropriate container - wait for the VOB move to complete
  • In the Add Selected files to source control screeen, select the resources to add to source control - create a new activity

  • Click OK and wait for the process to complete
  • Result: Model and its subunits are under source control in the relevant VOB
  • Update the code generation directory if a path different than the default one is needed
  • In the Rhapsody Modeling Perspective, right click to the configuration of the component and select Features

  • In the Settings tab, clear the Use default option and select a directory for code generation - this directory can be another directory in the same VOB or in an other VOB
  • Click Apply and save the model

  • Generate the code of the selected configuraiton: right click and select Generate Configuration

  • Verify that code is generated in the right directory
  • Create a new C++ project: File > New > C++ Project in the C++ perspective - select and enter relevant info
  • Set the path on level up of the code generation directory
  • Click Finish

  • Source code will be selected to be added to source control
  • Click OK and wait for the process to be completed

  • Result: all the model and source code is under source control

Checking in

  • Select Code development project, right click and select Show Pending Changes

  • Select My project uses single-stream development and click OK
  • ClearCase will find all checked out resources
  • Right click to the activity New Version Control and select Check in
  • On the Checkin selected files screen, click OK to check in evey file selected. Select Undo checkout if the version is identical to its precedessor

Make Changes

  • Checkout the model (or sub unit)
    • In the Rhapsody Modeler perspective, right click to the unit which you would like to update
    • Select Configuration Management > Select in Unit View
    • In the Unit View right click to the package and select Team > Checkout
  • In the Checkout selected files screen, create a new activity by selecting New in the select activity section. Name the activity name as New Changes

  • Create a new attribute in a class - for example, New Attribute: attrib1

  • To reflect model changes to source code, right click on the class of package and select Generate Code

  • After changes on the model and code, right click on the class and select Edit Code if you want to browse the code
  • Open the C++ perspective, right click on the Source Development Project
  • Select Team > Update From Repository

  • In the Update Resources screen, select which VOB you want to update and select Do not update Hijacked Files and click Apply

  • Select the hijacked files, right click and select checkout in the ClearCase view configuration view -these files are the ones which are changed due to model update
  • In the Checkout selected files screen, select or create an appropriate activity and click OK

Adding New Classes

  • In the Rhapsody Modeling Perspective, right click on the classes package and create a new class named MyClass

  • Right Click on the new MyClass and select Generate Code
  • Verify that new specification and implementation code are added automatically in the Source Development project in the C++ perspective; if not, try refreshing the project
  • ClearCase Eclipse Interface will automatically discover new resources and will prompt to add to source control - select activity and OK

Committing Changes

  • After changes are done, in order to commit changes go to ClearCase Pending Changes view and refresh - new outgoing changes will be found

  • Associate RTC Work Item with the ClearCase changes: Select ClearCase activity New Changes right click on the activity and select Associate Work Items

  • Select an appropriate RTC Work Item

  • In the ClearCase Pending Changes view, right click on the activity and select Checkin

  • Select Checkin even if identical ... option and a proper activity