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

Class ClaimAction

java.lang.Object

org.dspace.xmlworkflow.state.actions.Action

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

org.dspace.xmlworkflow.state.actions.userassignment.ClaimAction

public class ClaimAction
extends UserSelectionAction

Processing class for an action where x number of users have to accept a task from a designated pool

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 inherited from class org.dspace.xmlworkflow.state.actions.userassignment.UserSelectionAction

claimedTaskService, log, poolTaskService, workflowItemRoleService

Constructor Summary

Constructors

Constructor	Description
ClaimAction()

Method Summary

Modifier and Type	Method	Description
void	activate(Context context, XmlWorkflowItem wfItem)
void	alertUsersOnActivation(Context c, XmlWorkflowItem wfi, RoleMembers roleMembers)
ActionResult	execute(Context c, XmlWorkflowItem wfi, Step step, javax.servlet.http.HttpServletRequest request)
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)	Verifies if the user selection action is valid User constraints will be checked (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

addErrorField, getErrorFields, getParent, getProvenanceStartId, isOptionInParam, setParent

Methods inherited from class java.lang.Object

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

Constructor Detail

ClaimAction

public ClaimAction()

Method Detail

activate

public void activate(Context context,
                     XmlWorkflowItem wfItem)
              throws SQLException,
                     IOException,
                     AuthorizeException

Specified by:

activate in class Action

Throws:

SQLException

IOException

AuthorizeException

execute

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

Specified by:

execute in class Action

Throws:

SQLException

AuthorizeException

IOException

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

alertUsersOnActivation

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

Overrides:

alertUsersOnActivation in class Action

Throws:

IOException

SQLException

regenerateTasks

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

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.

AuthorizeException - thrown if the current user isn't authorized

IOException - A general class of exceptions produced by failed or interrupted I/O operations.

isFinished

public boolean isFinished(XmlWorkflowItem wfi)

Specified by:

isFinished in class UserSelectionAction

isValidUserSelection

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

Description copied from class: UserSelectionAction

Verifies if the user selection action is valid User constraints will be checked (enough users, group exists, ...)

Specified by:

isValidUserSelection in class UserSelectionAction

Parameters:

context - the dspace context

wfi - the workflow item

hasUI - boolean indicating whether or not the action has a user interface

Returns:

if the action is valid

Throws:

WorkflowConfigurationException - occurs if there is a configuration error in the workflow

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

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