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

Class BTInterventionMeasureCheck

java.lang.Object

overit.geocall.bl.BusinessTask<InterventionMeasureCheckEvent>

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

All Implemented Interfaces:

Serializable, Tool

@Event(InterventionMeasureCheckEvent.class)
public class BTInterventionMeasureCheck
extends BusinessTask<InterventionMeasureCheckEvent>

Business task that checks that all intervention measures are validated in order proceed with the intervention outcome.

When the InterventionMeasureCheckEvent is launched the BT notices the call and checks the intervention measures.

Error codes:

• Codes.InterventionMeasure.MISSING_MANDATORY_MEASURE

Since:

20.0

See Also:

• Serialized Form

GCApi:

task

Constructor Summary

Constructors

Constructor	Description
BTInterventionMeasureCheck()

Method Summary

Modifier and Type	Method	Description
protected void	body(InterventionMeasureCheckEvent event, PoolKit pk)	Validates the intervention measures according to census rules.
protected void	checkMandatoryMeasures(BOIntervention intervention, List<BOMeasuringElement> measuringElements, List<BOCensusRule> rules, PoolKit poolKit)	Checks if all mandatory measuring elements have at least one validated measure for the intervention.
protected WorkOrdersIntegrationService	getIntegrationService(PoolKit pk)	Retrieves the WorkOrdersIntegrationService instance.
protected List<BOCensusRule>	getInterventionMeasureCensusRules(BOIntervention intervention, PoolKit poolKit)	Loads the active census rules of type measures associated with the given intervention.
protected List<BOMeasuringElement>	getInterventionMeasuringElements(BOIntervention intervention, PoolKit pk)	Loads all measuring elements associated with the intervention's address.

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

BTInterventionMeasureCheck

public BTInterventionMeasureCheck()

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.

body

protected void body(InterventionMeasureCheckEvent event,
 PoolKit pk)
             throws DAException,
DAValidateException

Validates the intervention measures according to census rules.

The method performs the following steps:

1. Loads census rules for the intervention
2. Loads measuring elements associated with the intervention
3. If rules exist, checks that all mandatory measures are validated

Specified by:

body in class BusinessTask<InterventionMeasureCheckEvent>

Parameters:

event - the InterventionMeasureCheckEvent containing the intervention to check

pk - the PoolKit

Throws:

DAValidateException - if mandatory measures are missing or invalid

DAException - the DA exception

checkMandatoryMeasures

protected void checkMandatoryMeasures(BOIntervention intervention,
 List<BOMeasuringElement> measuringElements,
 List<BOCensusRule> rules,
 PoolKit poolKit)
                               throws DAValidateException,
DAException

Checks if all mandatory measuring elements have at least one validated measure for the intervention.

The method performs the following steps:

1. Collects mandatory catalog groups and characteristics from the rules
2. For each measuring element, checks if it belongs to a mandatory group or has mandatory characteristics
3. For mandatory elements, verifies existence of at least one validated measure for the intervention

Parameters:

intervention - the BOIntervention to check measures for

measuringElements - the list of BOMeasuringElement to validate

rules - the list of BOCensusRule containing mandatory requirements

poolKit - the PoolKit

Throws:

DAValidateException - with Codes.InterventionMeasure.MISSING_MANDATORY_MEASURE if a mandatory measure is missing, or Codes.InterventionMeasure.INVALID_MEASURES_VALIDATED if multiple validated measures exist for the same element

DAException - if a data access error occurs

getInterventionMeasuringElements

protected List<BOMeasuringElement> getInterventionMeasuringElements(BOIntervention intervention,
 PoolKit pk)
                                                             throws DAValidateException,
DAException

Loads all measuring elements associated with the intervention's address.

The method performs the following steps:

1. Gets the work order operation from the intervention
2. Gets the work order header from the operation
3. Gets the address from the work order
4. Searches for all measuring elements at that address that are working

Parameters:

intervention - the BOIntervention to load measuring elements for

pk - the PoolKit

Returns:

the list of BOMeasuringElement found at the intervention address

Throws:

DAValidateException - the DA validate exception

DAException - the DA exception

getInterventionMeasureCensusRules

protected List<BOCensusRule> getInterventionMeasureCensusRules(BOIntervention intervention,
 PoolKit poolKit)
                                                        throws DAValidateException,
DAException

Loads the active census rules of type measures associated with the given intervention.

Parameters:

intervention - the BOIntervention to load rules for

poolKit - the PoolKit

Returns:

the list of BOCensusRule associated with the intervention

Throws:

DAValidateException - the DA validate exception

DAException