OSID Logo
OSID Specifications
workflow package
Version 3.0.0
Release Candidate Preview
Interfaceosid.workflow.WorkflowSession
Implementsosid.OsidSession
Description

This session provides methods for looking at a workflow.

MethodgetOfficeId
Description

Gets the Office Id associated with this session.

Returnosid.id.Idthe Office Id associated with this session
CompliancemandatoryThis method must be implemented.
MethodgetOffice
Description

Gets the Office associated with this session.

Returnosid.workflow.Officethe office
ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodcanAccessWorkflow
Description

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.

Returnboolean false if workflow initiation methods are not authorized, true otherwise
CompliancemandatoryThis method must be implemented.
MethodcanAccessWorkflowForProcess
Description

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.

Parametersosid.id.IdprocessIda process Id
Returnboolean false if workflow initiation methods are not authorized, true otherwise
ErrorsNULL_ARGUMENT processId is null
CompliancemandatoryThis method must be implemented.
MethodgetProcessesForWork
Description

Gets the processes a work is in.

Parametersosid.id.IdworkIda work Id
Returnosid.workflow.ProcessListthe Processes
ErrorsNULL_ARGUMENT workId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetStepForWork
Description

Gets the step corresponding to a work in a process.

Parametersosid.id.IdprocessIda process Id
osid.id.IdworkIda work Id
Returnosid.workflow.Stepthe returned Step
ErrorsNOT_FOUND processId not found or workId is not active in the process
NULL_ARGUMENT processId or workId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetWorkAtStep
Description

Getsall the work at a step in a process.

Parametersosid.id.IdstepIda step Id
Returnosid.workflow.WorkListthe returned Work List
ErrorsNOT_FOUND stepId is not found
NULL_ARGUMENT stepId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetSuspendedWork
Description

Gets all the suspended work in a process.

Parametersosid.id.IdprocessIda process Id
Returnosid.workflow.WorkListthe returned Work List
ErrorsNOT_FOUND processId not found
NULL_ARGUMENT processId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetSuspendedWorkAtStep
Description

Gets the suspended work at a step in a process.

Parametersosid.id.IdstepIda step Id
Returnosid.workflow.WorkListthe returned Work List
ErrorsNOT_FOUND stepId is not found
NULL_ARGUMENT stepId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetCanceledWork
Description

Gets the work canceled in a process.

Parametersosid.id.IdprocessIda process Id
Returnosid.workflow.WorkListthe returned Work List
ErrorsNOT_FOUND processId not found
NULL_ARGUMENT processId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetCanceledWorkByDate
Description

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

Parametersosid.id.IdprocessIda process Id
osid.calendaring.DateTimestartstart range
osid.calendaring.DateTimeendend range
Returnosid.workflow.WorkListthe returned Work List
ErrorsINVALID_ARGUMENT start is greater than end
NOT_FOUND processId not found
NULL_ARGUMENT processId, start or end is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetStatusesForWork
Description

Gets the statuses of the work across all processes.

Parametersosid.id.IdworkIda work Id
Returnosid.workflow.WorkflowEventListthe current list of statuses
ErrorsNULL_ARGUMENT workId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetStatusForWork
Description

Gets the status of a work in a process.

Parametersosid.id.IdprocessIda process Id
osid.id.IdworkIda work Id
Returnosid.workflow.WorkflowEventthe status
ErrorsNOT_FOUND processId not found or workId is not active in the process
NULL_ARGUMENT processId or workId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetStatusesForWorks
Description

Gets the status of a works in a process.

Parametersosid.id.IdprocessIda process Id
osid.id.IdListworkIdsa list of work Ids
Returnosid.workflow.WorkflowEventListthe current list of statuses
ErrorsNULL_ARGUMENT processId or workIds is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.