User Defined Tables in Oracle Fusion HCM

Share

Introduction

User Defined Tables in Oracle Fusion HCM are one of the most powerful configuration tools used by consultants to store configurable values without hardcoding logic in Fast Formulas or application setups. In real Oracle Fusion HCM implementations, business rules frequently depend on dynamic values such as allowance amounts, eligibility criteria, grading thresholds, or policy parameters. Instead of embedding these values directly into formulas or custom integrations, consultants use User Defined Tables (UDTs) to manage such data centrally.

In Oracle Fusion HCM 26A, User Defined Tables are commonly used in Payroll, Compensation, Benefits, Absence Management, and Fast Formula logic. They provide a structured way to store lookup-style data that can be referenced during runtime calculations.

For example, consider a multinational company that provides different transport allowances by employee grade and location. Hardcoding this logic inside a Fast Formula would make maintenance difficult. Instead, the consultant creates a User Defined Table containing grade and location values, allowing HR teams to update allowances without modifying the formula.

This article provides a complete consultant-level understanding of User Defined Tables in Oracle Fusion HCM, including configuration steps, implementation scenarios, troubleshooting tips, and best practices.


What are User Defined Tables in Oracle Fusion HCM?

A User Defined Table (UDT) is a configurable data structure in Oracle Fusion HCM that allows organizations to store business-specific values that can be referenced in Fast Formulas or other configurations.

UDTs are essentially custom tables created within the application that store structured information based on rows and columns.

They typically consist of:

ComponentDescription
Table NameName of the User Defined Table
Row ValuePrimary identifier for records
ColumnsAttributes or values stored in the table
Data TypeNumber, Text, Date
Effective DatesSupports date-based validity

These tables are primarily accessed through Fast Formula functions.

Why Consultants Use User Defined Tables

UDTs solve several real-world configuration challenges:

  • Avoid hardcoding values in formulas

  • Allow business users to maintain configurable values

  • Provide centralized rule management

  • Support effective dating for historical logic

  • Enable flexible policy management


Key Features of User Defined Tables

User Defined Tables offer several powerful capabilities that make them essential for enterprise HCM implementations.

1. Dynamic Data Storage

Business values can be stored externally instead of embedding them in logic.

Example:

GradeTransport Allowance
G1200
G2350
G3500

Fast formulas can dynamically read the value.


2. Multiple Columns Support

UDTs allow multiple columns per row.

Example: Bonus eligibility table.

Performance RatingBonus %Multiplier
5201.5
4151.2
3101.0

3. Effective Dating

Tables support start and end dates.

This allows organizations to update policies without losing historical data.

Example:

RowBonus %Effective Date
2024 Policy10%Jan 1 2024
2025 Policy12%Jan 1 2025

4. Fast Formula Integration

UDTs integrate directly with Fast Formula functions such as:

 
GET_TABLE_VALUE
 

This allows formulas to retrieve values dynamically.


5. Business User Maintenance

HR administrators can maintain values without technical changes.

This significantly reduces IT dependency.


Real-World Business Use Cases

From real project implementations, User Defined Tables are used extensively.

Use Case 1 – Allowance Calculation by Grade

A global manufacturing company calculates transport allowance based on employee grade.

GradeAllowance
G1200
G2300
G3450

The payroll Fast Formula reads the value using UDT.


Use Case 2 – Performance Bonus Matrix

In Compensation implementations, companies use UDTs to determine bonus percentages.

RatingBonus %
Outstanding25
Exceeds18
Meets12

This allows HR to modify bonus structures without updating formulas.


Use Case 3 – Leave Accrual Rules

Organizations sometimes maintain accrual rules using UDTs.

Example:

Service YearsLeave Days
0–212
3–515
5+20

The absence accrual formula retrieves the appropriate value.


Configuration Overview

Before configuring User Defined Tables, consultants should understand the following prerequisites.

Required Roles

Typical roles include:

  • Application Implementation Consultant

  • Human Capital Management Implementation Consultant

  • Payroll Administrator


Required Knowledge

Consultants should understand:

  • Fast Formula logic

  • Payroll calculation flow

  • HCM configuration structure


Key Configuration Objects

User Defined Tables involve the following setup components:

ObjectDescription
User Defined TableMain container
ColumnsData attributes
RowsRecords
Fast FormulaConsumes values

Step-by-Step Configuration in Oracle Fusion

Step 1 – Navigate to User Defined Tables

Navigation path:

Navigator → My Client Groups → Payroll → User Defined Tables


Step 2 – Create a New User Defined Table

Click Create.

Enter the following values:

FieldExample Value
Table NameTRANSPORT_ALLOWANCE_TABLE
Base User Table NameSystem Generated
Legislative Data GroupVision LDG
Effective Start DateJan 1 2024

