Package overit.geocallapp.wfm.booking.bl.appointment.task

Class BTAppointmentPropose

java.lang.Object

overit.geocall.bl.BusinessTask<AppointmentProposeEvent>

overit.geocallapp.wfm.core.bl.common.validexecution.ValidExecutionBusinessTask<AppointmentProposeEvent>

overit.geocallapp.wfm.core.bl.common.validexecution.ValidPermissionBusinessTask<AppointmentProposeEvent>

overit.geocallapp.wfm.booking.bl.task.BTBookingManagement<AppointmentProposeEvent>

overit.geocallapp.wfm.booking.bl.appointment.task.BTAppointmentPropose

All Implemented Interfaces:

Serializable, Tool, ValidExecution

@Event(AppointmentProposeEvent.class)
public class BTAppointmentPropose
extends BTBookingManagement<AppointmentProposeEvent>

Business task in order to to find a list of BOAppointment proposal to perform a given activity.
When the AppointmentProposeEvent is launched the BT notices the call and searches for the BOAppointment proposals basing on the event's input.
The task is structured by these steps:

• data validation
• starting from the given activity (work order type), external code and external system, it verifies whether a WorkOrder already exists
• if no such order was found, we create a new work order for the required activity by calling the WorkOrderCreateFromWorkCycleEvent
• it calls the booking module to obtain the list of slots during which the activity can be performed
• if the list of slots is not empty, it creates a temporary appointment and the related agenda

Since:

15.0

See Also:

• Serialized Form

GCApi:

task

Constructor Summary

Constructors

Constructor	Description
BTAppointmentPropose()

Method Summary

Modifier and Type	Method	Description
protected void	checkBookingWorkOrder(WorkOrder workOrder, PoolKit poolKit)	Checks that the given WorkOrder has a not cancelled booking work order.
protected WorkOrder	createWorkOrder(BOWorkOrderHeader workOrderHeader, TechnicalObject technicalObject, PoolKit poolKit)	Creates the WorkOrder starting from the given data.
protected void	execute(AppointmentProposeEvent event, PoolKit poolKit)	Proposes a list of possible appointments slots for the given activity.
protected Long	getActivityCost(BOOperationActivity operationActivity, BOWorkOrderOperation woOperation, PoolKit poolKit)
protected void	insertAgenda(Long appointmentId, PoolKit poolKit)
protected Long	insertAppointment(WorkOrder workOrder, BOWorkOrderOperation woOperation, ExternalTeamTimeSlot firstSlot, PoolKit poolKit)
boolean	isValidExecution()	Checks if the execution is valid.
protected List<ExternalTeamTimeSlot>	loadAvailableSlots(WorkOrder workOrder, PoolKit poolKit)
protected BOAppointment	loadExistingTemporaryAppointment(Long id, PoolKit poolKit)
protected BOOperationActivity	loadOperationActivity(Long id, PoolKit poolKit)
protected WorkOrder	loadWorkOrder(Long id, PoolKit poolKit)	Loads the WorkOrder from the given id.
protected WorkOrder	searchWorkOrder(BOWorkOrderHeader workOrderHeader, PoolKit poolKit)	Searches for a work order with the given characteristics.
protected void	validateData(AppointmentProposeInput input)	Validates the input data.

Methods inherited from class overit.geocallapp.wfm.booking.bl.task.BTBookingManagement

checkValidExecution

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

getException, throwExceptionIfInvalid

Methods inherited from class overit.geocallapp.wfm.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

BTAppointmentPropose

public BTAppointmentPropose()

Method Details

isValidExecution

public boolean isValidExecution()

Checks if the execution is valid.

Returns:

true, if successful

execute

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

Proposes a list of possible appointments slots for the given activity.

Specified by:

execute in class ValidExecutionBusinessTask<AppointmentProposeEvent>

Parameters:

event - the AppointmentProposeEvent

poolKit - the PoolKit

Throws:

DAException - the DA exception

DAValidateException - the DA validate exception

validateData

protected void validateData(AppointmentProposeInput input)
                     throws DAValidateException

Validates the input data.

Parameters:

input - the AppointmentProposeInput

Throws:

DAValidateException - the DA validate exception

checkBookingWorkOrder

protected void checkBookingWorkOrder(WorkOrder workOrder,
 PoolKit poolKit)
                              throws DAValidateException,
DAException

Checks that the given WorkOrder has a not cancelled booking work order.

Parameters:

workOrder - the given WorkOrder

poolKit - the PoolKit

Throws:

DAValidateException - the DA validate exception

DAException - the DA exception

createWorkOrder

protected WorkOrder createWorkOrder(BOWorkOrderHeader workOrderHeader,
 TechnicalObject technicalObject,
 PoolKit poolKit)
                             throws DAValidateException,
DAException

Creates the WorkOrder starting from the given data.

Parameters:

workOrderHeader - the BOWorkOrderHeader containing the work order data

technicalObject - the TechnicalObject related to the work order

poolKit - the PoolKit

Returns:

the created WorkOrder

Throws:

DAValidateException - the DA validate exception

DAException - the DA exception

searchWorkOrder

protected WorkOrder searchWorkOrder(BOWorkOrderHeader workOrderHeader,
 PoolKit poolKit)
                             throws DAValidateException,
DAException

Searches for a work order with the given characteristics.

Parameters:

workOrderHeader - the BOWorkOrderHeader containing the data used as filters

poolKit - the PoolKit

Returns:

the loaded WorkOrder

Throws:

DAValidateException - the DA validate exception

DAException - the DA exception

loadWorkOrder

protected WorkOrder loadWorkOrder(Long id,
 PoolKit poolKit)
                           throws DAValidateException,
DAException

Loads the WorkOrder from the given id.

Parameters:

id - the WorkOrder id

poolKit - the PoolKit

Returns:

the loaded WorkOrder

Throws:

DAValidateException - the DA validate exception

DAException - the DA exception

loadAvailableSlots

protected List<ExternalTeamTimeSlot> loadAvailableSlots(WorkOrder workOrder,
 PoolKit poolKit)
                                                 throws DAValidateException,
DAException

Throws:

DAValidateException

DAException

loadExistingTemporaryAppointment

protected BOAppointment loadExistingTemporaryAppointment(Long id,
 PoolKit poolKit)
                                                  throws DAValidateException,
DAException

Throws:

DAValidateException

DAException

insertAppointment

protected Long insertAppointment(WorkOrder workOrder,
 BOWorkOrderOperation woOperation,
 ExternalTeamTimeSlot firstSlot,
 PoolKit poolKit)
                          throws DAValidateException,
DAException

Throws:

DAValidateException

DAException

getActivityCost

protected Long getActivityCost(BOOperationActivity operationActivity,
 BOWorkOrderOperation woOperation,
 PoolKit poolKit)
                        throws DAValidateException,
DAException

Throws:

DAValidateException

DAException

insertAgenda

protected void insertAgenda(Long appointmentId,
 PoolKit poolKit)
                     throws DAException,
DAValidateException

Throws:

DAException

DAValidateException

loadOperationActivity

protected BOOperationActivity loadOperationActivity(Long id,
 PoolKit poolKit)
                                             throws DAValidateException,
DAException

Throws:

DAValidateException

DAException