Please note : This help page is not for the latest version of Enterprise Architect. The latest help can be found here.

Prev Next

Configure Controlled Package

Once your version control application is set up and you have version control configurations in place, you can place the individual Packages in your model under version control. To put a Package under version control, you:

  • Flag the Package as a controlled Package
  • Specify the version control configuration to control it and
  • Associate an XMI file with the Package

You can then export and import the Package data to and from the file and issue commands to the version control system.



Configure > Version Control > Configure Package

Context Menu

Right-click on Package > Package Control > Configure

Keyboard Shortcuts


Apply version control to a single Package



See also


Click on the 'Control Package' checkbox to select it, indicating that this Package is to be controlled.


Click on the Version Control drop-down arrow and select the version control configuration to be used to control this Package.


The 'XMI Filename' field displays a default filename for the Package export file, based on the Package name.

Optionally, modify the filename. Either:

  • Type a new name, or
  • Click on the button to open a file selection dialog

The target file must be located within the working copy folder of the selected version control configuration, or one of its sub-folders.


The 'Version ID' field defaults to '1.0'.

Optionally, change this to a different version number.


The 'Owner' field defaults to your user name.

Optionally, type or select the name of the user who actually owns the Package.


Click on the OK button.

The 'Add Package to Version Control' dialog displays.


Optionally, clear the 'Keep checked out' checkbox.

After applying version control, the Package either remains checked-out for editing, or is checked-in and locked against editing, depending on this setting.


Click on the OK button.

The 'Add Comment' dialog displays.


Optionally, add any further comments to the default comment.

Enterprise Architect provides a default comment that includes the current date & time.


Click on the OK button.

The current Package is exported to the nominated XMI file, which is then committed to version control. The Package icon in the Project Browser is updated to reflect the Package's version control status.

Project Browser Indicators


  • If you are using the Corporate or extended editions of Enterprise Architect with security enabled, these features are only available to users who have been granted permission to configure and use version control

Learn more