org.osid.workflow

Interface ManualWorkflowSession

All Superinterfaces:

java.lang.AutoCloseable, java.io.Closeable, OsidSession, WorkflowManagementSession

public interface ManualWorkflowSession
extends WorkflowManagementSession

This session provides methods for manually moving work through a workflow.

Method Summary

Methods

Modifier and Type	Method and Description
void	advanceWork(Id processId, Id workId) Advances work to a next step in the workflow based on the work and the input conditions of the next steps.
void	assignWorkToStep(Id processId, Id workId, Id stepId) Manually assigns a work to a step.
boolean	canOperateWorkflow() Tests if this user can operate a workflow.
boolean	canOperateWorkflowForProcess(Id processId) Tests if this user can operate a workflow.
StepList	getAllValidStepsForWork(Id processId, Id workId) Gets the all valid steps in this process the given work can be manually assigned and includes the steps previous to the work's current step.
StepList	getValidNextStepsForWork(Id processId, Id workId) Gets the valid next steps in this process in which the given work can be manually advanced.

Methods inherited from interface org.osid.workflow.WorkflowManagementSession

cancelWork, canManageWorkflow, canManageWorkflowForProcess, getOffice, getOfficeId, resumeWork, suspendWork

Methods inherited from interface org.osid.OsidSession

getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions

Methods inherited from interface org.osid.binding.java.OsidSession

close

Methods inherited from interface java.io.Closeable

close

Method Detail

canOperateWorkflow

boolean canOperateWorkflow()

Tests if this user can operate a workflow. A return of true does not guarantee successful authorization. A return of false indicates that it is known all methods in this session will result in a PERMISSION_DENIED. This is intended as a hint to an application that may opt not to offer workflow operations to unauthorized users.

Returns:

false if workflow operation methods are not authorized, true otherwise

Compliance:

mandatory - This method must be implemented.

canOperateWorkflowForProcess

boolean canOperateWorkflowForProcess(Id processId)

Tests if this user can operate a workflow. A return of true does not guarantee successful authorization. A return of false indicates that it is known all methods in this session will result in a PERMISSION_DENIED. This is intended as a hint to an application that may opt not to offer workflow operations to unauthorized users.

Parameters:

processId - a process Id

Returns:

false if workflow operation methods are not authorized, true otherwise

Throws:

NullArgumentException - processId is null

Compliance:

mandatory - This method must be implemented.

advanceWork

void advanceWork(Id processId,
               Id workId)
                 throws NotFoundException,
                        OperationFailedException,
                        PermissionDeniedException

Advances work to a next step in the workflow based on the work and the input conditions of the next steps.

Parameters:

processId - a process Id

workId - a work Id

Throws:

NotFoundException - processId is not found or workId is in process

NullArgumentException - processId or workId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

getValidNextStepsForWork

StepList getValidNextStepsForWork(Id processId,
                                Id workId)
                                  throws NotFoundException,
                                         OperationFailedException,
                                         PermissionDeniedException

Gets the valid next steps in this process in which the given work can be manually advanced.

Parameters:

processId - a process Id

workId - a work Id

Returns:

the returned Step list

Throws:

NotFoundException - processId is not found or workId is in process

NullArgumentException - processId or workId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

getAllValidStepsForWork

StepList getAllValidStepsForWork(Id processId,
                               Id workId)
                                 throws NotFoundException,
                                        OperationFailedException,
                                        PermissionDeniedException

Gets the all valid steps in this process the given work can be manually assigned and includes the steps previous to the work's current step.

Parameters:

processId - a process Id

workId - a work Id

Returns:

the returned Step list

Throws:

NotFoundException - processId is not found or workId is in process

NullArgumentException - processId or workId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

assignWorkToStep

void assignWorkToStep(Id processId,
                    Id workId,
                    Id stepId)
                      throws NotFoundException,
                             OperationFailedException,
                             PermissionDeniedException

Manually assigns a work to a step.

Parameters:

processId - a process Id

workId - a work Id

stepId - a step Id

Throws:

NotFoundException - processId is not found or workId or stepId is not found in this process

NullArgumentException - processId, workId, or stepId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.