Designating a root directory

Use the <lang>_ReverseEngineering::ImplementationTrait::RootDirectory property to designate the root directory that contains all the folders that are to become package. In this way, Rhapsody® builds the package hierarchy according to the folder tree from the specified path.

About this task

The RootDirectory property is necessary for code-centric modeling as it determines the component directory and supports the package‑to‑directory connection.

The reverse engineering tool calculates the directory that creates the minimum number of packages and suggests (through a message window) this directory as the root directory during the reverse engineering process. You might use the <lang>_ReverseEngineering::ImplementationTrait::UseCalculatedRootDirectory property to set whether the root directory needs to be calculated. The calculated root directory overrides the value in the RootDirectory property.

Note: The root directory feature is available for Rhapsody Developer for C, C++, and Java.

Note the following information:

  • If you are doing reverse engineering with merge option, there will be no calculated root directory and the current value will be used.
  • For Rhapsody Developer for Java, if there is no value in the RootDirectory property and you are using the navigation tree version of the Reverse Engineering window (click the Tree View icon Screen capture), the root directory from the tree view will be used.
  • When you export an Eclipse project to Rhapsody , the root directory is set according to the Eclipse project. The UseCalculatedRootDirectory property is ignored.
  • If you use batch or the COM API to do reverse engineering, a No Reply is used if the UseCalculatedRootDirectory property is set to Auto. To avoid the calculate root directory message box, you might want to set the UseCalculatedRootDirectory property to Always or Never.