com.saperion.ngc.model.workflow

Interface WorkflowService

All Superinterfaces:

Service

All Known Implementing Classes:

WorkflowConnectorService

public interface WorkflowService
extends Service

Author:

tfr

Method Summary

Modifier and Type	Method and Description
com.saperion.connector.wf.WorkflowResult	addComment(String taskId, String comment) Execute add comment.
com.saperion.connector.wf.WorkflowResult	addHistory(String taskId, String description) Execute set history.
com.saperion.connector.wf.WorkflowResult	executeActivate(String taskId) Execute activate.
com.saperion.connector.wf.WorkflowResult	executeApprove(String taskId, String nextUser) Execute delegate.
com.saperion.connector.wf.WorkflowResult	executeAssignToMe(String taskId) Execute AssignToMe.
com.saperion.connector.wf.WorkflowResult	executeChangeOwner(String taskId, String newOwner) Execute change owner.
com.saperion.connector.wf.WorkflowResult	executeCommand(WorkflowActionBean workflowAction) Execute the given command.
com.saperion.connector.wf.WorkflowResult	executeDelegate(String taskId, String delegatee) Execute delegate.
com.saperion.connector.wf.WorkflowResult	executeEscalation(String taskId, Date date) Execute escalate.
com.saperion.connector.wf.WorkflowResult	executeForward(String taskId, String nextUser, int transition) Execute forward.
com.saperion.connector.wf.WorkflowResult	executeHold(String taskId, Date date) Execute hold.
com.saperion.connector.wf.WorkflowResult	executeInactivate(String taskId) Execute inactivate.
com.saperion.connector.wf.WorkflowResult	executeNotResponsible(String taskId, String comment) Execute not responsible.
com.saperion.connector.wf.WorkflowResult	executePutBack(String taskId) Execute putback.
com.saperion.connector.wf.WorkflowResult	executeReassign(String taskId) Execute reassign.
com.saperion.connector.wf.WorkflowResult	executeReject(String taskId, String nextUser) Execute reject.
com.saperion.connector.wf.WorkflowResult	executeRemove(String taskId, String comment) Execute remove.
com.saperion.connector.wf.WorkflowResult	executeRemoveNotice(String taskId) Execute remove notice.
com.saperion.connector.wf.WorkflowResult	executeResetHold(String taskId) Execute reset hold.
com.saperion.connector.wf.WorkflowResult	executeRework(String taskId, String nextUser) Execute rework.
com.saperion.connector.wf.WorkflowResult	executeSetActivity(String taskId, int activity) Execute set activity.
com.saperion.connector.wf.WorkflowResult	executeTake(String taskId) Execute take.
com.saperion.connector.wf.WorkflowResult	executeTerminate(String taskId) Execute terminate.
List<com.saperion.intf.wf.CommentInfo>	getComments(com.saperion.intf.wf.TaskInfo task) Retrieves the comments for the specified task.
List<String>	getDefinitions() Reads the available workflow definitions.
List<com.saperion.wf.ProcessDefinitionDescriptor>	getDefinitions(String ddcName) Reads the available workflow definitions for the specified DDC.
List<com.saperion.intf.wf.HistoryInfo[]>	getDocHistories(String docHdoc) Reads history information for a given document.
com.saperion.intf.wf.BoxDefinition	getInboxDefinition() Retrieves the definition of the current user's inbox.
com.saperion.intf.wf.WorkflowMember	getMember(com.saperion.intf.wf.WorkflowMember member, int depth, String filter) Reads direct workflow member.
com.saperion.intf.wf.WorkflowMember	getMembers() Reads workflow member.
String	getSubstitute() Gets the fullname of the substitute for workflows of the current user.
com.saperion.jcs.modules.users.api.User	getSubstituteUser() Gets the substitute-user for the current user.
com.saperion.connector.wf.SaWFTask	getTask(String taskId) Load the task object.
String	getWfDisplayName(com.saperion.intf.wf.WorkflowMember member) Retrieves the comments for the specified task.
boolean	isWorkflowFeatureEnabled() Checks if the workflow-feature is enabled.
com.saperion.connector.wf.WorkflowResult	setComment(String taskId, String comment) Execute set comment.
void	setSubstitute(String substituteFullname) Sets the substitute for workflows.
com.saperion.connector.wf.WorkflowResult	startWorkflow(String definition, String actor, String comment, String attachmentUID) Execute start workflow.

