Package org.dspace.xmlworkflow.state.actions.userassignment

Class AutoAssignAction

java.lang.Object

org.dspace.xmlworkflow.state.actions.Action

org.dspace.xmlworkflow.state.actions.userassignment.UserSelectionAction

org.dspace.xmlworkflow.state.actions.userassignment.AutoAssignAction

public class AutoAssignAction
extends UserSelectionAction

A user selection action that will create pooled tasks for all the user who have a workflowItemRole for this workflow item

Author:

Bram De Schouwer (bram.deschouwer at dot com), Kevin Van de Velde (kevin at atmire dot com), Ben Bosman (ben at atmire dot com), Mark Diggory (markd at atmire dot com)

Field Summary

Fields

Modifier and Type	Field	Description
protected GroupService	groupService
protected WorkflowRequirementsService	workflowRequirementsService

Fields inherited from class org.dspace.xmlworkflow.state.actions.userassignment.UserSelectionAction

claimedTaskService, poolTaskService, workflowItemRoleService

Constructor Summary

Constructors

Constructor	Description
AutoAssignAction()

Method Summary

Modifier and Type	Method	Description
void	activate(Context c, XmlWorkflowItem wfItem)	Called when a workflow item becomes eligible for this Action.
protected void	createTaskForEPerson(Context c, XmlWorkflowItem wfi, Step step, WorkflowActionConfig actionConfig, EPerson user)	Create a claimed task for the user IF this user doesn't have a claimed action for this workflow item
ActionResult	execute(Context c, XmlWorkflowItem wfi, Step step, javax.servlet.http.HttpServletRequest request)	Called when the action is to be performed.
List<String>	getOptions()	Returns a list of options that the user can select at this action which results in the next step in the workflow
boolean	isFinished(XmlWorkflowItem wfi)
boolean	isValidUserSelection(Context context, XmlWorkflowItem wfi, boolean hasUI)	Check user constraints (enough users, group exists, ...).
void	regenerateTasks(Context c, XmlWorkflowItem wfi, RoleMembers roleMembers)	Should a person have the option to repool the task the tasks will have to be regenerated
boolean	usesTaskPool()	A boolean indicating wether or not the task pool is used for this type of user selection

Methods inherited from class org.dspace.xmlworkflow.state.actions.userassignment.UserSelectionAction

isAuthorized

Methods inherited from class org.dspace.xmlworkflow.state.actions.Action

addApprovedProvenance, addErrorField, alertUsersOnActivation, getAdvancedInfo, getAdvancedOptions, getErrorFields, getParent, getProvenanceStartId, isAdvanced, isOptionInParam, setParent

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

groupService

@Autowired(required=true)
protected GroupService groupService

workflowRequirementsService

@Autowired(required=true)
protected WorkflowRequirementsService workflowRequirementsService

Constructor Detail

AutoAssignAction

public AutoAssignAction()

Method Detail

activate

public void activate(Context c,
                     XmlWorkflowItem wfItem)

Description copied from class: Action

Called when a workflow item becomes eligible for this Action.

Specified by:

activate in class Action

Parameters:

c - current DSpace session.

wfItem - the eligible item.

execute

public ActionResult execute(Context c,
                            XmlWorkflowItem wfi,
                            Step step,
                            javax.servlet.http.HttpServletRequest request)
                     throws SQLException,
                            AuthorizeException,
                            IOException

Description copied from class: Action

Called when the action is to be performed.

Specified by:

execute in class Action

Parameters:

c - current DSpace session.

wfi - the item on which the action is to be performed.

step - the workflow step in which the action is performed.

request - the current client request.

Returns:

the result of performing the action.

Throws:

SQLException - passed through.

AuthorizeException - passed through.

IOException - passed through.

getOptions

public List<String> getOptions()

Description copied from class: Action

Returns a list of options that the user can select at this action which results in the next step in the workflow

Specified by:

getOptions in class Action

Returns:

A list of options of this action, resulting in the next step of the workflow

createTaskForEPerson

protected void createTaskForEPerson(Context c,
                                    XmlWorkflowItem wfi,
                                    Step step,
                                    WorkflowActionConfig actionConfig,
                                    EPerson user)
                             throws SQLException,
                                    AuthorizeException,
                                    IOException

Create a claimed task for the user IF this user doesn't have a claimed action for this workflow item

Parameters:

c - the dspace context

wfi - the workflow item

step - the current step

actionConfig - the action

user - the user to create the action for

Throws:

SQLException - ...

AuthorizeException - ...

IOException - ...

isFinished

public boolean isFinished(XmlWorkflowItem wfi)

Specified by:

isFinished in class UserSelectionAction

regenerateTasks

public void regenerateTasks(Context c,
                            XmlWorkflowItem wfi,
                            RoleMembers roleMembers)
                     throws SQLException

Description copied from class: UserSelectionAction

Should a person have the option to repool the task the tasks will have to be regenerated

Specified by:

regenerateTasks in class UserSelectionAction

Parameters:

c - the dspace context

wfi - the workflowitem

roleMembers - the list of users for which tasks must be regenerated

Throws:

SQLException - An exception that provides information on a database access error or other errors.

isValidUserSelection

public boolean isValidUserSelection(Context context,
                                    XmlWorkflowItem wfi,
                                    boolean hasUI)
                             throws WorkflowConfigurationException,
                                    SQLException

Description copied from class: UserSelectionAction

Check user constraints (enough users, group exists, ...).

Specified by:

isValidUserSelection in class UserSelectionAction

Parameters:

context - the dspace context

wfi - the workflow item

hasUI - whether or not the Step has a user interface

Returns:

if the action is valid

Throws:

WorkflowConfigurationException - if there is an error in the workflow configuration.

SQLException - passed through.

usesTaskPool

public boolean usesTaskPool()

Description copied from class: UserSelectionAction

A boolean indicating wether or not the task pool is used for this type of user selection

Specified by:

usesTaskPool in class UserSelectionAction

Returns:

a boolean