Global Absence Vesting Period
The Global Absence Vesting Period fast formula can be used to enforce a custom vesting period (a period during which the Worker is enrolled into the plan and accrues balance but cannot use them) logic while defining an absence plan.
An organization might have a vesting period rule for new workers who are hired as Interns or Graduates that they need to complete 30 days of employment before they can use their vacation balance. Here the vesting period formula can be composed to look at the person type to determine the period applicable for the particular enrollment.
Configuration Point in HCM Cloud
If you have created this formula, you can attach this formula to the absence plan definition.
Navigation
- In the Absence Administration work area, click Absence Plans to open the Absence Plans page.
- On the Search Results section toolbar, click Create to open the Create Absence Plan dialog box.
- In the Plan Type field, select Accrual.
- Click Continue.
- On the Edit Absence Plan page Accruals tab, Accrual Attributes section, select Formula in the Accrual Vesting Rule field.
- Select the defined formula from the Vesting Period Formula field
Contexts
The following contexts are available in this formula type:
| Context Name | Data Type |
|---|---|
| ABSENCE_ENTRY_ID | Number |
| ABSENCE_TYPE_ID | Number |
| ACCRUAL_PLAN_ID | Number |
| DATE_EARNED | Date |
| EFFECTIVE_DATE | Date |
| END_DATE | Date |
| ENTERPRISE_ID | Number |
| HR_ASSIGNMENT_ID | Number |
| HR_RELATIONSHIP_ID | Number |
| HR_TERM_ID | Number |
| JOB_ID | Number |
| LEGAL_EMPLOYER_ID | Number |
| LEGISLATIVE_DATA_GROUP_ID | Number |
| ORGANIZATION_ID | Number |
| PAYROLL_ASSIGNMENT_ID | Number |
| PAYROLL_ID | Number |
| PAYROLL_RELATIONSHIP_ID | Number |
| PAYROLL_TERM_ID | Number |
| PERSON_ID | Number |
| START_DATE | Date |
Input Values
| Variable Name | Data Type | Description |
|---|---|---|
| IV_ACCRUAL | Number | Accrual value received from the accrual matrix |
| IV_CARRYOVER | Number | Carryover limit received from accrual matrix |
| IV_CEILING | Number | Ceiling limit received from the accrual matrix |
| IV_ACCRUAL_CEILING | Number | Annual accrual limit from the accrual matrix |
| IV_ACCRUALPERIODSTARTDATE | Date | Start date of accrual period |
| IV_ACCRUALPERIODENDDATE | Date | End date of accrual period |
| IV_CALEDARSTARTDATE | Date | Start date of accrual calendar year |
| IV_CALEDARENDDATE | Date | End date of accrual calendar year |
| IV_PLANENROLLMENTSTARTDATE | Date | Start date of enrollment |
| IV_PLANENROLLMENTENDDATE | Date | End date of enrollment |
Return Variables
| Variable Name | Data Type | Description |
|---|---|---|
| vestingUOM | Text | Unit of measure for the vesting period duration. UoM can be Calendar Days (‘C’), Weeks (‘W’), Months (‘M’) or Years (‘Y') |
| vestingUnits | Number | Period for which time-off is accrued, but cannot be used by worker. |
Sample Formula
Requirement: The organization has a vesting rule which allows newly joined interns and graduates to avail their vacation balance only after 30 days from enrollment into the plan.
Solution: A Global Absence Vesting Period formula such as the one below can be used.
FORMULA NAME: ANC_VESTPRD
FORMULA TYPE: Global Absence Vesting Period
DESCRIPTION: This formula calculates and returns the vesting period duration for the vacation plan
DEFAULT FOR PER_ASG_USER_PERSON_TYPE IS 'Worker'
vestingUOM = 'C'
vestingUnits = 0
IF (PER_ASG_USER_PERSON_TYPE != 'Worker')
THEN
(
vestingUOM = 'C'
vestingUnits=30
)
RETURN vestingUOM,vestingUnits