Package overit.geocallapp.wfm.orchestrator.scheduling.bl.activityassignment.task

Class BTActivityManualTeamAssignment<T extends ActivityManualTeamAssignmentInput>

java.lang.Object

overit.geocall.bl.BusinessTask<SimpleBusinessEvent<T,ActivityManualAssignmentOutput>>

overit.geocallapp.utilities.core.bl.common.validexecution.ValidExecutionBusinessTask<SimpleBusinessEvent<T,ActivityManualAssignmentOutput>>

overit.geocallapp.utilities.core.bl.common.validexecution.ValidPermissionBusinessTask<SimpleBusinessEvent<T,ActivityManualAssignmentOutput>>

overit.geocallapp.wfm.orchestrator.scheduling.bl.activityassignment.task.BTBaseActivityManualAssignment<T>

overit.geocallapp.wfm.orchestrator.scheduling.bl.activityassignment.task.BTActivityManualTeamAssignment<T>

All Implemented Interfaces:

Serializable, Tool, ValidExecution

@Event(ActivityManualTeamAssignmentEvent.class)
public class BTActivityManualTeamAssignment<T extends ActivityManualTeamAssignmentInput>
extends BTBaseActivityManualAssignment<T>

Business task in order to schedule an activity to a resource.
Error Code:

• Codes.ManualScheduling.STATUS_NOT_ALLOWED
• Codes.ManualScheduling.ACTIVITY_DATE_BLOCKED
• Codes.ManualScheduling.WRONG_APPOINTMENT_DATE
• Codes.ManualScheduling.APPOINTMENT_ALREADY_DEFINED
• Codes.ManualScheduling.INVALID_ACTIVITY_COORDINATES
• Codes.ManualScheduling.CANNOT_DEDUCE_DEPARTURE_ADDRESS
• Codes.ManualScheduling.CANNOT_DEDUCE_ARRIVAL_ADDRESS
• Codes.ManualScheduling.INVALID_ARRIVAL_ADDRESS_COORDINATES
• Codes.ManualScheduling.INVALID_DEPARTURE_ADDRESS_COORDINATES
• Codes.ManualScheduling.WORKSHIFT_TIME_EXCEEDED
• Codes.ManualScheduling.ACTION_NOT_ALLOWED_ON_PASSED_DAYS
• Codes.ManualScheduling.ACTION_NOT_POSSIBLE_ON_LOCKED_DAYS
• Codes.ManualScheduling.OPERATION_IS_BOOKING
• Codes.ManualScheduling.RESOURCE_UNAVAILABLE
• Codes.ManualScheduling.ACTIVITY_SCHEDULING_MODE_NOT_VALID
• Codes.ManualScheduling.OPERATION_NOT_ALLOWED_FROM_PROJECT
• Codes.ManualScheduling.WORKSHIFT_END_TIME_EXCEEDED
• Codes.ManualScheduling.WORKSHIFT_OVERTIME_TIME_EXCEEDED
• Codes.ManualScheduling.WRONG_WORKSHIFTS_DAYS
• Codes.ManualScheduling.WRONG_WORKSHIFTS_OC

Since:

18.0

See Also:

• Serialized Form

GCApi:

task

Field Summary

Fields inherited from class overit.geocallapp.wfm.orchestrator.scheduling.bl.activityassignment.task.BTBaseActivityManualAssignment

eventInput, output

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

LOG

Constructor Summary

Constructors

Constructor	Description
BTActivityManualTeamAssignment()

Method Summary

