Package overit.geocallapp.wfm.orchestrator.scheduling.bl.immediatescheduling.teamexclusion.task

Class BTImmediateSchedulingTeamExclusionByShift

java.lang.Object

overit.geocall.bl.BusinessTask<ImmediateSchedulingTeamExclusionEvent>

overit.geocallapp.wfm.orchestrator.scheduling.bl.immediatescheduling.teamexclusion.task.BTImmediateSchedulingTeamExclusion

overit.geocallapp.wfm.orchestrator.scheduling.bl.immediatescheduling.teamexclusion.task.BTImmediateSchedulingTeamExclusionByShift

All Implemented Interfaces:

Serializable, Tool

@Event(value=ImmediateSchedulingTeamExclusionEvent.class,
       priority=10)
public class BTImmediateSchedulingTeamExclusionByShift
extends BTImmediateSchedulingTeamExclusion

Business Task for filtering teams based on shift management rules and unavailability. Excludes teams that: - Have a shift that starts too late (after now + shiftStartExclTimeInterval) - Have a shift that ends too soon (before now + shiftEndExclTimeInterval) - Have foreman with unavailability (work shift exceptions) overlapping with current time

Since:

22.0

See Also:

• Serialized Form

Field Summary

Fields inherited from class overit.geocallapp.wfm.orchestrator.scheduling.bl.immediatescheduling.teamexclusion.task.BTImmediateSchedulingTeamExclusion

integrationService

Constructor Summary

Constructors

Constructor	Description
BTImmediateSchedulingTeamExclusionByShift()

Method Summary

Modifier and Type	Method	Description
protected Map<Long,Long>	buildWorkshiftByResourceId(List<BOWorkShift> foremanWorkShifts, List<BOWorkShift> assistantWorkShifts)	Builds a map of workshift IDs by resource ID for ALL team members (foreman + assistants).
protected Map<Long,Long>	buildWorkshiftsByTeam(List<BOWorkShift> workShifts, Map<Long,Long> foremanByTeam)	Builds a map of workshift IDs by team ID.
protected void	excludeByUnavailability(ImmediateSchedulingTeamExclusionOutput output, Long shiftEndExclTimeInterval, ImmediateSchedulingTeamExclusionInput input, Date date, PoolKit poolKit)
protected void	filter(ImmediateSchedulingTeamExclusionOutput output, ImmediateSchedulingTeamExclusionInput input, PoolKit poolKit)	Applies the specific exclusion filter logic.
protected List<Long>	getAliveResources(List<Long> aliveTeams, Map<Long,Long> foremanByTeam)
protected List<BOWorkShift>	getAssistantWorkshifts(Map<Long,Long> foremanByTeam, Map<Long,List<Long>> teamCompositionByTeamId, List<BOWorkShift> foremanWorkShifts, Date maxShiftStart, Date minShiftEnd, ImmediateSchedulingTeamExclusionInput input, PoolKit poolKit)	Loads workshifts for all assistant resources.
protected Set<Long>	getTeamsWithCompleteWorkshifts(Map<Long,Long> foremanByTeam, Map<Long,List<Long>> teamCompositionByTeamId, Map<Long,Long> workshiftByResourceId)	Returns the set of team IDs where ALL members (foreman + assistants) have valid workshifts.
protected List<BOWorkShiftException>	getUnavailabilities(List<Long> foremenIds, Date date, Date maxUnavailabilityEnd, PoolKit poolKit)
protected List<BOWorkShift>	getWorkshifts(List<Long> foremenIds, Date maxShiftStart, Date minShiftEnd, ImmediateSchedulingTeamExclusionInput input, PoolKit poolKit)

Methods inherited from class overit.geocallapp.wfm.orchestrator.scheduling.bl.immediatescheduling.teamexclusion.task.BTImmediateSchedulingTeamExclusion

body, createInitialTeamCompatibilityMatrix, getIntegrationService, getOutput, recordResourceExclusions, removeTeamsWithoutWorkOrders

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

BTImmediateSchedulingTeamExclusionByShift

public BTImmediateSchedulingTeamExclusionByShift()

Method Details

filter

protected void filter(ImmediateSchedulingTeamExclusionOutput output,
 ImmediateSchedulingTeamExclusionInput input,
 PoolKit poolKit)
               throws DAValidateException,
DAException

Description copied from class: BTImmediateSchedulingTeamExclusion

