Package overit.geocallapp.wfm.orchestrator.assets.bl.measuringelement.task

Class BTMeasuringElementUpdate

java.lang.Object

overit.geocall.bl.BusinessTask<MeasuringElementUpdateEvent>

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

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

overit.geocallapp.wfm.orchestrator.assets.bl.measuringelement.task.BTMeasuringElementUpdate

All Implemented Interfaces:

Serializable, Tool, ValidExecution

@Event(MeasuringElementUpdateEvent.class)
public class BTMeasuringElementUpdate
extends ValidPermissionBusinessTask<MeasuringElementUpdateEvent>

Business task in order to update a BOMeasuringElement.
When the MeasuringElementUpdateEvent is launched the BT notices the call and updates the BOMeasuringElement according to the event's input.
Permissions:

• MeasuringElementPermissions.MEASURING_ELEMENTS_EDIT

Error codes:

• Codes.INVALID_PROPERTY_VALUE for code, description and status
• Codes.FIELDS_LENGTH for code and description
• Codes.NOT_FOUND for technical object, status, counter direction, characteristic, measurement unit and catalog group
• Codes.MeasuringElement.UNDEFINED_CHARACTERISTIC_AND_CATALOG_GROUP
• Codes.MeasuringElement.INVALID_CHARACTERISTIC_USAGE
• Codes.MeasuringElement.PROPERTY_NOT_ALLOWED_FOR_CHARACTERISTIC
• Codes.MeasuringElement.PROPERTY_NOT_ALLOWED_WITHOUT_CHARACTERISTIC
• Codes.MeasuringElement.MEASUREMENT_CATALOG_GROUP_REQUIRED
• Codes.MeasuringElement.ONLY_STATUS_ADMISSIBLE_FOR_UPDATE

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

Method Summary

Modifier and Type	Method	Description
protected void	checkUniqueness(BOMeasuringElement measuringElement, PoolKit pk)	Validates that no other measuring element exists with the same code for the given technical object.
protected void	execute(MeasuringElementUpdateEvent event, PoolKit pk)	Updates the BOMeasuringElement object.
protected AssetsIntegrationService	getIntegrationService(PoolKit pk)	Returns an instance of AssetsIntegrationService.
boolean	isValidExecution()	Determines whether the current state is valid for execution.
protected void	validateForUpdate(BOMeasuringElement measuringElement, PoolKit pk)	Validates a measuring element for update when no measures exist.
protected void	validateInput(BOMeasuringElement measuringElement, PoolKit pk)	Validates the BOMeasuringElement object data before its update.

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

BTMeasuringElementUpdate

public BTMeasuringElementUpdate()

Method Details

getIntegrationService

protected AssetsIntegrationService getIntegrationService(PoolKit pk)
                                                  throws DAValidateException

Returns an instance of AssetsIntegrationService.

Parameters:

pk - the PoolKit

Returns:

an instance of AssetsIntegrationService

Throws:

DAValidateException - the DA validate exception

execute

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

Updates the BOMeasuringElement object.

Specified by:

execute in class ValidExecutionBusinessTask<MeasuringElementUpdateEvent>

Parameters:

event - the MeasuringElementUpdateEvent

pk - the PoolKit

Throws:

DAException - the DA exception

DAValidateException - the DA validate exception

validateInput

protected void validateInput(BOMeasuringElement measuringElement,
 PoolKit pk)
                      throws DAValidateException,
DAException

Validates the BOMeasuringElement object data before its update.

Parameters:

measuringElement - the BOMeasuringElement object to be updated

pk - the PoolKit pk

Throws:

DAValidateException - if there is a data validation exception

DAException - if a generic Exception object is thrown

validateForUpdate

protected void validateForUpdate(BOMeasuringElement measuringElement,
 PoolKit pk)
                          throws DAValidateException,
DAException

Validates a measuring element for update when no measures exist.

Performs the following validations:

• Validates code and description properties (length and non-empty)
• Validates status exists and is valid
• Checks uniqueness of code within technical object
• Validates counter direction if specified
• Ensures either characteristic or catalog group is defined
• If characteristic is present:
  • Validates characteristic exists and has valid usage
  • Validates measurement unit and max length
  • Validates counter-related properties for meter characteristics
• If catalog group is present, validates it exists and is of measurement type

Parameters:

measuringElement - the measuring element to validate

pk - the pool kit for accessing services

Throws:

DAValidateException - if any validation fails

DAException - if there's an error accessing services

checkUniqueness

protected void checkUniqueness(BOMeasuringElement measuringElement,
 PoolKit pk)
                        throws DAValidateException,
DAException

Validates that no other measuring element exists with the same code for the given technical object.

The method searches for measuring elements with the same code and technical object, excluding the current measuring element being updated (by ID comparison).

Parameters:

measuringElement - the measuring element to check for uniqueness

pk - the pool kit for accessing integration services

Throws:

DAValidateException - with Codes.CODE_ALREADY_DEFINED if another measuring element with the same code exists for the technical object

DAException - if there's an error during the search operation

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