2. 2
Table of ContentsTable of Contents
Payroll TermsPayroll Terms
Important TablesImportant Tables
Tables Relationship and DescriptionTables Relationship and Description
Useful QueriesUseful Queries
Other Related TablesOther Related Tables
3. 3
ElementElement
Elements are simply the units used to build the earnings, deductionsElements are simply the units used to build the earnings, deductions
and benefits that can be given to an employee.and benefits that can be given to an employee.
Input ValueInput Value
Input Value is like a placeholder for holding the actual value of theInput Value is like a placeholder for holding the actual value of the
Element. An element can have more than one input value.Element. An element can have more than one input value.
Element LinkElement Link
Element Link is the one which links the element to employees. ThisElement Link is the one which links the element to employees. This
linking can be done by associating an element to a payroll and thenlinking can be done by associating an element to a payroll and then
associating that payroll to an employees assignment. An element canassociating that payroll to an employees assignment. An element can
also be linked to employee by Employment Category, Grade and Job.also be linked to employee by Employment Category, Grade and Job.
Element EntryElement Entry
When an element is assigned to employees assignment it is called asWhen an element is assigned to employees assignment it is called as
Element EntryElement Entry
Payroll TermsPayroll Terms
4. 4
Element Entry ValueElement Entry Value
The actual value of the element entryThe actual value of the element entry
Payroll ActionPayroll Action
Any payroll related action performed on employee’s assignment is referred to asAny payroll related action performed on employee’s assignment is referred to as
Payroll Action. It can be a Payroll Run, Quick-Pay, Pre-payments or PaymentsPayroll Action. It can be a Payroll Run, Quick-Pay, Pre-payments or Payments
Assignment ActionAssignment Action
This is a record of actions performed by the Payroll process on each and everyThis is a record of actions performed by the Payroll process on each and every
assignment.assignment.
Run ResultRun Result
This is the actual calculated result of the payroll process for each and everyThis is the actual calculated result of the payroll process for each and every
element entryelement entry
Run Result ValueRun Result Value
This is the actual calculated value of each and every input value of an element.This is the actual calculated value of each and every input value of an element.
Payroll Terms (contd.)Payroll Terms (contd.)
6. 6
Table Flow DiagramTable Flow Diagram
Per_all_people_f
Per_all_assignments_f
Pay_payroll_actions
Pay_assignment_actions
Pay_element_entries_f
Pay_element_entry_values_f
Pay_run_results
Pay_run_result_values
Pay_input_values_f
Pay_element_types_f
Pay_element_links_f
Payroll Processing
Element and Element
Link Definition
Elements Attached to Employees
Person_id Payroll_action_id
Assignment_action_id
Element_entry_id
Assignment_id
Run_result_id
Element_type_id
Element_type_id
Element_link_id
Assignment_id
Source_id
7. 7
Per_all_people_fPer_all_people_f
This table holds personal information for employees,This table holds personal information for employees,
applicants, ex-employees, ex-applicants, contacts andapplicants, ex-employees, ex-applicants, contacts and
other people.other people.
Key ColumnsKey Columns
PERSON_IDPERSON_ID System generatedSystem generated
EFFECTIVE_START_DATEEFFECTIVE_START_DATE Effective start dateEffective start date
EFFECTIVE_END_DATEEFFECTIVE_END_DATE Effective end dateEffective end date
PERSON_TYPE_IDPERSON_TYPE_ID Links toLinks to
PER_PERSON_TYPESPER_PERSON_TYPES
START_DATESTART_DATE Start date for theStart date for the
personperson
CURRENT_APPLICANT_FLAGCURRENT_APPLICANT_FLAG Yes or nullYes or null
CURRENT_EMP_OR_APL_FLAGCURRENT_EMP_OR_APL_FLAG Yes or nullYes or null
CURRENT_EMPLOYEE_FLAGCURRENT_EMPLOYEE_FLAG Yes or nullYes or null
DATE_OF_BIRTHDATE_OF_BIRTH Date of birthDate of birth
EMAIL_ADDRESSEMAIL_ADDRESS Holds actual emailHolds actual email
8. 8
Per_all_assignments_fPer_all_assignments_f
This table holds information about employee assignments likeThis table holds information about employee assignments like
his Job, Manager, Department, Payroll and his expensehis Job, Manager, Department, Payroll and his expense
account.account.
Key ColumnsKey Columns
ASSIGNMENT_IDASSIGNMENT_ID System-generatedSystem-generated
EFFECTIVE_START_DATEEFFECTIVE_START_DATE Effective start dateEffective start date
EFFECTIVE_END_DATEEFFECTIVE_END_DATE Effective end dateEffective end date
BUSINESS_GROUP_IDBUSINESS_GROUP_ID Identifies theIdentifies the
Business groupBusiness group
JOB_IDJOB_ID Identifies EmployeesIdentifies Employees
JobJob
ASSIGNMENT_STATUS_TYPE_IDASSIGNMENT_STATUS_TYPE_ID Active or SuspendedActive or Suspended
PAYROLL_IDPAYROLL_ID Identifies the payrollIdentifies the payroll
assignedassigned
SUPERVISOR_IDSUPERVISOR_ID Identifies the managerIdentifies the manager
PERSON_IDPERSON_ID links tolinks to
9. 9
Pay_element_types_fPay_element_types_f
This table holds the definitions of elements. ElementsThis table holds the definitions of elements. Elements
are the units used to build all the earnings, deductionsare the units used to build all the earnings, deductions
and benefits that can be given to employees.and benefits that can be given to employees.
Key ColumnsKey Columns
ELEMENT_TYPE_IDELEMENT_TYPE_ID System-generatedSystem-generated
ELEMENT_NAMEELEMENT_NAME User name for the elementUser name for the element
typetype
REPORTING_NAMEREPORTING_NAME Reporting Name used inReporting Name used in
SOESOE
CLASSIFICATION_IDCLASSIFICATION_ID
Earnings/Deductions/InformationEarnings/Deductions/Information
MULTIPLE_ENTRIES_ALLOWED_FLAG Indicates ifMULTIPLE_ENTRIES_ALLOWED_FLAG Indicates if
multiplemultiple entriesentries
are allowedare allowed
10. 10
Pay_input_values_fPay_input_values_f
This tableThis table holds the definitions of the input values associatedholds the definitions of the input values associated
with a specific element. Input Value is like a placeholder forwith a specific element. Input Value is like a placeholder for
storing the actual values of the elementstoring the actual values of the element
Key ColumnsKey Columns
INPUT_VALUE_IDINPUT_VALUE_ID System-generatedSystem-generated
NAMENAME Input value nameInput value name
UOMUOM Hours, Money, Date etcHours, Money, Date etc
USER_ENTERABLEUSER_ENTERABLE If Users can enter values hereIf Users can enter values here
directlydirectly
DATABASE_ITEMDATABASE_ITEM If Database item needs to beIf Database item needs to be
createdcreated (used for FF)(used for FF)
ELEMENT_TYPE_IDELEMENT_TYPE_ID Links to PAY_ELEMENT_TYPES_FLinks to PAY_ELEMENT_TYPES_F
EFFECTIVE_START_DATEEFFECTIVE_START_DATE Effective start dateEffective start date
11. 11
Pay_element_links_fPay_element_links_f
This table that holds the eligibility rules that link elements to employees. AnThis table that holds the eligibility rules that link elements to employees. An
assignment must match the eligibility criteria defined for the element linkassignment must match the eligibility criteria defined for the element link
before it can have an entry of that element.before it can have an entry of that element.
Key ColumnsKey Columns
ELEMENT_LINK_IDELEMENT_LINK_ID System-generatedSystem-generated
PAYROLL_IDPAYROLL_ID Payroll attached to this elementPayroll attached to this element
COST_ALLOCATION_KEYFLEX_IDCOST_ALLOCATION_KEYFLEX_ID To which account this element willTo which account this element will
be costed againstbe costed against
ELEMENT_TYPE_IDELEMENT_TYPE_ID Links toLinks to
PAY_ELEMENT_TYPES_FPAY_ELEMENT_TYPES_F
BALANCING_KEYFLEX_IDBALANCING_KEYFLEX_ID To which account this element willTo which account this element will
be costed againstbe costed against
COSTABLE_TYPECOSTABLE_TYPE If the Element can be costed or notIf the Element can be costed or not
TRANSFER_TO_GL_FLAGTRANSFER_TO_GL_FLAG If the element values can be transfer to GLIf the element values can be transfer to GL
EFFECTIVE_START_DATEEFFECTIVE_START_DATE Effective start dateEffective start date
EFFECTIVE_END_DATEEFFECTIVE_END_DATE Effective end dateEffective end date
12. 12
Pay_element_entries_fPay_element_entries_f
This table holds the list of all elements that are actuallyThis table holds the list of all elements that are actually
assigned to an employees assignment. Each element isassigned to an employees assignment. Each element is
identified by element_link_ididentified by element_link_id
Key ColumnsKey Columns
ELEMENT_ENTRY_IDELEMENT_ENTRY_ID System-generatedSystem-generated
ASSIGNMENT_IDASSIGNMENT_ID Links toLinks to
PER_ALL_ASSIGNMENTS_FPER_ALL_ASSIGNMENTS_F
ELEMENT_LINK_IDELEMENT_LINK_ID Links toLinks to
PAY_ELEMENT_LINKS_FPAY_ELEMENT_LINKS_F
EFFECTIVE_START_DATEEFFECTIVE_START_DATE Effective start dateEffective start date
EFFECTIVE_END_DATEEFFECTIVE_END_DATE Effective end dateEffective end date
13. 13
Pay_element_entry_values_fPay_element_entry_values_f
This table holds the actual values of the element entries.This table holds the actual values of the element entries.
Key ColumnsKey Columns
ELEMENT_ENTRY_VALUE_IDELEMENT_ENTRY_VALUE_ID System-System-
generatedgenerated
ELEMENT_ENTRY_IDELEMENT_ENTRY_ID Links toLinks to
PAY_ELEMENT_ENTRIES_FPAY_ELEMENT_ENTRIES_F
INPUT_VALUE_IDINPUT_VALUE_ID Links toLinks to
PAY_INPUT_VALUES_FPAY_INPUT_VALUES_F
SCREEN_ENTRY_VALUESCREEN_ENTRY_VALUE Actual value of theActual value of the
ElementElement entryentry
EFFECTIVE_START_DATEEFFECTIVE_START_DATE Effective start dateEffective start date
EFFECTIVE_END_DATEEFFECTIVE_END_DATE Effective end dateEffective end date
14. 14
Pay_payroll_actionsPay_payroll_actions
This table holds general details about the execution of payrollThis table holds general details about the execution of payroll
processes, including their type and all the parameters passedprocesses, including their type and all the parameters passed
to them.to them.
Key ColumnsKey Columns
PAYROLL_ACTION_IDPAYROLL_ACTION_ID System-generatedSystem-generated
ACTION_TYPEACTION_TYPE R-Run, Q-Quick Pay and P-R-Run, Q-Quick Pay and P-
PrepaymentsPrepayments
CONSOLIDATION_SET_ID This is used to consolidateCONSOLIDATION_SET_ID This is used to consolidate
multiple payrollmultiple payroll processesprocesses
PAYROLL_IDPAYROLL_ID Identifies the PayrollIdentifies the Payroll
ACTION_POPULATION_STATUS Indicates if the insert ofACTION_POPULATION_STATUS Indicates if the insert of
assignmentassignment actions is completeactions is complete
ACTION_STATUSACTION_STATUS Unprocessed, Processing,Unprocessed, Processing,
Error, Complete.Error, Complete.
15. 15
Pay_assignment_actionsPay_assignment_actions
When you run a payroll the payroll process creates aWhen you run a payroll the payroll process creates a
row(Assignment action) in this table for each assignmentrow(Assignment action) in this table for each assignment
which has been processed by the payroll process. If at allwhich has been processed by the payroll process. If at all
there is a row in this table for an assignment that means thatthere is a row in this table for an assignment that means that
some payroll processing has taken place for that assignmentsome payroll processing has taken place for that assignment
and we can know the status of that payroll action by looking atand we can know the status of that payroll action by looking at
the ACTION_STATUS which indicates whether it processedthe ACTION_STATUS which indicates whether it processed
successfully, unsuccessfully, or not at all.successfully, unsuccessfully, or not at all.
Key ColumnsKey Columns
ASSIGNMENT_ACTION_IDASSIGNMENT_ACTION_ID System-generatedSystem-generated
ASSIGNMENT_IDASSIGNMENT_ID Links toLinks to
PER_ALL_ASSIGNMENTS_FPER_ALL_ASSIGNMENTS_F
PAYROLL_ACTION_IDPAYROLL_ACTION_ID Links toLinks to
16. 16
Pay_run_resultsPay_run_results
This table holds the run results from processing each elementThis table holds the run results from processing each element
entry. There is always a single run result for each entry.entry. There is always a single run result for each entry.
Key ColumnsKey Columns
RUN_RESULT_IDRUN_RESULT_ID System-generatedSystem-generated
ELEMENT_TYPE_IDELEMENT_TYPE_ID Links to PAY_ELEMENT_TYPES_FLinks to PAY_ELEMENT_TYPES_F
ASSIGNMENT_ACTION_IDASSIGNMENT_ACTION_ID Links toLinks to
PAY_ASSIGNMENT_ACTIONSPAY_ASSIGNMENT_ACTIONS
ENTRY_TYPEENTRY_TYPE E-element entry, D-additionalE-element entry, D-additional
entry, S-entry, S- OverrideOverride
SOURCE_IDSOURCE_ID Links to PAY_ELEMENT_ENTRIES_FLinks to PAY_ELEMENT_ENTRIES_F
SOURCE_TYPESOURCE_TYPE For example, E-normal entry, I-For example, E-normal entry, I-
indirect resultindirect result
STATUSSTATUS P-processed, U-unprocessedP-processed, U-unprocessed
17. 17
Pay_run_result_valuesPay_run_result_values
This table holds the actual run result values that areThis table holds the actual run result values that are
calculated from processing a single element entry.calculated from processing a single element entry.
Key ColumnsKey Columns
INPUT_VALUE_IDINPUT_VALUE_ID Links toLinks to
PAY_INPUT_VALUES_FPAY_INPUT_VALUES_F
RUN_RESULT_IDRUN_RESULT_ID Links toLinks to
PAY_RUN_RESULTSPAY_RUN_RESULTS
RESULT_VALUERESULT_VALUE The value of the result.The value of the result.
(calculated(calculated amount)amount)
18. 18
Query to get Element EntryQuery to get Element Entry
informationinformationSELECT ppf.employee_number PRN,SELECT ppf.employee_number PRN,
ppf.full_name Name,ppf.full_name Name,
pev.screen_entry_value "Annual Salary"pev.screen_entry_value "Annual Salary"
FROM per_all_people_fFROM per_all_people_f ppfppf
,per_assignments_f,per_assignments_f pafpaf
,pay_element_entries_f,pay_element_entries_f peepee
,pay_element_entry_values_f,pay_element_entry_values_f pevpev
,pay_element_links_f,pay_element_links_f pelpel
,pay_element_types_f,pay_element_types_f petpet
,pay_input_values_f,pay_input_values_f pivpiv
WHERE ppf.person_idWHERE ppf.person_id = paf.person_id= paf.person_id
AND paf.assignment_id = pee.assignment_idAND paf.assignment_id = pee.assignment_id
AND pee.element_entry_id = pev.element_entry_idAND pee.element_entry_id = pev.element_entry_id
AND pee.element_link_id = pel.element_link_idAND pee.element_link_id = pel.element_link_id
AND pel.element_type_id = pet.element_type_idAND pel.element_type_id = pet.element_type_id
AND piv.element_type_idAND piv.element_type_id = pet.element_type_id= pet.element_type_id
AND piv.input_value_id = pev.input_value_idAND piv.input_value_id = pev.input_value_id
AND pet.element_name = 'Salary'AND pet.element_name = 'Salary'
19. 19
Query to get Run ResultsQuery to get Run Results
informationinformationSELECT INITCAP(ppf.last_name ||','||ppf.first_name) name,SELECT INITCAP(ppf.last_name ||','||ppf.first_name) name,
ety.element_name,ety.element_name,
TO_NUMBER(rrv.result_value) CommissionTO_NUMBER(rrv.result_value) Commission
FROM per_people_x ppf,FROM per_people_x ppf,
per_assignments_x paf,per_assignments_x paf,
pay_assignment_actions paspay_assignment_actions pas
pay_payroll_actions ppa,pay_payroll_actions ppa,
pay_run_results rr,pay_run_results rr,
pay_run_result_values rrv,pay_run_result_values rrv,
pay_element_types_f ety,pay_element_types_f ety,
pay_input_values_x I,pay_input_values_x I,
WHERE ppf.person_id = paf.person_idWHERE ppf.person_id = paf.person_id
AND paf.assignment_id = pas.assignment_idAND paf.assignment_id = pas.assignment_id
AND pas.assignment_action_id = rr.assignment_action_idAND pas.assignment_action_id = rr.assignment_action_id
AND ppa.payroll_action_id = pas.payroll_action_idAND ppa.payroll_action_id = pas.payroll_action_id
AND rr.element_type_id = ety.element_type_idAND rr.element_type_id = ety.element_type_id
AND i.element_type_id = ety.element_type_idAND i.element_type_id = ety.element_type_id
AND rrv.run_result_id = rr.run_result_idAND rrv.run_result_id = rr.run_result_id
AND rrv.input_value_id = i.input_value_idAND rrv.input_value_id = i.input_value_id
20. 20
Other related tablesOther related tables
Pay_payrolls_f -Pay_payrolls_f - Holds Payroll DefinitionsHolds Payroll Definitions
Per_time_periods -Per_time_periods - Holds Payroll PeriodsHolds Payroll Periods
InformationInformation
Per_time_period_types -Per_time_period_types - Holds PayrollHolds Payroll
Period Types InformationPeriod Types Information
Pay_element_classifications -Pay_element_classifications - HoldsHolds
Element ClassificationsElement Classifications
Pay_consolidation_sets –Pay_consolidation_sets – HoldsHolds
Consolidation Set DefinitionsConsolidation Set Definitions
Pay_cost_allocation_keyflex -Pay_cost_allocation_keyflex - HoldsHolds
Accounting flex field infoAccounting flex field info
Pay_personal_payment_methods_f -Pay_personal_payment_methods_f -