Considering Diagram Differences in Detail

You can consider the comparison results for diagrams in detail in comparison windows.

Determining and Considering Diagram Differences

Prerequisites

The Open Comparison Window command has been called in the Align Models editor for a diagram selected in a hierarchy area that is not a single.

Context

The name of the left-hand diagram is displayed in the tab of the window.

In the hierarchy area, the comparison result of mapped diagrams takes into account the direct properties of the diagrams and the exclusively graphical properties of the diagrams themselves (for example, the size and position of nodes). Logical property differences of the contained diagram elements are not taken into account; instead, they are displayed for these model elements. A name change in a diagram is only taken into account as a difference if it is associated with a change to the node size.

Graphical differences are represented by the Diagram Content property.

The graphical and logical differences of the diagram elements are evaluated and displayed in the comparison window for diagrams.

The comparison takes place exclusively using the elements' UUID. Elements are both nodes and edges.

Icons for filters and the right-hand Differences area are available for a clear overview of the changes.

Note

The settings in the Filter and Show menu groups of the editor also affect the display of the logical differences in the comparison window.

You can use the following commands:

Icon Meaning
Entire Diagram (Ctrl+F9)
Zoom both diagrams with the same factor to fit the entire diagrams into the window.
Change Alignment (Ctrl+O)
Change the horizontal/vertical alignment of the diagrams.
Highlight Graphical Changes (Ctrl+W)
Highlight elements that are graphically modified.
Highlight Logical Changes (Ctrl+E)
Highlight elements that are logically modified.
  Highlight Left Singles (Ctrl+L)
Highlight elements that only exist in the left model.
Highlight Unequal Elements (Ctrl+H)
Highlight elements that exist in both models and are unequal.
Highlight Right Singles (Ctrl+R)
Highlight elements that only exist in the right model.

In the following, it is assumed that the left-hand diagram is the older, unchanged model copy and the right-hand diagram is the current, changed working copy.

How to proceed

  1. To highlight added elements, activate the display of graphical and/or logical changes and highlight only the right-hand singles.

    In the right-hand diagram, the elements that are contained only in the right-hand diagram are highlighted.

  2. To determine changed elements (in terms of content), activate the display of logical changes and highlight only the changed elements.

    In the diagrams, elements that have changed with regard to property content are highlighted.

  3. To highlight moved elements in the diagram, activate the display of graphical changes and highlight only the changed elements.

    The elements in the diagrams that have coordinate changes are highlighted.

  4. To highlight elements that have been removed from the diagram, activate the display of graphical and/or logical changes and highlight only the left-hand singles.

    In the left-hand diagram, the elements that are no longer contained in the right-hand diagram are highlighted. They can be removed from the diagram or deleted from the model.

Navigate to Elements

Prerequisites

The Open Comparison Window command has been called in the Align Models editor for a diagram selected in a hierarchy area that is not a single.

Context

The following assumes that you wish to get more information about certain selected elements in the comparison window.

How to proceed

  1. To navigate to occurrences of an element in a diagram, select  Go to>Occurrences in Diagrams... (Ctrl+Enter) in the context menu and select the diagram you require in the Occurrences in Diagrams...dialog for multiple occurrences.

    The element is selected in the diagram.

  2. To navigate to an element in the model structure, select  Go to>Location in Model Structure (Ctrl+M) from the context menu.

    The element is selected in the model structure

  3. To navigate to an element in the Compare result of the Align Models editor, select  Go to Compare result (Ctrl+D) from the context menu.

    The element is selected in the Compare result.