Package overit.geocallapp.wfm.core.bl.timesheet.task

Class BTTimesheetTaskUpdate

java.lang.Object

overit.geocall.bl.BusinessTask<TimesheetTaskUpdateEvent>

overit.geocallapp.wfm.core.bl.timesheet.task.BTTimesheet<TimesheetTaskUpdateEvent>

overit.geocallapp.wfm.core.bl.timesheet.task.BTTimesheetTaskUpdate

All Implemented Interfaces:

Serializable, Tool

@Event(TimesheetTaskUpdateEvent.class)
public class BTTimesheetTaskUpdate
extends BTTimesheet<TimesheetTaskUpdateEvent>

Business task in order to update a BOTask.
When the TimesheetTaskUpdateEvent is launched the BT notices the call and updates the BOTask basing on the event's input.

Required fields:

• timesheet task id

Error Code:

• Codes.Timesheet.Validation.TIMESHEET_NOT_EDITABLE
• Codes.Timesheet.Validation.END_DATE_EARLIER_START_DATE
• Codes.Timesheet.Validation.TIMESHEET_NOT_INCLUDE_DATES
• Codes.Timesheet.Validation.SERVER_EDIT_NOT_ALLOWED
• Codes.Timesheet.Validation.MOBILE_EDIT_NOT_ALLOWED
• Codes.Timesheet.Validation.FUTURE_INSERTION_NOT_AVAILABLE
• Codes.Timesheet.Validation.UNAVAILABILITY_REASON_REQUIRED
• Codes.Timesheet.Validation.INTERVENTION_REQUIRED

After updating tht timesheet task, it recalculates all the timesheet durations and warnings.

Since:

9.2

See Also:

• Serialized Form

GCApi:

task

Constructor Summary

Constructors

Constructor	Description
BTTimesheetTaskUpdate()

Method Summary

Modifier and Type	Method	Description
protected void	calculateDuration(Timesheet timesheet, PoolKit poolKit)	Calculates all the timesheet durations.
protected List<TimesheetShiftCalculationOutput>	calculateTaskShifts(Timesheet timesheet, Date startDate, Date endDate, PoolKit poolKit)
protected void	calculateWarnings(Timesheet timesheet, PoolKit poolKit)	Calculates all the timesheet warnings.
protected void	cancelLinkedTasks(PoolKit poolKit, List<BOTask> linkedTasks)
protected void	checkTimesheetState(Timesheet timesheet)	Checks the timesheet state for this operation.
protected BOEventEntity	createEventEntity(Long intervention)	Create a new BOEventEntity that refers to an intervention.
protected void	execute(TimesheetTaskUpdateEvent event, PoolKit poolKit)	Updates the BOTask and recalculates all the timesheet durations and warnings.
protected Long	insertEventEntity(BOEventEntity eventEntity, PoolKit poolKit)	Inserts the BOEventEntity in the repository.
protected void	insertTasks(TimesheetTaskUpdateInput input, Long user, Date startDate, Date endDate, PoolKit poolKit)
protected boolean	isSameShift(Timesheet timesheet, BOTask task, Date startDate, Date endDate, PoolKit poolKit)
protected List<BOTask>	loadLinkedTasks(BOTask task, PoolKit poolKit)
protected BOTask	loadTask(Long taskId, PoolKit poolKit)	Loads a BOTask.
protected Timesheet	loadTimesheet(TimesheetTaskUpdateInput input, PoolKit poolKit)	Loads the Timesheet.
protected BOTask	prepareTaskData(TimesheetTaskUpdateInput input, BOTask task, Long eventEntityId)	Prepares the task data for the update.
protected void	updateEventEntity(BOEventEntity eventEntity, PoolKit poolKit)	Updates the BOEventEntity in the repository.
protected void	updateTask(TimesheetTaskUpdateInput input, Timesheet timesheet, BOTask task, PoolKit poolKit)	Updates the BOTask.
protected Long	upsertEventEntity(TimesheetTaskUpdateInput input, Timesheet timesheet, BOTask task, PoolKit poolKit)	Insert or update the BOEventEntity related to the task.
protected void	validateData(TimesheetTaskUpdateInput input, Timesheet timesheet, PoolKit poolKit)	Validates the event's input data.

Methods inherited from class overit.geocallapp.wfm.core.bl.timesheet.task.BTTimesheet

body, checkTimesheetActivation, throwInactiveTimesheetException

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

BTTimesheetTaskUpdate

public BTTimesheetTaskUpdate()

Method Details

execute

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

Updates the BOTask and recalculates all the timesheet durations and warnings.

Specified by:

execute in class BTTimesheet<TimesheetTaskUpdateEvent>

Parameters:

event - the timesheet task update event

poolKit - the pool kit

Throws:

DAException - the DA exception

DAValidateException - the DA validate exception

loadTimesheet

protected Timesheet loadTimesheet(TimesheetTaskUpdateInput input,
 PoolKit poolKit)
                           throws DAValidateException,
