org.osid.assessment

Interface AssessmentSession

All Superinterfaces:

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

public interface AssessmentSession
extends OsidSession

This session is used to take an assessment. The assessment associated with this session represents the "assessment taken" by an Agent. This session may be created using an AssessmentOffered Id retrieved from an assessment bank, and instantiating this session represents the transaction of taking an assessment. Resuming an assessment, if permitted, is performed through instantiating this session with the AssessmentTaken Id.

Assessment Items are accessed via the Question interface. A Question Id is the same as the Item Id.

This session manages the flow of control for the assessment taking process. It allows for two types of processes:

• synchronous response: Each consecutive question is only available after the previous item was submitted or skipped.
• asynchronous response: Questions may be accessed independently of response submission.

It may be the case that it is allowed to suspend and resume an assessment. canSuspend() indicates the availability of this feature. finished() indicates the assessment is complete.

This session is used in the context of an AssessmentSection. An assessment with no sections defined is assumed to have a single default section that maps to the entire assessment.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	canTakeAssessments() Tests if this user can take this assessment section.
void	clearResponse(Id itemId) Clears the response to an item The item appears as unanswered.
void	finish() Indicates the assessment section is complete.
void	finishedAssessment(Id assessmentTakenId) Indicates the entire assessment is complete.
void	finishedAssessmentSection(Id assessmentSectionId) Indicates an assessment section is complete.
AssessmentList	getAnswers(Id itemId) Gets the acceptable answers to the associated item.
AssessmentSection	getAssessmentSection(Id assessmentSectionId) Gets an assessemnts section by Id.
AssessmentSectionList	getAssessmentSections(Id assessmentTakenId) Gets the assessment sections of this assessment.
Bank	getBank() Gets the Bank associated with this session.
Id	getBankId() Gets the Bank Id associated with this session.
AssessmentSection	getFirstAssessmentSection(Id assessmentTakenId) Gets the first assessment section in this assesment.
Question	getFirstQuestion() Gets the first question in this assesment section.
Question	getFirstUnansweredQuestion() Gets the first unanswered question in this assesment section.
AssessmentSectionList	getIncompleteAssessmentSections() Gets the incomplete assessment sections of this assessment.
AssessmentSection	getNextAssessmentSection(Id assessmentSectionId) Gets the next assessemnt section following the given assesment section.
Question	getNextQuestion(Id itemId) Gets the next question in this assesment section.
Question	getNextUnansweredQuestion(Id itemId) Gets the next unanswered question in this assesment section.
AssessmentSection	getPreviousAssessmentSection(Id assessmentSectionId) Gets the next assessemnt section following the given assesment section.
Question	getPreviousQuestion(Id itemId) Gets the previous question in this assesment section.
Question	getPreviousUnansweredQuestion(Id itemId) Gets the previous unanswered question in this assesment section.
Question	getQuestion(Id itemId) Gets the Question specified by its Id.
QuestionList	getQuestions() Gets the questions of this assessment section.
Response	getResponse(Id itemId) Gets the submitted response to the associated item.
AnswerForm	getResponseForm(Id itemId) Gets the response form for submitting an answer.
ResponseList	getResponses() Gets all submitted responses.
QuestionList	getUnansweredQuestions() Gets the unanswered questions of this assessment section.
boolean	hasAssessmentBegun(Id assessmentTakenId) Tests if this assessment has started.
boolean	hasAssessmentSectionBegun(Id assessmentSectionId) Tests if this assessment section has started.
boolean	hasNextAssessmentSection(Id assessmentSectionId) Tests if there is a next assessment section in the assessment following the given assessment section Id.
boolean	hasNextQuestion(Id itemId) Tests if there is a next question following the given question Id.
boolean	hasNextUnansweredQuestion(Id itemId) Tests if there is a next unanswered question following the given question Id.
boolean	hasPreviousAssessmentSection(Id assessmentSectionId) Tests if there is a previous assessment section in the assessment following the given assessment section Id.
boolean	hasPreviousQuestion(Id itemId) Tests if there is a previous question preceeding the given question Id.
boolean	hasPreviousUnansweredQuestion(Id itemId) Tests if there is a previous unanswered question preceeding the given question Id.
boolean	hasUnansweredQuestions() Tests if there are unanswered questions in this assessment section.
boolean	isAnswerAvailable(Id itemId) Tests if an answer is available for the given item.
boolean	isAssessmentOver(Id assessmentTakenId) Tests if this assessment is over.
boolean	isAssessmentSectionComplete(Id assessmentSectionId) Tests if the given assessment section is complete.
boolean	isAssessmentSectionOver(Id assessmentSectionId) Tests if this assessment section is over.
boolean	isQuestionAnswered(Id itemId) Tests if the given item has a response.
boolean	requiresSynchronousResponses(Id assessmentSectionId) Tests if synchronous responses are required in this assessment section.
boolean	requiresSynchronousSections() Tests if synchronous sections are required.
Response	skipItem(Id itemId) Skips an item.
void	submitResponse(Id itemId, AnswerForm answer) Submits an answer to an item.

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

