Reference Model Management

This feature connects multiple files and lets multiple users to work on the diagram at the same time. When any change is made in one diagram, the change will be visible in other diagrams for all the other users.

Demo Video

If the video does not play, please click here.

section divider

Import reference model

  1. Go to [File] – [Reference Model Management].
    Reference Model Management

  2. [Reference Model Management] dialog comes up, click [Add].
    Reference Model Management

  3. Select the Path Type (Absolute Path or Relative Path) then select the project file to import.
    Reference Model Management

  4. A file is added and the status says “Latest”.
    Reference Model Management

    The models you added will be read-only.
    Read-only models
section divider

When the reference model is updated

When the reference model has been updated with someone else, you will get the window below when you open a project.
Warning when a reference model is updated

Click [OK] to go next and update.
Reference Model Management

section divider

Update Reference project using Commandline

You can update the reference model by using .bat and .sh files.

Updates Certain Reference Models based on Time Stamp

By using “update-all” with the specified directory, you are able to update all the .asta files which are stored in the specified directory and are not updated yet in Astah. The command-line tool checks whether they needed to be updated or not by the time stamp that the file contains. However by using “use-builtin-timestamp” or “ubt”, you can find .asta files to be updated based on the timestamp which the project has.


call astah-run.bat "astah_directory_path" update-all
call astah-run.bat "C:\\Program Files\\astah-professional" update-all

Mac/Linux "astah_directory_path" update-all
e.g. "/home/tanaka/astah-professional" update-all
  • You can find “astah-run.bat” or “” in Astah Installation folder.
  • It exports log files as yyyyMMdd_HHmm_astah_convert_command.log in the directory.

Update all Reference Models

Use the following commands to update all the reference models in all *.asta files inside the selected directory.


call astah-run.bat "asta_directory_path" update-all-force
call astah-run.bat "C:\\Program Files\\astah-professional" update-all-force

Linux "astah_directory_path" update-all-force
e.g. "/home/tanaka/astah-professional" update-all-force
section divider


You can configure some detailed settings regarding the reference model management features from [Tools] – [System Properties].
System Properties