Check Out a Package

When you need to work on a version controlled Package, you check it out. The local XMI file associated with the Package is then checked-out from version control. No other user can check out the Package to make changes to it until it has been checked in again.

Access

Context Menu	Right-click on Package > Package Control > Check Out
Keyboard Shortcuts	Ctrl+Alt+L

Check out a single Package

The Package file is imported into your model, and the 'Package' icon is updated to reflect the change in the Package's version control status.

When working in a Private Model, if the system detects that the Package content in the model is already up to date with the latest revision of the Package file retrieved from version control, then the 'Import Package' dialog displays first. This dialog is not displayed for a Shared Model.

These options are available:

Force Reload From XMI - reload the Package from XMI regardless of whether it is up to date or not
Accept current package - select to skip the process of re-importing the Package from XMI
Refresh model view - select to refresh the Project Browser and diagrams, by reloading the Package content from the project database
Always use these settings - when selected, if you subsequently check out a Package that is found to be up to date, the same settings are applied again without displaying the dialog

Notes

If you check out a version controlled Package whilst offline, the 'Package' icon has a red figure 8 in front of it
If you have selected the 'Always use these settings' checkbox and you want to reconfigure the 'Import Package' dialog, press the Ctrl key whilst you select the 'Package Control | Check Out' context menu option; the dialog displays and you can change the settings

Learn more