DAException

Loads the Timesheet.

Parameters:

input - the input of the event

poolKit - the pool kit

Returns:

the laoded Timesheet

Throws:

DAValidateException - the DA validate exception

DAException - the DA exception

checkTimesheetState

protected void checkTimesheetState(Timesheet timesheet)
                            throws DAValidateException

Checks the timesheet state for this operation.

Parameters:

timesheet - the given Timesheet

Throws:

DAValidateException

validateData

protected void validateData(TimesheetTaskUpdateInput input,
 Timesheet timesheet,
 PoolKit poolKit)
                     throws DAValidateException,
DAException

Validates the event's input data.

Parameters:

input - the input of the event

timesheet - the given Timesheet

poolKit - the pool kit

Throws:

DAValidateException - the DA validate exception

DAException - the DA exception

loadTask

protected BOTask loadTask(Long taskId,
 PoolKit poolKit)
                   throws DAValidateException,
DAException

Loads a BOTask.

Parameters:

taskId - the task id

poolKit - the pool kit

Returns:

the BOTask with the given id

Throws:

DAValidateException - the DA validate exception

DAException - the DA exception

isSameShift

protected boolean isSameShift(Timesheet timesheet,
 BOTask task,
 Date startDate,
 Date endDate,
 PoolKit poolKit)
                       throws DAValidateException,
DAException

Throws:

DAValidateException

DAException

calculateTaskShifts

protected List<TimesheetShiftCalculationOutput> calculateTaskShifts(Timesheet timesheet,
 Date startDate,
 Date endDate,
 PoolKit poolKit)
                                                             throws DAValidateException,
DAException

Throws:

DAValidateException

DAException

updateTask

protected void updateTask(TimesheetTaskUpdateInput input,
 Timesheet timesheet,
 BOTask task,
 PoolKit poolKit)
                   throws DAValidateException,
DAException

Updates the BOTask.

Parameters:

input - the input of the event

timesheet - the given Timesheet

poolKit - the pool kit

Throws:

DAValidateException - the DA validate exception

DAException - the DA exception

upsertEventEntity

protected Long upsertEventEntity(TimesheetTaskUpdateInput input,
 Timesheet timesheet,
 BOTask task,
 PoolKit poolKit)
                          throws DAValidateException,
DAException

Insert or update the BOEventEntity related to the task.

Parameters:

input - the input of the event

timesheet - the given Timesheet

poolKit - the pool kit

Returns:

the event entity id

Throws:

DAValidateException - the DA validate exception

DAException - the DA exception

createEventEntity

protected BOEventEntity createEventEntity(Long intervention)

Create a new BOEventEntity that refers to an intervention.

Parameters:

intervention - the intervention id

Returns:

the new event entity

insertEventEntity

protected Long insertEventEntity(BOEventEntity eventEntity,
 PoolKit poolKit)
                          throws DAValidateException,
DAException

Inserts the BOEventEntity in the repository.

Parameters:

eventEntity - the given event entity

poolKit - the pool kit

Returns:

the inserted event entity id

Throws:

DAValidateException - the DA validate exception

DAException - the DA exception

updateEventEntity

protected void updateEventEntity(BOEventEntity eventEntity,
 PoolKit poolKit)
                          throws DAValidateException,
DAException

Updates the BOEventEntity in the repository.

Parameters:

eventEntity - the given event entity

poolKit - the pool kit

Throws:

DAValidateException - the DA validate exception

DAException - the DA exception

prepareTaskData

protected BOTask prepareTaskData(TimesheetTaskUpdateInput input,
 BOTask task,
 Long eventEntityId)

Prepares the task data for the update.

Parameters:

input - the input of the event

Returns:

the BOTask containing the new values for the update

calculateDuration

protected void calculateDuration(Timesheet timesheet,
 PoolKit poolKit)
                          throws DAValidateException,
DAException

Calculates all the timesheet durations.

Parameters:

timesheet - the given Timesheet

poolKit - the pool kit

Throws:

DAException

DAValidateException

calculateWarnings

protected void calculateWarnings(Timesheet timesheet,
 PoolKit poolKit)
                          throws DAValidateException,
DAException

Calculates all the timesheet warnings.

Parameters:

timesheet - the given Timesheet

poolKit - the pool kit

Throws:

DAException

DAValidateException

cancelLinkedTasks

protected void cancelLinkedTasks(PoolKit poolKit,
 List<BOTask> linkedTasks)
                          throws DAValidateException,
DAException

Throws:

DAValidateException

DAException

loadLinkedTasks

protected List<BOTask> loadLinkedTasks(BOTask task,
 PoolKit poolKit)
                                throws DAValidateException,
DAException

Throws:

DAValidateException

DAException

insertTasks

protected void insertTasks(TimesheetTaskUpdateInput input,
 Long user,
 Date startDate,
 Date endDate,
 PoolKit poolKit)
                    throws DAValidateException,
DAException

Throws:

DAValidateException

DAException