Methods inherited from interface com.saperion.ngc.model.Service

isActive

Method Detail

getDefinitions

List<String> getDefinitions()
                     throws AuthenticationException,
                            SystemException,
                            WorkflowException

Reads the available workflow definitions.

Returns:

Workflow definitions

Throws:

WorkflowException - workflow exception

SystemException - system exception

AuthenticationException - authentication exception

getDefinitions

List<com.saperion.wf.ProcessDefinitionDescriptor> getDefinitions(String ddcName)
                                                          throws AuthenticationException,
                                                                 SystemException,
                                                                 WorkflowException

Reads the available workflow definitions for the specified DDC. If the usage of workflow definitions is not restricted, all definitions will be returned.

Parameters:

ddcName - name of the DDC

Returns:

Workflow definitions

Throws:

WorkflowException - workflow exception

SystemException - system exception

AuthenticationException - authentication exception

getMember

com.saperion.intf.wf.WorkflowMember getMember(com.saperion.intf.wf.WorkflowMember member,
                                              int depth,
                                              String filter)
                                       throws WorkflowException,
                                              SystemException

Reads direct workflow member.

Parameters:

member - workflow member, witch direct children will be returned

depth - depth of the returned children.

filter - filter string

Returns:

Member tree

Throws:

WorkflowException - workflow exception

SystemException - system exception

getMembers

com.saperion.intf.wf.WorkflowMember getMembers()
                                        throws WorkflowException,
                                               SystemException

Reads workflow member.

Returns:

Member tree

Throws:

SystemException - system exception

WorkflowException - workflow exception

executeCommand

com.saperion.connector.wf.WorkflowResult executeCommand(WorkflowActionBean workflowAction)
                                                 throws WorkflowException

Execute the given command. The parameters must fit to the given command. Unneeded parameters can be set to null.

Parameters:

workflowAction - Information needed for executing workflow command

Returns:

Workflow result

Throws:

WorkflowException - workflow exception

executeApprove

com.saperion.connector.wf.WorkflowResult executeApprove(String taskId,
                                                        String nextUser)
                                                 throws WorkflowException

Execute delegate.

Parameters:

taskId - Task ID

nextUser - Next user

Returns:

Workflow result

Throws:

WorkflowException - workflow exception

executeForward

com.saperion.connector.wf.WorkflowResult executeForward(String taskId,
                                                        String nextUser,
                                                        int transition)
                                                 throws WorkflowException

Execute forward.

Parameters:

taskId - Task ID

nextUser - Next user

transition - Transition

Returns:

Workflow result

Throws:

WorkflowException - workflow exception

executeReject

com.saperion.connector.wf.WorkflowResult executeReject(String taskId,
                                                       String nextUser)
                                                throws WorkflowException

Execute reject.

Parameters:

taskId - Task ID

nextUser - Next user

Returns:

Workflow result

Throws:

WorkflowException - workflow exception

executeRework

com.saperion.connector.wf.WorkflowResult executeRework(String taskId,
                                                       String nextUser)
                                                throws WorkflowException

Execute rework.

Parameters:

taskId - Task ID

nextUser - Next user

Returns:

Workflow result

Throws:

WorkflowException - workflow exception

executeNotResponsible

com.saperion.connector.wf.WorkflowResult executeNotResponsible(String taskId,
                                                               String comment)
                                                        throws WorkflowException

Execute not responsible.

Parameters:

taskId - Task ID

comment - Comment

Returns:

Workflow result

Throws:

WorkflowException - workflow exception

executeTake

com.saperion.connector.wf.WorkflowResult executeTake(String taskId)
                                              throws WorkflowException

Execute take.

Parameters:

