Interface WorkflowEventOfficeSession

All Superinterfaces:

AutoCloseable, Closeable, OsidSession, OsidSession

public interface WorkflowEventOfficeSession
extends OsidSession

This session provides methods to retrieve WorkflowEvent to Office mappings. A WorkflowEvent may appear in multiple Office objects. E ach office may have its own authorizations governing who is allowed to look at it.

This lookup session defines several views:

• comparative view: elements may be silently omitted or re-ordered
• plenary view: provides a complete result set or is an error condition

Like all OsidSessions, WorkflowEventOfficeSessions are dedicated to single processing threads and a single authenticated user.

Method Summary

Modifier and Type	Method	Description
boolean	canLookupWorkflowEventOfficeMappings()	Tests if this user can perform lookups of workflow event/office mappings.
IdList	getOfficeIdsByWorkflowEvent(Id workflowEventId)	Gets the Office Ids mapped to a WorkflowEvent.
OfficeList	getOfficesByWorkflowEvent(Id workflowEventId)	Gets the Offices mapped to a WorkflowEvent.
IdList	getWorkflowEventIdsByOffice(Id officeId)	Gets the list of WorkflowEvent Ids associated with an Office.
IdList	getWorkflowEventIdsByOffices(IdList officeIds)	Gets the list of WorkflowEvent Ids corresponding to a list of Offices.
WorkflowEventList	getWorkflowEventsByOffice(Id officeId)	Gets the list of WorkflowEvents associated with an Office.
WorkflowEventList	getWorkflowEventsByOffices(IdList officeIds)	Gets the list of WorkflowEvent corresponding to a list of Offices.
void	useComparativeWorkflowEventOfficeView()	The returns from the lookup methods may omit or translate elements based on this session, such as authorization, and not result in an error.
void	usePlenaryWorkflowEventOfficeView()	A complete view of the WorkflowEvent and Office returns is desired.

Methods inherited from interface Closeable

close

Methods inherited from interface OsidSession

close

Methods inherited from interface OsidSession

getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatTypes, getLocales, isAuthenticated, startTransaction, supportsTransactions

Method Details

canLookupWorkflowEventOfficeMappings

boolean canLookupWorkflowEventOfficeMappings()

Tests if this user can perform lookups of workflow event/office mappings. A return of true does not guarantee successful authorization. A return of false indicates that it is known lookup methods in this session will result in a PERMISSION_DENIED. T his is intended as a hint to an application that may opt not to offer lookup operations to unauthorized users.

Returns:

false if looking up mappings is not authorized, true otherwise

Compliance:

mandatory - This method must be implemented.

useComparativeWorkflowEventOfficeView

void useComparativeWorkflowEventOfficeView()

The returns from the lookup methods may omit or translate elements based on this session, such as authorization, and not result in an error. This view is used when greater interoperability is desired at the expense of precision.

Compliance:

mandatory - This method must be implemented.

usePlenaryWorkflowEventOfficeView

void usePlenaryWorkflowEventOfficeView()

A complete view of the WorkflowEvent and Office returns is desired. Methods will return what is requested or result in an error. This view is used when greater precision is desired at the expense of interoperability.

Compliance:

mandatory - This method must be implemented.

getWorkflowEventIdsByOffice

IdList getWorkflowEventIdsByOffice(Id officeId)
                            throws NotFoundException,
OperationFailedException,
PermissionDeniedException

Gets the list of WorkflowEvent Ids associated with an Office.

Parameters:

officeId - Id of the Office

Returns:

list of related workflow event Ids

Throws:

NotFoundException - officeId is not found

NullArgumentException - officeId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

getWorkflowEventsByOffice

WorkflowEventList getWorkflowEventsByOffice(Id officeId)
                                     throws NotFoundException,
OperationFailedException,
PermissionDeniedException

Gets the list of WorkflowEvents associated with an Office.

Parameters:

officeId - Id of the Office

Returns:

list of related workflow events

Throws:

NotFoundException - officeId is not found

NullArgumentException - officeId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

getWorkflowEventIdsByOffices

IdList getWorkflowEventIdsByOffices(IdList officeIds)
                             throws OperationFailedException,
PermissionDeniedException

Gets the list of WorkflowEvent Ids corresponding to a list of Offices.

Parameters:

officeIds - list of office Ids

Returns:

list of workflow event Ids

Throws:

NullArgumentException - officeIds is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

getWorkflowEventsByOffices

WorkflowEventList getWorkflowEventsByOffices(IdList officeIds)
                                      throws OperationFailedException,
PermissionDeniedException

Gets the list of WorkflowEvent corresponding to a list of Offices.

Parameters:

officeIds - list of office Ids

Returns:

list of workflow events

Throws:

NullArgumentException - officeIds is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

getOfficeIdsByWorkflowEvent

IdList getOfficeIdsByWorkflowEvent(Id workflowEventId)
                            throws NotFoundException,
OperationFailedException,
PermissionDeniedException

Gets the Office Ids mapped to a WorkflowEvent.

Parameters:

workflowEventId - Id of a WorkflowEvent

Returns:

list of office Ids

Throws:

NotFoundException - workflowEventId is not found

NullArgumentException - workflowEventId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

getOfficesByWorkflowEvent

OfficeList getOfficesByWorkflowEvent(Id workflowEventId)
                              throws NotFoundException,
OperationFailedException,
PermissionDeniedException

Gets the Offices mapped to a WorkflowEvent.

Parameters:

workflowEventId - Id of a WorkflowEvent

Returns:

list of offices

Throws:

NotFoundException - workflowEventId is not found

NullArgumentException - workflowEventId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.