OSID - osid.personnel.AppointmentForm Service Interface Definition

Interface	osid.personnel.AppointmentForm
Implements	`osid.OsidRelationshipForm`
Implemented By	`osid.personnel.batch.AppointmentBatchForm`
Used By	`osid.personnel.AppointmentAdminSession`
Description	This is the form for creating and updating `Appointment` objects. Like all `OsidForm` objects, various data elements may be set here for use in the create and update methods in the `AppointmentAdminSession`. For each data element that may be set, metadata may be examined to provide display hints or data constraints.
Method	getCommitmentMetadata
Description	Gets the metadata for a required commitment.
Return	`osid.Metadata`		metadata for the required commitment
Compliance	`mandatory`		This method must be implemented.
Method	setCommitment
Description	Sets the required commitment percentage (0-100).
Parameters	`cardinal`	`commitment`	the required commitment
Errors	INVALID_ARGUMENT		`commitment` is invalid
Errors	NO_ACCESS		`Metadata.isReadOnly()` is `true`
Compliance	`mandatory`		This method must be implemented.
Method	clearCommitment
Description	Clears the required commitment.
Errors	NO_ACCESS		`Metadata.isRequired()` or `Metadata.isReadOnly()` is `true`
Compliance	`mandatory`		This method must be implemented.
Method	getTitleMetadata
Description	Gets the metadata for a title.
Return	`osid.Metadata`		metadata for the title
Compliance	`mandatory`		This method must be implemented.
Method	setTitle
Description	Sets the title.
Parameters	`string`	`title`	the title
Errors	INVALID_ARGUMENT		`title` is invalid
	NO_ACCESS		`Metadata.isReadOnly()` is `true`
	NULL_ARGUMENT		`title` is null
Compliance	`mandatory`		This method must be implemented.
Method	clearTitle
Description	Clears the title.
Errors	NO_ACCESS		`Metadata.isRequired()` or `Metadata.isReadOnly()` is `true`
Compliance	`mandatory`		This method must be implemented.
Method	getSalaryMetadata
Description	Gets the metadata for a salary.
Return	`osid.Metadata`		metadata for the salary
Compliance	`mandatory`		This method must be implemented.
Method	setSalary
Description	Sets the salary.
Parameters	`osid.financials.Currency`	`salary`	the slary
Errors	INVALID_ARGUMENT		`salary` is invalid
	NO_ACCESS		`Metadata.isReadOnly()` is `true`
	NULL_ARGUMENT		`salary` is null
Compliance	`mandatory`		This method must be implemented.
Method	clearLowSalaryRange
Description	Clears the salary.
Errors	NO_ACCESS		`Metadata.isRequired()` or `Metadata.isReadOnly()` is `true`
Compliance	`mandatory`		This method must be implemented.
Method	getAppointmentFormRecord
Description	Gets the `AppointmentFormRecord` interface corresponding to the given appointment record `Type`.
Parameters	`osid.type.Type`	`appointmentRecordType`	the appointment record type
Return	`osid.personnel.records.AppointmentFormRecord`		the 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.