taskId - Task ID

Returns:

Workflow result

Throws:

WorkflowException - workflow exception

executeRemove

com.saperion.connector.wf.WorkflowResult executeRemove(String taskId,
                                                       String comment)
                                                throws WorkflowException

Execute remove.

Parameters:

taskId - Task ID

comment - Comment

Returns:

Workflow result

Throws:

WorkflowException - workflow exception

executeRemoveNotice

com.saperion.connector.wf.WorkflowResult executeRemoveNotice(String taskId)
                                                      throws WorkflowException

Execute remove notice.

Parameters:

taskId - Task ID

Returns:

Workflow result

Throws:

WorkflowException - workflow exception

executeHold

com.saperion.connector.wf.WorkflowResult executeHold(String taskId,
                                                     Date date)
                                              throws WorkflowException

Execute hold.

Parameters:

taskId - Task ID

date - Hold date

Returns:

Workflow result

Throws:

WorkflowException - workflow exception

executeResetHold

com.saperion.connector.wf.WorkflowResult executeResetHold(String taskId)
                                                   throws WorkflowException

Execute reset hold.

Parameters:

taskId - Task ID

Returns:

Workflow result

Throws:

WorkflowException - workflow exception

executeEscalation

com.saperion.connector.wf.WorkflowResult executeEscalation(String taskId,
                                                           Date date)
                                                    throws WorkflowException

Execute escalate.

Parameters:

taskId - Task ID

date - Escalation date

Returns:

Workflow result

Throws:

WorkflowException - workflow exception

executeInactivate

com.saperion.connector.wf.WorkflowResult executeInactivate(String taskId)
                                                    throws WorkflowException

Execute inactivate.

Parameters:

taskId - Task ID

Returns:

Workflow result

Throws:

WorkflowException - workflow exception

executeActivate

com.saperion.connector.wf.WorkflowResult executeActivate(String taskId)
                                                  throws WorkflowException

Execute activate.

Parameters:

taskId - Task ID

Returns:

Workflow result

Throws:

WorkflowException - workflow exception

executeTerminate

com.saperion.connector.wf.WorkflowResult executeTerminate(String taskId)
                                                   throws WorkflowException

Execute terminate.

Parameters:

taskId - Task ID

Returns:

Workflow result

Throws:

WorkflowException - workflow exception

executeChangeOwner

com.saperion.connector.wf.WorkflowResult executeChangeOwner(String taskId,
                                                            String newOwner)
                                                     throws WorkflowException

Execute change owner.

Parameters:

taskId - Task ID

newOwner - New owner

Returns:

Workflow result

Throws:

WorkflowException - workflow exception

executeSetActivity

com.saperion.connector.wf.WorkflowResult executeSetActivity(String taskId,
                                                            int activity)
                                                     throws WorkflowException

Execute set activity.

Parameters:

taskId - Task ID

activity - Activity

Returns:

Workflow result

Throws:

WorkflowException - workflow exception

executeDelegate

com.saperion.connector.wf.WorkflowResult executeDelegate(String taskId,
                                                         String delegatee)
                                                  throws WorkflowException

Execute delegate.

Parameters:

taskId - Task ID

delegatee - Delegatee

Returns:

Workflow result

Throws:

WorkflowException - workflow exception

executeReassign

com.saperion.connector.wf.WorkflowResult executeReassign(String taskId)
                                                  throws WorkflowException

Execute reassign.

Parameters:

taskId - Task ID

Returns:

Workflow result

Throws:

WorkflowException - workflow exception

executeAssignToMe

com.saperion.connector.wf.WorkflowResult executeAssignToMe(String taskId)
                                                    throws WorkflowException

Execute AssignToMe.

Parameters:

taskId - Task ID

Returns:

Workflow result

Throws:

WorkflowException - workflow exception

executePutBack

com.saperion.connector.wf.WorkflowResult executePutBack(String taskId)
                                                 throws WorkflowException

Execute putback.

Parameters:

taskId - Task ID

Returns:

Workflow result

Throws:

WorkflowException - workflow exception

