Element Naming Conventions in Spain
Understanding the naming convention that is developed for Oracle-delivered elements can help you determine the element type, the functional area it serves, and how it is used.
This topic discusses:
Naming conventions.
Functional area codes.
Element type codes (PIN_TYPE).
This topic discusses:
Primary elements.
Supporting elements.
Additional clues to the use of Spanish elements.
Component names (suffixes).
Primary Elements
Primary elements (such as earnings, deductions, absence take, and absence entitlement elements) do not contain functional area codes or element type codes in their names. Primary elements have names that identify their functions and element types without the use of additional codes. For example, the name of the earning element SALARIO BASE identifies this element as a base salary element.
Supporting Elements
For supporting elements (such as variables, formulas, dates, and durations), Oracle uses this naming convention: FFF TT NAME.
FFF: Functional area code.
TT: Type of supporting element.
NAME: Based on a term in Spanish and provides a further means of identifying the element.
For example, in the tax array TAX AR ING A EST:
TAX represents the functional area (taxes).
AR represents the element type (array).
ING A EST (ingresos anuales estimados) represents a further means of identifying the element.
Note: This naming convention applies to these element types: accumulators, arrays, brackets, counts, dates, durations, formulas, rate codes, variables, historical rules, fictitious calculation rules, proration rules, rounding rules, writable arrays, and generation control conditions as well as sections and element groups.
Additional Clues to the Use of Spanish Elements
Many Spanish elements contain abbreviations that provide clues to their use in the system (beyond those provided by the functional area codes or element type codes). For example, these duration elements have been defined for Spain: GEN DR PERIODO D, GEN DR PERIODO M, and GEN DR PERIODO A. While the functional area code GEN indicates that these elements are used across various functional areas (they have general relevance), and the element type code DR identifies them as duration elements, the abbreviations D, M, and A provide additional clues to how each element measures time. The duration element GEN DR PERIODO D measures time in days (dias) , hence the D in the element's name. Likewise, the code M reveals that the element GEN DR PERIODO M measures time in months (meses). As you become more familiar with the payroll rules created for Spain, these abbreviations will help you to further identify and understand the role played by each element.
This table lists the most common abbreviations used in the names of Spanish elements.
Abbreviations Used in PeopleSoft Global Payroll for Spain |
English Equivalent |
---|---|
A |
Years or annual |
BS |
Base |
CC |
Common contingencies |
CP |
Professional contingencies |
CT |
Tax quota |
D |
Days |
DD |
Deductions |
DEV |
Earnings |
DIN |
Income |
EX |
Exempt |
M |
Months or monthly |
MN |
Minimum |
MX |
Maximum |
N |
Number and negation |
S |
Segment |
SPC |
In kind |
T |
Total and quarterly |
TP |
Ceiling |
U |
Unit |
Component Names (Suffixes)
In PeopleSoft Global Payroll for Spain, suffixes are used to name the components of earnings and deduction elements. For example, when you create an earning, deduction, or absence element in Global Payroll, you must 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 that are used. The system also names the components and accumulators by appending a suffix to the element's name.
For example, suppose that you define the earning element named EARN1 with this calculation rule:
EARN1 = Rate × Unit
The system automatically creates two additional elements for the components in the calculation rule:
Rate element: EARN1_RATE.
Unit element: EARN1_UNIT.
The system creates suffixes to name the components of the element (_RATE and _UNIT).
In PeopleSoft Global Payroll for Spain, all components and accumulators have:
Country: ESP
Separator: _
In Global Payroll, all suffixes fall into one of these types:
Separator.
Earnings or deductions component suffixes.
Earnings or deductions accumulator suffixes.
Deduction arrears component suffixes.
Deduction arrears accumulator suffixes.
Absence entitlement component suffixes.
Absence entitlement accumulator suffixes.
To view all of the suffixes defined for Spain, use the Element Suffixes component (GP_SUFFIX) in Global Payroll .
For some elements, you need to use a functional area in the naming convention. The three-digit functional area codes are used in naming conventions to identify the functional area where the element is being used.
This table contains the functional area codes used in the names of Spanish elements:
Functional Area |
Description |
---|---|
AJB |
Gross to net |
AJN |
Net to gross |
ANT |
Seniority |
AUS |
Absences |
AYP |
Loans and advances |
CLI |
Customer-oriented accumulators |
FNQ |
Termination |
GEN |
General (multiple areas) |
RTR |
Retroactivity |
SIN |
Unions |
SS |
Social security |
TAX |
Taxes |
XTR |
Extra period |
DEV |
Devengos (earnings) |
DD |
Deduction |
EXP |
Expatriates |
LIQ |
Liquidation |
PP |
Pension plans |
This table contains codes for all of the element types. Because not all element types are delivered for Spain, not all of these codes appear in the names of Spanish elements:
Element Type |
Description |
---|---|
AE |
Absence entitlement |
AT |
Absence take |
AC |
Accumulator |
AR |
Array |
AA |
Auto assigned |
BR |
Bracket |
CT |
Count |
DT |
Date |
DD |
Deduction |
DR |
Duration |
ER |
Earning |
EG |
Element group |
EM |
Error message |
FC |
Fictitious calculation |
FM |
Formula |
GC |
Generation control |
HR |
Historical rule |
PR |
Process |
PO |
Proration rule |
RC |
Rate code |
RR |
Rounding rule |
SE |
Section |
SY |
System element |
VR |
Variable |
WA |
Writable array |