Package overit.geocallapp.wfm.orchestrator.workorders.bl.attachment.task

Class BTWorkOrderAttachmentInsert

java.lang.Object

overit.geocall.bl.BusinessTask<WorkOrderAttachmentInsertEvent>

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

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

overit.geocallapp.wfm.orchestrator.workorders.bl.attachment.task.BTWorkOrderAttachmentInsert

All Implemented Interfaces:

Serializable, Tool, ValidExecution

@Event(WorkOrderAttachmentInsertEvent.class)
public class BTWorkOrderAttachmentInsert
extends ValidPermissionBusinessTask<WorkOrderAttachmentInsertEvent>

Business task in order to insert a BOAttachment related to a work order.
When the WorkOrderAttachmentInsertEvent is launched the BT notices the call and inserts the BOAttachment related to the given work order.

Error Code:

• Codes.Attachment.ALREADY_EXISTS

Permission:

• WorkOrderPermissions.WORK_ORDER_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
BTWorkOrderAttachmentInsert()

Method Summary

Modifier and Type	Method	Description
protected void	execute(WorkOrderAttachmentInsertEvent event, PoolKit poolKit)	Executes the work order attachment insert operation.
WorkOrdersIntegrationService	getIntegrationService(PoolKit poolKit)	Retrieves the WorkOrdersIntegrationService instance.
boolean	isValidExecution()	Determines if this task is valid for execution.
protected BOAddress	loadAddress(Long addressId, PoolKit poolKit)	Loads an address by its ID.
protected BOWorkOrderHeader	loadWorkOrderHeader(Long workOrderId, PoolKit poolKit)	Loads a work order header by its id.
void	validate(WorkOrderAttachmentInsertInput input, PoolKit poolKit)	Validates the input parameters for the work order attachment insert operation.

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

BTWorkOrderAttachmentInsert

public BTWorkOrderAttachmentInsert()

Method Details

execute

protected void execute(WorkOrderAttachmentInsertEvent event,
 PoolKit poolKit)
                throws DAException,
DAValidateException

Executes the work order attachment insert operation. This method performs the following steps:

1. Loads the work order header using the ID from the event input
2. Loads the address associated with the work order
3. Creates a new attachment object with the work order and technical object references
4. Launches a AttachmentInsertEvent to complete the insert process
5. Writes the created attachment ID to the event journal

Specified by:

execute in class ValidExecutionBusinessTask<WorkOrderAttachmentInsertEvent>

Parameters:

event - The WorkOrderAttachmentInsertEvent containing the work order ID

poolKit - The PoolKit providing access to the data layer

Throws:

DAException - If a data access error occurs during the operation

DAValidateException - If validation of the data fails

validate

public void validate(WorkOrderAttachmentInsertInput input,
 PoolKit poolKit)
              throws DAValidateException,
DAException

Validates the input parameters for the work order attachment insert operation.

Parameters:

input - The WorkOrderAttachmentInsertInput containing the work order ID

poolKit - The PoolKit providing access to the data layer

Throws:

DAValidateException - If validation of the data fails

DAException

loadWorkOrderHeader

protected BOWorkOrderHeader loadWorkOrderHeader(Long workOrderId,
 PoolKit poolKit)
                                         throws DAException,
DAValidateException

Loads a work order header by its id.

Parameters:

workOrderId - The id of the work order to load

poolKit - The PoolKit providing access to the data layer

Returns:

The BOWorkOrderHeader for the specified work order id

Throws:

DAException - If a data access error occurs during the operation

DAValidateException - If validation of the data fails

loadAddress

protected BOAddress loadAddress(Long addressId,
 PoolKit poolKit)
                         throws DAException,
DAValidateException

Loads an address by its ID.

Parameters:

addressId - The ID of the address to load

poolKit - The PoolKit providing access to the data layer

Returns:

The BOAddress for the specified address ID

Throws:

DAException - If a data access error occurs during the operation

DAValidateException - If validation of the data fails

getIntegrationService

public WorkOrdersIntegrationService getIntegrationService(PoolKit poolKit)
                                                   throws DAValidateException

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

Parameters:

poolKit - The PoolKit providing access to the data layer

Returns:

The WorkOrdersIntegrationService instance

Throws:

DAValidateException - If validation of the data fails during service creation

isValidExecution

public boolean isValidExecution()

Determines if this task is valid for execution. This method always returns true, indicating that this task can be executed without additional permission checks beyond those performed by the base class.

Returns:

true indicating that the task is always valid for execution