Package overit.geocallapp.wfm.mobileforms.bl.instance.task

Class BTDataCollectionSheetInstanceFillIn

java.lang.Object

overit.geocall.bl.BusinessTask<DataCollectionSheetInstanceFillInEvent>

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

overit.geocallapp.wfm.mobileforms.bl.task.BTDataCollection<DataCollectionSheetInstanceFillInEvent>

overit.geocallapp.wfm.mobileforms.bl.instance.task.BTDataCollectionSheetInstanceFillIn

All Implemented Interfaces:

Serializable, Tool, ValidExecution

@Event(DataCollectionSheetInstanceFillInEvent.class)
public class BTDataCollectionSheetInstanceFillIn
extends BTDataCollection<DataCollectionSheetInstanceFillInEvent>

Business task in order to fill in a DataCollectionSheetInstance.
When the DataCollectionSheetInstanceFillInEvent is launched the BT notices the call and fills in the DataCollectionSheetInstance basing on the event's input.

Permission:

• DataCollectionPermission.FSM_DATACOLLECTION_SHEET_EDIT
  or
• DataCollectionPermission.FSM_DATACOLLECTION_SUPERUSER_EXECUTE

Errors:

• Codes.DATACOLLECTION_NODE_ID_NOT_FOUND
• Codes.DATACOLLECTION_NODE_TYPE_MISMATCH
• Codes.DATACOLLECTION_FILL_IN_SHEET_FINAL_STATE

Since:

12.0

See Also:

• Serialized Form

GCApi:

task

Constructor Summary

Constructors

Constructor	Description
BTDataCollectionSheetInstanceFillIn()

Method Summary

Modifier and Type	Method	Description
protected void	checkNodesConstraints(TreeModel<DataCollectionNode> treeModel, PoolKit poolKit)	Checks the nodes constraints.
protected void	execute(DataCollectionSheetInstanceFillInEvent event, PoolKit poolKit)	Fills in the data collection sheet instance.
boolean	isValidExecution()	Checks whether the view sheet permission is activated or not.
protected DataCollectionSheetInstance	loadSheetInstance(Long sheetId, PoolKit poolKit)	Loads the sheet instance.
protected void	saveSheetInstance(DataCollectionSheetInstance sheetInstance, PoolKit poolKit)	Saves the sheet instance.

Methods inherited from class overit.geocallapp.wfm.mobileforms.bl.task.BTDataCollection

getException, throwExceptionIfInvalid

Methods inherited from class overit.geocallapp.utilities.core.bl.common.validexecution.ValidExecutionBusinessTask

body, checkValidExecution, 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

BTDataCollectionSheetInstanceFillIn

public BTDataCollectionSheetInstanceFillIn()

Method Details

isValidExecution

public boolean isValidExecution()

Checks whether the view sheet permission is activated or not.

Specified by:

isValidExecution in interface ValidExecution

Overrides:

isValidExecution in class BTDataCollection<DataCollectionSheetInstanceFillInEvent>

Returns:

true, if the view sheet permission is active, false otherwise

execute

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

Fills in the data collection sheet instance.

Specified by:

execute in class ValidExecutionBusinessTask<DataCollectionSheetInstanceFillInEvent>

Parameters:

event - the DataCollectionSheetInstanceFillInEvent

poolKit - the PoolKit

Throws:

DAException - the DA exception

DAValidateException - the DA validate exception

loadSheetInstance

protected DataCollectionSheetInstance loadSheetInstance(Long sheetId,
 PoolKit poolKit)
                                                 throws DAValidateException,
DAException

Loads the sheet instance.

Parameters:

sheetId - the sheet id

poolKit - the PoolKit

Returns:

the data collection sheet instance

Throws:

DAValidateException - the DA validate exception

DAException - the DA exception

checkNodesConstraints

protected void checkNodesConstraints(TreeModel<DataCollectionNode> treeModel,
 PoolKit poolKit)
                              throws DAValidateException,
DAException

Checks the nodes constraints.

Parameters:

treeModel - the TreeModel<DataCollectionNode>

poolKit - the pool kit

Throws:

DAValidateException - the DA validate exception

DAException - the DA exception

saveSheetInstance

protected void saveSheetInstance(DataCollectionSheetInstance sheetInstance,
 PoolKit poolKit)
                          throws DAException,
DAValidateException

Saves the sheet instance.

Parameters:

sheetInstance - the DataCollectionSheetInstance

poolKit - the PoolKit

Throws:

DAException - the DA exception

DAValidateException - the DA validate exception