org.osid.assessment

Interface AssessmentOffered

All Superinterfaces:

Browsable, Extensible, Identifiable, OsidObject, Subjugateable

public interface AssessmentOffered
extends OsidObject, Subjugateable

An AssessmentOffered represents a sequence of assessment items. Like all OSID objects, an AssessmentOffered is identified by its Id and any persisted references should use the Id.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	areItemsSequential() Tests if the items or parts in this assessment are taken sequentially.
boolean	areItemsShuffled() Tests if the items or parts appear in a random order.
Assessment	getAssessment() Gets the assessment corresponding to this assessment offereng.
Id	getAssessmentId() Gets the assessment Id corresponding to this assessment offering.
AssessmentOfferedRecord	getAssessmentOfferedRecord(Type assessmentTakenRecordType) Gets the assessment offered record corresponding to the given AssessmentOffered record Type.
DateTime	getDeadline() Gets the end time for this assessment.
Duration	getDuration() Gets the duration for this assessment.
GradeSystem	getGradeSystem() Gets the grade system for the grade.
Id	getGradeSystemId() Gets the grade system Id for the grade.
Grade	getLevel() Gets the Grade corresponding to the assessment difficulty.
Id	getLevelId() Gets the Id of a Grade corresponding to the assessment difficulty.
AssessmentOffered	getRubric() Gets the rubric.
Id	getRubricId() Gets the Id of the rubric.
GradeSystem	getScoreSystem() Gets the grade system for the score.
Id	getScoreSystemId() Gets the grade system Id for the score.
DateTime	getStartTime() Gets the start time for this assessment.
boolean	hasDeadline() Tests if there is a fixed end time for this assessment.
boolean	hasDuration() Tests if there is a fixed duration for this assessment.
boolean	hasRubric() Tests if a rubric assessment is associated with this assessment.
boolean	hasStartTime() Tests if there is a fixed start time for this assessment.
boolean	isGraded() Tests if this assessment will be graded.
boolean	isScored() Tests if this assessment will be scored.

Methods inherited from interface org.osid.OsidObject

getDescription, getDisplayName, getGenusType, isOfGenusType

Methods inherited from interface org.osid.Identifiable

getId, isCurrent

Methods inherited from interface org.osid.Extensible

getRecordTypes, hasRecordType

Methods inherited from interface org.osid.Browsable

getProperties, getPropertiesByRecordType

Method Detail

getAssessmentId

Id getAssessmentId()

Gets the assessment Id corresponding to this assessment offering.

Returns:

the assessment id

Compliance:

mandatory - This method must be implemented.

getAssessment

Assessment getAssessment()
                         throws OperationFailedException

Gets the assessment corresponding to this assessment offereng.

Returns:

the assessment

Throws:

OperationFailedException - unable to complete request

Compliance:

mandatory - This method must be implemented.

getLevelId

Id getLevelId()

Gets the Id of a Grade corresponding to the assessment difficulty.

Returns:

a grade id

Compliance:

mandatory - This method must be implemented.

getLevel

Grade getLevel()
               throws OperationFailedException

Gets the Grade corresponding to the assessment difficulty.

Returns:

the level

Throws:

OperationFailedException - unable to complete request

Compliance:

mandatory - This method must be implemented.

areItemsSequential

boolean areItemsSequential()

Tests if the items or parts in this assessment are taken sequentially.

Returns:

true if the items are taken sequentially, false if the items can be skipped and revisited

Compliance:

mandatory - This method must be implemented.

areItemsShuffled

boolean areItemsShuffled()

Tests if the items or parts appear in a random order.

Returns:

true if the items appear in a random order, false otherwise

Compliance:

mandatory - This method must be implemented.

hasStartTime

boolean hasStartTime()

Tests if there is a fixed start time for this assessment.

Returns:

true if there is a fixed start time, false otherwise

Compliance:

mandatory - This method must be implemented.

getStartTime

DateTime getStartTime()

Gets the start time for this assessment.

Returns:

the designated start time

Throws:

IllegalStateException - hasStartTime() is false

Compliance:

mandatory - This method must be implemented.

hasDeadline

boolean hasDeadline()

Tests if there is a fixed end time for this assessment.

Returns:

true if there is a fixed end time, false otherwise

Compliance:

mandatory - This method must be implemented.

getDeadline

DateTime getDeadline()

Gets the end time for this assessment.

Returns:

the designated end time

Throws:

IllegalStateException - hasDeadline() is false

Compliance:

mandatory - This method must be implemented.

hasDuration

boolean hasDuration()

Tests if there is a fixed duration for this assessment.

Returns:

true if there is a fixed duration, false otherwise

Compliance:

mandatory - This method must be implemented.

getDuration

Duration getDuration()

Gets the duration for this assessment.

Returns:

the duration

Throws:

IllegalStateException - hasDuration() is false

Compliance:

mandatory - This method must be implemented.

isScored

boolean isScored()

Tests if this assessment will be scored.

Returns:

true if this assessment will be scored false otherwise

Compliance:

mandatory - This method must be implemented.

getScoreSystemId

Id getScoreSystemId()

Gets the grade system Id for the score.

Returns:

the grade system Id

Throws:

IllegalStateException - isScored() is false

Compliance:

mandatory - This method must be implemented.

getScoreSystem

GradeSystem getScoreSystem()
                           throws OperationFailedException

Gets the grade system for the score.

Returns:

the grade system

Throws:

IllegalStateException - isScored() is false

OperationFailedException - unable to complete request

Compliance:

mandatory - This method must be implemented.

isGraded

boolean isGraded()

Tests if this assessment will be graded.

Returns:

true if this assessment will be graded, false otherwise

Compliance:

mandatory - This method must be implemented.

getGradeSystemId

Id getGradeSystemId()

Gets the grade system Id for the grade.

Returns:

the grade system Id

Throws:

IllegalStateException - isGraded() is false

Compliance:

mandatory - This method must be implemented.

getGradeSystem

GradeSystem getGradeSystem()
                           throws OperationFailedException

Gets the grade system for the grade.

Returns:

the grade system

Throws:

IllegalStateException - isGraded() is false

OperationFailedException - unable to complete request

Compliance:

mandatory - This method must be implemented.

hasRubric

boolean hasRubric()

Tests if a rubric assessment is associated with this assessment.

Returns:

true if a rubric is available, false otherwise

Compliance:

mandatory - This method must be implemented.

getRubricId

Id getRubricId()

Gets the Id of the rubric.

Returns:

an assessment offered Id

Throws:

IllegalStateException - hasRubric() is false

Compliance:

mandatory - This method must be implemented.

getRubric

AssessmentOffered getRubric()
                            throws OperationFailedException

Gets the rubric.

Returns:

the assessment offered

Throws:

IllegalStateException - hasRubric() is false

OperationFailedException - unable to complete request

Compliance:

mandatory - This method must be implemented.

getAssessmentOfferedRecord

AssessmentOfferedRecord getAssessmentOfferedRecord(Type assessmentTakenRecordType)
                                                   throws OperationFailedException

Gets the assessment offered record corresponding to the given AssessmentOffered record Type. This method is used to retrieve an object implementing the requested record. The assessmentOfferedRecordType may be the Type returned in getRecordTypes() or any of its parents in a Type hierarchy where hasRecordType(assessmentOfferedRecordType) is true .

Parameters:

assessmentTakenRecordType - an assessment offered record type

Returns:

the assessment offered record

Throws:

NullArgumentException - assessmentOfferedRecordType is null

OperationFailedException - unable to complete request

UnsupportedException - hasRecordType(assessmentOfferedRecordType) is false

Compliance:

mandatory - This method must be implemented.