psdi.app.pm

Class PMMeter

java.lang.Object

psdi.mbo.Mbo

psdi.app.pm.PMMeter

All Implemented Interfaces:

java.rmi.Remote, PMMeterRemote, MboConstants, MboRemote, MaxRemoteProxy

public class PMMeter
extends Mbo
implements PMMeterRemote

MBO object to represent PMMeter.

This is a site level object.

The key attributes for this object are SiteId,Pmnum, and Metername.

The attributes in this object are as follows:

Attribute Name	Description
AlertLead	Acceptable period (in days), prior to the PM due date, during which the PM may be performed.
Assetnum	Identifier of the asset associated with this PM. Foreign Key to Assetnum.
Average	Identifier of the asset associated with this PM. Foreign Key to Assetnum.
DATEOFNEXTWO	Estimated due date for next work order generation.
Frequency	Identifies the number of time units to elapse between the workorders generated from PM. The time units can be Days, Weeks, Months or Years.
LastPmWogenReadMeter Reading at the last work order generation.
LastPmWogenReadDtMeter Reading Date at Last work order generation.
Location	Identifies the location where the work will be done when workorders are generated by this PM.
MasterPM	Identifies the master PM which can be used as template to create associated PM records.
MeterName Identifies the meter on the PM.
ORGID	Identifier of the organization for this PM Meter.
PMNUM	Identifier for the Preventive Maintenance record.
READINGATNEXTWO	Reading at the next work order generation.
RollOver	Point at which the asset's (or) Location's meter returns to its mininum value. Rollover applies to CONTINUOUS meters only.
SiteId	Identifier of the site for the PM.
Status	Indicates status of a PM.
Tolerance	Identifier of the tolerance level.
UnitsToGo	Identifier of the Units to Go.
UPDMETER	A boolean field used to identify if meter is to be updated.

Field Summary

Fields inherited from class psdi.mbo.Mbo

MULTILANGCOPY, phantomList, phantomQueue

Fields inherited from interface psdi.mbo.MboConstants

ALLROWS, CHANGEDBY_USER, COUNT_ADDITIONS, COUNT_AFTERSAVE, COUNT_DATABASE, COUNT_DELETED, COUNT_EXISTING, DBCONFIG, DELAYVALIDATION, DELAYVALIDATIONONLY, DISCARDABLE, GOTCOMPLETEWHERE, HIDDEN, NO_RELATEDMBOS_OF_OWNERSCHILDREN_FETCH, NOACCESSCHECK, NOACTION, NOADD, NOCOMMIT, NODELETE, NONE, NOOVERWRITE, NOSAVE, NOSETVALUE, NOUPDATE, NOVALIDATION, NOVALIDATION_AND_NOACTION, NOVALIDATION_AND_NOACTION_ALLOWCROSSOVER, READONLY, REBUILD, REQUIRED, SAMEVALUEVALIDATION, SETBYPARENT, USER

Constructor Summary

Constructors

Constructor and Description
PMMeter(MboSet ms) Construct the PMMeter object

Method Summary

Modifier and Type	Method and Description
void	add() Sets default values for a PMMeter object
void	appValidate() Pre-save validation method.
void	canDelete() Method that checks whether a PMMeter can be deleted or not.
boolean	checkForUseTargetStartAndOpenWo() Check to see if any workorder is open when the PM.UseTargetStart is false
void	delete(long modifier) Deletes a PMMeter record.
protected MboSetRemote	findAssetOrLocationMeterSet() Based on whether PMMeter has asset or location, it returns the ASSETMETER or LOCATIONMETER mboset.
double	getReadingAtNextWO() Returns the meter reading at the generation of next work order from this PM for a given PM Meter.
double	getUnitsToGoReading() Calculate the new value for UnitsToGo attribute.
double	getUnitsToGoReading(MboRemote assetLocMeterMbo) Calculate the new value for UnitsToGo attribute using the assetmeter or locationmeter object provided.
void	init() Initialize the PMMeter object
void	save() Save the object and other linked objects.
void	setRollOverAndAverage() Calculate and set the value of RollOver and Average Field when a meter is entered.
protected boolean	skipCopyField(MboValueInfo mvi) This method overrides the skipCopyField() in the Mbo.
void	undelete() Undeletes a PMMeter record.

Methods inherited from class psdi.mbo.Mbo

