org.kuali.rice.ken.service
Interface NotificationWorkflowDocumentService

All Known Implementing Classes:

NotificationWorkflowDocumentServiceImpl

public interface NotificationWorkflowDocumentService

The NotificationWorkflowDocumentService class is responsible for housing service methods for interacting with KEW.

Author:

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

Method Summary

void	clearAllFyisAndAcknowledgeNotificationWorkflowDocument(java.lang.String initiatorUserId, NotificationWorkflowDocument workflowDocument, java.lang.String annotation) This method is responsible for canceling a workflow document; which in turn simulates the "checking-off" of a notification in the notification list by the system through an auto-removal.
java.lang.Long	createAndAdHocRouteNotificationWorkflowDocument(NotificationMessageDelivery messageDelivery, java.lang.String initiatorUserId, java.lang.String recipientUserId, java.lang.String annotation) This service method is responsible for creating a NotificationWorkflowDocument for the given user, which in turn, creates a workflow document in KEW.
NotificationWorkflowDocument	getNotificationWorkflowDocumentByDocumentId(java.lang.String initiatorUserId, java.lang.Long workflowDocumentId) This service method is responsible for retrieving a NotificationWorkflowDocument from KEW.
void	terminateWorkflowDocument(org.kuali.rice.kew.service.WorkflowDocument document) This method is responsible for unconditionally terminating a workflow document, after which there should be no pending action requests against this document.

Method Detail

createAndAdHocRouteNotificationWorkflowDocument

java.lang.Long createAndAdHocRouteNotificationWorkflowDocument(NotificationMessageDelivery messageDelivery,
                                                               java.lang.String initiatorUserId,
                                                               java.lang.String recipientUserId,
                                                               java.lang.String annotation)
                                                               throws org.kuali.rice.kew.exception.WorkflowException

This service method is responsible for creating a NotificationWorkflowDocument for the given user, which in turn, creates a workflow document in KEW. It then ad-hoc routes the document to the passed in recipient. This method will be used by the NotificationService.deliverNotification() service method.

Parameters:

messageDelivery - - the specific NotificationMessageDelivery that is associated with this ad hoc route

initiatorUserId - - the person/workflow user who is responsible for "initiating" this workflow document

recipientUserId - - the person/workflow user who will recieve this document via an ad hoc route

annotation - - a description of the workflow ad hoc route transaction

Returns:

Long - the id of the workflow document

Throws:

org.kuali.rice.kew.exception.WorkflowException

clearAllFyisAndAcknowledgeNotificationWorkflowDocument

void clearAllFyisAndAcknowledgeNotificationWorkflowDocument(java.lang.String initiatorUserId,
                                                            NotificationWorkflowDocument workflowDocument,
                                                            java.lang.String annotation)
                                                            throws org.kuali.rice.kew.exception.WorkflowException

This method is responsible for canceling a workflow document; which in turn simulates the "checking-off" of a notification in the notification list by the system through an auto-removal.

Parameters:

initiatorUserId -

workflowDocument -

annotation -

Throws:

org.kuali.rice.kew.exception.WorkflowException

terminateWorkflowDocument

void terminateWorkflowDocument(org.kuali.rice.kew.service.WorkflowDocument document)
                               throws org.kuali.rice.kew.exception.WorkflowException

This method is responsible for unconditionally terminating a workflow document, after which there should be no pending action requests against this document.

Parameters:

document - workflow document to terminate

Throws:

org.kuali.rice.kew.exception.WorkflowException

getNotificationWorkflowDocumentByDocumentId

NotificationWorkflowDocument getNotificationWorkflowDocumentByDocumentId(java.lang.String initiatorUserId,
                                                                         java.lang.Long workflowDocumentId)
                                                                         throws org.kuali.rice.kew.exception.WorkflowException

This service method is responsible for retrieving a NotificationWorkflowDocument from KEW.

Parameters:

initiatorUserId -

workflowDocumentId -

Returns:

NotificationWorkflowDocument

Throws:

org.kuali.rice.kew.exception.WorkflowException