Fixing Unresolved and Unloaded References

Technote (FAQ)


Question

In IBM Rational Rhapsody how can I fix Unresolved and Unloaded References in the model?

Cause

When an element is removed from a model, it is possible that references to that element will appear on diagrams that are read only and so can not be removed.

This results in an unresolved / unreferenced model element on a diagram, represented by a (U).


Answer

When an element is removed from a model, it is possible that references to that element will appear on diagrams that are read only and so can not be removed.

This results in an unresolved / unreferenced model element on a diagram, represented by a (U).
Having these elements in the model can, among other things, cause a crash during CM check out because they appear on one or more diagrams, but no longer exist in the model. In order to fix this problem, each element needs to be resolved manually, by either removing the element from the diagram (and then, if it really is not needed any more, deleting it from the model) OR by replacing the missing element if it is actually needed. For a project that is in CM already, all users should check in their modified files and then one user should check out the entire model outside of Rhapsody to be in a position to apply the fixes.
Once the model is fully checked out and writeable, open it in Rhapsody and perform a search using the Edit > Search > Advanced and Only unresolved/unloaded.

Right-click each element in the list, and select References to see where it occurs in the model..

Double-click on any references or relations displayed in the list to find them on the appropriate diagram.

To resolve this (U) element you must do one of two things – either replace it or delete it. Sometimes it will be necessary to replace the element in order to delete it.

If you intend to replace the missing element you simply need to perform an Add To Model from the file menu.
The (U) will disappear from the diagram and this element will now be fixed. If you wanted to remove the element from the model entirely, you can right-click on the element and select “Remove from View”, then right-click on the element in the search results and select “Delete from Model”.
If you do not remove the element from the diagram first, you will get an error message.

Sometimes, however, you will get an “Action is not allowed on unresolved element.” error message when you try to delete an element from the search results. This happens when a missing element is associated to an element that is also missing.

To resolve this problem, the elements in question MUST be replaced before they can be removed from the model. In most cases, the element’s corresponding unit no longer exists so there is nothing to replace it with. In this common scenario, the simplest solution is to open another copy of Rhapsody, create a new project and add an element of the SAME NAME and type. Ensure that it is saved as a separate unit (that is, right-click on it in the browser and select Unit > Create Unit) then save the model. Open your original model and perform add the newly created unit using Add To Model as a unit. Rhapsody might warn you that the model element exists in the model already [Iin fact, it is simply the stub, the (U) reference that shows up in the browser] so when prompted you should replace the existing occurrence with the new unit. It is now safe to remove the association / link / dependency from the model and once complete, you can remove the newly added unit.

New in Rhapsody 7.5

A new feature has been added. If one of these read-only references is an Object Model Diagram for example, then Rhapsody pops up a warning message:

"Warning: This element (or one of it's descendants) is referenced in
read only diagrams: OMD1 etc
Delete anyway?"

Selecting multiple elements for deletion that have such references can cause multiple messages so you should be presented with a Read Only Files With References dialog box that allows you to checkout the read-only files directly.

In the What's New guide it states:

Improved deletion of references across units Project teams working together on a model often may work on elements checked out in writeable units but with references in other units in a read only state. If this element is deleted then a situation arises where unresolved elements are created in the read only units. Rational Rhapsody 7.5 helps prevent this situation by displaying a dialogue with a list of the read only units containing the references to the deleted element and you have the option to check out those units to avoid creating unresolved elements.)


Product Alias/Synonym

Telelogic Rhapsody

Rate this page:

(0 users)Average rating

Document information


More support for:

Rational Rhapsody
General Information

Software version:

7.2, 7.3, 7.4, 7.4.0.1, 7.5

Operating system(s):

Windows

Reference #:

1393534

Modified date:

2010-07-13

Translate my page

Machine Translation

Content navigation