addMboSetForRequiredCheck, addToDeleteForInsertList, andEvaluateConditions, blindCopy, checkFieldAccess, checkMethodAccess, checkMethodAccess, checkQualifiedRestriction, checkRecordLock, checkSiteOrgAccessForSave, clear, clearRelatedSets, clearRelatedSets, commit, copy, copy, copy, copyFake, copyValue, copyValue, createComm, delete, deleteDoclinks, determineRequiredFieldsFromERM, duplicate, enableMethod, evaluateCondition, evaluateCondition, evaluateCtrlConditions, evaluateCtrlConditions, evaluateRestriction, excludeObjectForPropagate, findAllNullRequiredFields, fireEvent, generateAutoKey, generateContentUID, getAlwaysFlags, getAttrRestrictionFlag, getAttrRestrictions, getBoolean, getByte, getBytes, getCheckpoint, getClientLocale, getClientTimeZone, getCommLogOwnerNameAndUniqueId, getCondition, getDatabaseValue, getDate, getDeleteForInsertList, getDocLinksCount, getDomainFilterWhere, getDomainIDs, getDouble, getESId, getExistingMboSet, getFetchIndex, getFieldExceptions, getFlags, getFloat, getIgnoreLockCheck, getInitialValue, getInsertCompanySetId, getInsertItemSetId, getInsertOrganization, getInsertOrgForSite, getInsertSite, getInstanciatedMboSet, getInstanciatedMboValue, getInt, getIntegrationService, getKeyValue, getLanguageRecordRowStamp, getLinesRelationship, getList, getLockedByDisplayName, getLockedByUserID, getLong, getMatchingAttr, getMatchingAttr, getMatchingAttrs, getMaxMessage, getMboCtx, getMboData, getMboDataSet, getMboForAttribute, getMboForAttributeStatic, getMboInitialValue, getMboList, getMboLogger, getMboRecordData, getMboServer, getMboSet, getMboSet, getMboSet, getMboSetInfo, getMboSetInfo, getMboValue, getMboValueData, getMboValueData, getMboValueData, getMboValueDataForDownload, getMboValueInfoStatic, getMboValueInfoStatic, getMessage, getMessage, getMessage, getMessage, getMXTransaction, getName, getOrgForGL, getOrgSiteForMaxvar, getOwner, getProfile, getPropagateKeyFlag, getProxy, getRecordIdentifer, getRecordMboName, getRecordType, getRelatedSets, getRelatedWhere, getRelatedWhere, getRelationshipNameToLangTable, getResourceName, getRowRestrictionFlag, getRowStamp, getRowStampObject, getSecurityLogger, getSiteOrg, getSqlLogger, getString, getString, getStringInBaseLanguage, getStringInSpecificLocale, getStringTransparent, getSynonymValueWhere, getTenantId, getTenantIdForNoMboRecordData, getThisMboSet, getTranslator, getUniqueIdentifer, getUniqueIDName, getUniqueIDValue, getUniqueLanguageIDRecord, getUserInfo, getUserName, getValidateOrder, hasFieldAccess, hasHierarchyLink, hasLockSaveRights, hasRelatedQbe, hasUniqueID, initFieldFlagsOnMbo, initRelationship, isApiBatchError, isAppLockEnabled, isAutoKeyed, isBasedOn, isChangeByUserWhenSetFromLookup, isDuringInit, isEAuditFieldModified, isESigFieldModified, isFlagSet, isForDM, isLocked, isLocked, isLockedByMe, isMasterTenant, isMboLockedByMe, isModified, isModified, isNew, isNoSql, isNull, isOptionGranted, isSelected, isSkipCopyField, isValid, isZombie, lock, modify, moveFieldFlagsToMboValue, needCallInitFieldFlag, orEvaluateConditions, propagateKeyValue, removeCtx, removeRelatedSet, resolveNoSqlWhere, rollbackToCheckpoint, select, setAppDefaultValue, setApplicationError, setApplicationRequired, setAutokeyFields, setCopyDefaults, setDatabaseDefaultValues, setDatabaseDefaultValues, setDefaultValue, setDefaultValues, setDeleted, setDuringInit, setEAuditFieldModified, setESId, setESigFieldModified, setFetchIndex, setFieldFlag, setFieldFlag, setFieldFlag, setFieldFlag, setFieldFlag, setFieldFlag, setFieldFlags, setFlag, setFlag, setFlags, setForDM, setHierarchyLink, setIgnoreRecordLockCheck, setLangCodeDefault, setMboCtx, setMLValue, setModified, setModifiedForIntegrationOnly, setNewMbo, setNoSql, setPropagateKeyFlag, setPropagateKeyFlag, setProxy, setReadonlyWhenParentIsReadonly, setRecordType, setReferencedMbo, setReferencedMbo, setResolveNoSqlWhere, setResourceName, setTenantIdForNoMboRecordData, setUniqueIDValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValueFromSequence, setValueNull, setValueNull, sigopGranted, sigopGranted, sigopGranted, sigopGranted, sigOptionAccessAuthorized, smartFill, smartFind, smartFind, smartFind, smartFindByObjectName, smartFindByObjectName, smartFindByObjectNameDirect, startCheckpoint, thisToBeUpdated, throwRequiredException, toBeAdded, toBeDeleted, toBeSaved, toBeUpdated, toBeValidated, undeleteDoclinks, unlock, unselect, useDataSecurity, validate, validateAttributes, validateKeyUniqueness, valueChanged

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface psdi.mbo.MboRemote

