org.osid.personnel

Interface Position

All Superinterfaces:

Browsable, Extensible, Identifiable, OsidObject, Subjugateable, Temporal

public interface Position
extends OsidObject, Temporal, Subjugateable

A Position in an Organization.

Method Summary

Methods

Modifier and Type	Method and Description
Type	getBenefitsType() Gets the benefits Type assoicated with this position.
Duration	getCompensationFrequency() Gets the frequency of compensation.
Currency	getHighSalaryRange() Gets the high end of the salary range.
Grade	getLevel() Gets the grade level for this position.
Id	getLevelId() Gets the Id of the job level.
Currency	getLowSalaryRange() Gets the low end of the salary range.
Currency	getMidpointSalaryRange() Gets the midpoint of the salary range.
Organization	getOrganization() Gets the organization for this position.
Id	getOrganizationId() Gets the Id of the organization to which this position is assigned.
PositionRecord	getPositionRecord(Type positionRecordType) Gets the record corresponding to the given Position record Type.
IdList	getQualificationIds() Gets the qualifcation Ids.
ObjectiveList	getQualifications() Gets the list of qualifications required for this position.
long	getRequiredCommitment() Gets the required percentage commitment (0-100).
long	getTargetAppointments() Gets the target number of Appointments desired for this Position.
DisplayText	getTitle() Gets the title for this position.
boolean	hasBenefits() Tests if this position is eligible for benefits.
boolean	hasQualifications() Tests if qualifications are avilable for this position.
boolean	hasSalaryRange() Tests if a salary range is available.
boolean	isExempt() Tests if this position is FLSA exempt.

Methods inherited from interface org.osid.OsidObject

getDescription, getDisplayName, getGenusType, isOfGenusType

Methods inherited from interface org.osid.Identifiable

getId, isCurrent

Methods inherited from interface org.osid.Extensible

getRecordTypes, hasRecordType

Methods inherited from interface org.osid.Browsable

getProperties, getPropertiesByRecordType

Methods inherited from interface org.osid.Temporal

getEndDate, getStartDate, isEffective

Method Detail

getOrganizationId

Id getOrganizationId()

Gets the Id of the organization to which this position is assigned.

Returns:

the Organization Id

Compliance:

mandatory - This method must be implemented.

getOrganization

Organization getOrganization()
                             throws OperationFailedException

Gets the organization for this position.

Returns:

the Organization

Throws:

OperationFailedException - unable to complete request

Compliance:

mandatory - This method must be implemented.

getTitle

DisplayText getTitle()

Gets the title for this position.

Returns:

the position title

Compliance:

mandatory - This method must be implemented.

getLevelId

Id getLevelId()

Gets the Id of the job level.

Returns:

the Grade Id

Compliance:

mandatory - This method must be implemented.

getLevel

Grade getLevel()
               throws OperationFailedException

Gets the grade level for this position.

Returns:

the Grade

Throws:

OperationFailedException - unable to complete request

Compliance:

mandatory - This method must be implemented.

hasQualifications

boolean hasQualifications()

Tests if qualifications are avilable for this position.

Returns:

true if qualifications are available, false otherwise

Compliance:

mandatory - This method must be implemented.

getQualificationIds

IdList getQualificationIds()

Gets the qualifcation Ids.

Returns:

a list of objective Ids

Throws:

IllegalStateException - hasQualifications() is false

Compliance:

mandatory - This method must be implemented.

getQualifications

ObjectiveList getQualifications()
                                throws OperationFailedException

Gets the list of qualifications required for this position.

Returns:

the Objectives

Throws:

IllegalStateException - hasQualifications() is false

OperationFailedException - unable to complete request

Compliance:

mandatory - This method must be implemented.

getTargetAppointments

long getTargetAppointments()

Gets the target number of Appointments desired for this Position.

Returns:

the number of appointments

Compliance:

mandatory - This method must be implemented.

getRequiredCommitment

long getRequiredCommitment()

Gets the required percentage commitment (0-100).

Returns:

the required percentage commitment

Compliance:

mandatory - This method must be implemented.

hasSalaryRange

boolean hasSalaryRange()

Tests if a salary range is available.

Returns:

true if a salary range is available, false otherwise

Compliance:

mandatory - This method must be implemented.

getLowSalaryRange

Currency getLowSalaryRange()

Gets the low end of the salary range.

Returns:

the low slaary

Throws:

IllegalStateException - hasSalaryRange() is false

Compliance:

mandatory - This method must be implemented.

getMidpointSalaryRange

Currency getMidpointSalaryRange()

Gets the midpoint of the salary range.

Returns:

the midpoint slaary

Throws:

IllegalStateException - hasSalaryRange() is false

Compliance:

mandatory - This method must be implemented.

getHighSalaryRange

Currency getHighSalaryRange()

Gets the high end of the salary range.

Returns:

the high slaary

Throws:

IllegalStateException - hasSalaryRange() is false

Compliance:

mandatory - This method must be implemented.

getCompensationFrequency

Duration getCompensationFrequency()

Gets the frequency of compensation.

Returns:

the frequency

Throws:

IllegalStateException - hasSalaryRange() is false

Compliance:

mandatory - This method must be implemented.

isExempt

boolean isExempt()

Tests if this position is FLSA exempt.

Returns:

true if this position is exempt, false is non-exempt

Compliance:

mandatory - This method must be implemented.

hasBenefits

boolean hasBenefits()

Tests if this position is eligible for benefits.

Returns:

true if this position has benefits, false otherwise

Compliance:

mandatory - This method must be implemented.

getBenefitsType

Type getBenefitsType()

Gets the benefits Type assoicated with this position.

Returns:

the benefits type

Throws:

IllegalStateException - hasBenefits() is false

Compliance:

mandatory - This method must be implemented.

getPositionRecord

PositionRecord getPositionRecord(Type positionRecordType)
                                 throws OperationFailedException

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:

positionRecordType - the type of position record to retrieve

Returns:

the position record

Throws:

NullArgumentException - positionRecordType is null

OperationFailedException - unable to complete request

UnsupportedException - hasRecordType(positionRecordType) is false

Compliance:

mandatory - This method must be implemented.