getBankId

Id getBankId()

Gets the Bank Id associated with this session.

Returns:

the Bank Id associated with this session

Compliance:

mandatory - This method must be implemented.

getBank

Bank getBank()
             throws OperationFailedException,
                    PermissionDeniedException

Gets the Bank associated with this session.

Returns:

the Bank associated with this session

Throws:

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

canTakeAssessments

boolean canTakeAssessments()

Tests if this user can take this assessment section. 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 assessment operations to unauthorized users.

Returns:

false if assessment methods are not authorized, true otherwise

Compliance:

mandatory - This method must be implemented.

hasAssessmentBegun

boolean hasAssessmentBegun(Id assessmentTakenId)
                           throws NotFoundException,
                                  OperationFailedException,
                                  PermissionDeniedException

Tests if this assessment has started. An assessment begins from the designated start time if a start time is defined. If no start time is defined the assessment may begin at any time. Assessment sections cannot be accessed if the return for this method is false.

Parameters:

assessmentTakenId - Id of the AssessmentTaken

Returns:

true if this assessment has begun, false otherwise

Throws:

NotFoundException - assessmentTakenId is not found

NullArgumentException - assessmentTakenId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure occurred

Compliance:

mandatory - This method must be implemented.

isAssessmentOver

boolean isAssessmentOver(Id assessmentTakenId)
                         throws NotFoundException,
                                OperationFailedException,
                                PermissionDeniedException

Tests if this assessment is over. An assessment is over if finishedAssessment() is invoked or the designated finish time has expired.

Parameters:

assessmentTakenId - Id of the AssessmentTaken

Returns:

true if this assessment is over, false otherwise

Throws:

NotFoundException - assessmentTakenId is not found

NullArgumentException - assessmentTakenId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure occurred

Compliance:

mandatory - This method must be implemented.

finishedAssessment

void finishedAssessment(Id assessmentTakenId)
                        throws NotFoundException,
                               OperationFailedException,
                               PermissionDeniedException

Indicates the entire assessment is complete.

Parameters:

assessmentTakenId - Id of the AssessmentTaken

Throws:

IllegalStateException - hasBegun() is false or isOver() is true

NotFoundException - assessmentTakenId is not found

NullArgumentException - assessmentTakenId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

requiresSynchronousSections

boolean requiresSynchronousSections()

Tests if synchronous sections are required. This method should be checked to determine if all sections are available when requested, or the next sections becomes available only after the previous section is complete. There are two methods for retrieving sections. One is using the built-in hasNextSection() and getNextSection() methods. In synchronous mode, hasNextSection() is false until the current section is completed. In asynchronous mode, hasNextSection() returns true until the end of the assessment. AssessmentSections may also be accessed via an AssessmentSectionList. If syncronous sections are required, AssessmentSectionList.available() == 0 and AssessmentSectionList.getNextQuestion() blocks until the section is complete. AssessmentSectionList.hasNext() is always true until the end of the assessment is reached.

Returns:

true if this synchronous sections are required, false otherwise

Compliance:

mandatory - This method must be implemented.

getFirstAssessmentSection

AssessmentSection getFirstAssessmentSection(Id assessmentTakenId)
                                            throws NotFoundException,
                                                   OperationFailedException,
                                                   PermissionDeniedException

Gets the first assessment section in this assesment.

Parameters:

assessmentTakenId - Id of the AssessmentTaken

Returns:

the first assessment section

Throws:

IllegalStateException - hasAssessmentBegun() is false

NotFoundException - assessmentTakenId is not found

NullArgumentException - assessmentTakenId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure occurred

Compliance:

mandatory - This method must be implemented.

