Showing posts with label HDL absence entry example. Show all posts
Showing posts with label HDL absence entry example. Show all posts

Thursday, 19 January 2023

HDL Template to Absence Entry of Worker


✅ Oracle HCM HDL: Load Worker Absence Entry (PersonAbsenceEntry.dat) – Template + Examples

Absence management is one of the most common business requirements in Oracle Fusion HCM. If you need to load absence entries for employees in bulk (Sick leave, Earned leave, Casual leave, etc.), Oracle provides the HDL object:

๐Ÿ‘‰ PersonAbsenceEntry (and its child object PersonAbsenceEntryDetail)

This post provides a complete HDL template with real working examples, along with prerequisites, common issues, and FAQ.


⭐ What is PersonAbsenceEntry in Oracle HDL?

PersonAbsenceEntry is an HDL business object used to create or update worker absence entries in Oracle Fusion HCM.

It supports:

  • Absence Type (Sick, Annual Leave, etc.)

  • Absence dates and time

  • Absence status + approval status

  • Assignment-level detail (via PersonAbsenceEntryDetail)


✅ Prerequisites (Important)

Before loading absence entry using HDL, verify:

1) Worker must exist

The PersonNumber must be valid.

2) Absence Plan must be enrolled first

If the worker is not enrolled in the absence plan, the absence entry load may fail.

✅ Example errors:

  • Plan not enrolled

  • Absence type not eligible

  • No accrual available

3) Absence Type must exist

Absence Type should be configured in:
Absence Administration → Absence Types

4) Employer / Legal Entity should match worker

Use correct employer name.


๐Ÿ“‚ HDL File Name

๐Ÿ“Œ File Name:
PersonAbsenceEntry.dat


๐Ÿงพ HDL Sample Template: PersonAbsenceEntry

This is the main absence entry record.

METADATA|PersonAbsenceEntry|Employer|PersonNumber|AbsenceType|AbsenceReason|AbsenceStatus|ApprovalStatus|StartDatetime|EndDatetime|StartDate|StartTime|EndDate|EndTime|SourceSystemOwner|SourceSystemId

MERGE|PersonAbsenceEntry|US3 Legal Entity|XXTEST2|Sick||SUBMITTED|APPROVED||2021/07/12 08:00:00|2021/07/12|08:00|2021/07/12|16:30|XXTEST|XXTEST2_SICK1



๐Ÿ” Explanation of Key Fields

  • AbsenceType: Example: Sick, Annual Leave, etc.

  • AbsenceStatus: Usually SUBMITTED

  • ApprovalStatus: APPROVED / PENDING

  • StartDatetime / EndDatetime: Used for date+time entry

  • StartDate / EndDate: Used for date only entries

  • SourceSystemOwner / SourceSystemId: Must be unique per absence record


๐Ÿงพ HDL Sample Template: PersonAbsenceEntryDetail 

This object is used when you want to load daily/time details and connect absence to assignment.

METADATA|PersonAbsenceEntryDetail|AbsenceDate|Employer|PersonNumber|AbsenceType|AssignmentNumber|AbsenceStartDate|AbsenceStartTime|RowSeq|StartTime|EndTime|SourceSystemOwner|SourceSystemId

MERGE|PersonAbsenceEntryDetail|2021/07/12|US3 Legal Entity|XXTEST2|Sick|XXTEST_ASSIGN2-1|2021/07/12|08:00|1|06:00|16:30|XXTEST|XXTEST2_SICK1



⭐ Why PersonAbsenceEntryDetail is required?

You should use PersonAbsenceEntryDetail when:

✅ Absence is hourly
✅ Absence spans multiple dates
✅ You need assignment-level mapping
✅ You want exact daily breakdown


๐Ÿง  Recommended HDL Zip Structure

Your zip should look like this:

AbsenceEntryLoad.zip └── PersonAbsenceEntry.dat

Upload from:

Data Exchange → HCM Data Loader → Import and Load


⚠️ Common Errors and Fixes

❌ Error: Worker is not enrolled in absence plan

✅ Fix: Enroll the worker first in the plan.


❌ Error: Invalid Absence Type

✅ Fix: Verify Absence Type spelling and configuration.


❌ Error: SourceSystemId already exists

✅ Fix: Use unique SourceSystemId for each absence entry.


❌ Error: AssignmentNumber invalid

✅ Fix: Confirm assignment number from Person Management.


๐Ÿ”— Internal Links 



๐Ÿ’ฌ Feedback & Comments

If this absence entry HDL template helped you, drop your feedback in the comment section ๐Ÿ™Œ

If you face any issue, share:

  • HDL error message

  • Absence Type name

  • Whether plan enrollment exists

  • Your sample Worker.dat snippet (remove sensitive data)


❓ FAQ

Q1. Can we load absence entries using HDL in Oracle HCM?

Yes. You can load worker absences using the HDL objects PersonAbsenceEntry and PersonAbsenceEntryDetail.


Q2. Is absence plan enrollment required before loading absence entry?

Yes. In most cases, the worker must be enrolled in the absence plan first.


Q3. Which file is used to load absence entry in HDL?

The commonly used HDL file is PersonAbsenceEntry.dat.


Q4. What is the purpose of PersonAbsenceEntryDetail?

It provides daily/hourly absence details and connects the absence entry to assignment.


Q5. Can we load hourly absences using HDL?

Yes. Hourly absences are supported by providing StartTime and EndTime in PersonAbsenceEntryDetail.


Q6. What should be the AbsenceStatus and ApprovalStatus?

Typically:

  • AbsenceStatus = SUBMITTED

  • ApprovalStatus = APPROVED (or PENDING depending on workflow)

Oracle HCM HDL: Load Seniority Date Adjustments

  ✅ Oracle HCM HDL: Load / Update Seniority Date Adjustments (V3) – Examples + Worker.dat Templates Seniority Date in Oracle HCM is the dat...