org.kuali.rice.kew.actionrequest.service
Interface ActionRequestService

All Known Implementing Classes:

ActionRequestServiceImpl

public interface ActionRequestService

Service to handle the building, sorting, saving, activating and deactivating of action request graphs. These lists are what determine role and delegation behaviors in graphs of action requests. Fetching that is being done is also taking into account the 'weight' of action request codes.

Author:

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

Method Summary

void	activateRequest(ActionRequestValue actionRequest)
void	activateRequest(ActionRequestValue actionRequest, ActivationContext activationContext)
void	activateRequest(ActionRequestValue actionRequest, boolean simulate)
List	activateRequestNoNotification(ActionRequestValue actionRequest, ActivationContext activationContext)
List	activateRequestNoNotification(ActionRequestValue actionRequest, boolean simulate)
void	activateRequests(Collection actionRequests)
void	activateRequests(Collection actionRequests, ActivationContext activationContext)
void	activateRequests(Collection actionRequests, boolean simulate)
void	alterActionRequested(List actionRequests, String actionRequestCd)
void	deactivateRequest(ActionTakenValue actionTaken, ActionRequestValue actionRequest)
void	deactivateRequest(ActionTakenValue actionTaken, ActionRequestValue actionRequest, ActivationContext activationContext)
void	deactivateRequest(ActionTakenValue actionTaken, ActionRequestValue actionRequest, boolean simulate)
void	deactivateRequests(ActionTakenValue actionTaken, List actionRequests)
void	deactivateRequests(ActionTakenValue actionTaken, List actionRequests, ActivationContext activationContext)
void	deactivateRequests(ActionTakenValue actionTaken, List actionRequests, boolean simulate)
void	deleteActionRequestGraph(ActionRequestValue actionRequest)
void	deleteByActionRequestId(Long actionRequestId)
void	deleteByRouteHeaderId(Long routeHeaderId)
boolean	doesPrincipalHaveRequest(String principalId, Long documentId) Checks if the given user has any Action Requests on the given document.
List<ActionRequestValue>	filterActionRequestsByCode(List<ActionRequestValue> actionRequests, String principalId, List<String> principalGroupIds, String requestCode) Filters action requests based on if they occur after the given requestCode, and if they relate to the given principal
List	findActivatedByGroup(String groupId)
List	findAllActionRequestsByRouteHeaderId(Long routeHeaderId)
List<ActionRequestValue>	findAllPendingRequests(Long routeHeaderId) Returns all pending requests for a given routing entity
List	findAllValidRequests(String principalId, Collection actionRequests, String requestCode)
List	findAllValidRequests(String principalId, Long routeHeaderId, String requestCode)
ActionRequestValue	findByActionRequestId(Long actionRequestId)
List	findByRouteHeaderIdIgnoreCurrentInd(Long routeHeaderId)
List<ActionRequestValue>	findByStatusAndDocId(String statusCd, Long routeHeaderId)
Recipient	findDelegator(ActionRequestValue actionRequest) Returns the closest delegator for the given ActionRequest
Recipient	findDelegator(List actionRequests) Returns the highest priority delegator in the list of action requests.
ActionRequestValue	findDelegatorRequest(ActionRequestValue actionRequest)
List	findPendingByActionRequestedAndDocId(String actionRequestedCdCd, Long routeHeaderId)
List	findPendingByDoc(Long routeHeaderId)
List	findPendingByDocIdAtOrBelowRouteLevel(Long routeHeaderId, Integer routeLevel)
List	findPendingByDocRequestCdNodeName(Long routeHeaderId, String requestCode, String nodeName)
List	findPendingByDocRequestCdRouteLevel(Long routeHeaderId, String requestCode, Integer routeLevel)
List	findPendingRootRequestsByDocId(Long routeHeaderId)
List	findPendingRootRequestsByDocIdAtOrBelowRouteLevel(Long routeHeaderId, Integer routeLevel)
List	findPendingRootRequestsByDocIdAtRouteLevel(Long routeHeaderId, Integer routeLevel)
List<ActionRequestValue>	findPendingRootRequestsByDocIdAtRouteNode(Long routeHeaderId, Long nodeInstanceId)
List	findPendingRootRequestsByDocumentType(Long documentTypeId)
List	findRootRequestsByDocIdAtRouteNode(Long documentId, Long nodeInstanceId)
org.kuali.rice.core.xml.dto.AttributeSet	getActionsRequested(DocumentRouteHeaderValue routeHeader, String principalId, boolean completeAndApproveTheSame)
List	getDelegateRequests(ActionRequestValue actionRequest)
List<String>	getPrincipalIdsWithPendingActionRequestByActionRequestedAndDocId(String actionRequestedCd, Long routeHeaderId) This method gets a list of ids of all principals who have a pending action request for a document.
ActionRequestValue	getRoot(ActionRequestValue actionRequest)
List<ActionRequestValue>	getRootRequests(Collection<ActionRequestValue> actionRequests)
List	getTopLevelRequests(ActionRequestValue actionRequest) If this is a role request, then this method returns a List of the action request for each recipient within the role.
ActionRequestValue	initializeActionRequestGraph(ActionRequestValue actionRequest, DocumentRouteHeaderValue document, RouteNodeInstance nodeInstance)
boolean	isDuplicateRequest(ActionRequestValue actionRequest)
boolean	isValidActionRequestCode(String actionRequestCode)
void	saveActionRequest(ActionRequestValue actionRequest)
void	updateActionRequestsForResponsibilityChange(Set<Long> responsibilityIds)
void	validateActionRequest(ActionRequestValue actionRequest)

