Unresolved References

This page will be dedicated to information about Unresolved References and how to resolve them.

Model Integrity

Let's talk about Model Integrity. It is a mechanism that keeps the model accurate and prevent errors.

Terminology:

  • Proxy

    • Surrogate element that prevents dangling references (aka recovered elements)

    • Contains data of the referenced element:

      • Metaclasses

      • Name

      • Owners

    • Seen primarily in place of elements that the user does not have read access to

  • Recovered Elements/Unresolved References

    • Dangling references to deleted/inaccessible elements

Summary:

  • In order to keep model integrity, elements that are removed or are not accessible are changed to Recovered Elements or Proxies respectively to prevent model integrity issues.

So how do we manage Recovered Elements?

Running Composition Integrity

Identifying Validation Errors

Handling Recovered Elements

•It is recommended that you eliminate recovered elements from your model, using one of the following methods:

Eliminate the causes of the element recovery. This is the case when recovered elements still exist. Identify the cause of the element recovery and eliminate it by, for example, sharing the package that contains the recovered element, moving the element back from a non-shared location to the shared one, etc.

Restore recovered elements. This is the case when recovered elements no longer exist but can be restored from the bits of information the modeling tool still has. The restored element has only ID, name, and type.

Manage the unresolved references that refer to the appropriate recovered elements. This is the case when recovered elements no longer exist and cannot be restored.
 

•The following links outline methods of managing unresolved references using specific commands:

Replacing recovered element with another element

Removing unresolved reference

Removing recovered element symbol

How to avoid triggering element recovery

Steps to Dealing with Recovered Elements in Project Usage

Powerpoint

Demo

TBD