psdi.app.labor

Class LaborService

java.lang.Object

psdi.server.AppService

psdi.app.labor.LaborService

All Implemented Interfaces:

java.rmi.Remote, LaborServiceRemote, MboConstants, MboServerInterface, MaxRemoteProxy, AppServiceRemote, Dependable, Service, ServiceRemote, FixedLoggerNames, FixedLoggers

public class LaborService
extends AppService
implements LaborServiceRemote, MboConstants

Field Summary

Fields inherited from interface psdi.app.labor.LaborServiceRemote

critISCRAFT, critISLABOR

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

Fields inherited from interface psdi.util.logging.FixedLoggers

APPLOGGER, CRONTASKLOGGER, CRONTASKMGRLOGGER, CRONTASKMGRSQLLOGGER, DBCONNECTIONLOGGER, DDLOGGER, DMLOGGER, EVENTLOGGER, EXCEPTIONLOGGER, MAILLOGGER, MAXIMOLOGGER, MTLOGGER, NULLMBOPOINTER, SECURITY, SENDFAILEDLOGGER, SERVICELOGGER, SQLLOGGER

Fields inherited from interface psdi.util.logging.FixedLoggerNames

appenderPrefix, LOGGERNAME_APP, LOGGERNAME_CRONTASK, LOGGERNAME_CRONTASKMGR, LOGGERNAME_DBCONNECTION, LOGGERNAME_DD, LOGGERNAME_DM, LOGGERNAME_DMPREVIEW, LOGGERNAME_EVENT, LOGGERNAME_EXCEPTION, LOGGERNAME_MAIL, LOGGERNAME_MAXIMO, LOGGERNAME_MT, LOGGERNAME_NULLMBOPOINTER, LOGGERNAME_SECURITY, LOGGERNAME_SENDFAILED, LOGGERNAME_SERVICE, LOGGERNAME_SQL, LOGGERNAME_SQL_CRONTASKMGR, LOGGERNAME_TXN, loggerPrefix

Constructor Summary

Constructors

Constructor and Description
LaborService()
LaborService(MXServer mxServer)

Method Summary

Modifier and Type	Method and Description
void	createInvoiceForLabTrans(MboRemote labTransMbo, UserInfo userInfo) This method should only be used by MEA to create invoice from a labor transaction.
void	createServiceReceipts(UserInfo userinfo, MboRemote forLabor, boolean createSummary, java.util.Date startDate, java.util.Date endDate) Create service receipts for a single labor.
void	createServiceReceipts(UserInfo userinfo, java.util.Vector forLabor, boolean createSummary, java.util.Date startDate, java.util.Date endDate) Create service receipts for a list of labor.
void	destroy() Destroy the LabTransListener
MboSetRemote	getServReceiptSet(UserInfo ui, java.lang.String ponum) Returns a set of ServRecTrans records that are yet to be approved.
void	init() Initialization
void	initCriteriaList(java.util.Hashtable criteriaTable) Criteria defined for the LaborService object: ISCRAFT - all laborcodes where isCraft='Y' ISLABOR - all labor laborcodes, where isCraft is false
void	updateHours(UserInfo userinfo, java.lang.String laborcode, java.lang.String orgid, double regHours, double otHours) Service method to update the regular and year to date hours on a labor record.

Methods inherited from class psdi.server.AppService

checkSecurity, configure, freeDBConnection, freeMboSet, getCriteria, getCurrentState, getDBConnection, getLiveObjCount, getLoad, getMaximoDD, getMaxVar, getMboSet, getMXServer, getName, getProfile, getProxy, getSchemaOwner, getServiceInfo, getServiceLogger, getSetForRelationship, getSetFromKeys, getStateCmdList, getStateList, getURL, isAppService, isRunning, isSingletonService, restart, setProxy, setRunning, setURL, verifyUser, verifyUser

Methods inherited from class java.lang.Object

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

Methods inherited from interface psdi.server.AppServiceRemote

checkSecurity, getCriteria, getCurrentState, getLiveObjCount, getMboSet, getName, getSchemaOwner, getSetForRelationship, getSetFromKeys, getStateCmdList, getStateList, getURL, verifyUser, verifyUser

Methods inherited from interface psdi.server.ServiceRemote

isAppService, isSingletonService, restart

Constructor Detail

LaborService

public LaborService()
             throws java.rmi.RemoteException

Throws:

java.rmi.RemoteException

