Thursday, 1 January 2026

Error during Worker HDL load

 

Error during Worker HDL load


Error Message1 : You Must a Primary Value
Solution: Add PrimaryWorkTermsFlag attribute in Workterm Metadata.

Error Message2 : Person can have only 1 active Primary WorkRelationship 
Solution: Update the termination date tagged with previously terminated Workrelationship.

Error Message3 : SourceSystemOwner is unknown 
Solution: Update the HRC_SOURCE_SYSTEM_OWNER lookup by removing FUSION from the custom lookup code, then update the same value in the Worker (or relevant) HDL file.
Zip the updated file and load it via My Client Groups → Data Exchange → Import and Load File, and refresh to confirm successful completion.


Error Message4 : JBO-FND:::FND_FLEX_SEG_VAL_NOT_IN_LIST: xxx is not in the list
Solution: Resolve the issue by either updating the Site Code value for the affected Position record and removing the end date, or by extending the end date of the Site Code.
After making the correction, reload the Worker HDL file to apply the changes.


Error Message5 : You must enter a valid value for the GradeId field. 
Solution: Provide the correct GradeId/GradeCode for the new Position in the DAT file, or alternatively pass #NULL (with PER_ENFORCE_VALID_GRADE = Y) or set PER_ENFORCE_VALID_GRADE = N to avoid passing grade values.
In both scenarios, run the ESS job – Synchronize Person Assignment from Position to sync grade, job, and other position-related fields.

Error Message6 : The values xxxx aren't valid for the attribute LegislationCode. 
Solution: Update the existing Legal Entity with a unique Registration Number via Setup & Maintenance → Legal Structures → Manage Legal Reporting Unit Registrations, then save the changes.
After the update, reload the Worker HDL file to complete the process.

Error Message7 : METADATA line for the {BO_NAME} business object is invalid, When attempting to load a Worker HDL file to add Person Extra Information
Solution: Refresh the Worker HDL object, download the latest template, and update the Worker HDL file with the required PEI EFF, EFF_CATEGORY_CODE, and FLEX attributes by following the Oracle documentation for loading extensible flexfields.
Save, zip, and reload the file via My Client Groups → Data Exchange → Import and Load Data to confirm the error is resolved.

Error Message8 : You cannot update this record because the SourceSystemId <SOURCE_SYSTEM_ID_1> and the SourceSystemOwner ABC are invalid when attempting Assignment Supervisor. 
Solution: The user can either remove Source System ID/Owner and use surrogate or user keys for Assignment Supervisor, or align the Source System ID/Owner with Fusion-supported keys, ensuring parent/child objects do not mix different key types.
Alternatively, identify and update source key mappings via HRC_INTEGRATION_KEY_MAP using SourceKeys.dat, after which the original AssignmentSupervisor data can be successfully loaded—this approach is best suited for existing Fusion integrations.

Error Message9 : You must provide only one parent record Worker and it must start on the earliest effective start date and not have an end date. 
Solution: Pass the same date for both StartDate and EffectiveStartDate, ensuring it matches the first effective start date from PER_ALL_PEOPLE_F for the person.
If only creating a new work relationship or assignment, remove the METADATA Worker and MERGE Worker records from the data file.

Error Message10 :  No Assignment record from 2018-10-27
Solution: Assignment data is missing in Worker.dat from the effective date 2018-10-27.



Not able to End date the Person Contact Relationship using HDL

Not able to End date the Person Contact Relationship using HDL



Description : 
Using HDL trying to end date the Person Contact Relationship.

Resolution :
You can not end date contact relationship using HDL as this feature is not supported by Oracle.
In this case you can delete the Person Contact Relationship.

You can't delete the contact because the person is designated as a benefit dependent or beneficiary

 

You can't delete the contact because the person is designated as a benefit dependent or beneficiary

Error Message : 

You cannot delete the contact because the person is designated as a benefit dependent or beneficiary, or an attempt was made to process the benefit designation

Or

Error removing a duplicate beneficiary/contact


Solution : 

1. Check if Dependent is add as beneficiary or not. if yes then remove it.

2. Check if dependent is elected as beneficiary in any of the plan, remove if yes.

3. If Dependent is covered in any plan then void/purge the life event and Run Purge Backed-Out or Voided Life Event Data for the employee. 


After this you can delete or end date Person Contact Relationship either using HDL or UI.


 



Wednesday, 1 October 2025

HDL Template for Benefit Participant Enrollment

HDL Template for Benefit Participant Enrollment


For this use ParticipantEnrollment.dat file.


Please find the below sample template :

METADATA|ParticipantEnrollment|PersonNumber|ParticipantLastName|ParticipantFirstName|BenefitRelationship|LifeEvent|LifeEventOccuredDate|EffectiveDate

