OSID - osid.personnel.Person Service Interface Definition

Interface	osid.personnel.Person
Implements	`osid.OsidObject`
Description	A `Person.`
Method	getSalutation
Description	Gets the title for this person (Mr., Dr., Ms.).
Return	`osid.locale.DisplayText`		the title
Compliance	`mandatory`		This method must be implemented.
Method	getGivenName
Description	Gets the given name of this person.
Return	`osid.locale.DisplayText`		the given name
Compliance	`mandatory`		This method must be implemented.
Method	getPreferredName
Description	Gets the preferred forename or mononym of this person.
Return	`osid.locale.DisplayText`		the preferred name
Compliance	`mandatory`		This method must be implemented.
Method	getForenameAliases
Description	Gets additional forenames this person is or was known by.
Return	`osid.locale.DisplayText[]`		forname aliases
Compliance	`mandatory`		This method must be implemented.
Method	getMiddleNames
Description	Gets the middle names of this person.
Return	`osid.locale.DisplayText[]`		the middle names
Compliance	`mandatory`		This method must be implemented.
Method	getSurname
Description	Gets the surname of this person.
Return	`osid.locale.DisplayText`		the surname
Compliance	`mandatory`		This method must be implemented.
Method	getSurnameAliases
Description	Gets additional surnames this person is or was known by.
Return	`osid.locale.DisplayText[]`		the surname aliases
Compliance	`mandatory`		This method must be implemented.
Method	getGenerationQualifier
Description	Gets the generation qualifier of this person.
Return	`osid.locale.DisplayText`		the generation qualifier
Compliance	`mandatory`		This method must be implemented.
Method	getQualificationSuffix
Description	Gets the qualification suffix of this person (MD, Phd).
Return	`osid.locale.DisplayText`		the generation qualifier
Compliance	`mandatory`		This method must be implemented.
Method	hasBirthDate
Description	Tests if a birth date is available.
Return	`boolean`		`true` if a birth date is available, `false` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	getBirthDate
Description	Gets the date of birth for this person.
Return	`osid.calendaring.DateTime`		the date of birth
Errors	ILLEGAL_STATE		`hasBirthDate()` is `false`
Compliance	`mandatory`		This method must be implemented.
Method	isDeceased
Description	Tests if this person died.
Return	`boolean`		`true` if this person is dead, `false` if still kicking
Compliance	`mandatory`		This method must be implemented.
Method	getDeathDate
Description	Gets the date of death for this person.
Return	`osid.calendaring.DateTime`		the date of death
Errors	ILLEGAL_STATE		`isDead()` is `false`
Compliance	`mandatory`		This method must be implemented.
Method	getInstitutionalIdentifier
Description	Gets the institutional identifier for this person.
Return	`string`		the institutional identifier
Compliance	`mandatory`		This method must be implemented.
Method	getPersonRecord
Description	Gets the record corresponding to the given `Person` record `Type.` This method is used to retrieve an object implementing the requested record. The `personRecordType` may be the `Type` returned in `getRecordTypes()` or any of its parents in a `Type` hierarchy where `hasRecordType(personRecordType)` is `true` .
Parameters	`osid.type.Type`	`personRecordType`	the type of person record to retrieve
Return	`osid.personnel.records.PersonRecord`		the person record
Errors	NULL_ARGUMENT		`personRecordType` is `null`
	OPERATION_FAILED		unable to complete request
	UNSUPPORTED		`hasRecordType(personRecordType)` is `false`
Compliance	`mandatory`		This method must be implemented.