psdi.app.labor

Class ServRecTrans

java.lang.Object

psdi.mbo.Mbo

psdi.app.common.receipt.ReceiptMbo

psdi.app.labor.ServRecTrans

All Implemented Interfaces:

java.rmi.Remote, ReceiptMboRemote, ServRecTransRemote, MboConstants, MboRemote, MaxRemoteProxy

public class ServRecTrans
extends ReceiptMbo
implements ServRecTransRemote

Mbo object to represent ServRecTrans.

Attribute Description

Attribute	Description
AMTTORECEIVE	A non-persistent field on the ServRecTrans object. Indicates the Amount to Receive.
CHANGEBY	Status changed by login signature.
STATUS	Indicated the status of this transaction. Set by the approve line option.
CHANGEDATE	Timestamp of when the status of the transaction was changed.
CLAIMNUM	Claim number.
CURRENCYCODE	Copy from PO.CURRENCYCODE.
CURRENCYLINECOST	Extended or lump sum cost of this transaction line; In currency of PO or Invoice.
CURRENCYUNITCOST	Unit cost of service; In currency of the PO or Invoice.
DESCRIPTION	Service description.
ENTERBY	Entered by.
ENTERDATE	Date service usage was reported.
ASSETNUM	Asset Number.
EXCHANGERATE	Copy from PO.EXCHANGERATE.
EXCHANGERATE2	Base Exchange Rate 2
EXTERNALREFID	External Reference ID
FINANCIALPERIOD	Financial period in a format corresponding to that required by the accounting system.
FINCNTRLID	Financial Control Identifier
GLCREDITACCT	GL Contra Account.
GLDEBITACCT	GL Account.
INVOICENUM	Invoice number for receipt.
LINECOST	Extended or lump sum cost of this transaction line.
LINECOST2	Base Currency Line Cost 2.
LINECOSTALREADYRECVD	A non-persistent field on the ServRecTrans object. Indicates the LineCost Already Received.
LOADEDCOST	Line cost loaded with taxes & special charges.
LOCATION	Service Location.
MRLINENUM	MR Line Number
MRNUM	Material Request Number
ORDERQTY	A non-persistent field on the ServRecTrans object.
OWNERSYSID	Owner System ID
PERCENTAGE	A non-persistent field on the ServRecTrans object. Indicates the Percentage.
POLINENUM	PO line item number.
PONUM	Purchase Order Number.
PRORATECOST	Amount of special charges loaded onto the line item.
PRORATED	Has line amount been prorated (allocated)?
QUANTITY	Quantity receipted.
QTYALREADYRECVD	A non-persistent field on the ServRecTrans object. Indicates the Quantity Already Received.
psdi.app.labor.FldServRecTransQtyToReceive QTYTORECEIVE	A non-persistent field on the ServRecTrans object. Indicates the Quantity Already Received.
RefWo	the workorder number this service refered to.
REJECTCOST	Rejected extended or lump sum cost of this transaction line.
REJECTQTY	Quantity of claim rejected.
REMARK	Service Remark.
ROLLUP	Indicates whether or not this transaction has been rolled up.
SENDERSYSID	Column used by ERP-Integration (APIs)
SERVRECTRANSID	Primary key for the table
SOURCESYSID	Source System ID
TaskId	Work Plan task identification.
TAX1	Amount of tax due on line item levied by Tax1Code.
TAX1CODE	Tax code used for calculation of Tax1 column.
TAX2	Amount of tax due on line item levied by Tax2Code.
TAX2CODE	Tax code used for calculation of Tax2 column.
TAX3	Amount of tax due on line item levied by Tax3Code.
TAX3CODE	Tax code used for calculation of Tax3 column.
TAX4	Amount of tax due on line item levied by Tax4Code.
TAX4CODE	Tax code used for calculation of Tax4 column.
TAX5	Amount of tax due on line item levied by Tax5Code.
TAX5CODE	Tax code used for calculation of Tax5 column.
TRANSDATE	Timestamp - Key to Table
UNITCOST	Unit cost of service.
{@link psdi.app.labor.FldServRecTransWonum WONUM}	Work Order Number.