hasNextAssessmentSection

boolean hasNextAssessmentSection(Id assessmentSectionId)

Tests if there is a next assessment section in the assessment following the given assessment section Id.

Parameters:

assessmentSectionId - Id of the AssessmentSection

Returns:

true if there is a next section, false otherwise

Throws:

IllegalStateException - hasAssessmentBegun() is false

NullArgumentException - sectionId is null

Compliance:

mandatory - This method must be implemented.

getNextAssessmentSection

AssessmentSection getNextAssessmentSection(Id assessmentSectionId)
                                           throws OperationFailedException,
                                                  NotFoundException,
                                                  PermissionDeniedException

Gets the next assessemnt section following the given assesment section.

Parameters:

assessmentSectionId - Id of the AssessmentSection

Returns:

the next section

Throws:

IllegalStateException - hasNextAssessmentSection() is false

OperationFailedException - unable to complete request

NotFoundException - assessmentSectionId is not found

NullArgumentException - assessmentSectionId is null

PermissionDeniedException - authorization failure occurred

Compliance:

mandatory - This method must be implemented.

hasPreviousAssessmentSection

boolean hasPreviousAssessmentSection(Id assessmentSectionId)

Tests if there is a previous assessment section in the assessment following the given assessment section Id.

Parameters:

assessmentSectionId - Id of the AssessmentSection

Returns:

true if there is a previous assessment section, false otherwise

Throws:

IllegalStateException - hasAssessmentBegun() is false

NullArgumentException - sectionId is null

Compliance:

mandatory - This method must be implemented.

getPreviousAssessmentSection

AssessmentSection getPreviousAssessmentSection(Id assessmentSectionId)
                                               throws OperationFailedException,
                                                      NotFoundException,
                                                      PermissionDeniedException

Gets the next assessemnt section following the given assesment section.

Parameters:

assessmentSectionId - Id of the AssessmentSection

Returns:

the previous assessment section

Throws:

IllegalStateException - hasNextAssessmentSection() is false

OperationFailedException - unable to complete request

NotFoundException - assessmentSectionId is not found

NullArgumentException - assessmentSectionId is null

PermissionDeniedException - authorization failure occurred

Compliance:

mandatory - This method must be implemented.

getAssessmentSection

AssessmentSection getAssessmentSection(Id assessmentSectionId)
                                       throws OperationFailedException,
                                              NotFoundException,
                                              PermissionDeniedException

Gets an assessemnts section by Id.

Parameters:

assessmentSectionId - Id of the AssessmentSection

Returns:

the assessment section

Throws:

IllegalStateException - hasAssessmentBegun() is false

OperationFailedException - unable to complete request

NotFoundException - assessmentSectionId is not found

NullArgumentException - assessmentSectionId is null

PermissionDeniedException - authorization failure occurred

Compliance:

mandatory - This method must be implemented.

getAssessmentSections

AssessmentSectionList getAssessmentSections(Id assessmentTakenId)
                                            throws NotFoundException,
                                                   OperationFailedException,
                                                   PermissionDeniedException

Gets the assessment sections of this assessment.

Parameters:

assessmentTakenId - Id of the AssessmentTaken

Returns:

the list of assessment sections

Throws:

IllegalStateException - hasAssessmentBegun() is false

NotFoundException - assessmentTakenId is not found

NullArgumentException - assessmentTakenId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure occurred

Compliance:

mandatory - This method must be implemented.

isAssessmentSectionComplete

boolean isAssessmentSectionComplete(Id assessmentSectionId)
                                    throws NotFoundException,
                                           OperationFailedException,
                                           PermissionDeniedException

Tests if the given assessment section is complete.

Parameters:

assessmentSectionId - Id of the AssessmentSection

Returns:

true if this assessment section is complete, false otherwise

Throws:

IllegalStateException - isAssessmentOver() is true

NotFoundException - assessmentSectionId is not found

NullArgumentException - assessmentSectionId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

getIncompleteAssessmentSections

AssessmentSectionList getIncompleteAssessmentSections()
                                                      throws OperationFailedException,
                                                             PermissionDeniedException

Gets the incomplete assessment sections of this assessment.

Returns:

the list of incomplete assessment sections

Throws:

IllegalStateException - hasAssessmentBegun() is false

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure occurred

Compliance:

mandatory - This method must be implemented.

hasAssessmentSectionBegun

