org.kuali.rice.kns.workflow.service
Interface WorkflowDocumentService

All Known Implementing Classes:

WorkflowDocumentServiceImpl

public interface WorkflowDocumentService

This interface defines the contract that must be implemented by the workflow engine.

Method Summary

void	acknowledge(KualiWorkflowDocument workflowDocument, String annotation, List<AdHocRouteRecipient> adHocRecipients) acknowledge this workflowDocument optionally providing an annotation for this action taken which will show up in the route log for this document corresponding to this action taken, additionally optionally providing a list of ad hoc recipients for this document which should be restricted to actions requested of acknowledge or fyi as all other action request types will be discarded
void	approve(KualiWorkflowDocument workflowDocument, String annotation, List<AdHocRouteRecipient> adHocRecipients) approve this workflowDocument optionally providing an annotation for this action taken which will show up in the route log for this document corresponding to this action taken, and additionally optionally providing a list of ad hoc recipients for the document
void	blanketApprove(KualiWorkflowDocument workflowDocument, String annotation, List<AdHocRouteRecipient> adHocRecipients) blanket approve this document optionally providing an annotation for this action taken which will show up in the route log for this document corresponding to this action taken, and additionally optionally providing a list of ad hoc recipients for this document which should be restricted to actions requested of acknowledge or fyi as all other action request types will be discarded.
void	cancel(KualiWorkflowDocument workflowDocument, String annotation) cancel this workflowDocument optionally providing an annotation for this action taken which will show up in the route log for this document corresponding to this action taken
void	clearFyi(KualiWorkflowDocument workflowDocument, List<AdHocRouteRecipient> adHocRecipients) clear the fyi request for this document, optinoally providing a list of ad hoc recipients for this document which should be restricted to actions requested of fyi as all other action request types will be discarded
KualiWorkflowDocument	createWorkflowDocument(Long documentHeaderId, Person workflowUser) Given a documentHeaderId and workflowUser, retrieves the workflowDocument associated with that documentHeaderId from the workflow server.
KualiWorkflowDocument	createWorkflowDocument(String documentTypeId, Person workflowUser) Given a documentTypeId and workflowUser, returns a new workflowDocument from the workflow server.
void	disapprove(KualiWorkflowDocument workflowDocument, String annotation) disapprove this workflowDocument optionally providing an annotation for this action taken which will show up in the route log for this document corresponding to this action taken
String	getCurrentRouteLevelName(KualiWorkflowDocument workflowDocument) Gets the current route level name of the workflow document even if document has no active node names.
void	route(KualiWorkflowDocument workflowDocument, String annotation, List<AdHocRouteRecipient> adHocRecipients) route this workflowDocument optionally providing an annotation for this action taken which will show up in the route log for this document corresponding to this action taken, and additionally optionally providing a list of ad hoc recipients for the document
void	save(KualiWorkflowDocument workflowDocument, String annotation) This method will first determine if the KualiWorkflowDocument.saveDocument(String) method is valid to be called.
void	saveRoutingData(KualiWorkflowDocument workflowDocument) save the routing data of the document to workflow
void	sendWorkflowNotification(KualiWorkflowDocument workflowDocument, String annotation, List<AdHocRouteRecipient> adHocRecipients) Sends workflow notification to the list of ad hoc recipients.
void	sendWorkflowNotification(KualiWorkflowDocument workflowDocument, String annotation, List<AdHocRouteRecipient> adHocRecipients, String notificationLabel) Sends workflow notification to the list of ad hoc recipients.
void	superUserApprove(KualiWorkflowDocument workflowDocument, String annotation) super user approve this workflowDocument optionally providing an annotation for this action taken which will show up in the route log for this document corresponding to this action taken
void	superUserCancel(KualiWorkflowDocument workflowDocument, String annotation) super user cancel this workflowDocument optionally providing an annotation for this action taken which will show up in the route log for this document corresponding to this action taken
void	superUserDisapprove(KualiWorkflowDocument workflowDocument, String annotation) super user disapprove this workflowDocument optionally providing an annotation for this action taken which will show up in the route log for this document corresponding to this action taken
boolean	workflowDocumentExists(String documentHeaderId)

Method Detail

workflowDocumentExists

boolean workflowDocumentExists(String documentHeaderId)

Parameters:

documentHeaderId -

Returns:

true if a workflowDocument exists for the given documentHeaderId

createWorkflowDocument

KualiWorkflowDocument createWorkflowDocument(String documentTypeId,
                                             Person workflowUser)
                                             throws WorkflowException

Given a documentTypeId and workflowUser, returns a new workflowDocument from the workflow server.

Parameters:

documentTypeId -

workflowUser -

Returns:

newly-created workflowDocument instance

Throws:

IllegalArgumentException - if the given documentTypeId is blank

IllegalArgumentException - if the given workflowUser is null or contains no id

ResourceUnavailableException

WorkflowException

createWorkflowDocument

KualiWorkflowDocument createWorkflowDocument(Long documentHeaderId,
                                             Person workflowUser)
                                             throws WorkflowException

Given a documentHeaderId and workflowUser, retrieves the workflowDocument associated with that documentHeaderId from the workflow server.

Parameters:

documentHeaderId -

workflowUser -

Returns:

existing workflowDoc

Throws:

IllegalArgumentException - if the given documentHeaderId is null

IllegalArgumentException - if the given workflowUser is null or contains no id

WorkflowException

save

void save(KualiWorkflowDocument workflowDocument,
          String annotation)
          throws WorkflowException

This method will first determine if the KualiWorkflowDocument.saveDocument(String) method is valid to be called. If so the method will save the document to workflows action list optionally providing an annotation which will show up in the route log for this document corresponding to this action taken. If the KualiWorkflowDocument.saveDocument() method is not valid to be called the system will instead call the method saveRoutingData(KualiWorkflowDocument)

