psdi.app.jobplan

Class JobTask

java.lang.Object

psdi.mbo.Mbo

psdi.app.jobplan.JobTask

All Implemented Interfaces:

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

public class JobTask
extends Mbo
implements JobTaskRemote

MBO object that represents a Job Task.
See JobPlan Package description for details.

This is system level object that can be defined to exist at the system level, organization level or site level.

The key attributes for this object are OrgId,SiteId,Jpnum,Jptask.

The attributes in this object are as follows::

Attribute Name	Description
Description	Description of the task.
Jobplanid	A system generated unique identifier for the job plan that owns this Job Task. This will be copied from owner Job Plan to this Job Task.
Jobtaskid	A system generated unique identifier for this Job Task.
Jpnum	Identifier for the Job Plan. This will be copied from owner Job Plan to this Job Task.
JpTask	Identifier of the the Job Plan Task number.
MeterName	Generic meter name to associate with the job task. Point Number on a work order is established through the combination of this Meter Name and the work order's asset or location.
OrgId	Identifier of the organization for the Job Task.
SiteId	Identifier of the site for the Job Task.
TaskDuration	Represents the estimated duration for the Task in Hours.
TaskSequence	Task Sequence
JO1 through JO8	Extra Fields.

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

Method Summary

Modifier and Type	Method and Description
void	add() Add a new Job Task.
void	appValidate() Validate the task's org and site against the nestedjobplans org and site.
void	canDelete() Determines whether this record can be deleted.
void	clearClassification() This method clears the classtructureid of the job task.
MboRemote	copy(MboSetRemote mboSet) Overwrite the copy method in MboSet.
void	delete(long accessModifier) Deletes the Job Task. Also deletes corresponding references to this Job Task in jobtool, jobmaterial, jobservice and joblabor by calling the deleteJobTaskComponents() method on the owning job plan.
protected int	generateTaskID() Generates a unique Task ID with an interval.
void	init() Initialization routine.
protected boolean	isDifferentFromPreviousRevision() Determines if this task is different from a previous revision
void	propagateKeyValue(java.lang.String keyName, java.lang.String keyValue) Set value for Jpnum.
protected void	save() Sets revision status to CHANGED if necessary before saving
protected boolean	skipCopyField(MboValueInfo mvi) This method overrides the skipCopyField() in the Mbo.
void	undelete() Undeletes the job Task.
void	validateCondPredExist(java.lang.String attributeName) This method is called from the PREDECESSORTASKS and CONDITIONNUM fields on a job task.
void	validateJPTaskKey() Validates the Task Number:Orgid:Siteid key combination for uniqueness

Methods inherited from class psdi.mbo.Mbo

addMboSetForRequiredCheck, addToDeleteForInsertList, andEvaluateConditions, blindCopy, checkFieldAccess, checkMethodAccess, checkMethodAccess, checkQualifiedRestriction, checkRecordLock, checkSiteOrgAccessForSave, clear, clearRelatedSets, clearRelatedSets, commit, 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, 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, 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, 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

JobTask

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

Construct the JobTask object

Throws:

MXException

java.rmi.RemoteException

Method Detail

init

public void init()
          throws MXException

Initialization routine.
Set the orgid READONLY flag to true if there is an orgid on the jobplan
Set the siteid READONLY flag to true if there is a siteid on the jobplan

Overrides:

init in class Mbo

Throws:

MXException

appValidate

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

Validate the task's org and site against the nestedjobplans org and site.

Overrides:

appValidate in class Mbo

Throws:

MXException

java.rmi.RemoteException

add

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

Add a new Job Task.
When a new job task is added, the jobplan number, jobplanid, orgid and siteid are copied from the jobplan which owns this object.
Set the orgid READONLY flag to true if there is an orgid on the jobplan
Set the siteid READONLY flag to true if there is a siteid on the jobplan
Notify the owning job plan that a new component is being added

Specified by:

add in interface MboRemote

Overrides:

add in class Mbo

Throws:

MXException

java.rmi.RemoteException

See Also:

JobPlan.componentAdded()

canDelete

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

Determines whether this record can be deleted.
A user who does not have access to all the components of this task will not be allowed to delete this task.

Overrides:

canDelete in class Mbo

Throws:

MXApplicationException("jobplan", - "taskhascomponents") - thrown if this task has components that the user cannot see

java.rmi.RemoteException

MXException

See Also:

delete

delete

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

Deletes the Job Task.
Also deletes corresponding references to this Job Task in jobtool, jobmaterial, jobservice and joblabor by calling the deleteJobTaskComponents() method on the owning job plan.

Specified by:

