OSID - osid.learning.Proficiency Service Interface Definition

Interface	osid.learning.Proficiency
Implements	`osid.OsidRelationship`
Used By	`osid.learning.ProficiencyAdminSession`
	`osid.learning.ProficiencyList`
	`osid.learning.ProficiencyLookupSession`
Description	A `Proficiency` represents a competency of a leraning objective.
Method	getResourceId
Description	Gets the resource `Id` to whom this proficiency applies.
Return	`osid.id.Id`		the resource `Id`
Compliance	`mandatory`		This method must be implemented.
Method	getResource
Description	Gets the resource to whom this proficiency applies.
Return	`osid.resource.Resource`		the resource
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	getObjectiveId
Description	Gets the objective `Id` to whom this proficiency applies.
Return	`osid.id.Id`		the objective `Id`
Compliance	`mandatory`		This method must be implemented.
Method	getObjective
Description	Gets the objective to whom this proficiency applies.
Return	`osid.learning.Objective`		the objective
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	getCompletion
Description	Gets the completion of this objective as a percentage 0-100.
Return	`decimal`		the completion
Compliance	`mandatory`		This method must be implemented.
Method	hasLevel
Description	Tests if a proficiency level is available.
Return	`boolean`		`true` if a level is available, `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	getLevelId
Description	Gets the proficiency level expressed as a grade.
Return	`osid.id.Id`		the grade `Id`
Errors	ILLEGAL_STATE		`hasLevel()` is `false`
Compliance	`mandatory`		This method must be implemented.
Method	getLevel
Description	Gets the proficiency level expressed as a grade.
Return	`osid.grading.Grade`		the grade
Errors	ILLEGAL_STATE		`hasLevel()` is `false`
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	getProficiencyRecord
Description	Gets the proficiency record corresponding to the given `Proficiency` record `Type`. This method is used to retrieve an object implementing the requested record. The `proficiencyRecordType` may be the `Type` returned in `getRecordTypes()` or any of its parents in a `Type` hierarchy where `hasRecordType(proficiencyRecordType)` is `true`.
Parameters	`osid.type.Type`	`proficiencyRecordType`	the type of proficiency record to retrieve
Return	`osid.learning.records.ProficiencyRecord`		the proficiency record
Errors	NULL_ARGUMENT		`proficiencyRecordType` is `null`
	OPERATION_FAILED		unable to complete request
	UNSUPPORTED		`hasRecordType(proficiencyRecordType)` is `false`
Compliance	`mandatory`		This method must be implemented.