Meter Validations

The validations associated with the various features of a meter are detailed below.

Auto reset value

The following validations apply to a meter's Auto Reset Value:

  • When setting or changing a meter's Auto Reset Value, the reset value cannot be less than the Last Reading.

Meter readings

The following validations apply to meter readings:

  • Meter readings must be greater than or equal to zero.
  • Two readings for the same meter with the same Reading On date cannot exist.
  • A Reading can only be inserted on a meter which is running, ie the meter must not be paused. However, the meter does not have to be paused when updating meter readings.
  • If the meter has an Auto Reset Value, then the Reading that is inserted or updated cannot be more than the defined Auto Reset Value.
  • If an Auto Reset Value is not defined, a meter Reading must be more than it's previous Reading and less than the Reading after it, if there is one.
  • A meter's Reading On date cannot be updated if the new value is earlier than the previous reading's date or later than the following reading's date.
  • A meter's Reading On date cannot be in the future.
  • A meter Reading cannot be inserted earlier than the first meter Reading.
  • Only the first meter Reading can be updated if there are no readings after it.

Average daily rate

The Average Daily Rate is calculated by opening the meter's edit screen and using the Set ADR custom action in the Assist panel in the sidebar.

The Average Daily Rate is calculated as follows:

(The Cumulative Reading of the latest Reading - the Cumulative Reading of the earliest Reading) รท by the duration in days (the date of the latest Reading - the date of the earliest Reading).

The following validations apply when calculating a meter's Average Daily Rate:

  • If the calculation is count-based, there has to be at least two meter readings captured for the meter.
  • If the calculation is interval-based, there has to be at least two readings in range.
  • If Use Configured Calculation Unit is set to true, the Average Daily Rate Calculation Quantity and the Average Daily Rate Calculation Unit has to be null (ie must not be set).
  • If Use Configured Calculation Unit is set to false, the Average Daily Rate Calculation Quantity and the Average Daily Rate Calculation Unit cannot be null (ie must be set).
  • An error is returned if only one Reading is found.
  • A warning is returned if the calculation is count-based and there are fewer readings captured than the count, .
  • A warning is returned if the calculation is interval-based and the earliest meter Reading is later than the latest reading's date minus the time interval.

Manual meter resets

A manual reset is performed by opening the meter's edit screen using the Manual Reset Metercustom action in the Assist panel in the sidebar. The following validations apply for manual meter resets:

  • A reset can only be done if the meter is paused.
  • If the meter has an Auto Reset Value, the old meter's Last Reading and the new meter's First Reading has to be lower than the Auto Reset Value.
  • The old meter's Last Reading has to be the same as or higher than the latest Reading.
  • The Reset Date has to be later than the latest reading's date.

Meter reading accuracy

The accuracy of meter readings is important as meter readings are used to calculate due tasks on assets as well as the meter's Average Daily Rate (ADR).

The following optional meter reading validations assist users in accurately capturing meter readings:

  • The ADR of a meter generally does not differ significantly from one meter reading to the next. This is therefore a reliable measure to check that new meter readings are inserted correctly. If a meter reading is inserted that causes the ADR to vary more than specified, a warning is displayed prompting the user to confirm weather they would like to save the meter reading. The ADR allowed variance can be configured in system options and on the meter itself.
  • The maximum allowed ADR can be configured per meter. Users are then not able to insert a meter reading that causes the newly calculated ADR to exceed the maximum value specified. This validation is used in specific processes where a meter cannot run at more than a specified rate.

Refer to Meter Defaults, Reading Validations and Meter Screen for more information.