LaborService

public LaborService(MXServer mxServer)
             throws java.rmi.RemoteException

Parameters:

srvEnv - -- the "Server Environment" this Service is being created in.

Throws:

java.rmi.RemoteException

Method Detail

init

public void init()

Initialization

Specified by:

init in interface Service

Overrides:

init in class AppService

See Also:

This listener gets setup.

destroy

public void destroy()

Destroy the LabTransListener

Specified by:

destroy in interface Service

Overrides:

destroy in class AppService

See Also:

AppService.destroy()

initCriteriaList

public void initCriteriaList(java.util.Hashtable criteriaTable)
                      throws MXException,
                             java.rmi.RemoteException

Criteria defined for the LaborService object: ISCRAFT - all laborcodes where isCraft='Y' ISLABOR - all labor laborcodes, where isCraft is false

Overrides:

initCriteriaList in class AppService

Throws:

MXException

java.rmi.RemoteException

getServReceiptSet

public MboSetRemote getServReceiptSet(UserInfo ui,
                                      java.lang.String ponum)
                               throws MXException,
                                      java.rmi.RemoteException

Returns a set of ServRecTrans records that are yet to be approved.

Specified by:

getServReceiptSet in interface LaborServiceRemote

Throws:

MXException

java.rmi.RemoteException

See Also:

getServReceiptSet(psdi.security.UserInfo, java.lang.String)

createServiceReceipts

public final void createServiceReceipts(UserInfo userinfo,
                                        MboRemote forLabor,
                                        boolean createSummary,
                                        java.util.Date startDate,
                                        java.util.Date endDate)
                                 throws MXException,
                                        java.rmi.RemoteException

Create service receipts for a single labor.

Specified by:

createServiceReceipts in interface LaborServiceRemote

Throws:

MXException

java.rmi.RemoteException

See Also:

createServiceReceipts(UserInfo, Vector, boolean, Date, Date)

createServiceReceipts

public void createServiceReceipts(UserInfo userinfo,
                                  java.util.Vector forLabor,
                                  boolean createSummary,
                                  java.util.Date startDate,
                                  java.util.Date endDate)
                           throws MXException,
                                  java.rmi.RemoteException

Create service receipts for a list of labor.

Specified by:

createServiceReceipts in interface LaborServiceRemote

Parameters:

userinfo - Used to access the database

forLabor - The labor codes to generate service receipts for. Vector of MboRemote.

createSummary - Flag indicating that combined receipts should be created for the same PO+POLine. Otherwise a service receipt will be created for each labor transaction.

startDate - Defines the start of a date range. Can be null.

endDate - The end of the date range. Can be null.

Throws:

MXApplicationException - Thrown with "Labor","noservreceipt" if no receipts can be created from the given parameters.

MXException

java.rmi.RemoteException

See Also:

createServiceReceipts(UserInfo, Vector, boolean, Date, Date)

createInvoiceForLabTrans

public void createInvoiceForLabTrans(MboRemote labTransMbo,
                                     UserInfo userInfo)
                              throws MXException,
                                     java.rmi.RemoteException

This method should only be used by MEA to create invoice from a labor transaction. An invoice with one invoice line will be created for each labor transaction. An error will be thrown if the labor transaction does not have a vendor or is not approved. Also you cannot create invoice for a labor transaction which has an invoice number i.e. there already has been an invoice created against it.

Specified by:

createInvoiceForLabTrans in interface LaborServiceRemote

Parameters:

labTransMbo -

userInfo -

Throws:

MXException

java.rmi.RemoteException

See Also:

createInvoiceForLabTrans(psdi.mbo.MboRemote, psdi.security.UserInfo)

updateHours

public void updateHours(UserInfo userinfo,
                        java.lang.String laborcode,
                        java.lang.String orgid,
                        double regHours,
                        double otHours)
                 throws MXException,
                        java.rmi.RemoteException

Service method to update the regular and year to date hours on a labor record. This is a synchronized method designed to prevent more than one LabTransSet from updating the labor row at a time.

Parameters:

userinfo - -- A UserInfo object to be used for getting a LABOR mboset from the MXServer

laborcode - -- The laborcode to update

orgid - -- The org level laborcode to update

regHours - -- a quantity of regular hours to add to the labors reported hours

otHours - -- a quantity of over time hours to add to the labors year to date over time hours

Throws:

MXException

java.rmi.RemoteException