Package overit.geocallapp.wfm.core.bl.schedule.bundler.task

Class BTBundleSchedulingRecalculation

java.lang.Object

overit.geocall.bl.BusinessTask<BundleSchedulingRecalculationEvent>

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

overit.geocallapp.wfm.bundler.bl.task.BTBundler<BundleSchedulingRecalculationEvent>

overit.geocallapp.wfm.core.bl.schedule.bundler.task.BTBundleSchedulingRecalculation

All Implemented Interfaces:

Serializable, Tool, ValidExecution

@Event(BundleSchedulingRecalculationEvent.class)
public class BTBundleSchedulingRecalculation
extends BTBundler<BundleSchedulingRecalculationEvent>

Business task in order to recalculate the scheduling relations between the given list of BOWorkOrderOperations that are part of a Bundle.
The BundleSchedulingRecalculationEvent is called when a BOWorkOrderOperation is unlinked from a schedulated Bundle and therefore the "parent-children" relations between all its other BOWorkOrderOperation changed.
When the BundleSchedulingRecalculationEvent is launched the BT notices the call and recalculate the scheduling relations basing on the event's input.

Since:

10.1

See Also:

• Serialized Form

GCApi:

task

Constructor Summary

Constructors

Constructor	Description
BTBundleSchedulingRecalculation()

Method Summary

Modifier and Type	Method	Description
protected void	alignWorkShiftSchedulings(Set<Long> workShiftIds, PoolKit poolKit)	Aligns all the needed scheduling informations that are related to the given BOWorkShift.
protected void	cancelUnlinkedSchedulings(List<Long> parents, PoolKit poolKit)	Cancels the given schedulings that are related to the given unlinked BOWorkOrderOperations
protected void	execute(BundleSchedulingRecalculationEvent event, PoolKit poolKit)	Executes the recalculation of scheduling relations.
protected DBView	loadActiveSchedulings(List<Long> operations, PoolKit poolKit)	Loads the not cancelled schedulings related to the list of remaining BOWorkOrderOperations.
protected Set<Long>	recalculateLinks(List<Long> linkedOperations, Bundle bundle, PoolKit poolKit)	Recalculates the new links between the remaining schedulings.
protected List<Long>	unlink(Long unlinkingOperation, PoolKit poolKit)	Unlinks the schedulings related to the given BOWorkOrderOperation.
protected void	update(Long id, Long parent, String children, Long duration, PoolKit poolKit)	Updates the scheduling with the given informations.

Methods inherited from class overit.geocallapp.wfm.bundler.bl.task.BTBundler

getException, isValidExecution, throwExceptionIfInvalid

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

body, checkValidExecution, 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

BTBundleSchedulingRecalculation

public BTBundleSchedulingRecalculation()

Method Details

execute

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

Executes the recalculation of scheduling relations.

Specified by:

execute in class ValidExecutionBusinessTask<BundleSchedulingRecalculationEvent>

Parameters:

event - the BundleSchedulingRecalculationEvent

poolKit - the PoolKit

Throws:

DAException - the DA exception

DAValidateException - the DA validate exception

cancelUnlinkedSchedulings

protected void cancelUnlinkedSchedulings(List<Long> parents,
 PoolKit poolKit)
                                  throws DAException,
DAValidateException

Cancels the given schedulings that are related to the given unlinked BOWorkOrderOperations

Parameters:

parents - list of schedulings to cancel

poolKit - the PoolKit

Throws:

DAException - the DA exception

DAValidateException - the DA validate exception

recalculateLinks

protected Set<Long> recalculateLinks(List<Long> linkedOperations,
 Bundle bundle,
 PoolKit poolKit)
                              throws DAException,
DAValidateException

Recalculates the new links between the remaining schedulings.

Parameters:

linkedOperations - list of remaining BOWorkOrderOperations

bundle - the current Bundle

poolKit - the PoolKit

Returns:

the set of BOWorkShifts related to the elaborated schedulings

Throws:

DAException - the DA exception

DAValidateException - the DA validate exception

unlink

protected List<Long> unlink(Long unlinkingOperation,
 PoolKit poolKit)
                     throws DAException,
DAValidateException

Unlinks the schedulings related to the given BOWorkOrderOperation.

Parameters:

unlinkingOperation - the BOWorkOrderOperation to unlink

poolKit - the PoolKit

Returns:

a list of related schedulings

Throws:

DAException - the DA exception

DAValidateException - the DA validate exception

See Also:

• Long

loadActiveSchedulings

protected DBView loadActiveSchedulings(List<Long> operations,
 PoolKit poolKit)
                                throws DAException,
DAValidateException

Loads the not cancelled schedulings related to the list of remaining BOWorkOrderOperations. Only schedulings associated with the last appointment for each operation are returned.

Parameters:

operations - list of remaining BOWorkOrderOperations

poolKit - the PoolKit

Returns:

the related schedulings

Throws:

DAException - the DA exception

DAValidateException - the DA validate exception

update

protected void update(Long id,
 Long parent,
 String children,
 Long duration,
 PoolKit poolKit)
               throws DAException,
DAValidateException

Updates the scheduling with the given informations.

Parameters:

id - the id of the scheduling to consider

parent - the parent of the scheduling

children - the children of the scheduling

duration - the duration of the scheduling (null if the of the scheduling is a child)

poolKit - the PoolKit

Throws:

DAException - the DA exception

DAValidateException - the DA validate exception

alignWorkShiftSchedulings

protected void alignWorkShiftSchedulings(Set<Long> workShiftIds,
 PoolKit poolKit)
                                  throws DAException,
DAValidateException

Aligns all the needed scheduling informations that are related to the given BOWorkShift.

Parameters:

workShiftIds - the BOWorkShift id

poolKit - the PoolKit

Throws:

DAException - the DA exception

DAValidateException - the DA validate exception