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

Class CrewShellComposition

java.lang.Object

overit.geocall.platform.ui.UINode

overit.geocall.ui.Component

overit.geocall.ui.Control

overit.geocall.basic.ui.Container

overit.geocallapp.wfm.core.ux.crewshell.composition.CrewShellComposition

All Implemented Interfaces:

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

public class CrewShellComposition
extends Container

Crew Shell composition page.

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 AllocateTechnicians	cAllocateTechnicians
protected boolean	closePage
protected CrewShellCompositionServerTableView	compositionTable
protected final String	CREW_SHELL_DATE
protected BOCrewShell	crewShell
protected Form	crewShellForm
protected CrewShellDraftCompositionServerTableView	draftCompositionTable
protected PanelCheckResultHelper	panelCheckResultHelper
protected List<BOCrewShellSkill>	requiredSkills
protected Integer	selectedRow
protected BOCache<BOSkill>	skillBOCache
protected ColumnMessage	techRowMenu
protected TableMessage	tmAddTechnicians
protected TableMessage	tmDeallocateTechnicians

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

Constructor Summary

Constructors

Constructor	Description
CrewShellComposition()

Method Summary

Modifier and Type	Method	Description
protected void	closePage()
protected BOCrewShellDraftComposition	getSelectedObject(UIMessage uim)	Returns the selected BOCrewShellDraftComposition object from the CrewShellDraftCompositionServerTableView techniciansTable
protected void	init()
protected void	launchCrewShellCompositionConfirmEvent(CrewShellCompositionConfirmEvent event)
boolean	onAddTechnicians(UIMessage uim)	UI event handler to show the panel used to allocate BOSchedulingUser objects to a BOCrewShell object.
boolean	onAllocateTechnicians(UIMessage uim)	UI event handler to refresh the CrewShellDraftCompositionServerTableView techniciansTable, once the allocation of the BOSchedulingUser objects in a BOCrewShell object has been performed.
boolean	onCheckResultUserCancel(UIMessage uim)
boolean	onCheckResultUserConfirmComposition(UIMessage uim)
boolean	onConfirmAndClose(UIMessage uim)
boolean	onConfirmComposition(UIMessage uim)	Confirm the crew shell composition
boolean	onConfirmTechniciansAllocation(UIMessage uim)	UI event handler to refresh the CrewShellDraftCompositionServerTableView techniciansTable, once the allocation of the BOSchedulingUser objects in a BOCrewShell object has been confirmed in the Warning Alert.
boolean	onDeallocateTechnician(UIMessage uim)	Event launched when a user clicks on the button labeled as "Confirm" to confirm the technician's deallocation.
boolean	onDeallocateTechnicianMenu(UIMessage uim)	Event launched when a user clicks on the three dots menu item labeled as "Deallocate".
boolean	onDeallocateTechnicians(UIMessage uim)	UI event handler to perform a massive deallocation of the BOSchedulingUser objects from a BOCrewShell object.
boolean	onDeallocateTechniciansAlert(UIMessage uim)	UI event handler to display a Warning alert while performing technicians' deallocation.
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	onRowMenu(UIMessage uim)	Event launched when a user clicks on a table row menu button.
boolean	onSetNewForeman(UIMessage uim)	UI event handler to open the ManageForemanPanel object to set a new daily foreman for the BOCrewShell object.
boolean	onTableRefresh(UIMessage uim)	UI event handler to refresh the CrewShellDraftCompositionServerTableView techniciansTable, once the allocation of the BOSchedulingUser objects in a BOCrewShell object has been performed for the selected day.
protected void	refreshCompositionTable()
protected void	refreshDraftCompositionTable()
protected void	refreshDraftCompositionTableTitle()
protected List<BOCrewShellSkill>	retrieveRequiredSkills(BOCrewShell crewShell)	Retrieves the list of the Crew Shell's required skills
protected List<BOSkill>	retrieveTechniciansSkills(Long userId)	Retrieves the list of the BOSkill of an user
protected void	updateMissinSkills()
protected void	updateRequiredSkills()

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

alert, applyRule, getBASIC, getBLANK, getHtml, 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, buildSetupScript, 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, setup, 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

Field Details

CREW_SHELL_DATE

protected final String CREW_SHELL_DATE

See Also:

• Constant Field Values

crewShell

protected BOCrewShell crewShell

crewShellForm

protected Form crewShellForm

draftCompositionTable

protected CrewShellDraftCompositionServerTableView draftCompositionTable

compositionTable

protected CrewShellCompositionServerTableView compositionTable

cAllocateTechnicians

protected AllocateTechnicians cAllocateTechnicians

selectedRow

protected Integer selectedRow

tmAddTechnicians

protected TableMessage tmAddTechnicians

tmDeallocateTechnicians

protected TableMessage tmDeallocateTechnicians

techRowMenu

protected ColumnMessage techRowMenu

requiredSkills

protected List<BOCrewShellSkill> requiredSkills

skillBOCache

protected BOCache<BOSkill> skillBOCache

panelCheckResultHelper

protected PanelCheckResultHelper panelCheckResultHelper

closePage

protected boolean closePage

Constructor Details

CrewShellComposition

public CrewShellComposition()

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

refreshDraftCompositionTable

protected void refreshDraftCompositionTable()

refreshCompositionTable

protected void refreshCompositionTable()

refreshDraftCompositionTableTitle

protected void refreshDraftCompositionTableTitle()

init

protected void init()

onAddTechnicians

public boolean onAddTechnicians(UIMessage uim)