boolean hasAssessmentSectionBegun(Id assessmentSectionId)
                                  throws NotFoundException,
                                         OperationFailedException,
                                         PermissionDeniedException

Tests if this assessment section has started. A section begins from the designated start time if a start time is defined. If no start time is defined the section may begin at any time. Assessment items cannot be accessed or submitted if the return for this method is false.

Parameters:

assessmentSectionId - Id of the AssessmentSection

Returns:

true if this assessment section has begun, false otherwise

Throws:

IllegalStateException - hasAssessmentBegun() is false or isAssessmentOver() is true

NotFoundException - assessmentSectionId is not found

NullArgumentException - assessmentSectionId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

isAssessmentSectionOver

boolean isAssessmentSectionOver(Id assessmentSectionId)
                                throws NotFoundException,
                                       OperationFailedException,
                                       PermissionDeniedException

Tests if this assessment section is over. An assessment section is over if finishedAssessmentSection() is invoked or the designated finish time has expired.

Parameters:

assessmentSectionId - Id of the AssessmentSection

Returns:

true if this assessment is over, false otherwise

Throws:

IllegalStateException - hasAssessmenSectiontBegun() is false or isAssessmentSectionOver() is true

NotFoundException - assessmentSectionId is not found

NullArgumentException - assessmentSectionId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

finishedAssessmentSection

void finishedAssessmentSection(Id assessmentSectionId)
                               throws NotFoundException,
                                      OperationFailedException,
                                      PermissionDeniedException

Indicates an assessment section is complete.

Parameters:

assessmentSectionId - Id of the AssessmentSection

Throws:

IllegalStateException - hasAssessmentSectionBegun() is false or isAssessmentSectionOver() is true

NotFoundException - assessmentSectionId is not found

NullArgumentException - assessmentSectionId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

requiresSynchronousResponses

boolean requiresSynchronousResponses(Id assessmentSectionId)
                                     throws NotFoundException,
                                            OperationFailedException,
                                            PermissionDeniedException

Tests if synchronous responses are required in this assessment section. This method should be checked to determine if all items are available when requested, or the next item becomes available only after the response to the current item is submitted. There are two methods for retrieving questions. One is using the built-in hasNextQuestion() and getNextQuestion() methods. In synchronous mode, hasNextQuestion() is false until the response for the current question is submitted. In asynchronous mode, hasNextQuestion() returns true until the end of the assessment. Questions may also be accessed via a QuestionList. If syncronous responses are required, QuestionList.available() == 0 and QuestionList.getNextQuestion() blocks until the response is submitted. QuestionList.hasNext() is always true until the end of the assessment is reached.

Parameters:

assessmentSectionId - Id of the AssessmentSection

Returns:

true if this synchronous responses are required, false otherwise

Throws:

IllegalStateException - hasAssessmentBegun() is false or isAssessmentOver() is true

NotFoundException - assessmentSectionId is not found

NullArgumentException - assessmentSectionId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

getFirstQuestion

Question getFirstQuestion()
                          throws OperationFailedException,
                                 PermissionDeniedException

Gets the first question in this assesment section.

Returns:

the first question

Throws:

IllegalStateException - hasAssessmentSectionBegun() is false

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure occurred

Compliance:

mandatory - This method must be implemented.

hasNextQuestion

boolean hasNextQuestion(Id itemId)

Tests if there is a next question following the given question Id.

Parameters:

itemId - Id of the Item

Returns:

true if there is a next question, false otherwise

Throws:

IllegalStateException - hasAssessmentSectionBegun() is false

NullArgumentException - itemId is null

Compliance:

mandatory - This method must be implemented.

getNextQuestion

Question getNextQuestion(Id itemId)
                         throws OperationFailedException,
                                NotFoundException,
                                PermissionDeniedException

Gets the next question in this assesment section.

Parameters:

itemId - Id of the Item

Returns:

the next question

Throws:

IllegalStateException - hasAssessmentSectionBegun() or hasNextQuestion() is false

OperationFailedException - unable to complete request

NotFoundException - itemId is not found

NullArgumentException - itemId is null

PermissionDeniedException - authorization failure occurred

Compliance:

mandatory - This method must be implemented.

hasPreviousQuestion

boolean hasPreviousQuestion(Id itemId)

Tests if there is a previous question preceeding the given question Id.

Parameters:

itemId - Id of the Item

Returns:

