Package overit.geocallapp.wfm.orchestrator.workorders.bl.intervention.measure.task

Class BTInterventionMeasureLink

java.lang.Object

overit.geocall.bl.BusinessTask<InterventionMeasureLinkEvent>

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

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

overit.geocallapp.wfm.orchestrator.workorders.bl.intervention.measure.task.BTInterventionMeasureLink

All Implemented Interfaces:

Serializable, Tool, ValidExecution

@Event(InterventionMeasureLinkEvent.class)
public class BTInterventionMeasureLink
extends ValidPermissionBusinessTask<InterventionMeasureLinkEvent>

Business task in order to link a BOMeasure to an intervention.
When the InterventionMeasureLinkEvent is launched the BT notices the call and updates the BOMeasure intervention reference according to the event's input.

Permissions:

• MeasuringElementPermissions.MEASURING_ELEMENTS_EDIT

Error codes:

• Codes.PROPERTY_REQUIRED
• Codes.InterventionMeasure.INVALID_INTERVENTION_STATUS
• Codes.InterventionMeasure.MISMATCHING_TECHNICAL_OBJECT
• Codes.InterventionMeasure.NO_MATCHING_CENSUS_RULE

Since:

20.0

See Also:

• Serialized Form

GCApi:

task

Field Summary

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

LOG

Constructor Summary

Constructors

Constructor	Description
BTInterventionMeasureLink()

Method Summary

Modifier and Type	Method	Description
protected void	execute(InterventionMeasureLinkEvent event, PoolKit pk)	Updates the BOMeasure object linking the intervention.
protected WorkOrdersIntegrationService	getIntegrationService(PoolKit pk)	Retrieves the WorkOrdersIntegrationService instance.
boolean	isValidExecution()	Determines whether the current state is valid for execution.
protected void	validate(BOMeasure measure, PoolKit pk)	Validates the measure data.
protected void	validateWorkOrderStatus(BOWorkOrderHeader workOrder)	Validates that the work order is in a valid status.

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

BTInterventionMeasureLink

public BTInterventionMeasureLink()

Method Details

getIntegrationService

protected WorkOrdersIntegrationService getIntegrationService(PoolKit pk)
                                                      throws DAValidateException

Retrieves the WorkOrdersIntegrationService instance. If the instance hasn't been created yet, it will be created and stored for future use.

Parameters:

pk - The PoolKit.

Returns:

The WorkOrdersIntegrationService instance.

Throws:

DAValidateException - If any validation error occurs.

execute

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

Updates the BOMeasure object linking the intervention.

Specified by:

execute in class ValidExecutionBusinessTask<InterventionMeasureLinkEvent>

Parameters:

event - the InterventionMeasureLinkEvent

pk - the PoolKit

Throws:

DAException - the DA exception

DAValidateException - the DA validate exception

validate

protected void validate(BOMeasure measure,
 PoolKit pk)
                 throws DAException,
DAValidateException

Validates the measure data.

Performs the following validations:

• Checks if the intervention reference exists
• Checks if the measuring element reference exists
• Ensures the intervention is in a valid status for measure insertion
• Ensures the measuring element technical object matches the intervention technical object
• Ensures the measuring element matches at least one census rule's criteria

Parameters:

measure - the measure to validate

pk - the PoolKit

Throws:

DAValidateException - if the measure is invalid or addresses don't match

DAException - if a data access error occurs

validateWorkOrderStatus

protected void validateWorkOrderStatus(BOWorkOrderHeader workOrder)
                                throws DAValidateException

Validates that the work order is in a valid status. Throws an exception if the work order is in CLOSED, TECHNICALLY_CLOSED, CANCELLED or ALIGNED status.

Parameters:

workOrder - the work order header to validate

Throws:

DAValidateException - if the work order is in an invalid status

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