Package overit.geocallapp.wfm.core.ux.crewshell.composition.allocatetechnician

Class AllocateTechnicians

java.lang.Object

overit.geocall.platform.ui.UINode

overit.geocall.ui.Component

overit.geocall.ui.Control

overit.geocall.basic.ui.Container

overit.geocall.basic.ui.container.Panel

overit.geocallapp.wfm.core.ux.crewshell.composition.allocatetechnician.AllocateTechnicians

All Implemented Interfaces:

Serializable, overit.geocall.marks.MethodExposer, overit.geocall.marks.NameExposer, AjaxableComponent, Badgeable, Hideable, Identified, Tool, overit.geocall.ux.configurability.UIConfigurable, overit.geocall.ux.edm.ModelConfigurable

public class AllocateTechnicians
extends Panel

Panel used for the insertion of a BOCrewShellDraftComposition object, which associates BOSchedulingUser objects with a given BOCrewShell object. It should be noted that the composition of BOCrewShell object varies according to a specific day.

Since:

16.0

See Also:

• Serialized Form

GCApi:

controller

Nested Class Summary

Nested classes/interfaces inherited from class overit.geocall.ui.Component

Component.Configurable, Component.ConfigurableAttribute, Component.ConfigurableAttributes, Component.FilterCriteria, Component.Registry

Field Summary

Fields

Modifier and Type	Field	Description
protected BOCrewShell	crewShell
protected Form	fAllocateTechnicians
protected SubmitButton	sbAddTechniciansFromOC
protected BOCache<BOSkill>	skillBOCache
protected ServerTableViewAllocateTechnicians	stvAllocateTechnicians
protected CrewShellDraftCompositionServerTableView	techniciansTable
protected BOCache<BOWorkShift>	workShiftBOCache

Fields inherited from class overit.geocall.basic.ui.container.Panel

_align, _appear, _height, _maxHeight, _maxWidth, _minHeight, _minWidth, _modal, _moveable, _obj, _titleClosable, _type, _valign, _visible, _width

Fields inherited from class overit.geocall.basic.ui.Container

_rofields, _rules, DALINK_NO, DALINK_YES, DATE_MAX, DATE_MIN, TIME_MAX, TIME_MIN, TYPE_ACTION, TYPE_BOOLEAN, TYPE_DATE, TYPE_DOUBLE, TYPE_DTZ, TYPE_EURO, TYPE_FILE, TYPE_FILES, TYPE_INTEGER, TYPE_LONG, TYPE_LONGARRAY, TYPE_MAP, TYPE_MAXDATE, TYPE_MAXTIME, TYPE_MEASURE, TYPE_MINDATE, TYPE_MINTIME, TYPE_NEWACTION, TYPE_STRING, TYPE_STRINGARRAY, TYPE_SUBSET, TYPE_SUBSETRANGE, TYPE_SUPPORT, TYPE_TIMERANGE

Fields inherited from class overit.geocall.ui.Control

_blank, _cleaner, _dblink, _enabled, _ro, _title, altEventIconsList, altIcon, ariaDescription, ariaLabel, badge, badgeformat, FILTER_PREFIXES, LABEL_ATTRIBUTE, LABEL_IN_LINE_ATTRIBUTE, STATE_BLANK, STATE_NORMAL, STATE_RO, STATE_ROBLANK

Fields inherited from class overit.geocall.ui.Component

_basic, _childrenContainers, _currentId, _gridalign, _gridcols, _gridrows, _gridvalign, _iconElement, _id, _keylabel, _label, _layoutName, _name, _parentContainer, _registryName, _shortcut, _tabindex, _transformations, _valuesContainer, aliasField, BR, configHidden, configuredLabel, configuredLabelInLine, defaultHidden, ELEMENT_BR, ELEMENT_NULL, entityContainer, entityName, extendedField, fullHeight, important, labelInLine, layoutLabel, PIXEL_IMG, safeInlineService

Fields inherited from interface overit.geocall.ui.AjaxableComponent