Field Summary

Fields inherited from class psdi.app.common.receipt.ReceiptMbo

invoiceLineCreated

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
ServRecTrans(MboSet ms) Construct the ServRecTrans object

Method Summary

Modifier and Type	Method and Description
void	add() Adds a new ServRecTrans.
void	approve(java.util.Date changeDate, boolean fromLabTrans) Approved services receipt.
void	appValidate() Application validation routine called before the servRecTrans object is saved.
double[]	calculateUnInvoicedQtyCost() This method is use by the Invoice's Copy PO Line page to calculate the uninvoiced quantity and cost.
void	canDelete() Can the object be deleted ? This is object specific and should be overridden.
boolean	getPOLineUpdated() 10-13456 return the private boolean poLineUpdated
java.lang.String	getReceiptStatus() returns the internal value "MAXVALUE" of valuelist "RECEIPTSTATUS"
boolean	getWorkOrderUpdatedFlag() IV81062
void	init() Initialize the ServRecTrans object
void	save() Save ServRecTrans object and all other linked objects Calls super.save() after work on the other objects.
void	setPOLineUpdated() 10-13456 Set the private boolean poLineUpdated to true
void	setServRecTransValues(double quantity, double unitCost, double lineCost) Could be calling from LabTrans or Invoice.
void	setServRecTransValues(double quantity, double unitCost, double lineCost, double exchangeRate) Could be calling from Invoice.
void	setWorkOrderUpdatedFlag(boolean updated) IV81062
void	updateCompletedFields(java.util.Date changeDate) Completed services receipt.

Methods inherited from class psdi.app.common.receipt.ReceiptMbo

approve, approveInvoices, createChildMatServLines, createInvoicesForSchedule, delete, deleteChildReceipts, doChargeStore, getFirstCourierTransOut, getPO, getPOCostReference, getPOLine, getPOReference, getQtyStillInTransitForTransOut, getRemainingCurrencyLineCost, getRemainingInvoiceCurrencyLineCost, getRemainingInvoiceQty, getRemainingQty, getRemainingQtyTransInTransit, getRemainingShipmentQty, getWOReference, isLastReceipt, payOnReceipt, receiptDetails, refetchPOLine, setMRMbo, setPOCostReference, setPOLineMbo, setPOLineSet, setPOMbo, setPOReference, setWOReference, undelete, updateMR, useIntegration, useLineOrLoadedCost

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, skipCopyField, 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, 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, undelete, unlock, unselect, validate, validateAttributes

Constructor Detail

ServRecTrans

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

Construct the ServRecTrans object

Parameters:

ms -

Throws:

MXException

java.rmi.RemoteException

Method Detail

init

public void init()
          throws MXException

Initialize the ServRecTrans object

Overrides:

init in class Mbo

Throws:

MXException

appValidate

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

Application validation routine called before the servRecTrans object is saved. It will throw an exception if the receipt has PO but no POLine number and has not been created by Invoice. Based on a maxvar value check if the GL debit and credit accounts are required for this transaction.

Overrides:

appValidate in class ReceiptMbo

Throws:

MXApplicationException - (financial, GLRequiredForTrans) The debit and credit GL accounts require a value.

MXException

java.rmi.RemoteException

add

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

Adds a new ServRecTrans. Required fields of the ServRecTrans object are initialized. The table below shows the default values for each of the attributes listed.

Attribute Name	Attribute Value
currencylinecost	0.0
currencyunitcost	0.0
enterby	current username
enterdate	current date
exchangerate	1
linecost	0.0
loadedcost	0.0
prorated	No
rollup	No
transdate	current date
unitcost	0.0
currencycode	BaseCurrency1(gets maxvar)
financialperiod	FinancialPeriod(from Financial)

Specified by:

add in interface MboRemote

Overrides:

add in class Mbo

Throws:

MXException

java.rmi.RemoteException

save

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

