Package overit.geocallapp.wfm.core.bl.crewshell.composition.draft.task

Class BTCrewShellTechnicianInsert

java.lang.Object

overit.geocall.bl.BusinessTask<CrewShellTechnicianInsertEvent>

overit.geocallapp.utilities.core.bl.common.validexecution.ValidExecutionBusinessTask<CrewShellTechnicianInsertEvent>

overit.geocallapp.utilities.core.bl.common.validexecution.ValidPermissionBusinessTask<CrewShellTechnicianInsertEvent>

overit.geocallapp.wfm.core.bl.crewshell.composition.draft.task.BTCrewShellTechnicianInsert

All Implemented Interfaces:

Serializable, Tool, ValidExecution

@Event(CrewShellTechnicianInsertEvent.class)
public class BTCrewShellTechnicianInsert
extends ValidPermissionBusinessTask<CrewShellTechnicianInsertEvent>

Business task to insert a BOCrewShellDraftComposition object.
When the CrewShellTechnicianInsertEvent event is launched the BT notices the call and inserts the BOCrewShellDraftComposition object basing on the event's input.

Since:

16.0

See Also:

• Serialized Form

GCApi:

task

Field Summary

Fields inherited from class overit.geocallapp.utilities.core.bl.common.validexecution.ValidPermissionBusinessTask

LOG

Constructor Summary

Constructors

Constructor	Description
BTCrewShellTechnicianInsert()

Method Summary

Modifier and Type	Method	Description
protected void	alignCrewShellComposition(Long crewShellID, Date day, PoolKit pk)	Aligns the composition of a BOCrewShell object (i.e., crew shell) for the selected Date day (i.e., composition day) if its composition changes.
protected void	execute(CrewShellTechnicianInsertEvent event, PoolKit poolKit)	Executes the actual business logic after validation has passed.
protected void	initCache()	Initializes the BOCache object to load a BOCrewShell object.
boolean	isValidExecution()	Determines whether the current state is valid for execution.
protected List<BOCrewShellDraftComposition>	retrieveTechniciansByCrewShellAndDay(BOCrewShellDraftComposition input, PoolKit poolKit)	Retrieves the draft composition of a BOCrewShell object for the selected day, i.e., the list of associated BOSchedulingUser objects.
protected void	validateAllocation(BOCrewShellDraftComposition input, PoolKit poolKit)	Validates the data of the BOCrewShellDraftComposition object to be inserted.

Methods inherited from class overit.geocallapp.utilities.core.bl.common.validexecution.ValidPermissionBusinessTask

checkValidExecution, getException, throwExceptionIfInvalid

Methods inherited from class overit.geocallapp.utilities.core.bl.common.validexecution.ValidExecutionBusinessTask

body, getEvent

Methods inherited from class overit.geocall.bl.BusinessTask

start, start, startAlone, startInBackground

Methods inherited from class java.lang.Object

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

Constructor Details

BTCrewShellTechnicianInsert

public BTCrewShellTechnicianInsert()

Method Details

isValidExecution

public boolean isValidExecution()

Description copied from interface: ValidExecution

Determines whether the current state is valid for execution.

Returns:

true if execution is valid, false otherwise

execute

protected void execute(CrewShellTechnicianInsertEvent event,
 PoolKit poolKit)
                throws DAException,
DAValidateException

Description copied from class: ValidExecutionBusinessTask

Executes the actual business logic after validation has passed.

Specified by:

execute in class ValidExecutionBusinessTask<CrewShellTechnicianInsertEvent>

Parameters:

event - the input event to process

poolKit - the PoolKit

Throws:

DAException - if a data access error occurs during execution

DAValidateException - if validation fails during execution

validateAllocation

protected void validateAllocation(BOCrewShellDraftComposition input,
 PoolKit poolKit)
                           throws DAValidateException,
DAException

Validates the data of the BOCrewShellDraftComposition object to be inserted. It checks if the BOCrewShellDraftComposition object's foreman field is null. It checks if the BOCrewShellDraftComposition object's day field is not in the past. It checks if the BOCrewShell object and the BOCrewShellDraftComposition input are not null. It checks if the BOCrewShell object is active. It checks if, in the specified day, there is not already an association between the given BOCrewShell object and the selected BOSchedulingUser object. It checks if, in the specified day, there is not already an association between any BOCrewShell object and the selected BOSchedulingUser object.

Parameters:

input - the current BOCrewShellDraftComposition input to be validated

poolKit - the PoolKit poolkit

Throws:

DAValidateException - if there is a data validation exception

DAException - if a generic Exception object is thrown

retrieveTechniciansByCrewShellAndDay

protected List<BOCrewShellDraftComposition> retrieveTechniciansByCrewShellAndDay(BOCrewShellDraftComposition input,
 PoolKit poolKit)
                                                                          throws DAValidateException,
DAException

Retrieves the draft composition of a BOCrewShell object for the selected day, i.e., the list of associated BOSchedulingUser objects.

Parameters:

input - the current BOCrewShellDraftComposition input to be validated

poolKit - the PoolKit poolkit

Returns:

searchEvent.launch(poolKit).getContent(); the composition of a BOCrewShell object for the selected day

Throws:

DAValidateException - if there is a data validation exception

DAException - if a generic Exception object is thrown

alignCrewShellComposition

protected void alignCrewShellComposition(Long crewShellID,
 Date day,
 PoolKit pk)
                                  throws DAException,
DAValidateException

Aligns the composition of a BOCrewShell object (i.e., crew shell) for the selected Date day (i.e., composition day) if its composition changes.

Parameters:

crewShellID - the crew shell's ID

day - the composition date

pk - the PoolKit poolkit

Throws:

DAValidateException - if there is a data validation exception

DAException - if a generic Exception object is thrown

initCache

protected void initCache()

Initializes the BOCache object to load a BOCrewShell object.