Version Control Settings

As part of the process of setting up a version control configuration on your model, or updating an existing version control configuration, you define a number of settings that control how the status of your model is communicated to your version control system. You define these settings using the Version Control Settings dialog.

Access    Project | Version Control | Version Control Settings     or
Right-click on any package node | Package Control | Version Control Settings

Configuration Options

Field/Button

Action

See also

This model is private

Select to specify that this model database is to be accessed by just a single user
(Private Model).

Leave unselected (the default) or deselect to specify that the database is to be accessed by multiple concurrent users (Shared Model).

If in doubt, use the default setting.

 

Version Control Usage

Save nested version controlled packages to stubs only

Select to specify that the exported XMI file for a version controlled package will contain package stubs (place holders) for nested version controlled child packages (recommended).

Deselect to specify that the exported XMI file will contain the full content of nested version controlled child packages.

 

 

For all packages, create placeholders for external references

Select to force all XMI 1.1 imports across the model to exclude incoming relationships and instead create external references.

If the Create placeholders for missing External References during XMI 1.1/2.1 Import checkbox is not selected in the XML Specifications options for a user, this field overrides that setting.

 

 

 

XML Specifications

Unique ID

Specify a name that uniquely identifies the configuration. Either:

Type a name to identify a new configuration, or
Click on the drop-down arrow and select the name of a configuration previously defined in a different project (if any exist)
 

 

Type

Click on the appropriate radio button for the type of version control system you are associating with this configuration.

The middle section of the dialog changes to display a collection of fields relating to the type of version control configuration you are defining.

Set the type to SCC for:

MS Visual Source Safe
Rational Clear Case
Perforce
AccuRev
Any other SCC-compatible clients

 

For any other product that you are using, select the type that matches the product  - CVS, Subversion or TFS.

 

 

 

 

 
SCC Settings

 

 

 

 

CVS Settings

SVN Settings

TFS Settings

New

Click on this button to clear the fields and create a new version control configuration.

 

 

Save

Click on this button to save the details of a new or updated configuration.

 

 

Delete

Click on an entry in the Defined Configurations list and click this button to remove the definition of the selected configuration from this model.

 

 

Defined Configurations

Review a list of configurations that are in use in the current model.

 

 

In future, do not prompt for incomplete configurations

Select to specify that the user is not prompted to complete the definition of  configurations that are not fully specified (the default).

Deselect to prompt the user to complete configurations that are not fully defined.

 

 

Close

Close the Version Control Settings dialog.

 

 

Help

Display this Help topic.

 

 

Notes

It is important that, for any given version controlled package file, any user accessing that file from any model uses version control configurations having the same Unique ID
When you first open a model that was created by another user and that uses version control, the version control configuration(s) used by that model do not yet exist in your Windows registry settings; you need to complete the definitions of those configurations before you can use version control in that project
If User Security is enabled, you must have Configure Version Control permission to set up version control options for the current model
It is possible to use multiple version control configurations in the same model

Learn more