Click Save.


Step 3 – Define Columns

Columns represent the values stored in the table.

Example:

Column NameData Type
ALLOWANCE_AMOUNTNumber

Steps:

  1. Click Columns

  2. Add new column

  3. Enter column details

  4. Save


Step 4 – Add Rows

Rows represent lookup keys.

Example values:

Row NameAllowance
G1200
G2300
G3450

Steps:

  1. Click Rows

  2. Add new row

  3. Enter values

  4. Save


Step 5 – Verify Configuration

Ensure:

  • Columns are correctly defined

  • Rows contain values

  • Effective dates are correct


Using User Defined Tables in Fast Formula

Fast formulas retrieve values using the function:

 
GET_TABLE_VALUE
 

Example formula:

 
DEFAULT FOR GRADE IS ‘G1’

ALLOWANCE = GET_TABLE_VALUE(
‘TRANSPORT_ALLOWANCE_TABLE’,
‘ALLOWANCE_AMOUNT’,
GRADE
)
 

Explanation:

ParameterMeaning
Table NameUDT name
Column NameColumn storing value
Row ValueKey

If employee grade = G2, formula returns 300.


Testing the Setup

Testing is critical before deploying to production.

Test Scenario

Employee details:

AttributeValue
Employee NameJohn Smith
GradeG2

Expected result:

Transport allowance = 300


Testing Steps

  1. Run payroll calculation

  2. Verify formula output

  3. Validate payroll result


Validation Checklist

Consultants should confirm:

  • Correct value retrieved

  • Formula execution success

  • Payroll results accurate


Common Implementation Challenges

During implementations, consultants frequently encounter several issues.

1. Incorrect Row Values

If the row key does not match the input value, the formula returns null.

Solution:

Ensure row names match input exactly.


2. Effective Date Mismatch

UDT rows must be effective during the calculation date.

Solution:

Check start and end dates.


3. Column Name Errors

Column names in Fast Formula must match exactly.

Example error:

 
TABLE VALUE NOT FOUND
 

4. Legislative Data Group Issues

UDTs are LDG-specific.

Ensure the correct LDG is used.


Best Practices from Oracle HCM Implementations

Experienced consultants follow these practices.

Use Clear Naming Standards

Example:

 
UDT_ALLOWANCE_GRADE
UDT_BONUS_MATRIX
UDT_LEAVE_ACCRUAL
 

Avoid generic names.


Avoid Large Data Volumes

UDTs are not designed for massive datasets.

For large datasets, use:

  • HCM Extract

  • External tables

  • Integration services


Document Table Structures

Maintain documentation including:

  • Table name

  • Columns

  • Usage

  • Referenced formulas


Use Effective Dating

Always maintain historical values.

Never overwrite policy data.


Restrict Maintenance Access

Only authorized HR administrators should update UDT values.


Real Implementation Scenario

A consulting project for a telecommunications company required dynamic overtime multipliers.

Business rule:

ShiftMultiplier
Day1.5
Night2.0
Weekend2.5

Instead of hardcoding this logic, consultants created a User Defined Table called OVERTIME_MULTIPLIER_TABLE.

Payroll Fast Formula reads multiplier value during payroll run.

Result:

  • HR team updates values without IT involvement

  • Payroll logic remains unchanged

  • Implementation becomes more scalable


Frequently Asked Questions (FAQ)

1. What is the main purpose of User Defined Tables in Oracle Fusion HCM?

User Defined Tables store configurable business data that can be accessed by Fast Formulas during payroll or HR processing. They eliminate the need for hardcoded logic.


2. Can User Defined Tables be used outside payroll?

Yes. While commonly used in payroll formulas, they are also used in:

  • Absence Management

  • Compensation calculations

  • Benefits eligibility

  • Custom HR rules


3. Are User Defined Tables effective dated?

Yes. UDT rows support effective dating, allowing organizations to maintain historical policies and future changes.


Summary

User Defined Tables in Oracle Fusion HCM provide a powerful way to manage configurable business data. Instead of embedding values directly in formulas or application logic, organizations can store policy-driven information in structured tables that are easy to maintain and update.

From payroll allowances to bonus calculations and leave policies, UDTs enable scalable and flexible configuration across the Oracle Fusion HCM ecosystem. By following proper naming conventions, effective dating strategies, and structured implementation practices, consultants can build highly maintainable HCM solutions.

For deeper reference and technical documentation, Oracle provides official guides available at:

https://docs.oracle.com/en/cloud/saas/index.html

Consultants and learners should review the Oracle Global Payroll documentation for detailed examples and Fast Formula reference usage.


Share

Leave a Reply

Your email address will not be published. Required fields are marked *