Parameters:

workflowDocument -

annotation -

Throws:

WorkflowException

saveRoutingData

void saveRoutingData(KualiWorkflowDocument workflowDocument)
                     throws WorkflowException

save the routing data of the document to workflow

Parameters:

workflowDocument -

Throws:

WorkflowException

route

void route(KualiWorkflowDocument workflowDocument,
           String annotation,
           List<AdHocRouteRecipient> adHocRecipients)
           throws WorkflowException

route this workflowDocument optionally providing an annotation for this action taken which will show up in the route log for this document corresponding to this action taken, and additionally optionally providing a list of ad hoc recipients for the document

Parameters:

workflowDocument -

annotation -

adHocRecipients -

Throws:

WorkflowException

approve

void approve(KualiWorkflowDocument workflowDocument,
             String annotation,
             List<AdHocRouteRecipient> adHocRecipients)
             throws WorkflowException

approve this workflowDocument optionally providing an annotation for this action taken which will show up in the route log for this document corresponding to this action taken, and additionally optionally providing a list of ad hoc recipients for the document

Parameters:

workflowDocument -

annotation -

adHocRecipients -

Throws:

WorkflowException

superUserApprove

void superUserApprove(KualiWorkflowDocument workflowDocument,
                      String annotation)
                      throws WorkflowException

super user approve this workflowDocument optionally providing an annotation for this action taken which will show up in the route log for this document corresponding to this action taken

Parameters:

workflowDocument -

annotation -

adHocRecipients -

Throws:

WorkflowException

superUserCancel

void superUserCancel(KualiWorkflowDocument workflowDocument,
                     String annotation)
                     throws WorkflowException

super user cancel this workflowDocument optionally providing an annotation for this action taken which will show up in the route log for this document corresponding to this action taken

Parameters:

workflowDocument -

annotation -

Throws:

WorkflowException

superUserDisapprove

void superUserDisapprove(KualiWorkflowDocument workflowDocument,
                         String annotation)
                         throws WorkflowException

super user disapprove this workflowDocument optionally providing an annotation for this action taken which will show up in the route log for this document corresponding to this action taken

Parameters:

workflowDocument -

annotation -

Throws:

WorkflowException

disapprove

void disapprove(KualiWorkflowDocument workflowDocument,
                String annotation)
                throws WorkflowException

disapprove this workflowDocument optionally providing an annotation for this action taken which will show up in the route log for this document corresponding to this action taken

Parameters:

workflowDocument -

annotation -

Throws:

WorkflowException

cancel

void cancel(KualiWorkflowDocument workflowDocument,
            String annotation)
            throws WorkflowException

cancel this workflowDocument optionally providing an annotation for this action taken which will show up in the route log for this document corresponding to this action taken

Parameters:

workflowDocument -

annotation -

Throws:

WorkflowException

acknowledge

void acknowledge(KualiWorkflowDocument workflowDocument,
                 String annotation,
                 List<AdHocRouteRecipient> adHocRecipients)
                 throws WorkflowException

acknowledge this workflowDocument optionally providing an annotation for this action taken which will show up in the route log for this document corresponding to this action taken, additionally optionally providing a list of ad hoc recipients for this document which should be restricted to actions requested of acknowledge or fyi as all other action request types will be discarded

Parameters:

workflowDocument -

annotation -

adHocRecipients -

Throws:

WorkflowException

blanketApprove

void blanketApprove(KualiWorkflowDocument workflowDocument,
                    String annotation,
                    List<AdHocRouteRecipient> adHocRecipients)
                    throws WorkflowException

blanket approve this document optionally providing an annotation for this action taken which will show up in the route log for this document corresponding to this action taken, and additionally optionally providing a list of ad hoc recipients for this document which should be restricted to actions requested of acknowledge or fyi as all other action request types will be discarded.

Parameters:

workflowDocument -

annotation -

adHocRecipients -

Throws:

WorkflowException

clearFyi

void clearFyi(KualiWorkflowDocument workflowDocument,
              List<AdHocRouteRecipient> adHocRecipients)
              throws WorkflowException

clear the fyi request for this document, optinoally providing a list of ad hoc recipients for this document which should be restricted to actions requested of fyi as all other action request types will be discarded

Parameters:

workflowDocument -

adHocRecipients -

Throws:

WorkflowException

getCurrentRouteLevelName

String getCurrentRouteLevelName(KualiWorkflowDocument workflowDocument)
                                throws WorkflowException

Gets the current route level name of the workflow document even if document has no active node names. Allows for getting the node name of a document already in a final status.

Parameters:

workflowDocument -

Returns:

node name of the current node if only one or list of node names separated by string ", " if more than one current node name

Throws:

WorkflowException

sendWorkflowNotification

void sendWorkflowNotification(KualiWorkflowDocument workflowDocument,
                              String annotation,
                              List<AdHocRouteRecipient> adHocRecipients,
                              String notificationLabel)
                              throws WorkflowException

Sends workflow notification to the list of ad hoc recipients. This method is usually used to notify users of a note that has been added to a document. The notificationLabel parameter is used to give the request a custom label in the user's Action List

Parameters:

workflowDocument -

annotation -

adHocRecipients -

notificationLabel -

Throws:

WorkflowException

sendWorkflowNotification

void sendWorkflowNotification(KualiWorkflowDocument workflowDocument,
                              String annotation,
                              List<AdHocRouteRecipient> adHocRecipients)
                              throws WorkflowException

Sends workflow notification to the list of ad hoc recipients. This method is usually used to notify users of a note that has been added to a document

Parameters:

workflowDocument -

annotation -

adHocRecipients -

Throws:

WorkflowException