OSID - osid.assessment.AssessmentOffered Service Interface Definition

Interface	osid.assessment.AssessmentOffered
Implements	`osid.OsidObject`
Implements	`osid.Subjugateable`
Used By	`osid.assessment.AssessmentOffered`
	`osid.assessment.AssessmentOfferedAdminSession`
	`osid.assessment.AssessmentOfferedList`
	`osid.assessment.AssessmentOfferedLookupSession`
	`osid.assessment.AssessmentTaken`
Description	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	getAssessmentId
Description	Gets the assessment `Id` corresponding to this assessment offering.
Return	`osid.id.Id`		the assessment id
Compliance	`mandatory`		This method must be implemented.
Method	getAssessment
Description	Gets the assessment corresponding to this assessment offereng.
Return	`osid.assessment.Assessment`		the assessment
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	getLevelId
Description	Gets the `Id` of a `Grade` corresponding to the assessment difficulty.
Return	`osid.id.Id`		a grade id
Compliance	`mandatory`		This method must be implemented.
Method	getLevel
Description	Gets the `Grade` corresponding to the assessment difficulty.
Return	`osid.grading.Grade`		the level
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	areItemsSequential
Description	Tests if the items or parts in this assessment are taken sequentially.
Return	`boolean`		`true` if the items are taken sequentially, `false` if the items can be skipped and revisited
Compliance	`mandatory`		This method must be implemented.
Method	areItemsShuffled
Description	Tests if the items or parts appear in a random order.
Return	`boolean`		`true` if the items appear in a random order, `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	hasStartTime
Description	Tests if there is a fixed start time for this assessment.
Return	`boolean`		`true` if there is a fixed start time, `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	getStartTime
Description	Gets the start time for this assessment.
Return	`osid.calendaring.DateTime`		the designated start time
Errors	ILLEGAL_STATE		`hasStartTime()` is `false`
Compliance	`mandatory`		This method must be implemented.
Method	hasDeadline
Description	Tests if there is a fixed end time for this assessment.
Return	`boolean`		`true` if there is a fixed end time, `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	getDeadline
Description	Gets the end time for this assessment.
Return	`osid.calendaring.DateTime`		the designated end time
Errors	ILLEGAL_STATE		`hasDeadline()` is `false`
Compliance	`mandatory`		This method must be implemented.
Method	hasDuration
Description	Tests if there is a fixed duration for this assessment.
Return	`boolean`		`true` if there is a fixed duration, `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	getDuration
Description	Gets the duration for this assessment.
Return	`osid.calendaring.Duration`		the duration
Errors	ILLEGAL_STATE		`hasDuration()` is `false`
Compliance	`mandatory`		This method must be implemented.
Method	isScored
Description	Tests if this assessment will be scored.
Return	`boolean`		`true` if this assessment will be scored `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	getScoreSystemId
Description	Gets the grade system `Id` for the score.
Return	`osid.id.Id`		the grade system `Id`
Errors	ILLEGAL_STATE		`isScored()` is `false`
Compliance	`mandatory`		This method must be implemented.
Method	getScoreSystem
Description	Gets the grade system for the score.
Return	`osid.grading.GradeSystem`		the grade system
Errors	ILLEGAL_STATE		`isScored()` is `false`
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	isGraded
Description	Tests if this assessment will be graded.
Return	`boolean`		`true` if this assessment will be graded, `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	getGradeSystemId
Description	Gets the grade system `Id` for the grade.
Return	`osid.id.Id`		the grade system `Id`
Errors	ILLEGAL_STATE		`isGraded()` is `false`
Compliance	`mandatory`		This method must be implemented.
Method	getGradeSystem
Description	Gets the grade system for the grade.
Return	`osid.grading.GradeSystem`		the grade system
Errors	ILLEGAL_STATE		`isGraded()` is `false`
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	hasRubric
Description	Tests if a rubric assessment is associated with this assessment.
Return	`boolean`		`true` if a rubric is available, `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	getRubricId
Description	Gets the `Id` of the rubric.
Return	`osid.id.Id`		an assessment offered `Id`
Errors	ILLEGAL_STATE		`hasRubric()` is `false`
Compliance	`mandatory`		This method must be implemented.
Method	getRubric
Description	Gets the rubric.
Return	`osid.assessment.AssessmentOffered`		the assessment offered
Errors	ILLEGAL_STATE		`hasRubric()` is `false`
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	getAssessmentOfferedRecord
Description	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	`osid.type.Type`	`assessmentTakenRecordType`	an assessment offered record type
Return	`osid.assessment.records.AssessmentOfferedRecord`		the assessment offered record
Errors	NULL_ARGUMENT		`assessmentOfferedRecordType` is `null`
	OPERATION_FAILED		unable to complete request
	UNSUPPORTED		`hasRecordType(assessmentOfferedRecordType)` is `false`
Compliance	`mandatory`		This method must be implemented.