Delivered Elements Naming Convention
This section discusses:
Element names.
Functional area codes.
Element type codes (PIN_TYPE).
Viewing delivered elements.
One of the keys to understanding how delivered payroll elements function in the system is to understand their names. Understanding the naming convention developed for PeopleSoft-delivered elements can help you determine how an element is used, the element type, and even the functional area it serves. Depending on whether the element is a primary element, a component of a primary element, or a supporting element, one of the following naming conventions applies.
Supporting Elements
For supporting elements, such as variables, formulas, dates, durations, and so on, PeopleSoft uses the following naming convention: FFF (or FF) TT NAME.
FFF (or FF): Functional Area Code (see Functional Area Codes for more information).
TT: Type of Supporting Element (see List Element Type Codes (PIN_TYPE) for more information).
NAME (or NAME NAME): An indication of what the element does or is for. (The number of NAME components may vary.)
For example, in the MPF variable MPF VR START DATE, MPF stands for Mandatory Provident Fund, VR stands for variable and START DATE stands for start date. The element's thirty character (maximum) description (DESCR) provides a fuller explanation of what the element does or is for.
Primary Elements
Primary elements, such as earnings, deductions, absence take, and absence entitlement elements often do not contain functional area codes or element type codes in their names. This is because primary elements have names, based on Hong Kong terms, that identify their function and element type without the use of additional codes. For example, the name of the earning element 13MTHPAY clearly identifies this element as an earning, and more specifically, as a thirteenth month (13MTH) payment (PAY).
Additional Clues to the Use of Hong Kong Elements
Many Hong Kong elements contain abbreviations that provide clues (beyond those provided by the functional area codes or element type codes) to their use in the system. For example, consider the following duration element: TER DR DY IN SERV. The functional area code TER indicates that this element is used for termination elements, and the element type code DR identifies it as a duration element. The abbreviations DY, IN and SERV provide additional clues about how the element measures periods of time. The duration is in days (DY) in (IN) service (SERV). As you become more familiar with the payroll rules created for Hong Kong, these abbreviations will help you to further identify and understand the role played by each element.
The following table lists the most common abbreviations used in the names of Hong Kong elements.
Abbreviation |
English |
---|---|
AC |
Accumulator |
ADV |
Advance |
ALLOW |
Allowance |
AMT |
Amount |
ANNIV |
Anniversary |
BAL |
Balance |
BAS |
Basic |
CAL |
Calendar |
CNTR |
Contract |
COMCHST |
Community Chest |
COMP |
Compassion |
CUR |
Current |
DED |
Deductions |
DY |
Days |
ED |
Education |
EE / EMP |
Employee |
ELIG |
Eligibility |
ENT |
Entitlement |
ER |
Employer |
ERN |
Earnings |
EXT |
Extract |
FCAST |
Forecast |
GENL |
General |
HOL |
Holiday |
HLY |
Hourly |
INCM |
Income |
LSP |
Long service payment |
LWOP |
Leave without pay |
MARR |
Marriage |
MAT |
Maternity |
MAX |
Maximum |
MIN |
Minimum |
MN |
Mandatory |
MSG |
Message |
MTD |
Month to date |
MTH |
Month |
PERM |
Permitted |
PRD |
Period |
PREV |
Previous |
PRIM |
Primary |
REG |
Regular |
REVLNT |
Relevant |
ROLLAVG |
Rolling average |
RSLV |
Resolve |
SAL |
Salary |
STAT |
Statutory |
SVC / SERV |
Service |
TOT |
Total |
TX |
Tax |
VOL |
Voluntary |
YR |
Year |
YTD |
Year to date |
Component Names (Suffixes)
In Global Payroll for Hong Kong, suffixes are used to name the components of earning and deduction elements. For example, when you create an earning or deduction element in Global Payroll, you define the components that make up the element, such as base, rate, unit, and percentage. The system automatically generates the components and accumulators for the element based on the calculation rule or accumulator periods. The system also names the components and accumulators by appending a suffix to the element's name.
For example, let's say you define the earning element named EARN1 with the following calculation rule:
EARN1 = Rate x Unit
The system automatically creates two additional elements for the components in the calculation rule: a rate element called EARN1_RATE and a unit element called EARN1_UNIT. In Global Payroll for Hong Kong, all suffixes fall into one of the following types:
Separator.
Earnings and deductions and absence entitlement component suffixes.
Earnings and deductions and absence entitlement accumulator suffixes.
Deduction arrears component suffixes.
Deduction arrears accumulator suffixes.
Recipient suffixes.
Note: To view the suffixes used for Hong Kong, navigate to
The following table contains the functional area codes used in the names of Hong Kong elements:
Functional Area Code |
Description |
---|---|
ABS |
Absence |
ALV |
Annual leave |
CM |
Areas common to multiple functional areas |
DED |
Deductions |
ERN |
Earnings |
IRR |
Inland Revenue Reporting |
MLV |
Maternity Leave |
MPF |
Mandatory Provident Fund |
NPL |
No pay leave |
OLV |
Other leave |
PSLP |
Payslips |
SLV |
Sick leave |
TER |
Terminations |
Many element types, particularly supporting elements, are identified by the type code in their name. For example, the FM in MPF FM POST EEMN1 identifies the element as a formula.
You can see all the element types in the search page when you navigate to
Because not all element types are delivered for Hong Kong, not all of these codes appear in the names of Hong Kong elements.PeopleSoft delivers a query that you can run to view the names of all delivered elements designed for Hong Kong. Instructions for running the query are provided in the PeopleSoft HCM: Global Payroll.