org.kuali.rice.kew.actions

Class ReturnToPreviousNodeAction

java.lang.Object

org.kuali.rice.kew.actions.ActionTakenEvent

org.kuali.rice.kew.actions.ReturnToPreviousNodeAction

Direct Known Subclasses:

RecallAction

public class ReturnToPreviousNodeAction
extends ActionTakenEvent

Returns a document to a previous node in the route. Current implementation only supports returning to a node on the main branch of the document.

Author:

Kuali Rice Team (rice.collab@kuali.org)

Field Summary

Fields

Modifier and Type	Field and Description
protected static boolean	DEFAULT_SEND_NOTIFICATIONS
protected static String	INITIAL_NODE_NAME
protected static org.apache.log4j.Logger	LOG
protected String	nodeName

Fields inherited from class org.kuali.rice.kew.actions.ActionTakenEvent

annotation, DEFAULT_ANNOTATION, DEFAULT_QUEUE_DOCUMENT_AFTER_ACTION, DEFAULT_RUN_POSTPROCESSOR_LOGIC, routeHeader

Constructor Summary

Constructors

Modifier	Constructor and Description
	ReturnToPreviousNodeAction(DocumentRouteHeaderValue routeHeader, org.kuali.rice.kim.api.identity.principal.PrincipalContract principal)
	ReturnToPreviousNodeAction(DocumentRouteHeaderValue routeHeader, org.kuali.rice.kim.api.identity.principal.PrincipalContract principal, String annotation, String nodeName, boolean sendNotifications)
	ReturnToPreviousNodeAction(DocumentRouteHeaderValue routeHeader, org.kuali.rice.kim.api.identity.principal.PrincipalContract principal, String annotation, String nodeName, boolean sendNotifications, boolean runPostProcessorLogic)
protected	ReturnToPreviousNodeAction(String overrideActionTakenCode, DocumentRouteHeaderValue routeHeader, org.kuali.rice.kim.api.identity.principal.PrincipalContract principal, String annotation, String nodeName, boolean sendNotifications) Constructor used to override the action taken code...e.g.
protected	ReturnToPreviousNodeAction(String overrideActionTakenCode, DocumentRouteHeaderValue routeHeader, org.kuali.rice.kim.api.identity.principal.PrincipalContract principal, String annotation, String nodeName, boolean sendNotifications, boolean runPostProcessorLogic) Constructor used to override the action taken code...e.g.

Method Summary

Modifier and Type	Method and Description
protected org.kuali.rice.kim.api.identity.principal.PrincipalContract	determineInitialNodePrincipal(DocumentRouteHeaderValue routeHeader) Determines which principal to generate an actionqrequest when the document is returned to the initial node By default this is the document initiator.
protected List<ActionRequestValue>	findApplicableActionRequests(List<ActionRequestValue> actionRequests) Allows subclasses to determine which actionrequests to inspect for purposes of action validation
protected ActionRequestType	getReturnToInitiatorActionRequestType() Template method that determines what action request to generate when returning to initiator
boolean	isActionCompatibleRequest(List<ActionRequestValue> requests)
boolean	isSuperUserUsage()
void	recordAction()
protected void	sendAdditionalNotifications() Template method subclasses can use to send addition notification upon a return to previous action.
void	setSuperUserUsage(boolean superUserUsage)
String	validateActionRules() Placeholder for validation rules for each action
String	validateActionRules(List<ActionRequestValue> actionRequests)

Methods inherited from class org.kuali.rice.kew.actions.ActionTakenEvent

filterActionRequestsByCode, findDelegatorForActionRequests, generateAcknowledgementsToPreviousActionTakers, getActionPerformedCode, getActionRequestService, getActionTakenCode, getDocumentId, getGroupIdsForPrincipal, getPrincipal, getRouteHeader, invokePostProcessor, isActionValid, isPolicySet, isPolicySet, isRunPostProcessorLogic, notifyActionTaken, notifyAfterActionTaken, notifyStatusChange, performAction, queueDocumentProcessing, saveActionTaken, saveActionTaken, saveActionTaken, saveActionTaken, setActionTakenCode, setRouteHeader, updateSearchableAttributesIfPossible

