OSID - osid.personnel.Appointment Service Interface Definition

Interface	osid.personnel.Appointment
Implements	`osid.OsidRelationship`
Used By	`osid.personnel.AppointmentAdminSession`
	`osid.personnel.AppointmentList`
	`osid.personnel.AppointmentLookupSession`
Description	An `Appointment` relates a `Position` to a `Position`.
Method	getPersonId
Description	Gets the `Id` of the person.
Return	`osid.id.Id`		the person `Id`
Compliance	`mandatory`		This method must be implemented.
Method	getPerson
Description	Gets the person in this appointment.
Return	`osid.personnel.Person`		the `Person`
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	getPositionId
Description	Gets the `Id` of the position in this appointment.
Return	`osid.id.Id`		the `Position` `Id`
Compliance	`mandatory`		This method must be implemented.
Method	getPosition
Description	Gets the position in this appointment.
Return	`osid.personnel.Position`		the `Position`
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	getCommitment
Description	Gets the percentage commitment (0-100).
Return	`cardinal`		the percentage commitment
Compliance	`mandatory`		This method must be implemented.
Method	getTitle
Description	Gets the title for this appointment.
Return	`osid.locale.DisplayText`		the title
Compliance	`mandatory`		This method must be implemented.
Method	hasSalary
Description	Tests if a salary is available.
Return	`boolean`		`true` if a salary is available, `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	getSalary
Description	Gets the salary.
Return	`osid.financials.Currency`		the slaary
Errors	ILLEGAL_STATE		`hasSalary()` is `false`
Compliance	`mandatory`		This method must be implemented.
Method	getSalaryBasis
Description	Gets the basis in number of months per year.
Return	`cardinal`		the number of months
Errors	ILLEGAL_STATE		`hasSalary()` is `false`
Compliance	`mandatory`		This method must be implemented.
Method	getAppointmentRecord
Description	Gets the record corresponding to the given `Appointment` record `Type`. This method is used to retrieve an object implementing the requested record. The `appointmentRecordType` may be the `Type` returned in `getRecordTypes()` or any of its parents in a `Type` hierarchy where `hasRecordType(appointmentRecordType)` is `true`.
Parameters	`osid.type.Type`	`appointmentRecordType`	the type of appointment record to retrieve
Return	`osid.personnel.records.AppointmentRecord`		the appointment record
Errors	NULL_ARGUMENT		`appointmentRecordType` is `null`
	OPERATION_FAILED		unable to complete request
	UNSUPPORTED		`hasRecordType(appointmentRecordType)` is `false`
Compliance	`mandatory`		This method must be implemented.