Object Model Integrity

To ensure the integrity of all data within the Capital database, the integrity of data object models (for example: components, designs and so on) can be automatically validated as and when changes are made. Any validation errors will be reported in a warning dialog and written to the event log, and the action that triggered the validation will be aborted, removing the possibility that the invalid object model can be written to the database, possibly resulting in data corruption.

The level of validation is specified in the clientprops.xml file, located in the config sub-directory of your Capital install directory.

The following line sets the level of validation:

Copy

<validation level="VALUE"/>

Replace VALUE with one of the following options:

• NONE - no validation will be performed.

• LOW - validation will be performed on import, save and design generation. Otherwise, no validation will be performed unless an exception is raised, in which case validation will then also be performed on export and load.

• MEDIUM - validation will be performed on import, export, load, save and design generation. Otherwise, no validation will be performed unless an exception is raised, in which case validation will then also be performed on object modification.

• HIGH - validation will be performed on load, save, import, export, design generation and object modification.

A number of optional arguments can be added to the validation level statement in the form:

Copy

<validation level="HIGH" failureStopsExportValidation="true" exceptionIncreasesLevel="true" 
exceptionTriggersValidation="true"/>

replacing attribute name with one of the following attributes:

• failureStopsValidation false - if a validation failure has been detected, validation will continue to be performed.

true - if a validation failure has been detected, validation will no longer be performed.

• failureStopsExportValidation false - if a validation failure has been detected, validation will not be performed on export operations, thus allowing customers to export projects with invalid data to us.

true - if a validation failure has been detected, validation will be performed on export operations.

• exceptionIncreasesLevel false - if an exception has been raised anywhere in the code, the validation level will remain the same.

true - if an exception has been raised anywhere in the code, the validation level will be increased once (from LOW to MEDIUM, or MEDIUM to HIGH).

• exceptionTriggersValidation false - when the validation is set to LOW, any exceptions will not force a validation.

true - when the validation level is set to LOW, any exception encountered will trigger a validation at level HIGH. Note None, any or all of the optional attributes can be added to the validation level statement, with each attribute being separated by a space.

Parent Topic:

Overview

Capital Systems Modeler User Guide, 2512.2606

Unpublished work. © 2026 Siemens