setComment

com.saperion.connector.wf.WorkflowResult setComment(String taskId,
                                                    String comment)
                                             throws WorkflowException

Execute set comment.

Parameters:

taskId - Task ID

comment - Comment

Returns:

Workflow result

Throws:

WorkflowException - workflow exception

addComment

com.saperion.connector.wf.WorkflowResult addComment(String taskId,
                                                    String comment)
                                             throws WorkflowException

Execute add comment.

Parameters:

taskId - Task ID

comment - Comment

Returns:

Workflow result

Throws:

WorkflowException - workflow exception

addHistory

com.saperion.connector.wf.WorkflowResult addHistory(String taskId,
                                                    String description)
                                             throws WorkflowException,
                                                    SystemException,
                                                    AuthenticationException

Execute set history.

Parameters:

taskId - Task ID

description - Description

Returns:

Workflow result

Throws:

SystemException - system exception

WorkflowException - workflow exception

AuthenticationException - authentication exception

startWorkflow

com.saperion.connector.wf.WorkflowResult startWorkflow(String definition,
                                                       String actor,
                                                       String comment,
                                                       String attachmentUID)
                                                throws WorkflowException

Execute start workflow.

Parameters:

definition - Definition name

actor - Actor

comment - Comment

attachmentUID - Attachment UID

Returns:

True, if done

Throws:

WorkflowException - workflow exception

getTask

com.saperion.connector.wf.SaWFTask getTask(String taskId)
                                    throws AuthenticationException,
                                           SystemException,
                                           WorkflowException

Load the task object.

Parameters:

taskId - task id

Returns:

task

Throws:

WorkflowException - workflow exception

SystemException - system exception

AuthenticationException - authentication exception

getDocHistories

List<com.saperion.intf.wf.HistoryInfo[]> getDocHistories(String docHdoc)
                                                  throws WorkflowException

Reads history information for a given document.

Parameters:

docHdoc - document's hDoc

Returns:

list of history information arrays

Throws:

WorkflowException - workflow exception

getComments

List<com.saperion.intf.wf.CommentInfo> getComments(com.saperion.intf.wf.TaskInfo task)
                                            throws AuthenticationException,
                                                   SystemException,
                                                   WorkflowException

Retrieves the comments for the specified task.

Parameters:

task - task

Returns:

list of comments

Throws:

AuthenticationException - authentication exception

SystemException - system exception

WorkflowException - workflow exception

getWfDisplayName

String getWfDisplayName(com.saperion.intf.wf.WorkflowMember member)

Retrieves the comments for the specified task.

Parameters:

member - member to get display name for

Returns:

display name

getInboxDefinition

com.saperion.intf.wf.BoxDefinition getInboxDefinition()
                                               throws AuthenticationException,
                                                      SystemException

Retrieves the definition of the current user's inbox.

Returns:

BoxDefinition for user's inbox

Throws:

AuthenticationException - authentication exception

SystemException - system exception

isWorkflowFeatureEnabled

boolean isWorkflowFeatureEnabled()
                          throws SystemException

Checks if the workflow-feature is enabled.

Returns:

true, if workflow-feature is enabled

Throws:

SystemException - system exception when checking feature

getSubstitute

String getSubstitute()
              throws AuthenticationException,
                     SystemException

Gets the fullname of the substitute for workflows of the current user.

Returns:

Fullname of the substitute user.

Throws:

AuthenticationException - Authentication exception

SystemException - system exception

getSubstituteUser

com.saperion.jcs.modules.users.api.User getSubstituteUser()
                                                   throws AuthenticationException,
                                                          SystemException

Gets the substitute-user for the current user.

Returns:

the substitute user or null if no substitute user is available

Throws:

AuthenticationException - authentication exception

SystemException - system exception

setSubstitute

void setSubstitute(String substituteFullname)
            throws AuthenticationException,
                   SystemException

Sets the substitute for workflows.

Parameters:

substituteFullname - Fullname of the substitute to store.

Throws:

AuthenticationException - Authentication exception

SystemException - system exception