Please note : This help page is not for the latest version of Enterprise Architect. The latest help can be found here.
Check Visual Changes to Diagrams
The Baseline Diagram Compare feature is a quick and easy way to visually compare a current diagram with an earlier version from a saved Baseline, and highlight any elements in the diagram that have been added, deleted, resized or moved.
You can then review these changes and optionally roll back each change if needed to its previous state from the Baseline.
The changes are identified on the 'Baseline Diagram Compare' dialog and on the diagram itself. If the diagram is not already open, the compare feature also opens the diagram.
Access Any of these options:
- Project Browser | Right-click on Package | Package Control | Package Baselines | <select baseline> : Show Differences | Locate and right-click on diagram name | Compare to Baseline
- Click on a Package | (Main Menu) Package | Baselines | <select baseline>: Show Differences | Locate and right-click on diagram name | Compare to Baseline
- Project Browser | Right-click on diagram name | Compare Diagram to Baseline
- Right-click on open Diagram | Advanced | Compare Diagram to Baseline
Processing
In the first two access paths, you perform a comparison of a Package and Baseline, and then select the diagram from the results on the 'Baseline Comparison dialog' to display the 'Baseline Diagram Compare' dialog. Refer to the Results section and the Options table.
In the last pair of access paths, you first select the diagram to check, and then might have the option of selecting the Package from which to use a Baseline, on the 'Load Baselines from Package' dialog.
This dialog displays if you have NOT selected the:
- 'Always open first parent with a Baseline' checkbox on the dialog itself or
- 'Baseline Diagram Compare Options' checkbox on the 'Compare Options' dialog
(Selecting or clearing one of these checkboxes resets the other one as well.)
When you create a Baseline, it can be for a Package that contains one or more levels of child Package, and you might create Baselines for the Package(s) at each level. If the diagram you are checking is at a lower level in the hierarchy, there might therefore be a number of Baselines that contain information on the diagram, perhaps taken at different times and capturing different changes to the diagram. The 'Load Baselines from Package' dialog provides the facility to compare the diagram with one of a broader range of Baselines than just those from the diagram's immediate parent.
Click on the Package, and click on the . In this case, or if the dialog did not display at all (the checkboxes were selected), the 'Baselines dialog displays.
Click on the required Baseline and on the . The 'Baseline Diagram Compare' dialog displays. Refer to the Results section and the Options table.
Results
The 'Baseline Diagram Compare dialog shows the elements that have been changed on the diagram, and what kind of change (Status) was made.
As you select elements on the dialog, images are shown on the diagram itself to indicate where the changed element was and what kind of change it underwent.
Options
Option |
Detail |
See also |
---|---|---|
Select (click on) name of element |
The 'Status' column indicates whether the element has been:
When an item is selected, the corresponding element on the diagram is highlighted as shown:
The highlighted element on the diagram is marked with a colored dot, as shown, to indicate that it is in focus. |
|
Position the diagram to show the selected element |
To scroll the diagram so that you can see the original (Baseline) position of an element, double-click on the item in the list. To scroll the diagram so that you can see the current (model) position of the element, press and hold while you double-click on the item. |
|
Leave the changes in the item as they are |
Ensure that the checkbox against the item is not selected. Click on the . |
|
Roll the changes back to the Baseline position |
Click on the checkbox against each required item (or click on the to select every item). The 'Action' column displays the action required to roll each element's relationship to the diagram back to the Baseline relationship, and on the diagram the selected elements are represented as shown:
The comparison automatically shows a blue direction arrow for each reposition or resize that has been checked. For a heavily edited diagram this might be confusing. However, you can hide the arrow for all elements except the one currently in focus; to do this:
To roll back the changes for all items for which a checkbox is selected:
|
Notes
- Diagram Baseline facilities are available in the Corporate, Business and Software Engineering, Systems Engineering and Ultimate editions of Enterprise Architect
Learn more