OSID - osid.resourcing.Commission Service Interface Definition

Interface	osid.resourcing.Commission
Implements	`osid.OsidRelationship`
Used By	`osid.resourcing.CommissionAdminSession`
	`osid.resourcing.CommissionList`
	`osid.resourcing.CommissionLookupSession`
	`osid.resourcing.Effort`
Description	A `Commission` represents a commitment of a resource for work. A commission may also specify a competency to qualify the work performed. The effective dates of the relationship specify the duration of the commission.
Method	getResourceId
Description	Gets the `Id` of the commissioned resource.
Return	`osid.id.Id`		the resource `Id`
Compliance	`mandatory`		This method must be implemented.
Method	getResource
Description	Gets the commissioned resource.
Return	`osid.resource.Resource`		the resource
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	getWorkId
Description	Gets the `Id` of the work.
Return	`osid.id.Id`		the work `Id`
Compliance	`mandatory`		This method must be implemented.
Method	getWork
Description	Gets the work.
Return	`osid.resourcing.Work`		the work
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	isCompetent
Description	Tests if a competency is specified for this commission.
Return	`boolean`		`true` if a competency is available, `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	getCompetencyId
Description	Gets the competency `Id`.
Return	`osid.id.Id`		the competency `Id`
Errors	ILLEGAL_STATE		`isCompetent()` is `false`
Compliance	`mandatory`		This method must be implemented.
Method	getCompetency
Description	Gets the competency.
Return	`osid.resourcing.Competency`		the competency
Errors	ILLEGAL_STATE		`isCompetent()` is `false`
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	getPercentage
Description	Gets the percentage commitment.
Return	`cardinal`		the percentage commitment
Compliance	`mandatory`		This method must be implemented.
Method	getCommissionRecord
Description	Gets the commission record corresponding to the given `Commission` record `Type`. This method is used to retrieve an object implementing the requested record. The `commissionRecordType` may be the `Type` returned in `getRecordTypes()` or any of its parents in a `Type` hierarchy where `hasRecordType(commissionRecordType)` is `true`.
Parameters	`osid.type.Type`	`commissionRecordType`	the type of commission record to retrieve
Return	`osid.resourcing.records.CommissionRecord`		the commission record
Errors	NULL_ARGUMENT		`commissionRecordType` is `null`
	OPERATION_FAILED		unable to complete request
	UNSUPPORTED		`hasRecordType(commissionRecordType)` is `false`
Compliance	`mandatory`		This method must be implemented.