Restrictions
Restrictions allow you to define constraints on configuration properties to prevent invalid or out-of-range values during product configuration. The system supports two types of restrictions: property-based filters and expression-based restrictions.
Property-Based Restrictions
Property-based restrictions validate the standard configuration properties (length, width, height, weight, and units) against defined filter criteria. The Validation Type determines the system behavior when a value falls outside the allowed range:
- Error — Blocks the configuration and displays an error message. The user cannot proceed until the value is corrected.
- Warning — Displays a warning message but allows the user to continue with the configuration.
Fields and Options
| Field | Description |
|---|---|
| Validation Type | Determines whether the restriction triggers an Error (blocks configuration) or a Warning (allows continuation). |
| Length Filter | Filter expression for the allowed length range. |
| Width Filter | Filter expression for the allowed width range. |
| Height Filter | Filter expression for the allowed height range. |
| Weight Filter | Filter expression for the allowed weight range. |
| Unit Filter | Filter expression for the allowed unit (quantity) range. |
Expression-Based Restrictions
Expression-based restrictions use calculation expressions that are evaluated during configuration. When the expression evaluates to a non-zero result, the restriction is triggered.
| Field | Description |
|---|---|
| Validation Type | Determines whether the restriction triggers an Error or a Warning. |
| Calculation Expr | The calculation expression that defines the restriction condition. Supports properties, variables, and mathematical operators. |
| Message to Display | The message shown to the user when the restriction is triggered. |
Filter Criteria Reference
The following filter operators are supported for property-based restrictions:
| Filter | Description | Example |
|---|---|---|
| Interval | All values from start to end value. | 1000..2000 |
| Either/Or | Records matching either value. | 1000\|2000 |
| Not equal | All records not equal to the value. | <>1000 |
| Greater than | All records greater than the value. | >1000 |
| Less than | All records less than the value. | <1000 |
| Greater or equal | All records greater than or equal to the value. | >=1000 |
| Less or equal | All records less than or equal to the value. | <=1000 |
| Logical AND | Records matching both conditions. | >1000&<2000 |
How to Create Restrictions
- Choose the
icon, enter BOM Calculation Template List, and then choose the related link. - Open the BOM Calculation Template to edit.
- In the action bar, choose the Restrictions action for property-based restrictions, or Expression Restrictions for expression-based restrictions.
- Choose New to create a new restriction line.
- Set the Validation Type to Error or Warning.
- Enter the filter criteria or calculation expression and, for expression-based restrictions, the message to display.
Example
To ensure the configured length is between 500 and 3000 mm, set:
- Validation Type: Error
- Length Filter:
>=500&<=3000
If a user enters a length of 400, the system blocks the configuration with an error message.
Tip
Use the Test Calculation function to verify that your restrictions work as expected before releasing a template version.
Note
Restrictions can only be edited on draft versions (no version code). Versioned templates display restrictions in read-only mode.