true if there is a previous question, false otherwise

Throws:

IllegalStateException - hasAssessmentSectionBegun() is false

NullArgumentException - itemId is null

Compliance:

mandatory - This method must be implemented.

getPreviousQuestion

Question getPreviousQuestion(Id itemId)
                             throws OperationFailedException,
                                    NotFoundException,
                                    PermissionDeniedException

Gets the previous question in this assesment section.

Parameters:

itemId - Id of the Item

Returns:

the previous question

Throws:

IllegalStateException - hasBegun() or hasPreviousQuestion() is false

OperationFailedException - unable to complete request

NotFoundException - itemId is not found

NullArgumentException - itemId is null

PermissionDeniedException - authorization failure occurred

Compliance:

mandatory - This method must be implemented.

getQuestion

Question getQuestion(Id itemId)
                     throws NotFoundException,
                            OperationFailedException,
                            PermissionDeniedException

Gets the Question specified by its Id.

Parameters:

itemId - the Id of the Question to retrieve

Returns:

the returned Question

Throws:

IllegalStateException - hasAssessmentSectionBegun() is false

NotFoundException - no Question found with the given Id in this section

NullArgumentException - itemId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure occurred

Compliance:

mandatory - This method must be implemented.

getQuestions

QuestionList getQuestions()
                          throws OperationFailedException,
                                 PermissionDeniedException

Gets the questions of this assessment section.

Returns:

the list of assessment questions

Throws:

IllegalStateException - hasAssessmentSectionBegun() is false

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure occurred

Compliance:

mandatory - This method must be implemented.

getResponseForm

AnswerForm getResponseForm(Id itemId)
                           throws NotFoundException

Gets the response form for submitting an answer.

Parameters:

itemId - Id of the Item

Returns:

an answer form

Throws:

IllegalStateException - hasAssessmentSectionBegun() is false or isAssessmentSectionOver() is true

NotFoundException - itemId is not found

NullArgumentException - itemId is null

Compliance:

mandatory - This method must be implemented.

submitResponse

void submitResponse(Id itemId,
                  AnswerForm answer)
                    throws NotFoundException,
                           OperationFailedException,
                           PermissionDeniedException

Submits an answer to an item.

Parameters:

itemId - Id of the Item

answer - the response

Throws:

IllegalStateException - hasAssessmentSectionBegun() is false or isAssessmentSectionOver() is true

InvalidArgumentException - one or more of the elements in the form is invalid

NotFoundException - itemId is not found

NullArgumentException - itemId or response is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

UnsupportedException - answerForm is not of this service

Compliance:

mandatory - This method must be implemented.

skipItem

Response skipItem(Id itemId)
                  throws NotFoundException,
                         OperationFailedException,
                         PermissionDeniedException

Skips an item.

Parameters:

itemId - Id of the Item

Returns:

the response

Throws:

IllegalStateException - hasAssessmentSectionBegun() is false or isAssessmentSectionOver() is true

NotFoundException - itemId is not found

NullArgumentException - itemId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

isQuestionAnswered

boolean isQuestionAnswered(Id itemId)
                           throws NotFoundException,
                                  OperationFailedException,
                                  PermissionDeniedException

Tests if the given item has a response.

Parameters:

itemId - Id of the Item

Returns:

true if this item has a response, false otherwise

Throws:

IllegalStateException - hasAssessmentSectionBegun() is false or isAssessmentSectionOver() is true

NotFoundException - itemId is not found

NullArgumentException - itemId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

getUnansweredQuestions

QuestionList getUnansweredQuestions()
                                    throws OperationFailedException,
                                           PermissionDeniedException

Gets the unanswered questions of this assessment section.

Returns:

the list of questions with no rsponses

Throws:

IllegalStateException - hasAssessmentSectionBegun() is false

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure occurred

Compliance:

mandatory - This method must be implemented.

hasUnansweredQuestions

boolean hasUnansweredQuestions()

Tests if there are unanswered questions in this assessment section.

Returns:

true if there are unanswered questions, false otherwise

Throws:

IllegalStateException - hasBegun() is false

Compliance:

mandatory - This method must be implemented.

getFirstUnansweredQuestion

Question getFirstUnansweredQuestion()
                                    throws OperationFailedException,
                                           PermissionDeniedException

Gets the first unanswered question in this assesment section.

Returns:

the first unanswered question

