Configuring Property Rules¶
Property rules define the logical relationships between different model properties (attributes and measurement points) through property expressions, mapping the property values of a single model or multiple models. Using property rules can reduce the repetitive mapping of measurement point data during secondary integration and simplify data processing in scenarios without a model, thereby improving data management efficiency.
For example, you can define property rules in the following scenarios:
Data mapping across model properties. For instance, the “total power generation” measurement point in a “wind farm” model is the sum of the “current power generation” data from all wind turbine devices within the wind farm. You can set this in the property rule as
Wind Farm. Total Power Generation = sum(Wind Turbines. Current Power Generation).Mismatch between raw device data and model property definitions. For example, the raw data format or units provided by a device may not match the model’s requirements, necessitating transformation and mapping through property rules.
Dynamic calculation of model properties based on multiple raw data measurement points. For example, the “range efficiency” measurement point in a car model may need to be calculated using the “maximum range” and “battery capacity” data. You can set this property rule as
Range Efficiency = Max Range / Battery Capacity.
This file explains how to configure property rules for models. Property rules mainly include the following two types:
Default Rules: If only the properties of the current model are referenced as parameters in the expression, configure single-model property expressions in default rules.
Custom Rules: If properties of other models need to be referenced as parameters in the expression, a new rule must be created to configure cross-model property expressions.
Prerequisites¶
You need permission to edit models. If you don’t have the permissions, contact your OU administrator for access. For more information, refer to Model Management Permission Allocation.
Creating Rules¶
If elements of other models need to be referenced as parameters in the expression, a new rule must be created to configure cross-model property expressions.
In the Application Portal’s Developer Console, go to the Models page.
In the Models Created in This OU or Shared Models tab, select Edit to enter the configuration page for the target model.
Note
When editing model elements of a shared model, you need to click the
Custom Configuration button in the top-left corner to switch to the custom configuration interface before making changes. The effective configuration of a shared model = custom configuration + unchanged parts of the original configuration.
3. Select New Rule, then configure the basic information in the pop-up window according to the following rules, and click OK when done.
Name: The name of the rule.
Mapping Model: Select Click to check models in the popup.
If the current model is not inherited from another model, any model can be selected as the mapping model.
If the current model is inherited from another model, only the inherited parent model can be selected as the mapping model.
Description: A description of the rule.
Configuring Rules¶
On the Property Rules page within the model details, select the
Configure button on the right of the target rule.Configure Default Property Rules: Reference only the elements of the current model as parameters in the expression.
Create Property Rules: Reference elements of other models as parameters in the expression.
On the rule configuration page, select the
Configure Expression button on the right of the target model element.In the pop-up window, refer to the following details to select parameters, aggregation methods, and configure expressions, and then click OK when done:
Configuration Item |
Configuration Reference |
|---|---|
Parameters |
|
Aggregation Methods |
|