delete in interface MboRemote

Overrides:

delete in class Mbo

Parameters:

accessModifier - The bitwise flag specified to determine if certain normal security checks are to be bypassed for this delete request. For example: if the accessModifer is NOACCESSCHECK, then the check for the object's NODELETE flag and the call to the object's canDelete() method will not be performed. If the accessModifer is NONE, then all the access checks are performed before this object is marked delete.

Throws:

MXException

java.rmi.RemoteException

See Also:

JobPlan.deleteJobTaskComponents(int jptask, String taskorg, String tasksite), psdi.app.jobplan.JobMaterialSet#deleteJobMaterial(int jptask), psdi.app.jobplan.JobLaborSet#deleteJobLabor(int jptask), psdi.app.jobplan.JobToolSet#deleteJobTool(int jptask)

undelete

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

Undeletes the job Task.
Also undeletes corresponding references to this Job Task in jobtool, jobmaterial, jobservice and joblabor by calling the undeleteJobTaskComponents() method on the owning job plan.

Specified by:

undelete in interface MboRemote

Overrides:

undelete in class Mbo

Throws:

MXException

java.rmi.RemoteException

See Also:

JobPlan.deleteJobTaskComponents(int jptask, String taskorg, String tasksite), psdi.app.jobplan.JobMaterialSet#deleteJobMaterial(int jptask), psdi.app.jobplan.JobLaborSet#deleteJobLabor(int jptask), psdi.app.jobplan.JobToolSet#deleteJobTool(int jptask)

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 do not get copied from the source JobTask to the target JobTask.

1. jpnum
2. jobplanid
3. pluscrevstatus

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

propagateKeyValue

public void propagateKeyValue(java.lang.String keyName,
                              java.lang.String keyValue)
                       throws MXException,
                              java.rmi.RemoteException

Set value for Jpnum.

Specified by:

propagateKeyValue in interface MboRemote

Overrides:

propagateKeyValue in class Mbo

Parameters:

keyName - Should equal "jpnum" or else nothing will be propagated.

keyValue - The new value of jpnum.

Throws:

MXException

java.rmi.RemoteException

generateTaskID

protected int generateTaskID()
                      throws MXException,
                             java.rmi.RemoteException

Generates a unique Task ID with an interval.

Throws:

MXException

java.rmi.RemoteException

validateJPTaskKey

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

Validates the Task Number:Orgid:Siteid key combination for uniqueness

Specified by:

validateJPTaskKey in interface JobTaskRemote

Throws:

MXApplicationException("jobplan", - "duplicateTaskkey") - thrown if the key combination is not unique

MXException

java.rmi.RemoteException

See Also:

JobTask.validateJPTaskKey()

clearClassification

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

This method clears the classtructureid of the job task.

Specified by:

clearClassification in interface JobTaskRemote

Throws:

java.rmi.RemoteException

MXException

See Also:

JobTask.clearClassification()

copy

public MboRemote copy(MboSetRemote mboSet)
               throws MXException,
                      java.rmi.RemoteException

Overwrite the copy method in MboSet. This method is used by the invoice duplicate to duplicate the invoice line mbos. The invoice cost is also duplicated.

Specified by:

copy in interface MboRemote

Overrides:

copy in class Mbo

Parameters:

mboSet - The set into which the new mbo will be added.

Returns:

The new mbo, with values copied from this mbo.

Throws:

MXException

java.rmi.RemoteException

See Also:

Mbo.copy(MboSetRemote, long)

save

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

Sets revision status to CHANGED if necessary before saving

Overrides:

save in class Mbo

Throws:

MXException

java.rmi.RemoteException

isDifferentFromPreviousRevision

protected boolean isDifferentFromPreviousRevision()
                                           throws MXException,
                                                  java.rmi.RemoteException

Determines if this task is different from a previous revision

Returns:

true if this task has a previous revision and is different from it, false othewise

Throws:

MXException

java.rmi.RemoteException

validateCondPredExist

public void validateCondPredExist(java.lang.String attributeName)
                           throws java.rmi.RemoteException,
                                  MXException

This method is called from the PREDECESSORTASKS and CONDITIONNUM fields on a job task. A check is done here to see if there are any existing predecessors or conditions for the tasks on this job plan if either of these two fields are getting a value for the first time within the whole task set. The user is warned that conditions or predecessors exist on one or more job tasks for this job plan so they can set up tasks accordingly. This is done so that there are no gaps left sequentially in case a task is not copied for example if the condition is evaluated false.

Parameters:

attributeName - The attribute name from which this is called

Throws:

MXException

java.rmi.RemoteException