FRAME_ID_PREFIX, NOTRANSITION, TRANSITION_BODY_MORPH, TRANSITION_BODY_RESIZE, TRANSITION_BORDER_RESIZE, TRANSITION_DOWN, TRANSITION_UP

Constructor Summary

Constructors

Constructor	Description
AllocateTechnicians()

Method Summary

Modifier and Type	Method	Description
protected void	applyUserOnShiftFilters(Map<String,Object> filters)	Applies the right SQL clauses if the InputCheckBox component having name="with_defined_shifts" is checked.
protected Optional<BOCrewShellShift>	getCrewShellWorkshift(Long crewShell, Date day)
protected List<Long>	getResourcesWithOverlappingCrewShellWorkshifts(BOCrewShellShift crewShellWorkshift)
protected List<Long>	getResourcesWithOverlappingNextDayWorkshifts(BOCrewShellShift crewShellWorkshift)
protected void	init()
protected void	initCache()	Initializes the BOCache objects for each business object.
protected void	insertTechnicians(Collection<Long> userIDs)	Inserts a new BOCrewShellDraftComposition object, which represents the association between a given BOCrewShell object and a collection of BOSchedulingUser objects.
boolean	onAllocateTechnicians(UIMessage uim)	UI event handler to confirm the selection of BOSchedulingUser objects for the given BOCrewShell object.
boolean	onConfirmTechniciansAllocation(UIMessage uim)	UI event handler to confirm the insertion of n+1 BOCrewShellDraftComposition objects for the given BOCrewShell object having n size.
void	onOpen(Object o)	Method called when is executed the WindowManager.push(overit.geocall.basic.ui.Window, java.lang.Object) of the Window that contains the Container.
boolean	onSearchTechniciansFromOC(UIMessage uim)	UI event handler to search BOSchedulingUser objects from a given OC (i.e., Operation Center).
protected void	refreshServerTableView(Map<String,Object> filters)	Refreshes the ServerTableViewAllocateTechnicians stvAllocateTechnicians.
protected List<Long>	retrieveAlreadyAssignedUserIDs(BOCrewShell crewShell)	Retrieves the combined list of the IDs of the BOSchedulingUser objects (i.e., users) to be excluded from the search.
protected List<BOWorkShift>	retrieveCancelledBecauseInCrewShellWorkShifts(BOCrewShell crewShell)
protected List<Long>	retrieveCrewShellConfirmedUserIDs(BOCrewShell crewShell)	Retrieves the list of the IDs of the BOSchedulingUser objects (i.e., users) to be excluded from the search.
protected List<Long>	retrieveCrewShellDraftUserIDs(BOCrewShell crewShell)	Retrieves the list of the IDs of the BOSchedulingUser objects (i.e., users) to be excluded from the search.
protected List<BOCrewShellDraftComposition>	retrieveCrewShellTechnicians(BOCrewShell crewShell)	Retrieves the list of the BOCrewShellDraftComposition objects related to the BOCrewShell object.
protected List<BOSkill>	retrieveCrewShellTechniciansSkills(Long userId)	Retrieves the list of the BOSkill objects related to each BOSchedulingUser object.
protected List<Long>	retrieveCrewShellUserIDs(BOCrewShell crewShell)	Retrieves the list of the IDs of the BOSchedulingUser objects (i.e., users) to be excluded from the search.
protected List<Long>	retrieveFixedTeamUserIDs(BOCrewShell crewShell)	Retrieves the list of the IDs of the BOSchedulingUser objects (i.e., users) to be excluded from the search.
protected List<Long>	retrieveMissingCrewShellSkillIDs(BOCrewShell crewShell)	Retrieves the list of the IDs of the missing_skills, or rather, the list of the IDs of the required_skills with the exclusion of the FSM skills' IDs related to the BOCrewShellDraftComposition objects.
protected List<String>	retrieveMissingCrewShellSkillsDescriptions(BOCrewShell crewShell)	Retrieves the list of the descriptions of the missing_skills, or rather, the list of the descriptions of the required_skills with the exclusion of the FSM skills' descriptions related to the BOCrewShellDraftComposition objects.
protected List<Long>	retrieveRealUserIDs(BOCrewShell crewShell)	Retrieves the list of the IDs of the real BOSchedulingUser objects (i.e., users) which belong to the specified OC (i.e., operation center).
protected List<String>	retrieveRequiredSkillDescriptions(BOCrewShell crewShell)	Retrieves the list of the values of the description field for each BOSkill object related to the retrieved BOCrewShellSkill objects.
protected List<BOCrewShellSkill>	retrieveRequiredSkills(BOCrewShell crewShell)	Retrieves the list of the required_skills, or rather, the list of the BOCrewShellSkill objects related to the given BOCrewShell object.
protected List<BOWorkShift>	retrieveResourceWorkShifts(BOCrewShell crewShell)	Retrieves the list of the BOWorkShift objects by filtering them by Date day and OC (i.e., operation center).
protected List<BOScheduling>	retrieveSchedulingsByWorkShifts(List<Long> workShiftIDs)	Retrieves the list of the not cancelled BOScheduling objects by filtering them by BOWorkShift objects' IDs.
protected List<Long>	retrieveUserOnShiftIDs(BOCrewShell crewShell)	Retrieves the list of the IDs of the BOSchedulingUser objects (i.e., users) which belong to the specified OC (i.e., operation center) and have an associated BOWorkShift object (i.e., a shift) for the specified Date day.
protected List<Long>	retrieveUserWithAssignedSchedulingIDs(BOCrewShell crewShell)	Retrieves the list of the IDs of the BOSchedulingUser objects (i.e., users) to be excluded from the search.
protected List<Long>	retrieveWorkingTeamIDs(BOCrewShell crewShell)	Retrieves the list of the IDs of the active BOWorkingTeam objects (i.e., working teams or fixed teams), filtering them by OC (i.e., operation center).
protected List<Long>	retrieveWorkingTeamShiftIDs(BOCrewShell crewShell)	Retrieves the list of the IDs of the BOTeamShift objects (i.e., working team shifts), filtering them by Date day and by retrieved BOWorkingTeam objects.
void	setDay(Date day)	Sets the day.
void	show(Serializable obj)	It shows (make visible with the pop-up effect) the panel
protected void	showTechniciansSelectionAlert()	UI event handler to display the Warning Alert.

Methods inherited from class overit.geocall.basic.ui.container.Panel

buildSetupScript, changed, getDefaultChange, getFrameHtml, getHtml, getTitleDiv, hide, isVisible, onClose, onHide, perfectsDim, setALIGN, setHEIGHT, setMAXHEIGHT, setMAXWIDTH, setMINHEIGHT, setMINWIDTH, setMODAL, setMOVEABLE, setTITLECLOSABLE, setTYPE, setup, setVALIGN, setVISIBLE, setWIDTH, show, show, show, show, show, show, show, show, show, show, show, show, show, titlePanel

Methods inherited from class overit.geocall.basic.ui.Container

alert, applyRule, getBASIC, getBLANK, getRO, getROField, onClose, onOpenChildContainer, onRestore, onRule, prepareName, rulesNewValues, setROField, setValues, setValues

Methods inherited from class overit.geocall.ui.Control

avoidNull, clean, getBadgeFormat, getBadgeValue, getCleaner, getConfigurableProperties, getDAValues, getDBLINK, getKEYLABEL, getLABEL, getState, getTITLE, getValues, getWM, isEnabled, isEnabledBasedOnFunction, isFunctionEnabled, isImportant, isRoBasedOnFunction, nameWithNoFilterPrefix, setALTEVENTICON, setALTICON, setARIADESCRIPTION, setARIALABEL, setBADGEFORMAT, setBADGEVALUE, setBLANK, setCLEANER, setConfiguredProperty, setDBLINK, setENABLED, setFUNCTION, setModelProperties, setRO, setTitle, setTITLE

Methods inherited from class overit.geocall.ui.Component

adapt, ajaxQuery, appendAttribute, buildDisplayScript, calcKeyLabel, calcLabel, calcShortcut, canBeConfigured, changed, clearConfiguredProperties, componentIterator, componentSize, connect, containerIterator, createAjaxFrame, deprecate, fillSetupScript, generateFlexableFullHeightContainer, generateId, getBoolean, getBoolean, getChildrenComponents, getChildrenContainers, getDefaultLabel, getDefaultLayoutLabel, getEntityContainer, getEntityName, getFullHeight, getGridAlign, getGridCols, getGridRows, getGridVAlign, getHtmlLabel, getHtmlLabel, getIcon, getId, getIdentity, getint, getLayoutLabel, getLayoutName, getNAME, getParentComponent, getParentContainer, getPublishedChildrenList, getRegistryName, getSHORTCUT, getTabIndex, getTeacher, getValuesContainer, getWindow, initChilds, isActivable, isActive, isAliasField, isConfigHidden, isDefaultHidden, isExtendedField, isLabelInLine, onInit, setActivable, setActive, setAliasField, setBASIC, setConfigHidden, setDEFAULTHIDDEN, setEntityName, setExtendedField, setFULLHEIGHT, setGRIDALIGN, setGRIDCOLS, setGRIDROWS, setGRIDVALIGN, setICON, setIdentity, setIMPORTANT, setLabel, setLABEL, setLABELINLINE, setLAYOUTLABEL, setLAYOUTNAME, setNAME, setREGISTRYNAME, setTooltip, setValuesContainer, stringForJs, tabIndexer

Methods inherited from class overit.geocall.platform.ui.UINode

addChild, addChildText, getChildren, getNodeId, getParent, getRoot, getSchema, setNodeId, setParent, setSchema

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface overit.geocall.ui.Badgeable

badgeFormat, makeBadgedIcon

Methods inherited from interface overit.geocall.ui.Hideable

getVISIBLE

Field Details

fAllocateTechnicians

protected Form fAllocateTechnicians

stvAllocateTechnicians

protected ServerTableViewAllocateTechnicians stvAllocateTechnicians

techniciansTable

protected CrewShellDraftCompositionServerTableView techniciansTable

sbAddTechniciansFromOC

protected SubmitButton sbAddTechniciansFromOC

crewShell

protected BOCrewShell crewShell

skillBOCache

protected BOCache<BOSkill> skillBOCache

workShiftBOCache

protected BOCache<BOWorkShift> workShiftBOCache

Constructor Details

AllocateTechnicians

public AllocateTechnicians()

Method Details

onOpen

public void onOpen(Object o)

Description copied from class: Container

Method called when is executed the WindowManager.push(overit.geocall.basic.ui.Window, java.lang.Object) of the Window that contains the Container. It calls the onOpen(o) method of all the Container's childrens.
If a page is opened through the process of a route, it is possible that the route was called with params to pass to the page.
The route params could be passed specifying them like query string's param on the url, using commas or the '=' character, to separate the keys and the values. Valid syntaxs are: "&params=KEY1,VAL1,KEY2,VAL2" or "&params=KEY1=VAL1,KEY2=VAL2"
In that case it is possible to retrieve those params via the WindowManager.getRouteParams() method that returns an HashGetter with the params passed as parameters.
For example it's possible to retrieve and use the params in this way: HashGetter hg = getWM().getRouteParams();
String val1 = hg.getString("key1",null);
String val2 = hg.getString("key2",null);

Overrides:

onOpen in class Container

Parameters:

o - Object received from the caller

init

protected void init()

show

public void show(Serializable obj)

Description copied from class: Panel

It shows (make visible with the pop-up effect) the panel

Overrides:

show in class Panel

Parameters:

obj - serializable object saved as a global variable of the panel

setDay

public void setDay(Date day)