UI event handler to show the panel used to allocate BOSchedulingUser objects to a BOCrewShell object. The allocation of technicians is based on a specific day; it means that the composition of BOCrewShell object varies according to a specific day. Allocation means BOCrewShellDraftComposition object insertion.

Parameters:

uim - the UIMessage node

Returns:

true to break the responsibility chain, false otherwise

onRowMenu

public boolean onRowMenu(UIMessage uim)

Event launched when a user clicks on a table row menu button.

Parameters:

uim - the UIMessage node

Returns:

true to break the responsibility chain, false otherwise

onDeallocateTechnicianMenu

public boolean onDeallocateTechnicianMenu(UIMessage uim)

Event launched when a user clicks on the three dots menu item labeled as "Deallocate". Deallocation means BOCrewShellDraftComposition object deletion.

Parameters:

uim - the UIMessage node

Returns:

true to break the responsibility chain, false otherwise

onDeallocateTechnician

public boolean onDeallocateTechnician(UIMessage uim)

Event launched when a user clicks on the button labeled as "Confirm" to confirm the technician's deallocation. Deallocation means BOCrewShellDraftComposition object deletion.

Parameters:

uim - the UIMessage node

Returns:

true to break the responsibility chain, false otherwise

getSelectedObject

protected BOCrewShellDraftComposition getSelectedObject(UIMessage uim)

Returns the selected BOCrewShellDraftComposition object from the CrewShellDraftCompositionServerTableView techniciansTable

Parameters:

uim - the UIMessage node

Returns:

techniciansTable.getDBView().getRowMap(selectedRow).get(BUSINESS_OBJECT) the BOCrewShellDraftComposition object

onAllocateTechnicians

public boolean onAllocateTechnicians(UIMessage uim)
                              throws DAValidateException,
DAException

UI event handler to refresh the CrewShellDraftCompositionServerTableView techniciansTable, once the allocation of the BOSchedulingUser objects in a BOCrewShell object has been performed.

Parameters:

uim - the UIMessage node

Returns:

true to break the responsibility chain, false otherwise.

Throws:

DAException

DAValidateException

onConfirmTechniciansAllocation

public boolean onConfirmTechniciansAllocation(UIMessage uim)
                                       throws DAValidateException,
DAException

UI event handler to refresh the CrewShellDraftCompositionServerTableView techniciansTable, once the allocation of the BOSchedulingUser objects in a BOCrewShell object has been confirmed in the Warning Alert.

Parameters:

uim - the UIMessage node

Returns:

true to break the responsibility chain, false otherwise.

Throws:

DAException

DAValidateException

onTableRefresh

public boolean onTableRefresh(UIMessage uim)
                       throws DAValidateException,
DAException

UI event handler to refresh the CrewShellDraftCompositionServerTableView techniciansTable, once the allocation of the BOSchedulingUser objects in a BOCrewShell object has been performed for the selected day. The same happens once the technicians' deallocation has been performed. Remember that the composition of BOCrewShell object varies according to a specific day.

Parameters:

uim - the UIMessage node

Returns:

true to break the responsibility chain, false otherwise

Throws:

DAException

DAValidateException

onDeallocateTechnicians

public boolean onDeallocateTechnicians(UIMessage uim)

UI event handler to perform a massive deallocation of the BOSchedulingUser objects from a BOCrewShell object. Deallocation means BOCrewShellDraftComposition object deletion.

Parameters:

uim - the UIMessage node

Returns:

true to break the responsibility chain, false otherwise

onDeallocateTechniciansAlert

public boolean onDeallocateTechniciansAlert(UIMessage uim)

UI event handler to display a Warning alert while performing technicians' deallocation. Deallocation means BOCrewShellDraftComposition object deletion.

Parameters:

uim - the UIMessage node

Returns:

true to break the responsibility chain, false otherwise

onSetNewForeman

public boolean onSetNewForeman(UIMessage uim)

UI event handler to open the ManageForemanPanel object to set a new daily foreman for the BOCrewShell object. Being a foreman means be a BOCrewShellDraftComposition foreman for the selected day.

Parameters:

uim - the UIMessage node

Returns:

true to break the responsibility chain, false otherwise

retrieveRequiredSkills

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

Retrieves the list of the Crew Shell's required skills

Parameters:

crewShell - the BOCrewShell object

Returns:

crewShellSkillSearchEvent.launch().getContent() the list of the BOCrewShellSkill objects related to the given BOCrewShell object

Throws:

DAException

DAValidateException

retrieveTechniciansSkills

protected List<BOSkill> retrieveTechniciansSkills(Long userId)

Retrieves the list of the BOSkill of an user

Parameters:

userId -

Returns:

DBViewUtils.toList(dbvSkill, BOSkill.class) the list of the BOSkill objects related to each BOSchedulingUser object.

updateRequiredSkills

protected void updateRequiredSkills()
                             throws DAValidateException,
DAException

Throws:

DAValidateException

DAException

updateMissinSkills

protected void updateMissinSkills()

onConfirmComposition

public boolean onConfirmComposition(UIMessage uim)

Confirm the crew shell composition

Parameters:

uim - the UIMessage node

Returns:

true to break the responsibility chain, false otherwise

onCheckResultUserConfirmComposition

public boolean onCheckResultUserConfirmComposition(UIMessage uim)

launchCrewShellCompositionConfirmEvent

protected void launchCrewShellCompositionConfirmEvent(CrewShellCompositionConfirmEvent event)
                                               throws DAValidateException,
DAException

Throws:

DAValidateException

DAException

onConfirmAndClose

public boolean onConfirmAndClose(UIMessage uim)

closePage

protected void closePage()

onCheckResultUserCancel

public boolean onCheckResultUserCancel(UIMessage uim)