Book a Demo

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

Prev Next

Offline Version Control

When loading a model that uses Version Control, Enterprise Architect normally initializes a connection to the Version Control system for each Version Control configuration defined in the model. If Enterprise Architect is unable to connect a Version Control configuration for any reason, it displays warning messages to notify you and provides offline Version Control functionality for all Packages associated with the failed connection.

You can prevent Enterprise Architect from starting to make any Version Control connections, by selecting to work offline before loading your model.



Configure > Version Control > Work Offline

Working Offline



See also

Choosing to Work Offline

Selecting to work offline is useful if you know beforehand that Enterprise Architect cannot connect to your Version Control system. For example: If you are working on a laptop computer that is disconnected from your network, on an Enterprise Architect model that uses a large number of Version Control configurations, you can select to work offline before you load the model to avoid all the error messages that the system would normally display as each Version Control connection attempt failed.

You can switch between working offline and working online at any time, either before or after a model is loaded, by toggling the 'Work Offline' menu option. Enterprise Architect disconnects or reconnects Version Control (depending on the connection availability) according to your selection.

Using Version Control Whilst Disconnected From the Version Control Server

Enterprise Architect 'remembers' the status of a model’s Version Controlled Packages. Packages that were checked out to you prior to disconnecting from the server are still shown as checked out to you, even though you are no longer connected to the server. You can still edit these Packages as you normally would.

Packages that were not checked out to you prior to disconnecting from the server are shown as Version Controlled and locked. You cannot edit these Packages until you check them out.

Offline Check Out

You can 'check-out' and edit a Version Controlled Package even when your machine is disconnected from the Version Control server. In this example, the colored 'figure 8' icon for DFD indicates that you have checked it out whilst off line.

The red checkout overlay icon indicates that the package was checked out of version control whilst off line. In Sparx Systems Enterprise Architect.

(The gray 'figure 8' icon shown against Logical View indicates that you have checked out a Version Controlled Package on line.)

You should be aware that the Version Control system, and therefore other users, have no way of knowing that you have 'checked-out' a Package whilst offline. It is not possible to merge changes to an XMI file that result from two users editing the same Package at the same time. If an offline checkout leads to two people editing the same Package at the same time, when the changes are brought back online the first-saved set of changes is lost.

Browser Window Indicators

Checking In a Package That Was Checked Out Offline

Once you reconnect your system to the Version Control server, if the Package you checked out offline is not currently checked out by another user, you can check in that Package. However, before Enterprise Architect checks in the Package, it compares the local working copy of the Package file with the latest revision in the repository. (These Package files remain unchanged in your work area until Enterprise Architect exports the Package again before checking in.) If the repository version remains unchanged from when you last updated your local copy, Enterprise Architect exports and checks in your Package without further prompting.

On the other hand, if the repository now contains a file that has changed since you last updated your local copy, checking in your Package would overwrite those changes. Enterprise Architect displays a message warning you of the pending data loss and giving you the opportunity to abort the check in. At this point, you must decide whether to discard your own changes, using the 'Undo Check Out' command, or continue with your check in and overwrite the changes that have been committed to the repository since you last updated your local copy from the repository.

You can use the 'File Properties' command to determine who checked in the last changes to this Package. This might help you to discover what changes have been uploaded and decide whose changes take precedence.

Package Version Control Options

Update Before You Disconnect

Whenever you are connected to the Version Control server, you are always working with the latest version of a Package. This is because you cannot modify a Package until you check it out from Version Control, and checking it out loads the latest revision from the repository into your model.

This cannot happen when you are disconnected from the Version Control server. You are working on whatever versions you have on your machine, dating back to the last time you updated your local copy of each Version Controlled Package. So, if you are planning to work on a model whilst disconnected from Version Control, it is a very good idea to make sure that you have the latest versions of all Packages before you disconnect. The 'Get All Latest' option makes this a simple task.

Package Version Control Options