psdi.app.asset

Class MeterReading

  • All Implemented Interfaces:
    java.rmi.Remote, MeterReadingRemote, ReadingRemote, MboConstants, MboRemote, MaxRemoteProxy


    public class MeterReading
    extends Reading
    implements MeterReadingRemote
    MBO to represent a MeterReading. See Asset package description for details.

    The key attributes for this object are as follows: SiteId, AssetNum and MeterName.

    The attributes in this object are as follows:

    Attribute NameDescription
    Deltadifference between this MeterReading's Reading and the previous MeterReading's Reading.
    EnterBy, EnterDateName of the user who entered this MeterReading and the date the MeterReading was entered. These default to the system user name and date.
    AssetNumAsset associated with the meter in this MeterReading.
    GroupNameIdentifier of the meter group from which this meter was copied to this MeterReading.
    InspectorPerson who has provided the meter reading.
    IsModificationADeltaNon-persistent attribute to indicate if the modified reading is a delta.
    MatUseTransIdidentifier associated with the MatUseTrans from which this MeterReading originated. This attribute pertains only to those readings that originate from a material issue.
    MeasureUnitId unit of measure for this MeterReading. The value defaults to the meter's MeasureUnitId but can then be modified. This attribute pertains only to meters of type CONTINUOUS and GAUGE.
    MeterNameIdentifier of the meter associated with the asset in this MeterReading.
    MeterReadingIdunique identifier for this MeterReading.
    ModifiedReadingNon-persistent attribute used to record a modification to the reading of an existing MeterReading mbo.
    Readingmeter value for CONTINUOUS and GAUGE meters.
    ReadingDatedate of the meter reading. This cannot be a future date.
    ReadingIsDeltaNon-persistent attribute to indicate if the reading is a delta.
    ReadingSourceindicates whether the meter reading has been ENTERED directly, MODIFIED or INHERITED via a rolldown. These valid values are in the READINGSOURCE value list.
    ReadingTypeindicates whether the meter reading is being entered as a DELTA from the previous reading or as an ACTUAL. These valid values are in the READINGTYPE value list.
    RolldownSourceIdentifies whether or not a meter may accept reading deltas from a parent asset's or location's meter. Valid values are:

    ASSETaccepts Asset rolldowns only.
    LOCATIONaccepts Location rolldowns only.
    NONEoes not accept rolldowns

    If this attribute specifies ASSET or LOCATION, Active is 'Y' and this MeterReading's meter name is the same as the parent's meter name, then this asset's meter reading is increased by the same amount.

    Rollover Rollover value for this MeterReading. If this MeterReading has been created when applying a meter group to this asset, the value defaults to the meter group's rollover value but can then be modified.
    See Also:
    psdi.app.meter.metergroup, psdi.app.meter.meteringroup
    • Constructor Detail

      • MeterReading

        public MeterReading(MboSet ms)
                     throws MXException,
                            java.rmi.RemoteException
        Construct the MeterReading object
        Parameters:
        ms - Mbo set
        Throws:
        MXException
        java.rmi.RemoteException
    • Method Detail

      • add

        public void add()
                 throws MXException,
                        java.rmi.RemoteException
        Adds a new MeterReading object and sets its field defaults.
        Specified by:
        add in interface MboRemote
        Overrides:
        add in class Reading
        Throws:
        MXException
        java.rmi.RemoteException
      • save

        public void save()
                  throws MXException,
                         java.rmi.RemoteException
        saves new and modified MeterReading objects. If the MeterReading object being saved is a modified reading, then this method also begins the rolldown and/or roll forward by getting the AssetMeter object for this MeterReading and setting the AssetMeter.NewReading attribute.
        Overrides:
        save in class Reading
        Throws:
        MXException
        java.rmi.RemoteException
      • isChangeByUserWhenSetFromLookup

        public boolean isChangeByUserWhenSetFromLookup(java.lang.String lookupAttrName,
                                                       java.lang.String attributeName)
        Indicates whether the CHANGEDBY_USER flag should be set for attributes on this Mbo when their values are set (along with other key fields) via lookup.
        Overrides:
        isChangeByUserWhenSetFromLookup in class Mbo
        Parameters:
        lookupAttrName - the attribute whose lookup is being called.
        attributeName - the attribute that is not the lookup attribute.
        Returns: