public interface AssessmentBasicAuthoringSession extends OsidSession
This session defines methods to manage assessment items in an assessment. This session is used for simple assessments without sections or parts. Updating the items on an assessment authored with sections and parts may result in an error.
Modifier and Type | Method and Description |
---|---|
void |
addItem(Id assessmentId,
Id itemId)
Adds an existing
Item to an assessment. |
boolean |
canAuthorAssessments()
Tests if this user can author assessments.
|
Bank |
getBank()
Gets the
Bank associated with this session. |
Id |
getBankId()
Gets the
Bank Id associated with this
session. |
ItemList |
getItems(Id assessmentId)
Gets the items in sequence from an assessment.
|
void |
moveItem(Id assessmentId,
Id itemId,
Id preceedingItemId)
Moves an existing item to follow another item in an assessment.
|
void |
orderItems(Id[] itemIds,
Id assessmentId)
Sequences existing items in an assessment.
|
void |
removeItem(Id assessmentId,
Id itemId)
Removes an
Item from this assessment. |
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
Id getBankId()
Bank
Id
associated with this
session. Bank Id
associated with this sessionmandatory
- This method must be implemented. Bank getBank() throws OperationFailedException, PermissionDeniedException
Bank
associated with this session. Bank
associated with this sessionOperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. boolean canAuthorAssessments()
PERMISSION_DENIED.
This is intended as a hint to an
application that may opt not to offer authoring operations to
unauthorized users. false
if mapping is not authorized, true
otherwisemandatory
- This method must be implemented. ItemList getItems(Id assessmentId) throws NotFoundException, OperationFailedException, PermissionDeniedException
assessmentId
- the Id
of the Assessment
NotFoundException
- assessmentid
not
foundNullArgumentException
- assessmentId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failure
occurredmandatory
- This method must be implemented. void addItem(Id assessmentId, Id itemId) throws NotFoundException, OperationFailedException, PermissionDeniedException
Item
to an assessment.assessmentId
- the Id
of the Assessment
itemId
- the Id
of the Item
NotFoundException
- assessmentId
or
itemId
not foundNullArgumentException
- assessmentId
or
itemId
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failure
occurredmandatory
- This method must be implemented. void removeItem(Id assessmentId, Id itemId) throws NotFoundException, OperationFailedException, PermissionDeniedException
Item
from this assessment.assessmentId
- the Id
of the Assessment
itemId
- the Id
of the Item
NotFoundException
- assessmentId
or
itemId
not found or itemId
not
on assessmentid
NullArgumentException
- assessmentId
or
itemId
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failure
occurredmandatory
- This method must be implemented. void moveItem(Id assessmentId, Id itemId, Id preceedingItemId) throws NotFoundException, OperationFailedException, PermissionDeniedException
assessmentId
- the Id
of the Assessment
itemId
- the Id
of an Item
preceedingItemId
- the Id
of a preceeding
Item
in the sequenceNotFoundException
- assessmentId
is not
found, or itemId
or preceedingItemId
not on assessmentId
NullArgumentException
- assessmentId, itemId
or preceedingItemId
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failure
occurredmandatory
- This method must be implemented. void orderItems(Id[] itemIds, Id assessmentId) throws NotFoundException, OperationFailedException, PermissionDeniedException
itemIds
- the Id
of the Items
assessmentId
- the Id
of the Assessment
NotFoundException
- assessmentId
is not
found or an itemId
is not on
assessmentId
NullArgumentException
- assessmentId
or
itemIds
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failure
occurredmandatory
- This method must be implemented.