Package overit.geocallapp.wfm.core.bl.schedule.schedulingresource.task

Class BTSchedulingResourceSave

java.lang.Object

overit.geocall.bl.BusinessTask<SchedulingResourceSaveEvent>

overit.geocallapp.utilities.core.bl.common.validexecution.ValidExecutionBusinessTask<SchedulingResourceSaveEvent>

overit.geocallapp.utilities.core.bl.common.validexecution.ValidPermissionBusinessTask<SchedulingResourceSaveEvent>

overit.geocallapp.wfm.core.bl.schedule.schedulingresource.task.BTSchedulingResourceSave

All Implemented Interfaces:

Serializable, Tool, ValidExecution

@Event(SchedulingResourceSaveEvent.class)
public class BTSchedulingResourceSave
extends ValidPermissionBusinessTask<SchedulingResourceSaveEvent>

Business task in order to save a SchedulingResource.
When the SchedulingResourceSaveEvent is launched the BT notices the call and saves the SchedulingResource basing on the event's input.

Required fields:

• type
• name
• surname
• operation center
• serial number
• resource type

Permission:

• ResourcePermissions.RESOURCE_EDIT

Error Code:

• Codes.C270_1125: Invalid value for property
• Codes.MODULE_NOT_ACTIVE: Module {0} is not active

Since:

9.2

See Also:

• Serialized Form

GCApi:

task

Field Summary

Fields

Modifier and Type	Field	Description
protected SchedulingResource	schedulingResource

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

LOG

Constructor Summary

Constructors

Constructor	Description
BTSchedulingResourceSave()

Method Summary

Modifier and Type	Method	Description
protected void	body(SchedulingResourceSaveEvent event, PoolKit poolKit)	Main execution method that validates before proceeding with business logic.
protected void	checkAddressOrigin(SchedulingResource schedulingResource, Long addressId, String description, boolean userAddress, PoolKit pk)	Validates the address origin (existence, not a technical object address, resource or operation center address)
protected void	execute(SchedulingResourceSaveEvent event, PoolKit pk)	Writes the saved scheduling resource id into the event journal.
protected void	insertResource(BOSchedulingUser user, PoolKit pk)	Saves only the BOSchedulingUser.
boolean	isValidExecution()	Determines whether the current state is valid for execution.
protected void	normalizeAddress(HashGetter addressData, PooledConnection conn)	Normalizes the address.
protected DBView	prepareOperationCenterAddresses(PoolKit pk)	Prepares the operation center addresses for the scheduling resource, recalculating all related departure/arrival points.
protected DBView	prepareResourceAddresses(PoolKit pk)	Saves the resource addresses performing a normalization and prepares a DBView which contains all resource addresses data.
protected void	save(DBView resourceAddresses, DBView ocAddress, PoolKit pk)	Saves the SchedulingResource.
protected void	validate(BOSchedulingUser user)	Checks whether the user the timesheet profile is set and if the timesheet management is active.
protected void	validateDepartureAndArrivalAddresses(DBView dbvResourceAddresses, DBView dbvOperationCenterAddresses)	Validates departure and arrival addresses.

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

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

Field Details

schedulingResource

protected SchedulingResource schedulingResource

Constructor Details

BTSchedulingResourceSave

public BTSchedulingResourceSave()

Method Details

body

protected void body(SchedulingResourceSaveEvent event,
 PoolKit poolKit)
             throws DAException,
DAValidateException

Description copied from class: ValidExecutionBusinessTask

Main execution method that validates before proceeding with business logic. This method stores the input event and performs validation using ValidExecutionBusinessTask.checkValidExecution(). If validation passes, it delegates to the ValidExecutionBusinessTask.execute(Object, PoolKit) method for actual business logic execution.

Overrides:

body in class ValidExecutionBusinessTask<SchedulingResourceSaveEvent>

Parameters:

event - the input event to process

poolKit - the PoolKit

Throws:

DAException - if a data access error occurs during execution

DAValidateException - if validation fails and exceptions are enabled

execute

protected void execute(SchedulingResourceSaveEvent event,
 PoolKit pk)
                throws DAException,
DAValidateException

Writes the saved scheduling resource id into the event journal.

Specified by:

execute in class ValidExecutionBusinessTask<SchedulingResourceSaveEvent>

Parameters:

event - the SchedulingResourceSaveEvent

pk - the PoolKit

Throws:

DAException - the DA exception

DAValidateException - the DA validate exception

isValidExecution

public boolean isValidExecution()

Description copied from interface: ValidExecution

Determines whether the current state is valid for execution.

Returns:

true if execution is valid, false otherwise

prepareResourceAddresses

protected DBView prepareResourceAddresses(PoolKit pk)
                                   throws DAException,
DAValidateException

Saves the resource addresses performing a normalization and prepares a DBView which contains all resource addresses data.

Parameters:

pk - the PoolKit

Returns:

the resource addresses

Throws:

DAException - the DA exception

DAValidateException - the DA validate exception

prepareOperationCenterAddresses

protected DBView prepareOperationCenterAddresses(PoolKit pk)
                                          throws DAException,
DAValidateException

Prepares the operation center addresses for the scheduling resource, recalculating all related departure/arrival points.

Parameters:

pk - the PoolKit

Returns:

the operation center addresses

Throws:

DAException - the DA exception

DAValidateException - the DA validate exception

normalizeAddress

protected void normalizeAddress(HashGetter addressData,
 PooledConnection conn)
                         throws DAException,
DAValidateException

Normalizes the address.

Parameters:

addressData - the address data

conn - the connection

Throws:

DAException - the DA exception

DAValidateException - the DA validate exception

insertResource

protected void insertResource(BOSchedulingUser user,
 PoolKit pk)
                       throws DAValidateException,
DAException

Saves only the BOSchedulingUser. If the user is a new one an insertion in performed, otherwise the selected user is updated. When the resource is saved, its relations with the team and the warehouses are updated too.

Parameters:

user - the user

pk - the PoolKit

Throws:

DAValidateException - the DA validate exception

DAException - the DA exception

save

protected void save(DBView resourceAddresses,
 DBView ocAddress,
 PoolKit pk)
             throws DAValidateException,
DAException

Saves the SchedulingResource. The BOSchedulingUser is updated with the new data, i.e. the resources addresses data and the operation center addresses data.

Parameters:

resourceAddresses - the resource addresses

ocAddress - the operation center address

pk - the PoolKit

Throws:

DAValidateException - the DA validate exception

DAException - the DA exception

validateDepartureAndArrivalAddresses

protected void validateDepartureAndArrivalAddresses(DBView dbvResourceAddresses,
 DBView dbvOperationCenterAddresses)
                                             throws DAValidateException

Validates departure and arrival addresses.

Parameters:

dbvResourceAddresses - the resource addresses

dbvOperationCenterAddresses - the operation center addresses

Throws:

DAValidateException - the DA validate exception

checkAddressOrigin

protected void checkAddressOrigin(SchedulingResource schedulingResource,
 Long addressId,
 String description,
 boolean userAddress,
 PoolKit pk)
                           throws DAValidateException,
DAException

Validates the address origin (existence, not a technical object address, resource or operation center address)

Parameters:

schedulingResource - the scheduling resource

addressId - the address id

description - the description

userAddress - the user address

pk - the PoolKit

Throws:

DAValidateException - the DA validate exception

DAException - the DA exception

validate

protected void validate(BOSchedulingUser user)
                 throws DAValidateException

Checks whether the user the timesheet profile is set and if the timesheet management is active.

Parameters:

user - the BOSchedulingUser

Throws:

DAValidateException - the DA validate exception