Object Model Integrity

To ensure the integrity of all data within the Capital database, the system can validate the integrity of data object models (for example: components, designs, nets, and so on) automatically as, and when, you make changes.

Any validation errors appear in a warning dialog box and the event log. The action that triggered the validation aborts, removing the possibility that the system can write the invalid object model 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 occurs.

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

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

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

You can add a number of optional arguments 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 continues.

true - if a validation failure has been detected, validation stops.

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

true - if a validation failure has been detected, validation occurs on export operations.

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

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

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

true - when the validation level is set to LOW, any exception encountered triggers a validation at level HIGH. Note You can add none, any, or all of the optional attributes to the validation level statement, with each attribute separated by a space.

Parent Topic:

Overview

Capital Systems Integrator User Guide, 2512.2606

Unpublished work. © 2026 Siemens