OSID - osid.personnel.Position Service Interface Definition

Interface	osid.personnel.Position
Implements	`osid.OsidObject`
	`osid.Temporal`
	`osid.Subjugateable`
Used By	`osid.personnel.Appointment`
	`osid.personnel.PositionAdminSession`
	`osid.personnel.PositionList`
	`osid.personnel.PositionLookupSession`
Description	A `Position` in an `Organization`.
Method	getOrganizationId
Description	Gets the `Id` of the organization to which this position is assigned.
Return	`osid.id.Id`		the `Organization` `Id`
Compliance	`mandatory`		This method must be implemented.
Method	getOrganization
Description	Gets the organization for this position.
Return	`osid.personnel.Organization`		the `Organization`
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	getTitle
Description	Gets the title for this position.
Return	`osid.locale.DisplayText`		the position title
Compliance	`mandatory`		This method must be implemented.
Method	getLevelId
Description	Gets the `Id` of the job level.
Return	`osid.id.Id`		the `Grade` `Id`
Compliance	`mandatory`		This method must be implemented.
Method	getLevel
Description	Gets the grade level for this position.
Return	`osid.grading.Grade`		the `Grade`
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	hasQualifications
Description	Tests if qualifications are avilable for this position.
Return	`boolean`		`true` if qualifications are available, `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	getQualificationIds
Description	Gets the qualifcation Ids.
Return	`osid.id.IdList`		a list of objective `Ids`
Errors	ILLEGAL_STATE		`hasQualifications()` is `false`
Compliance	`mandatory`		This method must be implemented.
Method	getQualifications
Description	Gets the list of qualifications required for this position.
Return	`osid.learning.ObjectiveList`		the `Objectives`
Errors	ILLEGAL_STATE		`hasQualifications()` is `false`
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	getTargetAppointments
Description	Gets the target number of `Appointments` desired for this `Position`.
Return	`cardinal`		the number of appointments
Compliance	`mandatory`		This method must be implemented.
Method	getRequiredCommitment
Description	Gets the required percentage commitment (0-100).
Return	`cardinal`		the required percentage commitment
Compliance	`mandatory`		This method must be implemented.
Method	hasSalaryRange
Description	Tests if a salary range is available.
Return	`boolean`		`true` if a salary range is available, `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	getLowSalaryRange
Description	Gets the low end of the salary range.
Return	`osid.financials.Currency`		the low slaary
Errors	ILLEGAL_STATE		`hasSalaryRange()` is `false`
Compliance	`mandatory`		This method must be implemented.
Method	getMidpointSalaryRange
Description	Gets the midpoint of the salary range.
Return	`osid.financials.Currency`		the midpoint slaary
Errors	ILLEGAL_STATE		`hasSalaryRange()` is `false`
Compliance	`mandatory`		This method must be implemented.
Method	getHighSalaryRange
Description	Gets the high end of the salary range.
Return	`osid.financials.Currency`		the high slaary
Errors	ILLEGAL_STATE		`hasSalaryRange()` is `false`
Compliance	`mandatory`		This method must be implemented.
Method	getCompensationFrequency
Description	Gets the frequency of compensation.
Return	`osid.calendaring.Duration`		the frequency
Errors	ILLEGAL_STATE		`hasSalaryRange()` is `false`
Compliance	`mandatory`		This method must be implemented.
Method	isExempt
Description	Tests if this position is FLSA exempt.
Return	`boolean`		`true` if this position is exempt, `false` is non-exempt
Compliance	`mandatory`		This method must be implemented.
Method	hasBenefits
Description	Tests if this position is eligible for benefits.
Return	`boolean`		`true` if this position has benefits, `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	getBenefitsType
Description	Gets the benefits Type assoicated with this position.
Return	`osid.type.Type`		the benefits type
Errors	ILLEGAL_STATE		`hasBenefits()` is `false`
Compliance	`mandatory`		This method must be implemented.
Method	getPositionRecord
Description	Gets the record corresponding to the given `Position` record `Type`.This method is used to retrieve an object implementing the requested record. The `positionRecordType` may be the `Type` returned in `getRecordTypes()` or any of its parents in a `Type` hierarchy where `hasRecordType(positionRecordType)` is `true`.
Parameters	`osid.type.Type`	`positionRecordType`	the type of position record to retrieve
Return	`osid.personnel.records.PositionRecord`		the position record
Errors	NULL_ARGUMENT		`positionRecordType` is `null`
	OPERATION_FAILED		unable to complete request
	UNSUPPORTED		`hasRecordType(positionRecordType)` is `false`
Compliance	`mandatory`		This method must be implemented.