Method Detail

initializeActionRequestGraph

ActionRequestValue initializeActionRequestGraph(ActionRequestValue actionRequest,
                                                DocumentRouteHeaderValue document,
                                                RouteNodeInstance nodeInstance)

deactivateRequest

void deactivateRequest(ActionTakenValue actionTaken,
                       ActionRequestValue actionRequest)

deactivateRequests

void deactivateRequests(ActionTakenValue actionTaken,
                        List actionRequests)

deactivateRequest

void deactivateRequest(ActionTakenValue actionTaken,
                       ActionRequestValue actionRequest,
                       boolean simulate)

deactivateRequest

void deactivateRequest(ActionTakenValue actionTaken,
                       ActionRequestValue actionRequest,
                       ActivationContext activationContext)

deactivateRequests

void deactivateRequests(ActionTakenValue actionTaken,
                        List actionRequests,
                        boolean simulate)

deactivateRequests

void deactivateRequests(ActionTakenValue actionTaken,
                        List actionRequests,
                        ActivationContext activationContext)

deleteActionRequestGraph

void deleteActionRequestGraph(ActionRequestValue actionRequest)

findAllValidRequests

List findAllValidRequests(String principalId,
                          Long routeHeaderId,
                          String requestCode)

findAllValidRequests

List findAllValidRequests(String principalId,
                          Collection actionRequests,
                          String requestCode)

findPendingByDoc

List findPendingByDoc(Long routeHeaderId)

saveActionRequest

void saveActionRequest(ActionRequestValue actionRequest)

activateRequest

void activateRequest(ActionRequestValue actionRequest)

activateRequest

void activateRequest(ActionRequestValue actionRequest,
                     boolean simulate)

activateRequest

void activateRequest(ActionRequestValue actionRequest,
                     ActivationContext activationContext)

activateRequests

void activateRequests(Collection actionRequests)

activateRequests

void activateRequests(Collection actionRequests,
                      boolean simulate)

activateRequests

void activateRequests(Collection actionRequests,
                      ActivationContext activationContext)

activateRequestNoNotification

List activateRequestNoNotification(ActionRequestValue actionRequest,
                                   boolean simulate)

activateRequestNoNotification

List activateRequestNoNotification(ActionRequestValue actionRequest,
                                   ActivationContext activationContext)

findByActionRequestId

ActionRequestValue findByActionRequestId(Long actionRequestId)

findPendingRootRequestsByDocId

List findPendingRootRequestsByDocId(Long routeHeaderId)

findPendingRootRequestsByDocIdAtRouteLevel

List findPendingRootRequestsByDocIdAtRouteLevel(Long routeHeaderId,
                                                Integer routeLevel)

findPendingByDocIdAtOrBelowRouteLevel

List findPendingByDocIdAtOrBelowRouteLevel(Long routeHeaderId,
                                           Integer routeLevel)

findPendingRootRequestsByDocIdAtOrBelowRouteLevel

List findPendingRootRequestsByDocIdAtOrBelowRouteLevel(Long routeHeaderId,
                                                       Integer routeLevel)

findPendingRootRequestsByDocumentType

List findPendingRootRequestsByDocumentType(Long documentTypeId)

findAllActionRequestsByRouteHeaderId

