Import Controlled Model Branch

Applying version control to a model can result in many XMI files placed under version control. It could then be hard to locate and import the file corresponding to the root of a particular model branch, if you want to:

  • Retrieve a model branch created by another user in a private copy of a model, to import it into your own private copy of the same model
  • Retrieve a model branch that is common in many models, for inclusion in a new model

Model Branch Files overcome this problem by simplifying the retrieval of Package hierarchies for use in other models. You use Enterprise Architect's Model Branch Files, of which there are few, to retrieve information about the root Package file such as the name and type of the version control configuration for the selected Package, and the relative filename of the version controlled XMI file associated with the Package. The system then uses this information to import the branch into your model.


Before you begin, you must have:

  • An operational version control environment that can be accessed by Enterprise Architect, and
  • All of the version controlled Package files and the model branch file associated with the model branch to import, in a valid and accessible working copy folder

Access Project Browser | right-click on target Package for import | Package Control | Import a Model Branch

Import a Model Branch



See also


On the 'Import VC Model Branch' dialog, either:

  • Use the lower portion of the dialog to select a model branch file (this is the simpler option if the associated version control configuration has already been saved in the current model; continue to step 2)
  • Click on the Find a Model Branch (.EAB) file button (this option is useful when you have not yet defined the version control configuration that is associated with the model branch to be imported; see the Manually Locating Model Branch Files topic)

Manually Locating Model Branch Files


Click on the drop-down arrow in the 'Select a Version Control Configuration' field and select a configuration.

A list of .eab files controlled by that configuration is displayed in the 'Select a Model Branch (.EAB) file' list.


Select the Model Branch File you need, then click on the OK button.

The system imports the root Package specified in the Model Branch File and recursively imports and populates all the sub-Packages contained in the root Package.


  • The Import a Model Branch command is only enabled for Packages that you (the current user) are able to edit, as the imported model branch is inserted into the model under your selected Package

Learn more