Astah User's Guide

Merge


Options for Merge

There are two levels of merge. One is relatively simple. When there are conflicts between two projects, Astah imports the contents of the one project to another.

  1. Open an .asta file you want to merge.
  2. Go to [File] - [Merge Project...].
  3. Select another .asta file to merge.
  4. Choose which file to prioritize, and click [OK]. Then when there are conflicts, models in the .file you select will overwrite the other.
    astah merge

Detail Merge

Another way is to merge two projects by choosing which model should overwrite to the other by looking at the conflict list.

  1. Go to [File] - [Merge Project...].
  2. Select file to merge.
  3. Click [Detail] button to open another window.
    astah merge

Merge Window


astah merge

Left pane: Conflict tree

The differences between the working Project and the importing Project are displayed in the Conflict Tree.


IconDescription
only_workingThis indicates that these diagrams/models exist only in the working Project.
only_workingThis indicates that these diagram/models exist only in the compared Project.
only_workingThis indicates that these diagrams/models exist in both Projects.


Filterling

Since version 8.2, two filtering options are available. By checking off the [Show differences in presentation attributes], any models with presentation-changes only such as color changes and subtle re-locations will be removed from the list, so you can see the list of models that were actually modified.

astah merge

Show Diagram Difference Astah Professional

You can compare two diagrams visually by clicking [Show Diagram Difference] button.

astah merge

This pulls out a new window to show two diagrams side by side with conflicted models marked.
You can filter the marks by the type of change such as "Added", "Deleted" and "Modified".
astah merge

Filtering option

You can check "Hide differences in appearance" option to filter out the models with presentation-change only such as color change or subtle re-location.

astah merge

Merge Method

Merge Methods can be chosen for each Model selected in the Tree. If multiple Models, whose Merge Method options differ, are selected in the Conflict Tree, all the options are displayed.

astah merge

  • Ignore importing Models
    If this option is selected, importing models are not included in the merged Project.
  • Replacing with importing Models
    If the importing Project is empty, the merged Models will be deleted. After merging, Models are replaced with those in the merged Project. If the importing project is empty, all Models will be deleted
  • Merge - Using this option
    Elements that exist only in either the working Project or the importing Project are merged. For other Elements, the working Project is prioritized.
  • Merge - Prefer the Importing Project
    Using this option, Elements that exist only in either the working Project or the importing Project are merged. For other Elements, the importing Project is prioritized.
  • Free Selection for each Element
    Using this option, Elements are merged according to the selection in the checkbox [Keep Elements in the Working] in the Conflict List.

Restrictions

  1. It is not possible to merge the contents of:
    Sequence Diagrams, Communication Diagrams, Statemachine Diagrams, Activity Diagrams, Flowcharts, Data Flow Diagrams, CRUDs and Mindmaps. So you will have to select either the working Diagram or the importing Diagram.
  2. Sequence Diagrams, Communication Diagrams, Statemachine Diagrams, Activity Diagrams, Flowcharts, Data Flow Diagrams, CRUDs and Mindmaps are always displayed in the Conflict Dialog even if there is no change.