HCM

Data Loader (HDL)

Advanced Topics

Prasanna Borse
Oracle HCM Cloud Center of Excellence
June, 2017

Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal
Safe Harbor Statement
The following is intended to outline our general product direction. It is intended for
information purposes only, and may not be incorporated into any contract. It is not a
commitment to deliver any material, code, or functionality, and should not be relied upon
in making purchasing decisions. The development, release, and timing of any features or
functionality described for Oracle’s products remains at the sole discretion of Oracle.

Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | 2

HDL Advanced Topics
• Checking for Duplicate Person Records
– When you load person records using HCM Data Loader, you can request a check for
duplicate records. In this case, an error message is raised if you try to load a duplicate
record.
– This topic describes how to request duplicate checking for individual person records.
– It also describes how this option works in conjunction with the enterprise setting for
duplicate checking.

Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 3
Checking for Duplicate Person Records
Manage Enterprise HCM Information

• The enterprise option Person Creation Service Duplicate Check controls

whether checks for duplicate person records occur by default when you
load person records in bulk.
• If you exclude the PersonDuplicateCheck attribute of the worker object,
then Enterprise defaults applies.
• If you include the PersonDuplicateCheck attribute, then the Enterprise
defaults are ignored for the relevant person record.

Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | 4

Checking for Duplicate Person Records
HDL Load
• To request duplicate checking for a person record, you include the PersonDuplicateCheck
attribute of the worker object. This attribute can have one of the values shown in this table. The
Description column identifies the attributes that the application uses in each case to identify
duplicate records.

Value Description
ORA_NONE No duplicate checking occurs
ORA_LN_FI_DOB_GEN_NID Either the last name, first-name initial, date of birth, and gender or the national ID
ORA_LN_FI_DOB_NID Either the last name, first-name initial, and date of birth or the national ID
ORA_LN_FN_DOB_GEN_NID Either the last name, first name, date of birth, and gender or the national ID
ORA_NID_ONLY The national ID
Null No Duplicate Validation at row level, will use enterprise setting if it's defined

Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | 5

Checking for Duplicate Person Records
HDL Load - Example
• METADATA|Worker|SourceSystemOwner|SourceSystemId|EffectiveStartDate|EffectiveEndDate|PersonNumber|Acti
onCode|StartDate|DateOfBirth|CountryOfBirth|WaiveDataProtectFlag|CategoryCode|PersonDuplicateCheck|Sourc
eRefTableName=PERSON|SourceRef001=EMPLID
• MERGE|Worker|STUDENT*|STUDENT*_PER120|1990/07/08|4712/12/31|STUDENT*_PERSON120|HIRE|1990/07/0
8|1975/01/01|US|N|PER_EIT|ORA_NID_ONLY||STUDENT*_PER120
• MERGE|Worker|STUDENT*|STUDENT*_PER121|2010/05/07|4712/12/31|STUDENT*_PERSON121|HIRE|2010/05/0
7|1975/01/02|US|N|PER_EIT|ORA_NONE||STUDENT*_PER121

Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal/Restricted/Highly Restricted 6
Checking for Duplicate Person Records
HDL Load – Run Results

Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal/Restricted/Highly Restricted 7
Checking for Duplicate Person Records
HDL Load – Error message

Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal/Restricted/Highly Restricted 8
Additional Documentation

• Integration guide
https://docs.oracle.com/cloud/latest/common/FAIHM/FAIHM2197527.htm
#FAIHM2225178

Copyright © 2017, Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal/Restricted/Highly Restricted 9