Sets the day. Remember that the composition of BOCrewShell object varies according to a specific day.

Parameters:

day - the selected day

See Also:

• entity

initCache

protected void initCache()

Initializes the BOCache objects for each business object.

onSearchTechniciansFromOC

public boolean onSearchTechniciansFromOC(UIMessage uim)
                                  throws DAValidateException,
DAException

UI event handler to search BOSchedulingUser objects from a given OC (i.e., Operation Center).

Parameters:

uim - the UIMessage node

Returns:

true to break the responsibility chain, false otherwise

Throws:

DAValidateException - if there is a data validation exception

DAException - if a generic Exception object is thrown

onAllocateTechnicians

public boolean onAllocateTechnicians(UIMessage uim)

UI event handler to confirm the selection of BOSchedulingUser objects for the given BOCrewShell object.

Parameters:

uim - the UIMessage node

Returns:

true to break the responsibility chain, false otherwise

showTechniciansSelectionAlert

protected void showTechniciansSelectionAlert()

UI event handler to display the Warning Alert.

onConfirmTechniciansAllocation

public boolean onConfirmTechniciansAllocation(UIMessage uim)
                                       throws DAValidateException,
DAException

UI event handler to confirm the insertion of n+1 BOCrewShellDraftComposition objects for the given BOCrewShell object having n size.

Parameters:

uim - the UIMessage node

Returns:

true to break the responsibility chain, false otherwise

Throws:

DAValidateException

DAException

insertTechnicians

protected void insertTechnicians(Collection<Long> userIDs)
                          throws DAValidateException,
DAException

Inserts a new BOCrewShellDraftComposition object, which represents the association between a given BOCrewShell object and a collection of BOSchedulingUser objects. Remember that the composition of BOCrewShell object varies according to a specific day.

Parameters:

userIDs - the collection of BOSchedulingUser objects' IDs

Throws:

DAValidateException - if there is a data validation exception

DAException - if a generic Exception object is thrown

refreshServerTableView

protected void refreshServerTableView(Map<String,Object> filters)
                               throws DAValidateException,
DAException

Refreshes the ServerTableViewAllocateTechnicians stvAllocateTechnicians. If the InputCheckBox tag having name="with_missing_skills" has been checked on UI interface, it displays the BOSchedulingUser objects which have at least one of the BOSkill object of the Output tag having name = "missing_skills". If the InputCheckBox tag having name="with_defined_shifts" has been checked on UI interface, it displays the BOSchedulingUser objects which have an associated BOWorkShift object (i.e., a shift) for the specified Date day. It does not display the BOSchedulingUser objects having certain conditions.

Parameters:

filters - the filters that are applied to the search

Throws:

DAValidateException - if there is a data validation exception

DAException - if a generic Exception object is thrown

retrieveRequiredSkills

protected List<BOCrewShellSkill> retrieveRequiredSkills(BOCrewShell crewShell)
                                                 throws DAValidateException,
DAException

Retrieves the list of the required_skills, or rather, the list of the BOCrewShellSkill objects related to the given BOCrewShell object.

Parameters:

crewShell - the BOCrewShell object

Returns:

the list of the BOCrewShellSkill objects related to the given BOCrewShell object

Throws:

DAValidateException - if there is a data validation exception

DAException - if a generic Exception object is thrown

retrieveRequiredSkillDescriptions

protected List<String> retrieveRequiredSkillDescriptions(BOCrewShell crewShell)
                                                  throws DAValidateException,
DAException

Retrieves the list of the values of the description field for each BOSkill object related to the retrieved BOCrewShellSkill objects.

Parameters:

crewShell - the BOCrewShell object

Returns:

the list of the values of the description field for each BOSkill object related to the retrieved BOCrewShellSkill objects

Throws:

DAValidateException - if there is a data validation exception

DAException - if a generic Exception object is thrown

retrieveCrewShellTechnicians

protected List<BOCrewShellDraftComposition> retrieveCrewShellTechnicians(BOCrewShell crewShell)
                                                                  throws DAValidateException,
