org.osid.workflow

Interface WorkflowSession

All Superinterfaces:

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

public interface WorkflowSession
extends OsidSession

This session provides methods for looking at a workflow.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	canAccessWorkflow() Tests if this user can access a workflow.
boolean	canAccessWorkflowForProcess(Id processId) Tests if this user can access a workflow in a process.
WorkList	getCanceledWork(Id processId) Gets the work canceled in a process.
WorkList	getCanceledWorkByDate(Id processId, DateTime start, DateTime end) Gets the work canceled in a process within the given date range inclusive.
Office	getOffice() Gets the Office associated with this session.
Id	getOfficeId() Gets the Office Id associated with this session.
ProcessList	getProcessesForWork(Id workId) Gets the processes a work is in.
WorkflowEventList	getStatusesForWork(Id workId) Gets the statuses of the work across all processes.
WorkflowEventList	getStatusesForWorks(Id processId, IdList workIds) Gets the status of a works in a process.
WorkflowEvent	getStatusForWork(Id processId, Id workId) Gets the status of a work in a process.
Step	getStepForWork(Id processId, Id workId) Gets the step corresponding to a work in a process.
WorkList	getSuspendedWork(Id processId) Gets all the suspended work in a process.
WorkList	getSuspendedWorkAtStep(Id stepId) Gets the suspended work at a step in a process.
WorkList	getWorkAtStep(Id stepId) Getsall the work at a step in a process.

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

getOfficeId

Id getOfficeId()

Gets the Office Id associated with this session.

Returns:

the Office Id associated with this session

Compliance:

mandatory - This method must be implemented.

getOffice

Office getOffice()
                 throws OperationFailedException,
                        PermissionDeniedException

Gets the Office associated with this session.

Returns:

the office

Throws:

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

canAccessWorkflow

boolean canAccessWorkflow()

Tests if this user can access 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 initiation methods are not authorized, true otherwise

Compliance:

mandatory - This method must be implemented.

canAccessWorkflowForProcess

boolean canAccessWorkflowForProcess(Id processId)

Tests if this user can access a workflow in a process. 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 initiation methods are not authorized, true otherwise

Throws:

NullArgumentException - processId is null

Compliance:

mandatory - This method must be implemented.

getProcessesForWork

ProcessList getProcessesForWork(Id workId)
                                throws OperationFailedException,
                                       PermissionDeniedException

Gets the processes a work is in.

Parameters:

workId - a work Id

Returns:

the Processes

Throws:

NullArgumentException - workId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

getStepForWork

Step getStepForWork(Id processId,
                  Id workId)
                    throws NotFoundException,
                           OperationFailedException,
                           PermissionDeniedException

Gets the step corresponding to a work in a process.

Parameters:

processId - a process Id

workId - a work Id

Returns:

the returned Step

Throws:

NotFoundException - processId not found or workId is not active in the process

NullArgumentException - processId or workId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

getWorkAtStep

WorkList getWorkAtStep(Id stepId)
                       throws NotFoundException,
                              OperationFailedException,
                              PermissionDeniedException

Getsall the work at a step in a process.

Parameters:

stepId - a step Id

Returns:

the returned Work List

Throws:

NotFoundException - stepId is not found

NullArgumentException - stepId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

getSuspendedWork

WorkList getSuspendedWork(Id processId)
                          throws NotFoundException,
                                 OperationFailedException,
                                 PermissionDeniedException

Gets all the suspended work in a process.

Parameters:

processId - a process Id

Returns:

the returned Work List

Throws:

NotFoundException - processId not found

NullArgumentException - processId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

getSuspendedWorkAtStep

WorkList getSuspendedWorkAtStep(Id stepId)
                                throws NotFoundException,
                                       OperationFailedException,
                                       PermissionDeniedException

Gets the suspended work at a step in a process.

Parameters:

stepId - a step Id

Returns:

the returned Work List

Throws:

NotFoundException - stepId is not found

NullArgumentException - stepId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

getCanceledWork

WorkList getCanceledWork(Id processId)
                         throws NotFoundException,
                                OperationFailedException,
                                PermissionDeniedException

Gets the work canceled in a process.

Parameters:

processId - a process Id

Returns:

the returned Work List

Throws:

NotFoundException - processId not found

NullArgumentException - processId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

getCanceledWorkByDate

WorkList getCanceledWorkByDate(Id processId,
                             DateTime start,
                             DateTime end)
                               throws NotFoundException,
                                      OperationFailedException,
                                      PermissionDeniedException

Gets the work canceled in a process within the given date range inclusive.

Parameters:

processId - a process Id

start - start range

end - end range

Returns:

the returned Work List

Throws:

InvalidArgumentException - start is greater than end

NotFoundException - processId not found

NullArgumentException - processId, start or end is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

getStatusesForWork

WorkflowEventList getStatusesForWork(Id workId)
                                     throws OperationFailedException,
                                            PermissionDeniedException

Gets the statuses of the work across all processes.

Parameters:

workId - a work Id

Returns:

the current list of statuses

Throws:

NullArgumentException - workId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

getStatusForWork

WorkflowEvent getStatusForWork(Id processId,
                             Id workId)
                               throws NotFoundException,
                                      OperationFailedException,
                                      PermissionDeniedException

Gets the status of a work in a process.

Parameters:

processId - a process Id

workId - a work Id

Returns:

the status

Throws:

NotFoundException - processId not found or workId is not active in the process

NullArgumentException - processId or workId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

getStatusesForWorks

WorkflowEventList getStatusesForWorks(Id processId,
                                    IdList workIds)
                                      throws OperationFailedException,
                                             PermissionDeniedException

Gets the status of a works in a process.

Parameters:

processId - a process Id

workIds - a list of work Ids

Returns:

the current list of statuses

Throws:

NullArgumentException - processId or workIds is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.