Use Version Control

Once your version control product is installed and you have created a suitable environment, Enterprise Architect can make use of that environment to control the Packages in your project. Version control provides a range of facilities, as outlined in this table.

Facilities

Facility

Detail

See also

Define Version Control Settings

Version control configurations are used by Enterprise Architect to communicate with your version control system.

You define one or more version control configurations in your project and then use those configurations to control the Packages in your project.

Version Control Setup

Configure a Package

To put a Package under version control you mark the Package as a controlled Package, specify the version control configuration to control it, and associate an XMI file with the Package.

Configure Controlled Package

Check In a Model Branch

Checks in all Packages involved in a particular unit of work, as a single operation.

Checking-in updates the reference version of a Package or group of Packages in the model.

Check In a Model Branch

Check Out a Model Branch

Checks out all Packages within a selected model branch as a single operation, so that you can update modeling objects within them.

Check Out a Model Branch

Check In a Package

Checks in the Package currently selected in the Project Browser.

Checking-in updates the reference version of a Package or group of Packages in the model.

Check In a Package

Check Out a Package

Checks out the version controlled Package currently selected in the Project Browser, so that you can update modeling objects within it.

Check Out a Package

Undo Check Out of a Package

Reverses the check-out of a Package, discarding any modifications that have been made by restoring the Package content to the latest revision held in version control.

Undo Check Out of a Package

Import a Package From Version Control

Retrieves Packages from version control that have been created by other users, or by you in another model, and imports them into your current model.

Include Other Users Packages

Apply Version Control to a Model Branch

Applies version control to all Packages within the selected model branch, in a single operation.

In this context, a model branch is a Package in the Project Browser, and all of the Packages contained within it.

Apply Version Control to Branches

Export a Version Controlled Model Branch

Exports version control information about the root Package of a model branch, that is used to simplify the process of exporting and importing a hierarchy of Packages from one model to another.

Export Controlled Model Branch

Import a Model Branch From Version Control

Uses Enterprise Architect's Model Branch files, of which there are few, to retrieve information about the root Package file and to import the model branch.

Model branch files can simplify the process of exporting and importing a hierarchy of Packages from one model to another.

Import Controlled Model Branch

View Package Revision History

Displays the change history of version controlled Packages.

You can also check out a prior revision of the Package for editing, effectively rolling-back to a prior revision of the Package.

Review Package History

Validate Package Configurations

You can test the validity of the version control settings associated with each version controlled Package within your current model.

Validate Package Configurations

Resynchronize the Status of Version Controlled Packages

Re-synchronizes the version control status of Packages within your project with the status reported by your version control provider.

Resynchronize Package Status

Notes

  • Database replication should not be combined with version controlled Packages
  • If the Packages under version control contain any alternative images, you can export the images to the version control repository when you check in the Packages, by setting the 'Export alternate images' option on the 'Options' dialog

Learn more