DAException

Retrieves the list of the BOCrewShellDraftComposition objects related to the BOCrewShell object.

Parameters:

crewShell - the BOCrewShell object

Returns:

the list of the BOCrewShellDraftComposition objects related to the BOCrewShell object

Throws:

DAValidateException - if there is a data validation exception

DAException - if a generic Exception object is thrown

retrieveCrewShellTechniciansSkills

protected List<BOSkill> retrieveCrewShellTechniciansSkills(Long userId)
                                                    throws DAValidateException,
DAException

Retrieves the list of the BOSkill objects related to each BOSchedulingUser object.

Parameters:

userId - the BOSchedulingUser object's id field

Returns:

the list of the BOSkill objects related to each BOSchedulingUser object

Throws:

DAValidateException - if there is a data validation exception

DAException - if a generic Exception object is thrown

retrieveMissingCrewShellSkillIDs

protected List<Long> retrieveMissingCrewShellSkillIDs(BOCrewShell crewShell)
                                               throws DAValidateException,
DAException

Retrieves the list of the IDs of the missing_skills, or rather, the list of the IDs of the required_skills with the exclusion of the FSM skills' IDs related to the BOCrewShellDraftComposition objects.

Parameters:

crewShell - the BOCrewShell object

Returns:

the list of the IDs of the required_skills with the exclusion of the FSM skills' IDs related to the BOCrewShellDraftComposition objects

Throws:

DAValidateException - if there is a data validation exception

DAException - if a generic Exception object is thrown

retrieveMissingCrewShellSkillsDescriptions

protected List<String> retrieveMissingCrewShellSkillsDescriptions(BOCrewShell crewShell)
                                                           throws DAValidateException,
DAException

Retrieves the list of the descriptions of the missing_skills, or rather, the list of the descriptions of the required_skills with the exclusion of the FSM skills' descriptions related to the BOCrewShellDraftComposition objects.

Parameters:

crewShell - the BOCrewShell object

Returns:

the list of the descriptions of the required_skills with the exclusion of the FSM skills' descriptions related to the BOCrewShellDraftComposition objects

Throws:

DAValidateException - if there is a data validation exception

DAException - if a generic Exception object is thrown

retrieveCrewShellUserIDs

protected List<Long> retrieveCrewShellUserIDs(BOCrewShell crewShell)
                                       throws DAValidateException,
DAException

Retrieves the list of the IDs of the BOSchedulingUser objects (i.e., users) to be excluded from the search. The users to be excluded are those already assigned, for the selected Date day and OC (i.e., operation center), to any BOCrewShell object.

Parameters:

crewShell - the BOCrewShell object

Returns:

the list of the IDs of the BOSchedulingUser objects to be excluded from the search

Throws:

DAValidateException - if there is a data validation exception

DAException - if a generic Exception object is thrown

retrieveCrewShellDraftUserIDs

protected List<Long> retrieveCrewShellDraftUserIDs(BOCrewShell crewShell)
                                            throws DAException,
DAValidateException

Retrieves the list of the IDs of the BOSchedulingUser objects (i.e., users) to be excluded from the search. The users to be excluded are those which are associated, for the selected Date day and OC (i.e., operation center), to any BOCrewShellDraftComposition object (i.e., draft composition) related to any BOCrewShell object.

Parameters:

crewShell - the BOCrewShell object

Returns:

the list of the IDs of the BOSchedulingUser objects to be excluded from the search

Throws:

DAValidateException - if there is a data validation exception

DAException - if a generic Exception object is thrown

retrieveCrewShellConfirmedUserIDs

protected List<Long> retrieveCrewShellConfirmedUserIDs(BOCrewShell crewShell)
                                                throws DAException,
DAValidateException

Retrieves the list of the IDs of the BOSchedulingUser objects (i.e., users) to be excluded from the search. The users to be excluded are those which are associated, for the selected Date day and OC (i.e., operation center), to any BOCrewShellComposition object (i.e., confirmed composition) related to any BOCrewShell object.

