跳至主要内容

3.3 Rule Library

Provides users with a diagnostic rule template library containing both built-in and customer-defined rules. All rules are configured according to HVAC templates.

Built-in Rules:

  • Built-in rules (currently used for energy efficiency evaluation reports) cannot be deleted or modified.
  • To use built-in rules, duplicate them via the copy icon and then modify the copies.

Custom Rules:

Custom rules support two creation methods:

Method 1 - Manual Creation

  • Click the add button to enter the rule creation page and manually define templates.

Method 2 - Excel Import/Export

  • Click the export and import icons to execute operations.
  • For imports, first download the template, complete all fields according to the template specifications, then import the file.
  • Custom rules can be edited or deleted after creation.

Rule Library

3.3.1 Add/Edit Rule Template

The creation page and editing page share identical content layouts. The following figure illustrates each field's purpose:

Add/Edit Rule Template

Key Notes:

FieldDescription
Rule LevelSystem-level and device-level are built-in. Users may add other levels.
Rule TypeBuilt-in types: "Peak, Shoulder and Off-Peak Diagnosis", "Efficiency Diagnosis", and "Temperature Difference Diagnosis". Users may add custom types.
Diagnosis CycleSupports "real-time", "hourly", "daily", and "monthly" cycles.
Delay TimeRepresents the duration during which the diagnostic rule conditions are continuously met, and it is applicable only to "Real-time" cycles.

Example: For a real-time diagnosis cycle with 60s delay time, the rule will trigger only if conditions are consistently met for the entire 60s period. If the conditions are not met at any point during the 60s calculation, the diagnostic rule will not be triggered.

Delay time does not apply to hourly/daily/monthly diagnostic cycles.
Target ObjectThe target object is relative to HVAC templates in APM's [Template Management]. The dropdown list only displays template types beginning with "hvac_" and their associated subtemplates.

Once configured here, rules applied to energy stations in the [Rule Configuration] section will automatically propagate to all nodes using matching templates within the asset group.
Data ItemsUsed to select parameters required for the rule formula. Only parameters from the current node can be selected here, meaning only those included in the target object template's components.

Common components in APM:
EdgeInput - An edge input component, where all parameters are collected and uploaded from the edge.
UsageAnalysis - A usage analysis component for calculating data such as power consumption, cooling and heating capacity.
ANOM - A mean value component used to compute the average of selected parameters over a specified period.
DeviceStatusMeasure - A device status component for tracking runtime under different states and recording the latest status.

Click the add button to add additional data items.

Data Items Default

Data Items Selection
Rule FormulaBased on the selected data items, construct the calculation formula using the supported operators.

Note: The unit in the rule formula is primarily for user reference, as the threshold values entered in the diagnostic details are unitless.

Example: If the unit in the rule formula is set to %, a threshold written as [30,50) means ≥ 30% and <50%.

Rule Formula Default

Rule Formula Operators

Rule Formula Units
Diagnosis DetailsDiagnosis details consist of four components: criteria, thresholds, diagnosis results, and recommended actions.

1. Criteria (Required Field): Text description (maximum 20 Chinese characters).

2. Thresholds (Required Field):
   • Single-range threshold: Use open/closed intervals. Example: (0, 10) = >0 and <10, [10, 30] = ≥10 and ≤30.
   • Single-value threshold: For a value of 100, enter [100, 100].
   • Multiple threshold ranges for one criterion: Separate threshold ranges with semicolons. Example: "(-,30);(30,-)" means the criterion, diagnosis results, and recommended actions are the same when the value ≠ 30).

3. Each diagnostic criterion is configured as a single entry containing: diagnostic criteria, thresholds, diagnostic results, recommended actions. Click the add button to add multiple diagnostic criteria.

4. Both diagnostic results and recommended actions must not exceed 300 Chinese characters each.

5. For user-defined rules, the system will display diagnostic results and recommended actions exactly as entered.

Example of Rule Configuration:

Rule Configuration Example 1

Rule Configuration Example 2

Rule Configuration Example 3

On this page ...

Is this helpful?