Contents > 4 The SDMetrics User Interface > 4.16 Setting Preferences > 4.16.1 Project File Sets

4.16.1 Project File Sets

SDMetrics maintains a list of project file sets (see Section 4.2.1 "Specifying Project Files"). Each project file set contains one XMI transformation file (for a specific XMI version and possibly a specific XMI exporter), one metamodel definition file, and one metric definition file.

When SDMetrics analyzes an XMI file, it retrieves the XMI version from the file, as well as the name and version of the XMI exporter that created the file. SDMetrics then selects from the list of available project file sets the one that best matches the specification of the XMI file at hand.

If you downloaded updated project files from the SDMetrics web site www.sdmetrics.com, or wrote your own project files, and want to use these files by default, you can define new project file sets or change the existing ones. That way, you do not have to specify your custom project files over and over again in the project settings dialog.

Open the preferences dialog and select the tab sheet "Project File Sets":

Project File Settings Dialog
Figure 25: Project File Set Preferences

The tab sheet shows a list of all available project file sets. You can add, modify, copy, and delete entries from the list.

To add a new project file set, click the "New..." button. This opens an editor where you can specify the project file set:

Project File Set
Figure 26: Project File Set Editor

The parameters of a project file set are as follows:

To edit an existing project file set, double-click its entry on the list, or select the entry and click the "Edit..." button. This opens the editor window where you can modify the details.

To copy the settings of an existing project file set, select its entry on the list and then click the "Copy" button. This opens the editor window where you can modify the details. When you close the editor window with the "OK" button, a new entry with the modified settings will be added to the list; the originally selected entry remains unchanged.

To delete an entry from the list, select the entry and click the "Delete" button.

Default project file sets

SDMetrics ships with three default project file sets for the various versions of the UML and XMI:

These default project file sets cover all versions of the XMI currently in use. These project file sets cannot be renamed or deleted from the list, and you cannot modify their XMI version and XMI exporter name/version settings (the latter two being empty - no specific exporter). This is to ensure that SDMetrics always finds a suitable project file set. However, it is easy to override the default project file sets: Resetting default project file sets

The "Restore..." button resets the default project file sets to the "factory settings", that is, the default XMI transformations and associated metamodel and metric definition files that originally ship with SDMetrics.

This feature is useful if you moved the SDMetrics installation directory. After the move, SDMetrics keeps looking for the project files in the old location; with this feature you can quickly reset the file paths to the new location of the installation directory.

Note that your custom project file sets will remain unaffected by this operation.