Parameters:

crewShell - the BOCrewShell object

Returns:

the list of the IDs of the BOSchedulingUser objects to be excluded from the search

Throws:

DAValidateException - if there is a data validation exception

DAException - if a generic Exception object is thrown

retrieveWorkingTeamIDs

protected List<Long> retrieveWorkingTeamIDs(BOCrewShell crewShell)
                                     throws DAValidateException,
DAException

Retrieves the list of the IDs of the active BOWorkingTeam objects (i.e., working teams or fixed teams), filtering them by OC (i.e., operation center). The list only contains BOWorkingTeam objects whose cardinality is greater than one, or rather, it does not contain unary teams.

Parameters:

crewShell - the BOCrewShell object

Returns:

the list of the IDs of the active BOWorkingTeam objects (i.e., working teams or fixed teams) having cardinality greater than one

Throws:

DAValidateException - if there is a data validation exception

DAException - if a generic Exception object is thrown

retrieveWorkingTeamShiftIDs

protected List<Long> retrieveWorkingTeamShiftIDs(BOCrewShell crewShell)
                                          throws DAValidateException,
DAException

Retrieves the list of the IDs of the BOTeamShift objects (i.e., working team shifts), filtering them by Date day and by retrieved BOWorkingTeam objects.

Parameters:

crewShell - the BOCrewShell object

Returns:

workingTeamIDs the list of the IDs of the BOTeamShift objects (i.e., working team shifts)

Throws:

DAValidateException - if there is a data validation exception

DAException - if a generic Exception object is thrown

retrieveFixedTeamUserIDs

protected List<Long> retrieveFixedTeamUserIDs(BOCrewShell crewShell)
                                       throws DAValidateException,
DAException

Retrieves the list of the IDs of the BOSchedulingUser objects (i.e., users) to be excluded from the search. The users to be excluded are those already assigned, for the selected Date day and OC (i.e., operation center), to a given BOTeamShiftResource object, provided it is active.

Parameters:

crewShell - the BOCrewShell object

Returns:

the list of the IDs of the BOSchedulingUser objects (i.e., fixed team users)

Throws:

DAValidateException - if there is a data validation exception

DAException - if a generic Exception object is thrown

retrieveResourceWorkShifts

protected List<BOWorkShift> retrieveResourceWorkShifts(BOCrewShell crewShell)
                                                throws DAValidateException,
DAException

Retrieves the list of the BOWorkShift objects by filtering them by Date day and OC (i.e., operation center).

Parameters:

crewShell - the BOCrewShell object

Returns:

the list of the BOWorkShift objects retrieved by Date day and OC (i.e., operation center)

Throws:

DAValidateException - if there is a data validation exception

DAException - if a generic Exception object is thrown

retrieveCancelledBecauseInCrewShellWorkShifts

protected List<BOWorkShift> retrieveCancelledBecauseInCrewShellWorkShifts(BOCrewShell crewShell)
                                                                   throws DAValidateException,
DAException

Throws:

DAValidateException

DAException

retrieveSchedulingsByWorkShifts

protected List<BOScheduling> retrieveSchedulingsByWorkShifts(List<Long> workShiftIDs)
                                                      throws DAValidateException,
DAException

Retrieves the list of the not cancelled BOScheduling objects by filtering them by BOWorkShift objects' IDs.

Parameters:

workShiftIDs - the list of the BOWorkShift objects retrieved by Date day and OC (i.e., operation center)

Returns:

the list of the not cancelled BOScheduling objects retrieved by BOWorkShift objects' IDs

Throws:

DAValidateException - if there is a data validation exception

DAException - if a generic Exception object is thrown

retrieveUserWithAssignedSchedulingIDs

protected List<Long> retrieveUserWithAssignedSchedulingIDs(BOCrewShell crewShell)
                                                    throws DAValidateException,
DAException

