OSID - osid.recognition.Conferral Service Interface Definition

Interface	osid.recognition.Conferral
Implements	`osid.OsidRelationship`
Used By	`osid.recognition.ConferralAdminSession`
	`osid.recognition.ConferralList`
	`osid.recognition.ConferralLookupSession`
Description	A `Conferral` represents an `Award` conferred to a `Recipient` for something (reference). Often, an award is conferred for a body of work. The body of work may be represented by another `OsidObject`, such as an `Asset` or an `Assessment` may be related using an `Id`. The recipiens is the `Resource` to whom the award is addressed is often the producer or creator of the work. In some instances, the `Resource` and the reference may be one in the same.
Method	getAwardId
Description	Gets the `Id` of the subscriber's award.
Return	`osid.id.Id`		the subscriber `Id`
Compliance	`mandatory`		This method must be implemented.
Method	getAward
Description	Gets the subscriber's award.
Return	`osid.recognition.Award`		the subscriber's award.
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	getRecipientId
Description	Gets the `Id` of the recipient.
Return	`osid.id.Id`		the resource `Id`
Compliance	`mandatory`		This method must be implemented.
Method	getRecipient
Description	Gets the recipient (e.g. Samuel Goldwyn).
Return	`osid.resource.Resource`		the resource
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	hasReference
Description	Tests if the was conferred for a reference object.
Return	`boolean`		`true` if a reference exists, `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	getReferenceId
Description	Gets the `Id` of the reference (e.g. "Best Years of Our Lives").
Return	`osid.id.Id`		the reference `Id`
Errors	ILLEGAL_STATE		`hasReference()` is `false`
Compliance	`mandatory`		This method must be implemented.
Method	hasConvocation
Description	Tests if the award was conferred as part of a convocation.
Return	`boolean`		`true` if a convocation exists, `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	getConvocationId
Description	Gets the `Id` of the convocation.
Return	`osid.id.Id`		the convocation `Id`
Errors	ILLEGAL_STATE		`hasConvocation()` is `false`
Compliance	`mandatory`		This method must be implemented.
Method	getConvocation
Description	Gets the convocation (e.g. 19th Academy Awards for the time period 1946).
Return	`osid.recognition.Convocation`		the convocation
Errors	ILLEGAL_STATE		`hasConvocation()` is `false`
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	getConferralRecord
Description	Gets the conferral record corresponding to the given `Conferral` record `Type`. This method is used to retrieve an object implementing the requested record. The `conferralRecordType` may be the `Type` returned in `getRecordTypes()` or any of its parents in a `Type` hierarchy where `hasRecordType(conferralRecordType)` is `true`.
Parameters	`osid.type.Type`	`conferralRecordType`	the type of conferral record to retrieve
Return	`osid.recognition.records.ConferralRecord`		the conferral record
Errors	NULL_ARGUMENT		`conferralRecordType` is `null`
	OPERATION_FAILED		unable to complete request
	UNSUPPORTED		`hasRecordType(conferralRecordType)` is `false`
Compliance	`mandatory`		This method must be implemented.