Tool Mentor: Configuring the Rhapsody - Process Content Integration
This tool mentor describes how to set up IBM Rational Rhapsody® to work with the Systems Engineering process content.
Tool: IBM Rational Rhapsody
Main Description

To enable access from your Rhapsody projects to the process content you need to:

  • Deploy the process published website on your web server
  • Customize the included hep file and create the links between the Rhapsody elements and the appropriate topics in the published website
  • Add the helper file to Rhapsody
Customizing the HEP file

The SEPracticeContentHelpers.hep file identifies helpers which are links to process content web pages showing on the right-click menus. In this context, a helper has a set of elements to which it applies. In addition, the .hep file identifies a tool to run and arguments. In this case, the .hep file uses Microsoft Internet Explorer as the tool (in its default install location) and as arguments it uses a file path to the relevant process content page. A typical helper entry (for helper #2, in this case) looks something like this:  

name2=SE Practices\Work Product: System Use Case Diagram
command2=C:\Program Files\Internet Explorer\iexplore.exe
arguments2=http://rupository.svl.ibm.com:3000/wikis/SSE_UC_M1/index.htm#practice.tech.syseng.common.base-ibm/workproducts/sys_uc_diag_7DE4D72F.html
applicableTo2=UseCase, UseCaseDiagram
applicableToProfile2=
UsingJava2=0
isPluginCommand2=0
isSynced2=0
isPlugin2=0
isMacro2=0
isVisible2=1

where:

  • namex = menu\entry -- menu is optional (and you can define as many different menus as you like). entry is what will appear on the right click menu in rhapsody
  • commandx = path to your browser
  • argumentsx = path to repository page
  • applicableTox = list of elements in Rhapsody to attach this helper to (see Rhapsody/Doc/metaclasses.txt for a full list of available elements and their correct spellings)

The numberOfElements line should be modified to match the number of helpers in the .hep file. Each .hep entry is numbered - make sure when you copy a helper that you change the number on each line in the entry: for example for entry number 2 use name2, command2, arguments2, and so on.

Adding the Helper File to Rhapsody
  • In Rhapsody, select File > Project Properties
  • Select the Properties Tab
  • Locate the Property: General:Model:HelpersFile (or AdditionalHelpersFile if HelpersFile is already used)
  • Set the property to the location of the helpers file
  • Save, close the project and reload it.