Retrieves the list of the IDs of the BOSchedulingUser objects (i.e., users) to be excluded from the search. The users to be excluded are those which, for the selected Date day and OC (i.e., operation center), have a given BOWorkShift object associated with a not cancelled BOScheduling object, (or rather, the users which have a scheduling in their work shifts).

Parameters:

crewShell - the BOCrewShell object

Returns:

the list of the IDs of the users which, for the selected Date day and OC (i.e., operation center), have a given BOWorkShift object associated with a not cancelled BOScheduling object

Throws:

DAValidateException - if there is a data validation exception

DAException - if a generic Exception object is thrown

retrieveAlreadyAssignedUserIDs

protected List<Long> retrieveAlreadyAssignedUserIDs(BOCrewShell crewShell)
                                             throws DAValidateException,
DAException

Retrieves the combined list of the IDs of the BOSchedulingUser objects (i.e., users) to be excluded from the search. The users to be excluded are those already assigned, for the selected Date day and OC (i.e., operation center), to a given BOTeamShiftResource object or a given BOCrewShell object. The users to be excluded are those which, for the selected Date day and OC (i.e., operation center), have a given BOWorkShift object associated with a not cancelled BOScheduling object, (or rather, the users which have a scheduling in their work shifts).

Parameters:

crewShell - the BOCrewShell object

Returns:

the list of the IDs of the BOSchedulingUser objects to be excluded from the search

Throws:

DAValidateException - if there is a data validation exception

DAException - if a generic Exception object is thrown

retrieveUserOnShiftIDs

protected List<Long> retrieveUserOnShiftIDs(BOCrewShell crewShell)
                                     throws DAValidateException,
DAException

Retrieves the list of the IDs of the BOSchedulingUser objects (i.e., users) which belong to the specified OC (i.e., operation center) and have an associated BOWorkShift object (i.e., a shift) for the specified Date day.

Parameters:

crewShell - the BOCrewShell object

Returns:

the list of the IDs of the BOSchedulingUser objects (i.e., users) which belong to the specified OC (i.e., operation center) and have an associated BOWorkShift object (i.e., a shift) for the specified Date day

Throws:

DAValidateException - if there is a data validation exception

DAException - if a generic Exception object is thrown

retrieveRealUserIDs

protected List<Long> retrieveRealUserIDs(BOCrewShell crewShell)
                                  throws DAValidateException,
DAException

Retrieves the list of the IDs of the real BOSchedulingUser objects (i.e., users) which belong to the specified OC (i.e., operation center).

Parameters:

crewShell - the BOCrewShell object

Returns:

the list of the IDs of the real BOSchedulingUser objects (i.e., users) which belong to the specified OC (i.e., operation center)

Throws:

DAValidateException - if there is a data validation exception

DAException - if a generic Exception object is thrown

applyUserOnShiftFilters

protected void applyUserOnShiftFilters(Map<String,Object> filters)
                                throws DAValidateException,
DAException

Applies the right SQL clauses if the InputCheckBox component having name="with_defined_shifts" is checked. Note that the component is checked by default.

Parameters:

filters - the Map object containing the filters

Throws:

DAValidateException - if there is a data validation exception

DAException - if a generic Exception object is thrown

getCrewShellWorkshift

protected Optional<BOCrewShellShift> getCrewShellWorkshift(Long crewShell,
 Date day)
                                                    throws DAException,
DAValidateException

Throws:

DAException

DAValidateException

getResourcesWithOverlappingCrewShellWorkshifts

protected List<Long> getResourcesWithOverlappingCrewShellWorkshifts(BOCrewShellShift crewShellWorkshift)
                                                             throws DAException,
DAValidateException

Throws:

DAException

DAValidateException

getResourcesWithOverlappingNextDayWorkshifts

protected List<Long> getResourcesWithOverlappingNextDayWorkshifts(BOCrewShellShift crewShellWorkshift)
                                                           throws DAException,
DAValidateException

Throws:

DAException

DAValidateException