OSID - osid.offering.Result Service Interface Definition

Interface	osid.offering.Result
Implements	`osid.OsidObject`
	`osid.Temporal`
	`osid.Subjugateable`
Description	An `Result` is an outcome from a `Participation.`
Method	getParticipantId
Description	Gets the `Id` of the participant in this result.
Return	`osid.id.Id`		the `Participant` `Id`
Compliance	`mandatory`		This method must be implemented.
Method	getParticipant
Description	Gets the participant in this result.
Return	`osid.offering.Participant`		the `Participant`
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	isGraded
Description	Tests if a grade or score has been assigned to this entry. Generally, an entry is created with a grade or score.
Return	`boolean`		`true` if a grade has been assigned, `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	getGradeId
Description	Gets the grade `Id` in this entry if the grading system is based on grades.
Return	`osid.id.Id`		the grade `Id`
Errors	ILLEGAL_STATE		`isGraded()` is `false` or `GradeSystem.isBasedOnGrades()` is `false`
Compliance	`mandatory`		This method must be implemented.
Method	getGrade
Description	Gets the grade in this entry if the grading system is based on grades.
Return	`osid.grading.Grade`		the grade
Errors	ILLEGAL_STATE		`isGraded()` is `false` or `GradeSystem.isBasedOnGrades()` is `false`
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	getValue
Description	Gets the value in this entry if the grading system is not based on grades.
Return	`decimal`		the value
Errors	ILLEGAL_STATE		`isGraded()` is `false` or `GradeSystem.isBasedOnGrades()` is `true`
Compliance	`mandatory`		This method must be implemented.
Method	getResultRecord
Description	Gets the record corresponding to the given `Result` record `Type.` This method is used to retrieve an object implementing the requested record. The `resultRecordType` may be the `Type` returned in `getRecordTypes()` or any of its parents in a `Type` hierarchy where `hasRecordType(resultRecordType)` is `true` .
Parameters	`osid.type.Type`	`resultRecordType`	the type of result record to retrieve
Return	`osid.offering.records.ResultRecord`		the result record
Errors	NULL_ARGUMENT		`resultRecordType` is `null`
	OPERATION_FAILED		unable to complete request
	UNSUPPORTED		`hasRecordType(resultRecordType)` is `false`
Compliance	`mandatory`		This method must be implemented.