addMboSetForRequiredCheck, addToDeleteForInsertList, blindCopy, checkMethodAccess, clear, copy, copy, copy, copyFake, copyValue, copyValue, createComm, delete, duplicate, evaluateCondition, evaluateCtrlConditions, evaluateCtrlConditions, excludeObjectForPropagate, generateAutoKey, getBoolean, getByte, getBytes, getCommLogOwnerNameAndUniqueId, getDatabaseValue, getDate, getDeleteForInsertList, getDocLinksCount, getDomainIDs, getDouble, getExistingMboSet, getFlags, getFloat, getIgnoreLockCheck, getInitialValue, getInsertCompanySetId, getInsertItemSetId, getInsertOrganization, getInsertSite, getInt, getKeyValue, getLinesRelationship, getList, getLockedByDisplayName, getLong, getMatchingAttr, getMatchingAttr, getMatchingAttrs, getMaxMessage, getMboData, getMboDataSet, getMboInitialValue, getMboList, getMboSet, getMboSet, getMboSet, getMboValueData, getMboValueData, getMboValueData, getMboValueDataForDownload, getMboValueInfoStatic, getMboValueInfoStatic, getMessage, getMessage, getMessage, getMessage, getMXTransaction, getName, getOrgForGL, getOrgSiteForMaxvar, getOwner, getPropagateKeyFlag, getRecordIdentifer, getSiteOrg, getString, getString, getStringInBaseLanguage, getStringInSpecificLocale, getStringTransparent, getThisMboSet, getUniqueIDName, getUniqueIDValue, getUserInfo, getUserName, hasHierarchyLink, hasLockSaveRights, isAutoKeyed, isBasedOn, isFlagSet, isForDM, isLocked, isLocked, isMasterTenant, isMboLockedByMe, isModified, isModified, isNew, isNull, isOptionGranted, isSelected, isZombie, lock, propagateKeyValue, rollbackToCheckpoint, select, setApplicationError, setApplicationRequired, setAutokeyFields, setCopyDefaults, setDeleted, setESigFieldModified, setFieldFlag, setFieldFlag, setFieldFlag, setFieldFlag, setFieldFlag, setFieldFlag, setFieldFlags, setFlag, setFlag, setFlags, setForDM, setIgnoreRecordLockCheck, setMLValue, setModified, setNewMbo, setPropagateKeyFlag, setPropagateKeyFlag, setReferencedMbo, setReferencedMbo, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValueNull, setValueNull, sigopGranted, sigopGranted, sigopGranted, sigOptionAccessAuthorized, smartFill, smartFind, smartFind, smartFind, smartFindByObjectName, smartFindByObjectName, smartFindByObjectNameDirect, startCheckpoint, thisToBeUpdated, toBeAdded, toBeDeleted, toBeSaved, toBeUpdated, toBeValidated, unlock, unselect, validate, validateAttributes

Constructor Detail

PMMeter

public PMMeter(MboSet ms)
        throws MXException,
               java.rmi.RemoteException

Construct the PMMeter object

Throws:

MXException

java.rmi.RemoteException

Method Detail

init

public void init()
          throws MXException

Initialize the PMMeter object

Overrides:

init in class Mbo

Throws:

MXException

add

public void add()
         throws MXException,
                java.rmi.RemoteException

Sets default values for a PMMeter object

Specified by:

add in interface MboRemote

Overrides:

add in class Mbo

Throws:

MXException

java.rmi.RemoteException

appValidate

public void appValidate()
                 throws MXException,
                        java.rmi.RemoteException

Description copied from class: Mbo

Pre-save validation method. Programmer can override with specific rules.

Overrides:

appValidate in class Mbo

Throws:

MXException

java.rmi.RemoteException

delete

public void delete(long modifier)
            throws MXException,
                   java.rmi.RemoteException

Deletes a PMMeter record.
when all pmmeter are deleted, get the PM(owner) and set the pmactmeter and pmassetwogen fields to false.

Specified by:

delete in interface MboRemote

Overrides:

delete in class Mbo

Parameters:

modifier - access modifier

Throws:

MXException

java.rmi.RemoteException

See Also:

Mbo.delete(long)

undelete

public void undelete()
              throws MXException,
                     java.rmi.RemoteException

Undeletes a PMMeter record.
when PMMETERs are undeleted, get the PM(owner) and set the pmactmeter fields to editable.

Specified by:

undelete in interface MboRemote

Overrides:

undelete in class Mbo

Throws:

MXException

java.rmi.RemoteException

getUnitsToGoReading

public double getUnitsToGoReading()
                           throws java.rmi.RemoteException,
                                  MXException

Calculate the new value for UnitsToGo attribute. These attributes get a new value everytime the corrosponding ReadingAtNextWO attribute changes. The calculation is: (LTDLASTPMWOREAD + FREQUENCY)- ASSETLOCMETER.LIFETODATE - TOLERANCE

Specified by:

getUnitsToGoReading in interface PMMeterRemote

Returns:

PMMeter.UnitsToGo value

Throws:

MXException

java.rmi.RemoteException

See Also:

PMMeter.getUnitsToGoReading(MboRemote assetLocMeterMbo)

getUnitsToGoReading

public double getUnitsToGoReading(MboRemote assetLocMeterMbo)
                           throws java.rmi.RemoteException,
                                  MXException

Calculate the new value for UnitsToGo attribute using the assetmeter or locationmeter object provided. The calculation is: (LTDLASTPMWOREAD + FREQUENCY)- ASSETLOCMETER.LIFETODATE - TOLERANCE This should be called when establishing UNITSTOGO as a new reading is being entered and the committed update of the ASSETMETER or LOCATIONMETER cumulative meter reading values (most importantly for UNITSTOGO determination, LIFETODATE) cannot be insured prior to PM work order generation being run. For example, when importing a reading via integration, this method is used. When certain that cumulative meter readings unchanging (for example, when the PMWoGenCronTask is run,PMMeter.getUnitsToGoReading() is called.

Specified by:

getUnitsToGoReading in interface PMMeterRemote

Returns:

PMMeter.UnitsToGo value

Throws:

MXException

java.rmi.RemoteException

See Also:

PMMeter.getUnitsToGoReading(MboRemote assetLocMeterMbo)

findAssetOrLocationMeterSet

protected MboSetRemote findAssetOrLocationMeterSet()
                                            throws MXException,
                                                   java.rmi.RemoteException

Based on whether PMMeter has asset or location, it returns the ASSETMETER or LOCATIONMETER mboset.

Returns:

A set of AssetMeters or LocationMeters depending if PM is for an asset or a location.

Throws:

MXException

java.rmi.RemoteException

getReadingAtNextWO

public double getReadingAtNextWO()
                          throws java.rmi.RemoteException,
                                 MXException

Returns the meter reading at the generation of next work order from this PM for a given PM Meter.

Specified by:

getReadingAtNextWO in interface PMMeterRemote

Returns:

(lastpmwogenread - frequency)

Throws:

MXException

java.rmi.RemoteException

See Also:

PMMeter.getReadingAtNextWO()

checkForUseTargetStartAndOpenWo

public boolean checkForUseTargetStartAndOpenWo()
                                        throws java.rmi.RemoteException,
                                               MXException

Check to see if any workorder is open when the PM.UseTargetStart is false

Returns:

true if the usetargetdate is false and if any open workorder against this PM

Throws:

MXException

java.rmi.RemoteException

skipCopyField

protected boolean skipCopyField(MboValueInfo mvi)
                         throws java.rmi.RemoteException,
                                MXException

This method overrides the skipCopyField() in the Mbo. This method takes the MboValueInfo as its parameter to see if this field needs to be copied or skipped.If this field does not need to be copied, it returns true. The following fields donot get copied from the source PMMeter to the target PMMeter.

1. pmnum
2. dateofnextwo
3. lastpmwogenread
4. lastpmwogenreaddt
5. readingatnextwo
6. unitstogo

Overrides:

skipCopyField in class Mbo

Parameters:

mvi - The MboValueInfo object of the MboValue that needs to be copied.

Returns:

True,if the field does not need to be copied.In all other cases return false.

Throws:

MXException

java.rmi.RemoteException

setRollOverAndAverage

public void setRollOverAndAverage()
                           throws java.rmi.RemoteException,
                                  MXException

Calculate and set the value of RollOver and Average Field when a meter is entered.

Throws:

MXException

java.rmi.RemoteException

canDelete

public void canDelete()
               throws MXException,
                      java.rmi.RemoteException

Method that checks whether a PMMeter can be deleted or not.
Throws interactive message in case of UI to delete the PM Hierarchy forecast if the meter is deleted

Overrides:

canDelete in class Mbo

Throws:

MXException

java.rmi.RemoteException

save

public void save()
          throws MXException,
                 java.rmi.RemoteException

Description copied from class: Mbo

Save the object and other linked objects. Subclasses can code their save() logic to include any appropriate updates to other linked objects and call super.save().

Overrides:

save in class Mbo

Throws:

MXException

java.rmi.RemoteException