MERGE|ParticipantEnrollment|XXTEST_PER1|Adam|Baro|Default|NewHire|2016/11/05|2016/11/05

METADATA|CompensationObject|Program|OriginalEnrollmentDate|PersonNumber|LineNumber

MERGE|CompensationObject|XXTEST Benefits Program|2016/11/05|XXTEST_PER1|1


Tuesday, 2 July 2024

How to sort data in rtf template

 How to sort data in rtf template


Sort the data in Data model is the recommended approach.
But if you want to sort the data in rtf template then you have to use below xml tag code.

<?sort:fieldname?><?fieldname?>  

this will sort the data in ascending order be default as it is not mentioned.

if user want to sort the data in descending order then use below code

<?sort:fieldname;'descending'?><?fieldname?>  

Prenotification Status of Personal Payment Method in Oracle HCM

 

Prenotification Status of Personal Payment Method in Oracle HCM


Prenote Status is not stored directly in table, you can find the corresponding details in pay_bank_account_prenotes table.

Prenote status you have to use below logic.

CASE
WHEN pay_bank_account_prenotes.PRENOTE_DATE=TO_DATE('31/12/4712','DD/MM/YYYY') THEN 'ORA_R'
WHEN pay_bank_account_prenotes.PRENOTE_DATE=TO_DATE('01/01/0001','DD/MM/YYYY') THEN 'ORA_SK'
WHEN NVL((pay_bank_account_prenotes.PRENOTE_DATE),TO_DATE('31/12/4712','DD/MM/YYYY'))=TO_DATE('31/12/4712','DD/MM/YYYY') THEN 'ORA_N_S'
WHEN TRUNC(pay_bank_account_prenotes.PRENOTE_DATE+NVL(OrganizationPaymentMethodDEO.VALIDATION_DAYS,0)) <= TRUNC(SYSDATE) THEN 'ORA_C'
ELSE 'ORA_S'
END AS PRENOTE_STATUS



Monday, 1 July 2024

Customize the Seeded Job Offer Letter Template

 Steps to Customize Oracle Seeded Job Offer Letter Template

Click here for step by step video to create job offer letter template customization

Below are the steps to customize the seeded job offer letter.

First download the seeded job offer template from below path.

      Path - Shared Folders > Human Capital Management > Recruiting > Job Offer

Select Job Offer Letter Report and click on Edit



Click on Edit to download the seeded template.



Save the Downloaded .rtf template.

To modify the template we need .xml to do the changes as per needed. 

We need offer id which need to provide the job offer letter Data model to get XML so first we need to find offer id using below SQL.


SELECT

offer.OFFER_ID

FROM

IRC_OFFERS offer,

IRC_CANDIDATES candidate,

IRC_REQUISITIONS_B req,

IRC_SUBMISSIONS sub

WHERE

req.REQUISITION_ID = sub.REQUISITION_ID

AND candidate.PERSON_ID = sub.PERSON_ID

AND sub.SUBMISSION_ID = offer.SUBMISSION_ID

AND REQUISITION_NUMBER = 'Enter the Requisition Number'

AND CANDIDATE_NUMBER = 'Enter the Candidate Number'


Once we get the offer letter then go to the below path to get XML.

  Path - Shared Folders > Human Capital Management > Recruiting > Job Offer
 
Open the JobOfferLetterDM


Pass the Job offer ID as mentioned below and click on view.



Once data is fetched by Data model then export the xml.




Then load the same xml in .rtf template as mentioned below.


Do the necessary changes as per the requirement then save the rtf template.
Add the rtf template to .zip file.

Now upload the zip file to Recruiting Content Library.
Go to Setup and Maintenance.


 
Select Recruiting and Candidate Experience Management then click on Recruiting Content Library.









Click Create to create the content Item.







Enter the details.







Name:- User defined Name

Code :- User defined

Category :- Job Offer Letter Template

Visibility: - Internal,External







Select Start on Activation Check box and upload the zip file.

Then click on Save and activate button.










Now Create/Edit the job offer with new job offer template.

Path - My Client Group > Hiring

Select the Requisition and click on active application.

Click on Action to create job offer or If Offer is already created then click edit job offer.

It will open new dialogue. Select appropriate Check Box and click on continue.

Enter the details as per the section on Job Creation Page.

In offer section Select the newly created job offer letter and click on submit. 

Click on Preview to verify the customize offer letter.





The values {attributes} are not valid for the attribute BankAccountId

Error While Loading PersonalPaymentMethod Using HCM Data Loader Introduction Oracle Fusion HCM HCM Data Loader (HDL) is commonly used to lo...