By default, you cannot use the number sign (#) in file names for model files. The model files do not open.
To use the number sign character in model file names, open the <install_dir>/rationalsdp.ini file and add the following argument under the Settings section:
VMArgs=-Dorg.eclipse.emf.common.util.URI.encodePlatformResourceURIs="true"
Note: Do not add this argument to an already existing line. This argument should be on its own line in the file.
On Linux operating systems, a file name can contain a question mark (?). However, Rational Software Architect does not support question marks in model file names. If you use a question mark in a model file name, an exception is thrown in the .log file. Do not use question mark characters in model file names.
If you apply a stereotype to an element in a model, and then modify a property that the stereotype added to use blank spaces, after you save and close the model, you can not open the model. To avoid this issue, use the underscore character (_) instead of spaces in the names of stereotype properties.
To work around this issue, use a text editor to remove the name value pair that is associated with the property. For example, you would remove the "My Stereotype Property" property from the following example:
<contents xmi:type="Profile_2:Profile__Stereotype1" xmi:id="_eVPvkCbPEdmF27ugxgyz4g" My Stereotype Property="New Value"/>If you remove the property, the result would be as follows:
<contents xmi:type="Profile_2:Profile__Stereotype1" xmi:id="_eVPvkCbPEdmF27ugxgyz4g"/>
When you work with a UML model, you can use the Avoid obstructions option to specify that connectors do not intersect model elements. However, when you publish a model, the connectors might intersect model elements. To work around this issue, select the connector(s), clear the Avoid obstructions option, and manually adjust the bendpoints to avoid any obstructions. The next time you publish the model, the connectors will display correctly.
Icons in the titles of model elements, such as classes and packages, print with a white border. The white borders stand out against the titles, which print with a gradient shading. To print models without a gradient shading, turn off the gradient preference.
To turn off the gradient preference:
- Click Windows > Preferences.
- Expand Modeling and click Appearance.
- Under Global appearance, clear the Show gradient check box.
Dependency and realization connectors might not be visible in printed models. To work around this issue, change the line color of the connectors.
To change the line color of the connectors:
- Right-click the model; then click Select > All Connectors.
- From the toolbar, click the Line Color drop-down menu and select a darker color.
Composite structure diagrams that are owned by a class can only contain properties that have their UML Aggregation property set to composite. These properties can be visualized. To visualize properties that do not have UML Aggregation set to composite, you must set the canonical behavior of the compartment to false. You can then visualize the non-composite properties by dragging them from the Model Explorer view onto the composite structure diagram.
To set the canonical behavior of a property:
- Select the background of the compartment.
- In the Properties view, click Advanced.
- Expand Styles and set the Canonical property to false.
You should not copy and paste models directly from the file system. Doing so can corrupt models, when you work with an original and a copy in the same workspace. Issues might also arise when you compare or merge a model, because of identical model element IDs. To work around this issue, use the Export as template option, or manually copy and paste the root elements into a new blank model.
There is no easy way to add parameters or return types to behaviors.
To add parameters or return types to behaviors:
- In the Model Explorer view, right-click the behavior; then click Properties.
- In the list of properties, click Parameter.
- In the drop-down list, click Parameter or Result Type.
If you rename a diagram in the Model Explorer view, the name might not update immediately on the Properties page, under General. To work around this issue, select another diagram element in the Model Explorer view. The diagram information updates when you return focus to the diagram.
If you apply multiple stereotypes to a model element, and one or more of the stereotypes has an icon, only one of the stereotype icons is displayed in the Model Explorer view. To work around this issue, set the stereotype style to text only.
To set the stereotype style to text only:
- Click Window > Preferences.
- Expand Modeling and click Views.
- On the Views page, set the stereotype style to Text.
- Click Apply.
- Click OK.
You cannot add stereotypes to multiple elements at one time. Doing so only applies the stereotype to the first selected element. To work around this issue, apply stereotypes to one element at a time.
When you move a diagram from one model to another, classes are not shown as cross-model references. To work around this issue, close and open the diagram. This refreshes the cross-model reference decorators.
When you move a connection in the Model Explorer view, the diagram editor might not update properly. To work around this issue, delete the connection from the diagram editor and use the Show/Hide Relationships option to display the connection.
To show and hide connectors in a modeling diagram:
- In the diagram editor, right-click a diagram element; then click Filters > Show/Hide Relationships.
- In the Show/Hide Relationships window, click the relationships that you want to show, hide, or leave as is in the diagram, and click OK.
When you work with certain diagram types, such as activity, state machine, and sequence diagrams, the Show Related Elements option might not be available for state elements.
If you change a model file, close the UML Model Editor, and click No in the Save Resource window, the Model Explorer view indicates that the model file contains unsaved changes. The model file does not contain unsaved changes. The next time that you open the model file, the Model Explorer view displays the correct information.
When you select a collaboration or use case in the Model Explorer view, certain menu items (for example, Interaction, Activity, and State Machine) do not appear in the Add UML pop-up menu. To work around this issue, use the Add Diagram pop-up menu to add the required behavior to the model file.
When you open the Inheritance Explorer view using the Window > Show View > Inheritance Explorer command, the information displayed in the Inheritance Explorer view is misleading.
To display the inheritance hierarchy of an element in the Inheritance Explorer view:
- In the Model Explorer view or the diagram editor, select an element.
- Right-click the selection; then click Navigate > Show in > Inheritance Explorer.
Alternatively, you can drag a model element from the Model Explorer view directly into the Inheritance Explorer view.
When you perform any of the following actions, the product might display a validation error message that is not descriptive or useful:
- Perform an invalid action
- Break the model validation
- Request an option that is not available in this release
Return to the main readme file