Save ServRecTrans object and all other linked objects Calls super.save() after work on the other objects.

Overrides:

save in class Mbo

Throws:

MXException

java.rmi.RemoteException

approve

public void approve(java.util.Date changeDate,
                    boolean fromLabTrans)
             throws MXException,
                    java.rmi.RemoteException

Approved services receipt. 1) Change status field to be COMP, update changeby and changedate. 2) Call POLINE to update POLINE receipts complete flag. 3) Update MRLINE status. 4) Add loaded cost to work order ActServCost if there is a work order on the line (if owner is not LabTrans). 5) Call POLINE or INVOICECOST to update asset InvCost with the loaded cost (if owner is not LabTrans). 6) Pay on Receipt -- create invoice (if owner is not INVOICECOST).

Specified by:

approve in interface ServRecTransRemote

Parameters:

changeDate - - changed date

fromLabTrans - - true: indicates it's calling from LabTrans

Throws:

MXException

java.rmi.RemoteException

setServRecTransValues

public void setServRecTransValues(double quantity,
                                  double unitCost,
                                  double lineCost)
                           throws MXException,
                                  java.rmi.RemoteException

Could be calling from LabTrans or Invoice. Set values on quantity, unitcost, linecost, currencyunitcost, currencylinecost columns

Specified by:

setServRecTransValues in interface ServRecTransRemote

Parameters:

quantity - - quantity

unitCost - - unit cost

lineCost - - line cost

Throws:

MXException

java.rmi.RemoteException

setServRecTransValues

public void setServRecTransValues(double quantity,
                                  double unitCost,
                                  double lineCost,
                                  double exchangeRate)
                           throws MXException,
                                  java.rmi.RemoteException

Could be calling from Invoice. Set values on quantity, unitcost, linecost, currencyunitcost, currencylinecost columns

Specified by:

setServRecTransValues in interface ServRecTransRemote

Parameters:

quantity - - quantity

unitCost - - unit cost

lineCost - - line cost

exchangeRate - - exchange rate

Throws:

MXException

java.rmi.RemoteException

updateCompletedFields

public void updateCompletedFields(java.util.Date changeDate)
                           throws MXException,
                                  java.rmi.RemoteException

Completed services receipt. Changes status to be COMP. Set changedate with given values and changeby with default username.

Parameters:

changeDate - - change date

Throws:

MXException

java.rmi.RemoteException

See Also:

approve

canDelete

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

Description copied from class: Mbo

Can the object be deleted ? This is object specific and should be overridden.

Overrides:

canDelete in class Mbo

Throws:

MXException

java.rmi.RemoteException

calculateUnInvoicedQtyCost

public double[] calculateUnInvoicedQtyCost()
                                    throws MXException,
                                           java.rmi.RemoteException

This method is use by the Invoice's Copy PO Line page to calculate the uninvoiced quantity and cost. The uninvoiced quantity/cost is calculated by subtracting the sum of all the invoicelines quantity/cost which have the same ponum and polinenum as of this receipt. Invoices which are cancelled are not considered.

Returns:

double[] Returns an array which has the calculted quantity as the first element and the calculated cost as the second element.

Throws:

MXException

java.rmi.RemoteException

getReceiptStatus

public java.lang.String getReceiptStatus()
                                  throws MXException,
                                         java.rmi.RemoteException

returns the internal value "MAXVALUE" of valuelist "RECEIPTSTATUS"

Throws:

MXException

java.rmi.RemoteException

getPOLineUpdated

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

10-13456 return the private boolean poLineUpdated

Throws:

MXException

java.rmi.RemoteException

setPOLineUpdated

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

10-13456 Set the private boolean poLineUpdated to true

Throws:

MXException

java.rmi.RemoteException

setWorkOrderUpdatedFlag

public void setWorkOrderUpdatedFlag(boolean updated)

IV81062

Parameters:

updated - true, if already updated.

getWorkOrderUpdatedFlag

public boolean getWorkOrderUpdatedFlag()

IV81062

Parameters:

updated - true, if already updated.