Package overit.geocallapp.wfm.measuringelements.bl.measuringelement.measure.task

Class BTPreviousMeasureSearch

java.lang.Object

overit.geocall.bl.BusinessTask<PreviousMeasureSearchEvent>

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

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

overit.geocallapp.wfm.measuringelements.bl.measuringelement.measure.task.BTPreviousMeasureSearch

All Implemented Interfaces:

Serializable, Tool, ValidExecution

@Event(PreviousMeasureSearchEvent.class)
public class BTPreviousMeasureSearch
extends ValidPermissionBusinessTask<PreviousMeasureSearchEvent>

Business task in order to search for a measuring element's previous BOMeasure, according to the target date.
When the PreviousMeasureSearchEvent is launched the BT notices the call and searches for the BOMeasure according to the event's input.
Permissions:

• MeasuringElementPermissions.MEASURING_ELEMENTS_VIEW
• MeasuringElementPermissions.MEASURING_ELEMENTS_EDIT

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
BTPreviousMeasureSearch()

Method Summary

Modifier and Type	Method	Description
protected void	execute(PreviousMeasureSearchEvent event, PoolKit pk)	Writes the measuring element's previous measure into the event journal.
protected BOMeasure	findPreviousChronologicalMeasure(PreviousMeasureSearchEventInput input, PoolKit pk)	Finds the most recent chronological measure for a measuring element before a target date.
boolean	isValidExecution()	Determines whether the current state is valid for execution.

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

BTPreviousMeasureSearch

public BTPreviousMeasureSearch()

Method Details

execute

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

Writes the measuring element's previous measure into the event journal.

Specified by:

execute in class ValidExecutionBusinessTask<PreviousMeasureSearchEvent>

Parameters:

event - the PreviousMeasureSearchEvent

pk - the PoolKit

Throws:

DAException - the DA exception

DAValidateException - the DA validate exception

findPreviousChronologicalMeasure

protected BOMeasure findPreviousChronologicalMeasure(PreviousMeasureSearchEventInput input,
 PoolKit pk)
                                              throws DAException,
DAValidateException

Finds the most recent chronological measure for a measuring element before a target date.

This method searches for the previous BOMeasure of the specified measuring element that was taken before the given target date. The search excludes measures with BOMeasureStatus.Values.REJECTED status and returns the most recent valid measure in chronological order.

The search process:

• Filters measures by the specified measuring element ID
• Restricts the search to measures taken before the target date
• Excludes measures with REJECTED status
• Orders results by measuring date in descending order
• Returns the first (most recent) result, or null if no measures are found

Parameters:

input - the PreviousMeasureSearchEventInput containing the measuring element and target date for the search

pk - the PoolKit for database access and transaction management

Returns:

the most recent BOMeasure before the target date, or null if no valid previous measure exists

Throws:

DAException - if a database access error occurs during the search

DAValidateException - if validation fails during the search operation

See Also:

• PreviousMeasureSearchEventInput.getMeasuringElement()
• PreviousMeasureSearchEventInput.getTargetDate()
• BOMeasureStatus.Values.REJECTED

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