org.kuali.kfs.module.bc.service
Interface BudgetConstructionPositionService

All Known Implementing Classes:

BudgetConstructionPositionServiceImpl

public interface BudgetConstructionPositionService

Provides methods to retrieve and populate budget construction position records.

Method Summary

BudgetConstructionPosition	getByPrimaryId(String fiscalYear, String positionNumber) retrieve a Budget Construction Position object by its primary key.
boolean	isBudgetablePosition(BudgetConstructionPosition budgetConstructionPosition) determine whether the given position is budgetable (valid, active and budgeted)
void	pullNewPositionFromExternal(Integer universityFiscalYear, String positionNumber) Retrieves a new position record from an external system using HumanResourcesPayrollService then populates the record in the budget position table.
void	refreshPositionFromExternal(Integer universityFiscalYear, String positionNumber) Refreshes a position record from an external system using HumanResourcesPayrollService then updates the record in the budget position table.

Method Detail

pullNewPositionFromExternal

void pullNewPositionFromExternal(Integer universityFiscalYear,
                                 String positionNumber)
                                 throws BudgetPositionAlreadyExistsException

Retrieves a new position record from an external system using HumanResourcesPayrollService then populates the record in the budget position table.

Parameters:

universityFiscalYear - budget fiscal year for the position

positionNumber - position number for the record

Throws:

BudgetPositionAlreadyExistsException - thrown when position is already in the budget table

PositionLockNotObtainedException - thrown when the position and associated funding locks could not be obtained

refreshPositionFromExternal

void refreshPositionFromExternal(Integer universityFiscalYear,
                                 String positionNumber)

Refreshes a position record from an external system using HumanResourcesPayrollService then updates the record in the budget position table.

Parameters:

universityFiscalYear - budget fiscal year for the position

positionNumber - position number for the record

getByPrimaryId

BudgetConstructionPosition getByPrimaryId(String fiscalYear,
                                          String positionNumber)

retrieve a Budget Construction Position object by its primary key.

Parameters:

fiscalYear - the given fiscal year

positionNumber - the given position number

Returns:

a Budget Construction Position object retrived by its primary key

isBudgetablePosition

boolean isBudgetablePosition(BudgetConstructionPosition budgetConstructionPosition)

determine whether the given position is budgetable (valid, active and budgeted)

Parameters:

budgetConstructionPosition - the given position

Returns:

true if the given position is budgetable; otherwise, false