Applies the specific exclusion filter logic. Implementations should: 1. Remove teams from output.getForemanByAliveTeam() that should be excluded 2. Remove incompatible work orders from output.getTeamWorkOrderCompatibility() 3. Log the excluded resources with appropriate messages Note: Teams are automatically removed by BTImmediateSchedulingTeamExclusion.removeTeamsWithoutWorkOrders(overit.geocallapp.wfm.scheduling.bl.immediatescheduling.teamexclusion.event.ImmediateSchedulingTeamExclusionOutput) if they have no compatible work orders.

Specified by:

filter in class BTImmediateSchedulingTeamExclusion

Parameters:

output - the current output from previous filters (modify foremanByAliveTeam and teamWorkOrderCompatibility)

input - the event input containing scheduling model and reference date

poolKit - the pool kit

Throws:

DAValidateException - if a validation error occurs

DAException - if a data access error occurs

getWorkshifts

protected List<BOWorkShift> getWorkshifts(List<Long> foremenIds,
 Date maxShiftStart,
 Date minShiftEnd,
 ImmediateSchedulingTeamExclusionInput input,
 PoolKit poolKit)
                                   throws DAException,
DAValidateException

Throws:

DAException

DAValidateException

excludeByUnavailability

protected void excludeByUnavailability(ImmediateSchedulingTeamExclusionOutput output,
 Long shiftEndExclTimeInterval,
 ImmediateSchedulingTeamExclusionInput input,
 Date date,
 PoolKit poolKit)
                                throws DAException,
DAValidateException

Throws:

DAException

DAValidateException

getUnavailabilities

protected List<BOWorkShiftException> getUnavailabilities(List<Long> foremenIds,
 Date date,
 Date maxUnavailabilityEnd,
 PoolKit poolKit)
                                                  throws DAException,
DAValidateException

Throws:

DAException

DAValidateException

getAliveResources

protected List<Long> getAliveResources(List<Long> aliveTeams,
 Map<Long,Long> foremanByTeam)

buildWorkshiftsByTeam

protected Map<Long,Long> buildWorkshiftsByTeam(List<BOWorkShift> workShifts,
 Map<Long,Long> foremanByTeam)

Builds a map of workshift IDs by team ID.

This method creates a mapping from team ID to the corresponding workshift ID (ARSHID) for the current day, using the foreman as an intermediary.

Parameters:

workShifts - the list of workshifts loaded during filtering

foremanByTeam - the map of team ID to foreman resource ID

Returns:

the map of team ID → workshift ID (ARSHID)

getAssistantWorkshifts

protected List<BOWorkShift> getAssistantWorkshifts(Map<Long,Long> foremanByTeam,
 Map<Long,List<Long>> teamCompositionByTeamId,
 List<BOWorkShift> foremanWorkShifts,
 Date maxShiftStart,
 Date minShiftEnd,
 ImmediateSchedulingTeamExclusionInput input,
 PoolKit poolKit)
                                            throws DAException,
DAValidateException

Loads workshifts for all assistant resources.

Parameters:

foremanByTeam - the map of team ID to foreman resource ID

teamCompositionByTeamId - the map of team ID to list of resource IDs (foreman + assistants)

foremanWorkShifts - the list of foreman workshifts

maxShiftStart - the maximum shift start date

minShiftEnd - the minimum shift end date

input - the input

poolKit - the pool kit

Returns:

the list of assistant workshifts

Throws:

DAException - if a database error occurs

DAValidateException - if validation fails

buildWorkshiftByResourceId

protected Map<Long,Long> buildWorkshiftByResourceId(List<BOWorkShift> foremanWorkShifts,
 List<BOWorkShift> assistantWorkShifts)

Builds a map of workshift IDs by resource ID for ALL team members (foreman + assistants).

Parameters:

foremanWorkShifts - the list of foreman workshifts

assistantWorkShifts - the list of assistant workshifts

Returns:

the map of resource ID → workshift ID

getTeamsWithCompleteWorkshifts

protected Set<Long> getTeamsWithCompleteWorkshifts(Map<Long,Long> foremanByTeam,
 Map<Long,List<Long>> teamCompositionByTeamId,
 Map<Long,Long> workshiftByResourceId)

Returns the set of team IDs where ALL members (foreman + assistants) have valid workshifts.

A team is considered to have complete workshifts if:

• The foreman has a valid workshift
• ALL assistants in the team composition have valid workshifts

If any member of the team is missing a workshift, the entire team is excluded.

Parameters:

foremanByTeam - the map of team ID to foreman resource ID

teamCompositionByTeamId - the map of team ID to list of resource IDs (foreman + assistants)

workshiftByResourceId - the map of resource ID to workshift ID

Returns:

the set of team IDs with complete workshifts