Configuring VEE Rules
This portal is used to display and maintain a VEE Rule. Also, a list of the specific out-of-the-box rules is included below the instructions for using the portal.
You can access the portal by selecting Admin, then VEE, then VEE Rule. You are brought to a query portal with options for searching. Once your record has been selected you are brought to the maintenance portal to view and maintain the selected record.
The following zones may appear as part of the portal's Main tab page:
VEE Rule: this zone displays all of the configuration items specific to this instance of a VEE Rule.
Eligibility Criteria List: this zone displays any VEE Rule Eligibility Criteria that have been setup. These eligibility criteria determine conditionally whether the VEE Rule should be executed or not. Use the Add button to create a new eligibility criteria for the rule you're viewing.
Validation VEE Rules
Below is a list of the validation rules provided as part of base product. For more information on how each rule executes and can be configured, follow the link provided on the rule.
VEE Rule Name
Applicable Data Type(s)
Purpose
Interval
This validation rule flags any combination of consecutive intervals within Initial Measurement Data based on the values of the data or the condition codes of the data.
Interval or Scalar
This rule allows for a duplicate IMD to be flagged.
Interval or Scalar
This powerful, flexible validation rule compares measurements to historical statistics for the related Service Point. The system will maintain statistics such as the following: sum, min, max, average, median, zero value count, outage count, and standard deviation. Then you define formulas (no programming required) for the comparison of current measurements to these statistics.
Interval or Scalar
This rule validates that an IMD exists for all of the other measuring components associated to the same Device Configuration as the current measuring component, for the same period of time.
Interval or Scalar
This validation rule allows you to define a variety of configuration options to decide if new data should replace existing measurements. The options include value change thresholds, percentage change thresholds, as well as condition code ranking.
Interval or Scalar
This validation rule compares the total consumption of the current IMD to historical values. The comparison is normalized based on average daily usage (ADU). If the current IMD is too high or too low compared to historical data then an exception is thrown.
Interval or Scalar
This validation rule flags any Initial Measurement Data received on a device that is either disconnected, uninstalled, and/or not connected to a Usage Subscription.
Interval
This rule validates that the interval size (in seconds) supplied with the Initial Measurement is equal to the interval size defined on measuring component's type.
Interval
This rule checks for spikes within an IMD and generates an exception if one is found.
Interval or Scalar
This rule validates that the register multiplier supplied with the IMD is equal to the multiplier stored on the measuring component. If not, an exception is created using the register multiplier exception type and severity configured on the rule.
Interval or Scalar
This rule flags any IMD where the total consumption is negative.
Interval or Scalar
This validation rule creates an alert when a device has been estimated for an extended period of time.
Interval
This rule flags any missing interval data.
Interval or Scalar
This rule is used to compare the difference between interval data to scalar data for a period of time, or between a set of TOU scalar reads to a "Sum" scalar reading.
Interval or Scalar
This rule checks the unit of measure (UOM) passed in with the Initial Measurement against the primary unit of measure configured on the measuring component's type.
Interval or Scalar
This rule checks if the total consumption for the IMD is zero. There is also a check for whether an outage occurred during the same time as the zero consumption to provide ways to avoid exceptions in that case.
Estimation VEE Rules
Below is a list of the estimation rules provided as part of base product. For more information on how each rule executes and can be configured, follow the link provided on the rule.
VEE Rule Name
Applicable Data Type(s)
Purpose
Interval
This rule performs adjustments to interval values based on the values from the associated scalar data on the same device.
Interval
This rule finds historical interval data from the same measuring component based on a variety of configuration options to use for estimating any missing data within an IMD.
Interval
This estimation rule creates a new Estimation IMD to fill gaps between the interval data received from the Head End.
Note: this estimation rule acts differently from the other rules as it creates a new IMD rather than filling in missing values in an estimation IMD created from periodic estimations.
Interval
This rule attempts to interpolate gaps within an IMD using prior and subsequent intervals as starting points for linear interpolation.
Interval
This rule estimates any missing interval data for the IMD based on a referenced Profile Factor.
Interval
This rule checks for days with similar temperature and uses the measurement data from those days as the basis of interval estimation for the in-flight initial measurement.
Scalar
This rule performs adjustments to scalar values based on the values from the associated interval data on the same device.
Scalar
This rule finds historical scalar data from the same measuring component based on a variety of configuration options to use for estimating any missing data within an IMD.
Scalar
This rule estimates any missing scalar data for the IMD based on a referenced Profile Factor.
Scalar
This rule prorates the value of a scalar reading that has two valid scalar readings on either side as boundaries. It will also take into account any related interval data within the same period to exclude from the calculation.
Subtractive Interval Adjustment Rule
This rule performs adjustments to qualifying interval consumption values for subtractive interval measuring components based on an adjustment target calculated using a start and stop reading for the period that encapsulates the intervals to adjust.
Decision-Making VEE Rules
There are VEE Rules delivered as part of the base product that help with decision-making when executing VEE (listed below). For more information on how each rule executes and can be configured, follow the link provided on the rule.
VEE Rule Name
Purpose
This rule allows for termination of the VEE process based on a configurable set of exceptions being present for the IMD. This rule also allows a unique To Do Type to be generated based on a group of exceptions.
This rule performs a call to execute a separate VEE Group which includes execution of all VEE Rules within that group.
This rule allows VEE to be successfully terminated based on a list of exceptions.
This rule provides a way to choose different instances of a VEE Rule using a Factor. This factor leverages characteristics that are defined on Service Point, Device, or Measuring Component.