Throws:

IllegalStateException - hasAssessmentSectionBegun() or hasUnansweredQuestions() is false

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure occurred

Compliance:

mandatory - This method must be implemented.

hasNextUnansweredQuestion

boolean hasNextUnansweredQuestion(Id itemId)

Tests if there is a next unanswered question following the given question Id.

Parameters:

itemId - Id of the Item

Returns:

true if there is a next unanswered question, false otherwise

Throws:

IllegalStateException - hasAssessmentSectionBegun() is false

NullArgumentException - itemId is null

Compliance:

mandatory - This method must be implemented.

getNextUnansweredQuestion

Question getNextUnansweredQuestion(Id itemId)
                                   throws OperationFailedException,
                                          NotFoundException,
                                          PermissionDeniedException

Gets the next unanswered question in this assesment section.

Parameters:

itemId - Id of the Item

Returns:

the next unanswered question

Throws:

IllegalStateException - hasAssessmentSectionBegun() or hasNextUnansweredQuestion() is false

OperationFailedException - unable to complete request

NotFoundException - itemId is not found

NullArgumentException - itemId is null

PermissionDeniedException - authorization failure occurred

Compliance:

mandatory - This method must be implemented.

hasPreviousUnansweredQuestion

boolean hasPreviousUnansweredQuestion(Id itemId)

Tests if there is a previous unanswered question preceeding the given question Id.

Parameters:

itemId - Id of the Item

Returns:

true if there is a previous unanswered question, false otherwise

Throws:

IllegalStateException - hasAssessmentSectionBegun() is false

NullArgumentException - itemId is null

Compliance:

mandatory - This method must be implemented.

getPreviousUnansweredQuestion

Question getPreviousUnansweredQuestion(Id itemId)
                                       throws OperationFailedException,
                                              NotFoundException,
                                              PermissionDeniedException

Gets the previous unanswered question in this assesment section.

Parameters:

itemId - Id of the Item

Returns:

the previous unanswered question

Throws:

IllegalStateException - hasAssessmnetSectionBegun() or hasPreviousUnansweredQuestion() is false

OperationFailedException - unable to complete request

NotFoundException - itemId is not found

NullArgumentException - itemId is null

PermissionDeniedException - authorization failure occurred

Compliance:

mandatory - This method must be implemented.

getResponse

Response getResponse(Id itemId)
                     throws NotFoundException,
                            OperationFailedException,
                            PermissionDeniedException

Gets the submitted response to the associated item.

Parameters:

itemId - Id of the Item

Returns:

the response

Throws:

IllegalStateException - hasAssessmentSectionBegun() is false or isAssessmentSectionOver() is true

NotFoundException - itemId is not found

NullArgumentException - itemId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

getResponses

ResponseList getResponses()
                          throws OperationFailedException,
                                 PermissionDeniedException

Gets all submitted responses.

Returns:

the list of responses

Throws:

IllegalStateException - hasAssessmentSectionBegun() is false or isAssessmentSectionOver() is true

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

clearResponse

void clearResponse(Id itemId)
                   throws NotFoundException,
                          OperationFailedException,
                          PermissionDeniedException

Clears the response to an item The item appears as unanswered. If no response exists, the method simply returns.

Parameters:

itemId - Id of the Item

Throws:

IllegalStateException - hasAssessmentSectionBegun() is false or isAssessmentSectionOver() is true

NotFoundException - itemId is not found

NullArgumentException - itemId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

finish

void finish()
            throws OperationFailedException,
                   PermissionDeniedException

Indicates the assessment section is complete.

Throws:

IllegalStateException - hasAssessmentSectionBegun() is false or isAssessmentSectionOver() is true

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

isAnswerAvailable

boolean isAnswerAvailable(Id itemId)

Tests if an answer is available for the given item.

Parameters:

itemId - Id of the Item

Returns:

true if an answer are available, false otherwise

Throws:

NullArgumentException - itemId is null

Compliance:

mandatory - This method must be implemented.

getAnswers

AssessmentList getAnswers(Id itemId)
                          throws NotFoundException,
                                 OperationFailedException,
                                 PermissionDeniedException

Gets the acceptable answers to the associated item.

Parameters:

itemId - Id of the Item

Returns:

the answers

Throws:

IllegalStateException - isAnswerAvailable() is false

NotFoundException - itemId is not found

NullArgumentException - itemId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.