List findAllActionRequestsByRouteHeaderId(Long routeHeaderId)

findPendingByActionRequestedAndDocId

List findPendingByActionRequestedAndDocId(String actionRequestedCdCd,
                                          Long routeHeaderId)

getPrincipalIdsWithPendingActionRequestByActionRequestedAndDocId

List<String> getPrincipalIdsWithPendingActionRequestByActionRequestedAndDocId(String actionRequestedCd,
                                                                              Long routeHeaderId)

This method gets a list of ids of all principals who have a pending action request for a document.

Parameters:

actionRequestedCd -

routeHeaderId -

Returns:

findByStatusAndDocId

List<ActionRequestValue> findByStatusAndDocId(String statusCd,
                                              Long routeHeaderId)

alterActionRequested

void alterActionRequested(List actionRequests,
                          String actionRequestCd)

findByRouteHeaderIdIgnoreCurrentInd

List findByRouteHeaderIdIgnoreCurrentInd(Long routeHeaderId)

findActivatedByGroup

List findActivatedByGroup(String groupId)

updateActionRequestsForResponsibilityChange

void updateActionRequestsForResponsibilityChange(Set<Long> responsibilityIds)

getRoot

ActionRequestValue getRoot(ActionRequestValue actionRequest)

getRootRequests

List<ActionRequestValue> getRootRequests(Collection<ActionRequestValue> actionRequests)

isDuplicateRequest

boolean isDuplicateRequest(ActionRequestValue actionRequest)

findPendingByDocRequestCdRouteLevel

List findPendingByDocRequestCdRouteLevel(Long routeHeaderId,
                                         String requestCode,
                                         Integer routeLevel)

findPendingByDocRequestCdNodeName

List findPendingByDocRequestCdNodeName(Long routeHeaderId,
                                       String requestCode,
                                       String nodeName)

findAllPendingRequests

List<ActionRequestValue> findAllPendingRequests(Long routeHeaderId)

Returns all pending requests for a given routing entity

Parameters:

routeHeaderId - the id of the document header being routed

Returns:

a List of all pending ActionRequestValues for the document

filterActionRequestsByCode

List<ActionRequestValue> filterActionRequestsByCode(List<ActionRequestValue> actionRequests,
                                                    String principalId,
                                                    List<String> principalGroupIds,
                                                    String requestCode)

Filters action requests based on if they occur after the given requestCode, and if they relate to the given principal

Parameters:

actionRequests - the List of ActionRequestValues to filter

principalId - the id of the principal to find active requests for

principalGroupIds - List of group ids that the principal belongs to

requestCode - the request code for all ActionRequestValues to be after

Returns:

the filtered List of ActionRequestValues

findDelegator

Recipient findDelegator(List actionRequests)

Returns the highest priority delegator in the list of action requests.

findDelegator

Recipient findDelegator(ActionRequestValue actionRequest)

Returns the closest delegator for the given ActionRequest

findDelegatorRequest

ActionRequestValue findDelegatorRequest(ActionRequestValue actionRequest)

deleteByRouteHeaderId

void deleteByRouteHeaderId(Long routeHeaderId)

deleteByActionRequestId

void deleteByActionRequestId(Long actionRequestId)

validateActionRequest

void validateActionRequest(ActionRequestValue actionRequest)

findPendingRootRequestsByDocIdAtRouteNode

List<ActionRequestValue> findPendingRootRequestsByDocIdAtRouteNode(Long routeHeaderId,
                                                                   Long nodeInstanceId)

findRootRequestsByDocIdAtRouteNode

List findRootRequestsByDocIdAtRouteNode(Long documentId,
                                        Long nodeInstanceId)

getDelegateRequests

List getDelegateRequests(ActionRequestValue actionRequest)

getTopLevelRequests

List getTopLevelRequests(ActionRequestValue actionRequest)

If this is a role request, then this method returns a List of the action request for each recipient within the role. Otherwise, it will return a List with just the original action request.

isValidActionRequestCode

boolean isValidActionRequestCode(String actionRequestCode)

doesPrincipalHaveRequest

boolean doesPrincipalHaveRequest(String principalId,
                                 Long documentId)

Checks if the given user has any Action Requests on the given document.

getActionsRequested

org.kuali.rice.core.xml.dto.AttributeSet getActionsRequested(DocumentRouteHeaderValue routeHeader,
                                                             String principalId,
                                                             boolean completeAndApproveTheSame)