Importing a Rational Rose model

Ensure that your IBM® Rational Rose® model is correct from the Rational Rose perspective before you import it into IBM Rational® Rhapsody®. In addition, a target project must first exist in Rational Rhapsody before you can import a Rational Rose model.

Procedure

  1. Before importing a Rational Rose model, verify that the model is correct from the Rational Rose perspective. Use the Rational Rose check model function and clear all reported errors in the model before importing it. Attempting to import a model with errors might result in problems using the Rational Rose Importer.
  2. With Rational Rhapsody running, create the project. For example, choose File > New.
  3. To start the process to import your Rational Rose model, select Tools > Import from Rose > Import Model.
    Notice that Rational Rhapsody automatically opens the Output window for you.
  4. To select a Rational Rose model to import, do whichever of the following action is applicable for you to fill in the File to import field:
    • If you have the Rational Rose environment and the Rational Rose model you want to import open, select the Connect to Running Rose Instance check box to enter the File to import field.
    • If you do not have the Rational Rose environment open, use the Browse button to locate the Rational Rose .mdl file you want to import. Or you can type the name, including the full path, of the Rational Rose model in the File to import field.
  5. Once the Rational Rose .mdl filename displays in the File to import field, the Logical View, Use case View, and Component View branches for the Rational Rose model to be imported are displayed on the Rose Import window.
    Rose Import window
  6. Expand the contents of a view choice and select the elements you want to import. Note the following information:
    • Clicking the check box for the main (top) branch selects or clears all sub-branches and their elements.
    • Clicking the check box for a sub-branch selects or clears that sub-branch and all its elements.
    • Right-clicking a check box either clears or selects that specific element, depending on its current state.
  7. To select your import options, click the Options button to open the Import Options window:
    • Import statecharts and activity diagrams, Import object model diagrams, Import Associations with no names. Decide (select/clear the check boxes) if you want to include statecharts and activity diagrams and/or object model diagrams and/or associations with no names.
    • If you want the imported Rational Rose project to have the look‑and‑feel of a Rational Rose project, select the Use Rose Look-and-feel check box.
      Note: If you are reimporting a model, the Use Rose Look-and-feel check box is disabled if this check box was selected when the model was initially imported.
    • If you want to import properties from the Rose model, select the Import Properties check box and use the Browse button to point to the needed property XML map file. See Importing Rational Rose properties.
      Note: Rational Rhapsody will automatically use these settings the next time you do an import. For example, if you select the Import statecharts and activity diagrams check box and clear the Import object model diagrams check box, this setting will be used for all subsequent imports until you change the settings again.
  8. Before you import, you might want to be sure of or do the following information:
    • If you are re-importing the same packages from Rational Rose, remember that the names in Rational Rhapsody and in Rational Rose must be the same.
    • If necessary, move the Rational Rose Import window away from the Output window before you start the import so that you can see any messages as they occur.
      Note: While Rational Rose allows names with spaces, Rational Rhapsody does not. Rational Rhapsody approximates spaces in names by replacing them with underscores. For example, a package named "Course roster" in Rational Rose becomes "Course_roster" when imported into Rational Rhapsody. There are other characters not allowed in Rational Rhapsody names (such as &, #, $, and %). For these characters, Rational Rhapsody uses underscores or truncate the names.
  9. To close the Import Options window, click OK.
  10. On the Rose Import window, to do the import, click the Import button.
  11. If a top-level package with the same name as one you are importing exists in the Rational Rhapsody model, the following message displays:
    Packages Logical_View, Use_Case_View, Component_View already exist. Do 
    you want to continue?

    To continue with the import, click Yes. This means that any package that is re‑imported is totally overwritten.

  12. The import process begins. Progress meters and possible messages regarding "lost data" are written to the Output window. The following examples show types of messages:
    Error: Can't import association itsTerminal from IControlDevice. It 
    has only one role.
    ...
    Error: Can't add operation GetPropertyValue to class IControlDevice, 
    there is a name or signature clash.
    ...
    Error: Can't override statechart for derived class IAlarm.

Results

The import process creates a log file, importRose.log, which is located in the folder of the active project.


Feedback