public interface TodoSmartChecklistSession extends OsidSession
This session manages queries and sequencing to create "smart" dynamic
catalogs. A TodoQuery
can be retrieved from this session
and mapped to this Checklist
to create a virtual collection
of Todos.
The todos may be sequenced using the
TodoSearchOrder
from this session.
This Checklist
has a default query that matches any
todo and a default search order that specifies no sequencing. The queries
may be examined using a TodoQueryInspector.
The query may
be modified by converting the inspector back to a TodoQuery.
Modifier and Type | Method and Description |
---|---|
void |
applyTodoQuery(TodoQuery todoQuery)
Applies a todo query to this checklist.
|
void |
applyTodoSequencing(TodoSearchOrder todoSearchOrder)
Applies a todo search order to this checklist.
|
boolean |
canManageSmartChecklists()
Tests if this user can manage smart checklists.
|
Checklist |
getChecklist()
Gets the
Checklist associated with this session. |
Id |
getChecklistId()
Gets the
Checklist Id associated with
this session. |
TodoQuery |
getTodoQuery()
Gets a todo query.
|
TodoQuery |
getTodoQueryFromInspector(TodoQueryInspector todoQueryInspector)
Gets a todo query from an inspector.
|
TodoSearchOrder |
getTodoSearchOrder()
Gets a todo search order.
|
TodoQueryInspector |
inspectTodoQuery()
Gets a todo query inspector for this checklist.
|
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
Id getChecklistId()
Checklist
Id
associated with
this session. Checklist Id
associated with this sessionmandatory
- This method must be implemented. Checklist getChecklist() throws OperationFailedException, PermissionDeniedException
Checklist
associated with this session. Checklist
associated with this sessionOperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. boolean canManageSmartChecklists()
PERMISSION_DENIED.
This is intended as a hint to an
application that may opt not to offer operations to unauthorized
users. false
if smart checklist management is not
authorized, true
otherwisemandatory
- This method must be implemented. TodoQuery getTodoQuery()
mandatory
- This method must be implemented. TodoSearchOrder getTodoSearchOrder()
mandatory
- This method must be implemented. void applyTodoQuery(TodoQuery todoQuery) throws OperationFailedException, PermissionDeniedException
todoQuery
- the todo queryNullArgumentException
- todoQuery
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failure
occurredUnsupportedException
- todoQuery
not of
this servicemandatory
- This method must be implemented. TodoQueryInspector inspectTodoQuery() throws OperationFailedException, PermissionDeniedException
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failure
occurredmandatory
- This method must be implemented. void applyTodoSequencing(TodoSearchOrder todoSearchOrder) throws OperationFailedException, PermissionDeniedException
todoSearchOrder
- the todo search orderNullArgumentException
- todoSearchOrder
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failure
occurredUnsupportedException
- todoSearchOrder
not of this servicemandatory
- This method must be implemented. TodoQuery getTodoQueryFromInspector(TodoQueryInspector todoQueryInspector)
todoQueryInspector
- a query inspectorNullArgumentException
- todoQueryInspector
is null
UnsupportedException
- todoQueryInspector
is not of this servicemandatory
- This method must be implemented.