Modifier and Type	Method	Description
protected void	assignActivity(PoolKit poolKit)	Schedule the current activity in the work shift of the resource, aligning previous and next activities.
protected void	buildTravelData(PoolKit poolKit)	Calculated the travel data needed to assign the activity to the team
protected void	checkCrewShell(PoolKit poolKit)	Evaluate if the assignation of the activity can be done checking the resource configuration.
protected void	checkTeamWorkShifts()	Checks if the input work shifts can be used for the assignment
protected void	defineCoordinatesFromScheduling()	Define the start coordinate of each team resources using the previous scheduling coordinates.
protected org.locationtech.jts.geom.Coordinate	defineCoordinatesFromWorkShift(PoolKit poolKit)	Define the start coordinate of each team resources using the work shift or the team configuration.
protected void	defineResourceCoordianteFromWorkShift(SchedulingTeamResource resource, PoolKit poolKit)	Define the start and end coordinates of the resource
protected void	defineTeamDislocation(Long idTeamDislocation)
protected void	defineTransferTime(org.locationtech.jts.geom.Coordinate defaultTeamCoordinate, PoolKit poolKit)
protected Long	getPlanningAction()	This method doesn't refer to the constants of core module of planning action.
protected Long	getResourceStartAddress(SchedulingTeamResource resource)	Return the start address of the resource
protected Long	getTeamDislocation(SchedulingTeamResource resource)	Returns the team dislocation of the working team
protected Long	getTeamLocation(SchedulingTeamResource resource)	Returns the team location of the working team
protected Double	getTimeBetweenCoordiates(Long ossSpace, Long operationCenter, org.locationtech.jts.geom.Coordinate startCoordinate, org.locationtech.jts.geom.Coordinate endCoordinate, PoolKit poolKit)	Calls the VRP for calculate the movement time between the two input coordinates
protected void	initialChecks(PoolKit poolKit)	Initial checks that evaluate if the operations is assignable to a resource.
protected SchedulingTeam	loadTeam(PoolKit poolKit)	Loads the team on which the activity will be assigned
protected void	updateAssistantsSchedulingsId()	Updates the list of assistants schedulings id in the foreman scheduling
protected void	updateRelatedWorkshifts()	Sets the list of workshift id of the team members
protected void	validateEventInput()

Methods inherited from class overit.geocallapp.wfm.orchestrator.scheduling.bl.activityassignment.task.BTBaseActivityManualAssignment

alignAgenda, buildOutput, calculateMissingSkills, calculateTimeAndDistanceInformation, checkActivity, checkActivityBlockDate, checkBookingDate, checkFreezingDay, checkScheduledTimeOnWorkshift, checkSchedulingsOfAgendas, createNewAgenda, execute, getAllResourcesSchedulings, getContext, getIntegrationService, getInterventionDuration, getLock, initializeContext, insertBasicScheduling, isValidExecution, launchCompleteManualActionEvent, launchSchedulingCheckEvent, loadWorkShiftDays, notifyActivityScheduled, notifyInsert, prepareTeam, reloadSchedulings, retrieveAgenda, retrieveAppointment, saveInitialSchedulings, savePlanningHistory, setContext, updateNextsSchedulingsOrder, updateParentScheduling, updatePreviousNextSchedulingCoordinatesPath, updateSchedulings, updateStatus, updateWorkshiftTourData

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

BTActivityManualTeamAssignment

public BTActivityManualTeamAssignment()

Method Details

loadTeam

protected SchedulingTeam loadTeam(PoolKit poolKit)
                           throws DAValidateException,
DAException

Description copied from class: BTBaseActivityManualAssignment

Loads the team on which the activity will be assigned

Specified by:

loadTeam in class BTBaseActivityManualAssignment<T extends ActivityManualTeamAssignmentInput>

Parameters:

poolKit - the PoolKit

Returns:

Throws:

DAValidateException

DAException

validateEventInput

protected void validateEventInput()

Overrides:

validateEventInput in class BTBaseActivityManualAssignment<T extends ActivityManualTeamAssignmentInput>

checkCrewShell

protected void checkCrewShell(PoolKit poolKit)
                       throws DAValidateException,
DAException

Evaluate if the assignation of the activity can be done checking the resource configuration.
Is not possible to assign activities to crew shells or members of a crew shell.

Specified by:

checkCrewShell in class BTBaseActivityManualAssignment<T extends ActivityManualTeamAssignmentInput>

Throws:

DAValidateException

DAException

initialChecks

protected void initialChecks(PoolKit poolKit)
                      throws DAValidateException,
DAException

Initial checks that evaluate if the operations is assignable to a resource.

