Support Configuration Files
- Last UpdatedNov 13, 2023
- 3 minute read
By default, support configuration files are read from the default path which is the installation directory. The default path can be overwritten by setting the environment variable MDS_SUPPORT_CONFIG_LOCATION.
The standard support configuration file is named SupportConfigurationFile.xml. Multiple support configuration files are supported.
New support catalogs must follow a defined folder path:
%MDS_SUPPORT_CONFIG_LOCATION%userSupportConfiguration\Configuration-<MDU DB CODE>\plots
A folder named userSupportConfiguration must be added to the %MDS_SUPPORT_CONFIG_LOCATION% path.
All configuration information, for example, image files, the support configuration xml file and any other files specific to that support configuration must be stored in a unique configuration specific folder. This folder uses the naming convention Configuration-<MDU DB CODE>.
Plot files must be stored in the plots folder which is located in the configuration specific folder.
Specific naming conventions must be used, if the internally referenced MDU DB CODE is A, the naming convention is:
|
Configuration specific folder |
Configuration-A |
|
Support configuration file |
SupportConfiguration-A.xml |
|
Folder for configuration specific plot files |
plots |
|
Image names & plot file names |
Same naming convention as existing support standards. |
For example, if the %MDS_SUPPORT_CONFIG_LOCATION% is configured to a folder other than the installation directory, the default configuration xml file (SupportConfiguration.xml) must be located alongside the userSupportConfiguration folder. In the example, the %MDS_SUPPORT_CONFIG_LOCATION% folder is D:\localSupportConfigurations\.

The userSupportConfiguration folder contains a folder for each specific configuration.

The configuration specific folder contains the plots folder, image files and the support configuration file.

The plots folder contains the plot files.

A new support catalog that uses the key letter K may require a separate support configuration file, named SupportConfigurationFile-K.xml. The new support configuration file is stored in the configuration specific folder.

The DimensionsControlConfiguration id value, in the support configuration file, can be set to the defined key letter. For example:
<DimensionControlConfiguration id="K">

Mapping and representation for a specific support type can be defined. For example, AT510 and AT03.
For mapping name "AT510", the image id is "at510". The application searches for the image named at510.png. The image is stored in the same path as the support configuration file.
For mapping name "AT03", the image id is "at03". An image file is not found, the application uses the support standard image.
If an external image or a support standard image is not found, a blank image displays.