OSID - osid.grading.GradeSystem Service Interface Definition

Interface	osid.grading.GradeSystem
Implements	`osid.OsidObject`
Implements	`osid.Aggregateable`
Description	A `GradeSystem` represents a grading system. The system can be based on assigned Grades or based on a numeric scale.
Method	isBasedOnGrades
Description	Tests if the grading system is based on grades.
Return	`boolean`		true if the grading system is based on grades, `false` if the system is a numeric score
Compliance	`mandatory`		This method must be implemented.
Method	getGradeIds
Description	Gets the grade `Ids` in this system ranked from highest to lowest.
Return	`osid.id.IdList`		the list of grades `Ids`
Errors	ILLEGAL_STATE		`isBasedOnGrades()` is `false`
Compliance	`mandatory`		This method must be implemented.
Method	getGrades
Description	Gets the grades in this system ranked from highest to lowest.
Return	`osid.grading.GradeList`		the list of grades
Errors	ILLEGAL_STATE		`isBasedOnGrades()` is `false`
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	getLowestNumericScore
Description	Gets the lowest number in a numeric grading system.
Return	`decimal`		the lowest number
Errors	ILLEGAL_STATE		`isBasedOnGrades()` is `true`
Compliance	`mandatory`		This method must be implemented.
Method	getNumericScoreIncrement
Description	Gets the incremental step.
Return	`decimal`		the increment
Errors	ILLEGAL_STATE		`isBasedOnGrades()` is `true`
Compliance	`mandatory`		This method must be implemented.
Method	getHighestNumericScore
Description	Gets the highest number in a numeric grading system.
Return	`decimal`		the highest number
Errors	ILLEGAL_STATE		`isBasedOnGrades()` is `true`
Compliance	`mandatory`		This method must be implemented.
Method	getGradeSystemRecord
Description	Gets the grade system record corresponding to the given `GradeSystem` record `Type.` This method is used to retrieve an object implementing the requested record. The `gradeSystemRecordType` may be the `Type` returned in `getRecordTypes()` or any of its parents in a `Type` hierarchy where `hasRecordType(gradeSystemRecordType)` is `true` .
Parameters	`osid.type.Type`	`gradeSystemRecordType`	the type of the record to retrieve
Return	`osid.grading.records.GradeSystemRecord`		the grade system record
Errors	NULL_ARGUMENT		`gradeSystemRecordType` is `null`
	OPERATION_FAILED		unable to complete request
	UNSUPPORTED		`hasRecordType(gradeSystemRecordType)` is `false`
Compliance	`mandatory`		This method must be implemented.