Overrides:

initialChecks in class BTBaseActivityManualAssignment<T extends ActivityManualTeamAssignmentInput>

Parameters:

poolKit - the PoolKit

Throws:

DAValidateException - the DA validate exception

DAException - the DA exception

checkTeamWorkShifts

protected void checkTeamWorkShifts()
                            throws DAValidateException

Checks if the input work shifts can be used for the assignment

Throws:

DAValidateException

assignActivity

protected void assignActivity(PoolKit poolKit)
                       throws DAValidateException,
DAException

Schedule the current activity in the work shift of the resource, aligning previous and next activities.

Specified by:

assignActivity in class BTBaseActivityManualAssignment<T extends ActivityManualTeamAssignmentInput>

Parameters:

poolKit - the PoolKit

Throws:

DAValidateException - the DA validate exception

DAException - the DA exception

updateAssistantsSchedulingsId

protected void updateAssistantsSchedulingsId()

Updates the list of assistants schedulings id in the foreman scheduling

updateRelatedWorkshifts

protected void updateRelatedWorkshifts()

Sets the list of workshift id of the team members

buildTravelData

protected void buildTravelData(PoolKit poolKit)
                        throws DAValidateException,
DAException

Calculated the travel data needed to assign the activity to the team

Throws:

DAValidateException

DAException

defineCoordinatesFromWorkShift

protected org.locationtech.jts.geom.Coordinate defineCoordinatesFromWorkShift(PoolKit poolKit)
                                                                       throws DAValidateException,
DAException

Define the start coordinate of each team resources using the work shift or the team configuration.

Throws:

DAException

DAValidateException

defineCoordinatesFromScheduling

protected void defineCoordinatesFromScheduling()

Define the start coordinate of each team resources using the previous scheduling coordinates.

getTeamLocation

protected Long getTeamLocation(SchedulingTeamResource resource)

Returns the team location of the working team

Parameters:

resource - the SchedulingTeamResource

Returns:

the team location id

getTeamDislocation

protected Long getTeamDislocation(SchedulingTeamResource resource)

Returns the team dislocation of the working team

Parameters:

resource - the SchedulingTeamResource

Returns:

the team dislocation id

getResourceStartAddress

protected Long getResourceStartAddress(SchedulingTeamResource resource)

Return the start address of the resource

Parameters:

resource - the SchedulingTeamResource

Returns:

the start address of the resource

defineResourceCoordianteFromWorkShift

protected void defineResourceCoordianteFromWorkShift(SchedulingTeamResource resource,
 PoolKit poolKit)
                                              throws DAValidateException,
DAException

Define the start and end coordinates of the resource

Parameters:

resource - the SchedulingTeamResource

poolKit - the PoolKit

Throws:

DAValidateException

DAException

defineTeamDislocation

protected void defineTeamDislocation(Long idTeamDislocation)

defineTransferTime

protected void defineTransferTime(org.locationtech.jts.geom.Coordinate defaultTeamCoordinate,
 PoolKit poolKit)
                           throws DAValidateException,
DAException

Throws:

DAValidateException

DAException

getTimeBetweenCoordiates

protected Double getTimeBetweenCoordiates(Long ossSpace,
 Long operationCenter,
 org.locationtech.jts.geom.Coordinate startCoordinate,
 org.locationtech.jts.geom.Coordinate endCoordinate,
 PoolKit poolKit)
                                   throws DAValidateException,
DAException

Calls the VRP for calculate the movement time between the two input coordinates

Parameters:

ossSpace - the OSSSpace id

operationCenter - the BOOperationCenter id

startCoordinate - the start coordinate

endCoordinate - the end coordinate

Returns:

the movement time between the two input coordinates

Throws:

DAValidateException

DAException

getPlanningAction

protected Long getPlanningAction()

This method doesn't refer to the constants of core module of planning action. We don't want to manage planning action outside core module, for now we fix the basic value

Specified by:

getPlanningAction in class BTBaseActivityManualAssignment<T extends ActivityManualTeamAssignmentInput>