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":

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:

Figure 26: Project File Set Editor
The parameters of a project file set are as follows:
- Name of entry: The name of the project file set.
- XMI Transformation File: The location of the XMI
transformation file of this project file set. Enter the file name
in the text field, or use the
"Browse..." button to locate the file via a file chooser
dialog.
- XMI version number(s): The XMI version number(s) that the
XMI transformation file handles. If the XMI transformation file
handles several XMI versions, list all supported XMI version numbers
separated by semicolons, e.g. 1.1;1.2;1.3.
- Exporter:
If you created the XMI transformation file for a specific XMI
exporter, enter the name of the exporter here. Use the exact name of
the exporter as indicated in the XMI.exporter element in the
documentation section of the XMI files produced by the exporter.
Leave this field empty if the XMI transformation file is not
written for a specific exporter.
- Exporter Version(s): If you created the XMI transformation file for a
specific version of an exporter, specify the version number
here. Use the exact version number as indicated in the
XMI.exporterVersion element in the XMI files produced by the
exporter. If the XMI transformation file is suitable for several exporter
versions, list all supporter exporter version numbers, separated by
semicolons.
Leave this field empty if the XMI transformation file is not written
for a specific version of the exporter.
- Metric definition file: The location of the metric definition
file of this project file set.
Enter the file name in the text field, or use the
"Browse..." button to locate the file via a file chooser
dialog.
- Metamodel definition file: The location of the metamodel
definition file of this project file set.
Enter the file name in the text field, or use the
"Browse..." button to locate the file via a file chooser
dialog.
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:
- Default UML 1.x and XMI 1.0
- Default UML 1.x and XMI 1.1-1.3
- Default UML 2.x and XMI 2.0/2.1
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:
- When you specify a new project file set for any XMI version and no specific
XMI exporter, SDMetrics will always select your project file set over one of its
default project file sets.
- You can replace the XMI transformation, metric definition, and
metamodel definition files associated with the default project file
sets with you own.
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.