Methods inherited from class java.lang.Object

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

Field Detail

LOG

protected static final org.apache.log4j.Logger LOG

INITIAL_NODE_NAME

protected static final String INITIAL_NODE_NAME

DEFAULT_SEND_NOTIFICATIONS

protected static final boolean DEFAULT_SEND_NOTIFICATIONS

See Also:

Constant Field Values

nodeName

protected final String nodeName

Constructor Detail

ReturnToPreviousNodeAction

public ReturnToPreviousNodeAction(DocumentRouteHeaderValue routeHeader,
                                  org.kuali.rice.kim.api.identity.principal.PrincipalContract principal)

ReturnToPreviousNodeAction

public ReturnToPreviousNodeAction(DocumentRouteHeaderValue routeHeader,
                                  org.kuali.rice.kim.api.identity.principal.PrincipalContract principal,
                                  String annotation,
                                  String nodeName,
                                  boolean sendNotifications)

ReturnToPreviousNodeAction

public ReturnToPreviousNodeAction(DocumentRouteHeaderValue routeHeader,
                                  org.kuali.rice.kim.api.identity.principal.PrincipalContract principal,
                                  String annotation,
                                  String nodeName,
                                  boolean sendNotifications,
                                  boolean runPostProcessorLogic)

ReturnToPreviousNodeAction

protected ReturnToPreviousNodeAction(String overrideActionTakenCode,
                                     DocumentRouteHeaderValue routeHeader,
                                     org.kuali.rice.kim.api.identity.principal.PrincipalContract principal,
                                     String annotation,
                                     String nodeName,
                                     boolean sendNotifications)

Constructor used to override the action taken code...e.g. when being performed as part of a Move action

ReturnToPreviousNodeAction

protected ReturnToPreviousNodeAction(String overrideActionTakenCode,
                                     DocumentRouteHeaderValue routeHeader,
                                     org.kuali.rice.kim.api.identity.principal.PrincipalContract principal,
                                     String annotation,
                                     String nodeName,
                                     boolean sendNotifications,
                                     boolean runPostProcessorLogic)

Constructor used to override the action taken code...e.g. when being performed as part of a Move action

Method Detail

getReturnToInitiatorActionRequestType

protected ActionRequestType getReturnToInitiatorActionRequestType()

Template method that determines what action request to generate when returning to initiator

Returns:

the ActionRequestType

determineInitialNodePrincipal

protected org.kuali.rice.kim.api.identity.principal.PrincipalContract determineInitialNodePrincipal(DocumentRouteHeaderValue routeHeader)

Determines which principal to generate an actionqrequest when the document is returned to the initial node By default this is the document initiator.

Parameters:

routeHeader - the document route header

Returns:

a Principal

validateActionRules

public String validateActionRules()

Description copied from class: ActionTakenEvent

Placeholder for validation rules for each action

Specified by:

validateActionRules in class ActionTakenEvent

Returns:

error message string of specific error message

validateActionRules

public String validateActionRules(List<ActionRequestValue> actionRequests)

Specified by:

validateActionRules in class ActionTakenEvent

findApplicableActionRequests

protected List<ActionRequestValue> findApplicableActionRequests(List<ActionRequestValue> actionRequests)

Allows subclasses to determine which actionrequests to inspect for purposes of action validation

Parameters:

actionRequests - all actionrequests for this document

Returns:

a (possibly) filtered list of actionrequests

isActionCompatibleRequest

public boolean isActionCompatibleRequest(List<ActionRequestValue> requests)

Overrides:

isActionCompatibleRequest in class ActionTakenEvent

recordAction

public void recordAction()
                  throws InvalidActionTakenException

Specified by:

recordAction in class ActionTakenEvent

Throws:

InvalidActionTakenException

sendAdditionalNotifications

protected void sendAdditionalNotifications()

Template method subclasses can use to send addition notification upon a return to previous action. This occurs after the postprocessors have been called and the node has been changed

isSuperUserUsage

public boolean isSuperUserUsage()

setSuperUserUsage

public void setSuperUserUsage(boolean superUserUsage)