Академический Документы
Профессиональный Документы
Культура Документы
Table of Figures
Figure 1: Steps to Dispose Ex-employee Records ................................................................................................... 2
Figure 2: Fast Formula - Example: Format Start Date .............................................................................................. 6
Figure 3: Fast Formula - Example: Mask Date of Birth ............................................................................................. 7
Figure 4: Fast Formula - Manage Fast Formulas ...................................................................................................... 7
Figure 5: Fast Formula - Create Fast Formula.......................................................................................................... 7
Figure 6: Fast Formula - Formula Text ..................................................................................................................... 8
Figure 7: HCM Extract - Creating an Extract............................................................................................................. 8
Figure 8: HCM Extract - Creating a Data Group ....................................................................................................... 9
Figure 9: HCM Extract - Creating Filter Conditions ................................................................................................... 9
Figure 10: HCM Extract - Creating a Record .......................................................................................................... 10
Figure 11: HCM Extract - Creating a Detail Record ................................................................................................ 10
Figure 12: HCM Extract - Detail Record ................................................................................................................. 10
Figure 13: HCM Extract - Selecting attributes ......................................................................................................... 11
Figure 14: HCM Extract - Reviewing Attribute Properties ....................................................................................... 11
Figure 15: HCM Extract - Changing the Attribute Short Code ................................................................................. 12
Figure 16: HCM Extract - Creating an Attribute ...................................................................................................... 12
Figure 17: HCM Extract - Creating a Rule Attribute ................................................................................................ 13
Figure 18: HCM Extract - Creating the Data Group Connection ............................................................................. 13
Figure 19: HCM Extract - Creating a Hierarchy traversal record ............................................................................. 14
Figure 20: HCM Extract - Delivery Options ............................................................................................................. 15
Figure 21: HCM Extract - Creating an Inbound Interface Delivery Option ............................................................... 15
Figure 22: HCM Extract - Compile All Formula ....................................................................................................... 16
Figure 23: Submitting a HCM Extract ..................................................................................................................... 16
Figure 24: HCM Extract Results - Search ............................................................................................................... 17
Figure 25: HCM Extract Results - Task Details....................................................................................................... 17
Figure 26: HCM Extract Results - Processes and Reports ..................................................................................... 18
Figure 27: HCM Extract Results - View Results...................................................................................................... 18
Figure 28: Define the METADATA definition line for each component of the business object ................................ 19
Figure 29: Business Intelligence - globalReportsDataModel ................................................................................... 22
Figure 30: Business Intelligence - Create Report ................................................................................................... 23
Figure 31: Business Intelligence - Use Report Editor.............................................................................................. 23
Figure 32: Business Intelligence - Naming the Report ............................................................................................ 23
Figure 33: Business Intelligence - Uploading the eText template ........................................................................... 24
This white paper describes an approach that enables companies to implement their own unique and
specific data retention and disposal policies, and to achieve data privacy whilst preserving the integrity
of data stored in Oracle Fusion HCM.
Identify the records that must be disposed, based on various data retention and disposal policies.
Obfuscate records that must be retained to preserve referential integrity. Obfuscation is achieved as follows:
HCM Extracts
In order to identify each record to be disposed, it is recommended that an HCM Extract be defined. Using HCM
Extracts, you can specify rules (filter criteria) to fetch the records to be disposed. For each record, you can retrieve
the attributes that uniquely identify the record as well as the attributes to be obfuscated.
The output of each HCM Extract can be automatically transformed into the HCM Data Loader (HDL) file format. This
is achieved by choosing the “HDL” delivery option and associating an eText template with this delivery option. The
resulting output will be a HDL data file which contains the following:
HDL merge lines to obfuscate records. These lines will contain commands to
Steps to success
1. Analyze the object to dispose and identify what data can be deleted and which data needs obfuscation.
2. Define and test the shape of the HDL file and confirm it achieves the required result.
3. Define and test the HCM Extract to extract records (based on your disposal rules) and to output the attribute
values required to be included in the HDL file.
4. Define the eText template to generate files lines for the HDL file.
Disclaimer
It is not possible to reverse the disposal of data. Ensure you genuinely want to dispose of the data extracted in the
HCM Extract generated file, before uploading it with HDL. You should consider taking a snapshot or baseline of your
environment prior to disposing of employee data.
SET PURGE_FUTURE_CHANGES Y
This command ensures that data existing in the Oracle HCM Cloud will be replaced with the data supplied in the file.
Other HDL commands are available if you need to overwrite the default behavior.
Purging Records
For the records that can be purged, usually only the surrogate ID attribute that uniquely identifies the record, and the
surrogate ID attribute that identifies the parent record are required.
METADATA|PersonEmail|EmailAddressId|PersonId
A data line to purge the e-mail record would look something like:
DELETE|PersonEmail|300100074926175|300100074926164
Obfuscating Records
For the records that must be obfuscated, in addition to the surrogate IDs for the local and parent records, other
attributes will be required. These will fall into two categories:
Attributes used to identify the record to update. These will remain unchanged.
Attributes to obfuscate.
For each date-effective record type, you must also determine if all date-effective records should be included, or a
single record spanning the duration of employment.
A data line to obfuscate the worker record would look something like:
MERGE|Worker|300100074926164|10041|1982/02/08|1962/02/13|#NULL|#NULL|#NULL|#NULL|#NUL
L|#NULL|#NULL
The DateofBirth field is mandatory and therefore replaced (masked) with new values. The #NULL tag tells HDL to
remove non-mandatory attribute values.
Steps to execute HCM Data Loader are available in the HCM Data Loader User’s Guide (MOS Doc ID: 1664133.1).
The formatting of the extracted data, along with the data obfuscation can predominantly be achieved by defining an
eText layout for each business object to be obfuscated. The eText layout is a rich text document that allows you to
specify the HCM Data Loader file instruction for each record type including the value and masking criteria for each
attribute.
Data Groups
Data groups are used to extract and filter the required records and attribute values from the Oracle Fusion HCM
database.
Each component to purge or obfuscate will need a data group in the extract. Additionally a root data group is
required to filter the records to be included in the output.
Records
Each data group requires a record. Records are used for two purposes:
Detail Records
If your data group will return multiple records for the same person, the name of the record will be referenced in your
eText template to repeat the eText record definition for each record extracted.
The connections and flow will follow the same hierarchical shape as the business object you are disposing.
Attributes
There are two types of HCM Extract attributes:
User entity attributes Attributes selected from the data group user entity, these retrieve the unformatted
value from the database.
Rule based attributes Manually created to invoke a fast formula to format or mask a user entity attribute.
Having defined your business object file, map the HDL attributes to be included to the user entity attributes. Identify
all rule based attributes to create.
Fast Formulae
HCM Extract outputs dates in a timestamp format incompatible with HDL. The eText template is responsible for
formatting the file shape, but it cannot correctly format date values. Date attributes need to be formatted to the HDL
date format (YYYY/MM/DD). This can be achieved by creating a simple Extract Rule fast formula to perform the
formatting:
INPUTS ARE DATA_ELEMENTS (TEXT_TEXT)
rule_date_value = TO_DATE(substr(DATA_ELEMENTS['Start_Date'], 1, 10),'YYYY/MM/DD')
rule_value = date_to_text(rule_date_value, 'YYYY/MM/DD')
return rule_value
Figure 2: Fast Formula - Example: Format Start Date
A single formula can be used to provide formatting for multiple attributes. The formula uses the user entity attribute’s
short code to determine which attribute value to format.
If you will be retrieving both start and end dates you should create two formulae, one to format the start date, the
other to format the end date. Multiple attributes in the same record cannot have the same short code.
A fast formula can also be used to mask an attribute value. For example, if you want to mask a worker’s date of birth
to be 20 years before their start date, the following formula can be created to adjust the date by 20 years and format
the output to the HDL date format.
INPUTS ARE DATA_ELEMENTS (TEXT_TEXT)
rule_date_value = ADD_YEARS(TO_DATE(substr(DATA_ELEMENTS['Start_Date'], 1,
10),'YYYY/MM/DD'),-20)
rule_value = date_to_text(rule_date_value, 'YYYY/MM/DD')
Fast Formulae
First create the fast formula you require for formatting and masking.
4. Click Save
5. Compile the formula and Refresh to ensure successfully compilation.
3. Check the Root Data Group checkbox only for the population data group, the data group that identifies who
should be included in the extract.
3. Use the Edit Filter Criteria Condition popup to specify the filter criteria
4. Click OK.
2. Specify a Sequence of ‘10’ and provide the name for the record group. You do not need to use the Advanced
options for Detail records.
3. Click Save, your record will appear within the Data Group
Selecting Attributes
1. To add attributes to your record, double click the record name, a list of attributes will appear on the left:
2. Use the Search filter to find the required attributes, clicking an attribute name will add it to the detail record.
2. In the fast formula used to format the date, a reference is made to the attribute short code. In order to format
the date with one of the formulae, change the short code to the value used, such as Start_Date, or End_Date
4. Create a new Rule attribute by clicking on the Configure button on the Detail Record, and selecting Create
Attribute:
6. Click Save
1. Click on the Data Group Connection icon on all but the root data group to connect the data group to its parent:
1. Click the Create Record action on the parent Data Group, available from the Configure button
You can repeat the above steps to create all required data groups. However, it is recommended that you define a
delivery option and test each data group as it is added.
Delivery Option
The extract requires an Inbound Interface delivery option in order to associate your eText layout to format the data in
the HDL file format, and deliver your output to a file to the Oracle WebCenter Content server. However, initially it is
recommended that you create a simple ‘Data’ output type, to output the extracted data in XML format. This will allow
2. Provide a Delivery Option and Output name. The Output Type should remain ‘Data’.
3. Click Save
The file will be created with a txt file extension. Before you can upload it using HDL you must first change the file
extension to .dat and add this file to a compressed zip file. Whilst compressing the file you can encrypt the zip file.
The individual business object files should not be encrypted separately.
1. On the Deliver page, click the Add button on the Extract Delivery Options table.
3. The delivery type of Inbound Interface generates parameters that need to be configured in the Additional
Details table. Specify:
Encryption Mode Select the mode to encrypt the file whilst it is on the WebCenter Content server.
4. Click Save
2. Refresh occasionally until green ticks appear against all Fast Formula records in the Status column.
3. Click Submit to validate your extract. You can now submit your extract.
1. Search and select your extract using the Query By Example filter
2. Click Next
5. You can restrict the search results by specifying your process flow name, or specify the name of your extract in
the Flow Pattern search field.
6. Click on the payroll process flow name to navigate to the task details.
7. Click on the Go to Task icon against the row with your extract name. This navigates you to the Processes and
Reports for your test run.
8. Click the icon in the View Results column to see the files generated by the extract.
9. One file will be generated for each delivery option specified. To download the file click the File Name.
Once you have designed the HDL file format, with respect to components and attributes to include, the eText
template should be straight forward to create.
Template Shape
eText templates adhere to the following shape:
SET PURGE_FUTURE_CHANGES Y
Example
<NEW RECORD> REPLACE_FUTURE_CHANGES
<DISPLAY 1=1
CONDITION>
<MAXIUMUM <FORMAT> <DATA> <TAG> <COMMENTS>
LENGTH>
100 Alpha 'SET PURGE_FUTURE_CHANGES
Y'
Example
<NEW WORKER_HEADER
RECORD>
<DISPLAY 1=1
CONDITION>
<MAXIUMUM <FORMAT> <DATA> <TAG> <COMMENTS>
LENGTH>
100 Alpha 'METADATA|Worker'
1 Alpha '|'
100 Alpha 'PersonId' PersonId
1 Alpha '|'
100 Alpha 'PersonNumber' PersonNumber
1 Alpha '|'
100 Alpha 'EffectiveStartDate' EffectiveStartDate
1 Alpha '|'
100 Alpha 'DateOfBirth' DateOfBirth
1 Alpha '|'
100 Alpha 'DateOfDeath' DateOfDeath
Figure 28: Define the METADATA definition line for each component of the business object
Example
<LEVEL> Terminated_Workers
<NEW Worker
RECORD>
<DISPLAY 1=1
CONDITION>
<MAXIUMUM <FORMAT> <DATA> <TAG> <COMMENTS>
LENGTH>
100 Alpha 'MERGE|Worker'
1 Alpha '|'
100 Alpha Extract_Person_ID PersonId
1 Alpha '|'
100 Alpha Person_Number PersonNumber
1 Alpha '|'
100 Alpha Person_Effective_Start_Date EffectiveStartDate
1 Alpha '|'
100 Alpha Date_Of_Birth DateOfBirth
1 Alpha '|'
10 Alpha '#NULL' DateOfDeath
Specify the data type and maximum length for each row. The comments column can be used to specify which
attribute the file row pertains to.
In the Data column, specify the name of the attribute tag, as seen in the XML output, or a constant value. The HDL
#NULL tag can be used to set non-mandatory attributes to null.
Each attribute value must be delimited with a pipe ‘|’ character to conform to the HDL file line format.
Repeating Records
If the record type repeats you must wrap your record definition with a level definition.
Example
<LEVEL> Email
Example
<END LEVEL> Terminated_Workers
Example
<END LEVEL> DATA_DS
3. Use the folder hierarchy to find the globalReportsDataModel within the /SharedFolders/Human Capital
Management/Payroll/Data Models folder.
5. Click Create Report to create a new report based on this generic data model.
6. You will create your report using the report editor, so change the radio group to ‘Use Report Editor’ and click
Finish.
7. Select a folder for your report and specify a name, such as ObfuscateWorker:
You can now create the Inbound Interface delivery option for your HCM Extract. See Defining the Inbound
Interface Delivery Option.
Note: The example that follows assumes that the worker was previously employed. For worker records created in
error, other options are available. For example, you can cancel the work relationship, which will purge the
employment-related records. See the HCM Data Loader: Loading Workers white paper (document ID 2022624.1) for
further details of what can be achieved using HCM Data Loader.
Person Citizenship State or nation that a person identifies as being a native or naturalized member of and is entitled to its
protection.
Person Delivery Method The types of communication methods for a person. For example IM, web address and so on.
Person Ethnicity Name of the cultural or racial group a person belongs to.
Person Legislative Data Secondary legislative data records. Primary legislative data records cannot be purged.
Person National Identifier String of alpha numeric characters assigned by a legal authority that are used to represent a person.
Person Phone Secondary phone details of a particular type for a person. Primary phone numbers cannot be purged.
Person Religion Group that a person belongs to in reference to their fundamental beliefs and practices.
External Identifier External Identifier enables the ability to capture a third party payroll identifier and time clock badge identifier
for a person assignment.
Worker Extra Information Represents the extensible structure for the worker.
Assignment Work Defines information about the HR budget values for an assignment.
Measure
Employment Terms Work Defines information about the HR budget values for a work terms record.
Measure
Employment Terms Extra Represents the extensible structure for the employment terms.
Information
Worker Person working for an enterprise, for example, Mask DateOfBirth, remove all non-mandatory attributes
employee or contingent worker.
Person Address Postal address for a person. Remove any date-effective updates, overwrite with a generic
address.
Person Name Common and legislative-specific name components Remove date-effective updates.
for a person. Remove non-mandatory attributes. Mask Last Name.
Person Phone Primary phone details for a person. Remove non-mandatory attributes. Mask Phone Number.
Work A work relationship is the highest level in the Remove non-mandatory attributes. Mask mandatory.
Relationship employment model and exists for every worker for a Date Start, Actual Termination Date and Worker Type cannot be
Legal Employer. changed.
Employment Second level in the employment model that Remove non-mandatory attributes. Mask mandatory.
Terms captures the terms and conditions associated with Legal Employer cannot be changed.
one or more assignments.
Assignment Lowest level in the employment model, which Remove non-mandatory attributes. Mask mandatory.
identifies the details of the work to be performed. Legal Employer cannot be changed.
Contract Defines the contract associated with employment Remove non-mandatory attributes. Mask mandatory.
terms, for example, contract type and duration.
An example Worker.dat file for disposing a single ex-employee could look something like this:
SET PURGE_FUTURE_CHANGES Y
METADATA|Worker|PersonId|PersonNumber|EffectiveStartDate|DateOfBirth|DateOfDeath|CountryOfBirth|RegionOf
Birth|TownOfBirth|ApplicantNumber|BloodType|CorrespondenceLanguage
MERGE|Worker|300100074926164|EJ10041|1982/02/08|1962/02/13|#NULL|#NULL|#NULL|#NULL|#NULL|#NULL|#NULL
METADATA|PersonAddress|PersonAddrUsageId|PersonId|EffectiveStartDate|AddressType|Country|AddressLine1|Ad
dressLine2|AddressLine3|AddressLine4|TownOrCity|Region1|Region2|PostalCode
MERGE|PersonAddress|300100074926170|300100074926164|1982/02/08|HOME|US|Masked
Address|#NULL|#NULL|#NULL|New York|New York|NY|10130
METADATA|PersonCitizenship|CitizenshipId|PersonId
DELETE|PersonCitizenship|300100074926173|300100074926164
DELETE|PersonCitizenship|300100075017914|300100074926164
METADATA|PersonDeliveryMethod|DeliveryMethodId|PersonId
DELETE|PersonDeliveryMethod|300100074926174|300100074926164
To achieve this:
Identify if any additional formatting or masking actions are required for the data being extracted.
For example, if the attribute is non-mandatory and is to be set to null (blank), the source will be the #NULL tag used
by HDL to nullify non-mandatory attribute values. If however, the attribute is used to identify the record to update or
delete, the attribute value needs to be extracted using the HCM Extract. Some attributes may need to be set to a
constant value to mask the existing value. Specify which value will be used to mask the attribute.
HCM Extract outputs dates in a timestamp format not compatible with HDL. When extracting dates you must also
format them to the YYYY/MM/DD format required by HDL. There will be an action required for all date attributes.
Additionally if you want to achieve a masked value by adjusting an existing database value, you will need an action
to generate the masked value. An example would be to adjust the employee’s start date by 20 years to be used to
mask their date of birth.
Worker
Requirement One record spanning employment for the ex-employee
Instruction MERGE
Discriminator Worker
Attributes
Attribute Source Action
DateOfDeath ‘#NULL’
CountryOfBirth ‘#NULL’
RegionOfBirth ‘#NULL’
TownOfBirth ‘#NULL’
ApplicantNumber ‘#NULL’
BloodType ‘#NULL’
CorrespondenceLanguage ‘#NULL’
Person Address
Requirement One record spanning employment for the parent ex-employee
Instruction MERGE
Discriminator PersonAddress
Attributes
Attribute Source Action
Country ‘US’
AddressLine1 ‘MASKED’
AddressLine2 ‘#NULL’
AddressLine3 ‘#NULL’
AddressLine4 ‘#NULL’
Region2 ‘NY’
PostalCode ‘10130’
Sex ‘#NULL’
MaritalStatus ‘#NULL’
Person Name
Requirement One record spanning employment for the parent ex-employee
Instruction MERGE
Discriminator PersonName
Attributes
HDL Attribute Source Action
LastName ‘MASKED’
FirstName ‘#NULL’
MiddleNames ‘#NULL’
Title ‘#NULL’
PreNameAdjunct ‘#NULL’
Suffix ‘#NULL’
KnownAs ‘#NULL’
PreviousLastName ‘#NULL’
Work Relationship
Requirement All work relationship records for the parent ex-employee
Instruction MERGE
Discriminator WorkRelationship
Attributes
HDL Attribute Source Action
ActionCode ‘RESIGNATION’
ReasonCode ‘RESIGN_PERSONAL’
Employment Terms
Requirement All employment terms records for the parent work relationship
Instruction MERGE
Discriminator WorkTerms
Attributes
HDL Attribute Source Action
PeopleGroup ‘#NULL’
DateProbationEnd ‘#NULL’
WorkerCategory ‘#NULL’
AssignmentCategory ‘#NULL’
EstablishmentId ‘#NULL’
ExpenseCheckSendToAddress ‘#NULL’
GradeId ‘#NULL’
GradeLadderPgmId ‘#NULL’
HourlySalariedCode ‘#NULL’
InternalBuilding ‘#NULL’
InternalFloor ‘#NULL’
InternalLocation ‘#NULL’
InternalMailstop ‘#NULL’
InternalOfficeNumber ‘#NULL’
JobId ‘#NULL’
LabourUnionMemberFlag ‘#NULL’
LocationId ‘#NULL’
ManagerFlag ‘#NULL’
NormalHours ‘#NULL’
Frequency ‘#NULL’
NoticePeriod ‘#NULL’
NoticePeriodUOM ‘#NULL’
OrganizationId ‘#NULL’
PositionId ‘#NULL’
ProbationPeriod ‘#NULL’
ProbationUnit ‘#NULL’
ProjectedEndDate ‘#NULL’
ProectedStartDate ‘#NULL’
PropopsedWorkerType ‘#NULL’
ProposedUserPersonType ‘#NULL’
RetirementAge ‘#NULL’
RetirementDate ‘#NULL’
SpecialCeilingStepId ‘#NULL’
TaxAddressId ‘#NULL’
EndTime ‘#NULL’
StartTime ‘#NULL’
VendorSiteId ‘#NULL’
WorkAtHomeFlag ‘#NULL’
VendorId ‘#NULL’
CollectiveAgreementId ‘#NULL’
FullPartTime ‘#NULL’
PermanentTemporary ‘#NULL’
Assignment
Requirement All assignment records for the parent work term record
Instruction MERGE
Discriminator Assignment
Attributes
HDL Attribute Source Action
PeopleGroup ‘#NULL’
DateProbationEnd ‘#NULL’
WorkerCategory ‘#NULL’
AssignmentCategory ‘#NULL’
EstablishmentId ‘#NULL’
ExpenseCheckSendToAddress ‘#NULL’
GradeId ‘#NULL’
GradeLadderPgmId ‘#NULL’
HourlySalariedCode ‘#NULL’
InternalBuilding ‘#NULL’
InternalFloor ‘#NULL’
InternalLocation ‘#NULL’
InternalMailstop ‘#NULL’
InternalOfficeNumber ‘#NULL’
JobId ‘#NULL’
LabourUnionMemberFlag ‘#NULL’
LocationId ‘#NULL’
ManagerFlag ‘#NULL’
NormalHours ‘#NULL’
Frequency ‘#NULL’
NoticePeriod ‘#NULL’
NoticePeriodUOM ‘#NULL’
OrganizationId ‘#NULL’
PositionId ‘#NULL’
ProbationPeriod ‘#NULL’
ProbationUnit ‘#NULL’
ProjectedEndDate ‘#NULL’
ProectedStartDate ‘#NULL’
PropopsedWorkerType ‘#NULL’
ProposedUserPersonType ‘#NULL’
RetirementAge ‘#NULL’
RetirementDate ‘#NULL’
SpecialCeilingStepId ‘#NULL’
TaxAddressId ‘#NULL’
EndTime ‘#NULL’
StartTime ‘#NULL’
VendorSiteId ‘#NULL’
WorkAtHomeFlag ‘#NULL’
VendorId ‘#NULL’
CollectiveAgreementId ‘#NULL’
FullPartTime ‘#NULL’
PermanentTemporary ‘#NULL’
Person Citizenship
Requirement All citizenship records for the parent ex-employee
Instruction DELETE
Discriminator PersonCitizenship
Attributes
HDL Attribute Source Action
Person E-mail
Requirement All e-mail records for the parent ex-employee
Instruction DELETE
Discriminator PersonEmail
Attributes
HDL Attribute Source Action
Person Ethnicity
Requirement All ethnicity records for the parent ex-employee
Instruction DELETE
Discriminator PersonEthnicity
Attributes
HDL Attribute Source Action
Person Passport
Requirement All passport records for the parent ex-employee
Instruction DELETE
Discriminator PersonPassport
Attributes
HDL Attribute Source Action
Person Phone
Primary phone numbers cannot be purged, whilst secondary phone numbers exist. To provide obfuscation is one
step, mask the primary phone number whilst deleting the secondary phone numbers.
CountryCodeNumber ‘#NULL’
AreaCode ‘#NULL’
PhoneNumber ‘000000’
Extension ‘#NULL’
SpeedDialNumber ‘#NULL’
DateFrom ‘’
CountryCodeNumber ‘’
AreaCode ‘’
PhoneNumber ‘’
Extension ‘’
SpeedDialNumber ‘’
Person Religion
Requirement All religion records for the parent ex-employee
Instruction DELETE
Discriminator PersonReligion
Attributes
HDL Attribute Source Action
Person Visa
Requirement All visa records for the parent ex-employee
Instruction DELETE
Discriminator PersonVisa
Attributes
HDL Attribute Source Action
The effective start date is also required when deleting visa records.
Person Image
Requirement All image records for the parent ex-employee
Instruction DELETE
Discriminator PersonImage
Attributes
HDL Attribute Source Action
Assignment Supervisor
Requirement All supervisor records for the parent assignment
Instruction DELETE
Now that all components, attributes, attribute values and actions have been identified the next steps are:
Map the attributes that need values to be extracted to the user entity and attribute that will provide the
data.
Data Groups
HDL
Name Data Restriction
Discriminator
Terminated Workers n/a All ex-employees terminated over 6 years ago, that haven’t previously
been obfuscated.
Worker Worker A single person related data record for each Terminated Worker
Legislative Data PersonLegislativeData All legislative data records for each Terminated Worker
Name PersonName A single name record spanning the employment of each Terminated
Worker
Work Relationship WorkRelationship All work relationships for each Terminated Worker
Employment Terms WorkTerms All employment terms for each Work Relationship
Delivery Method PersonDeliveryMethod All delivery methods for each Terminated Worker
Drivers License PersonDriversLicense All driver license records for each Terminated Worker
National Identifier PersonNationalIdentifier All national identifier records for each Terminated Worker
Detail Record
PersonVisa
For example:
Worker
User Entity PER_EXT_SEC_PERSON_UE
Attributes
Person Address
User Entity PER_EXT_PERSON_ADDRESSES_UE
Attributes
This mapping example is not extended further as the complete information is provided in the Data Groups section of
Defining the HCM Extract.
The Creating the Extract section provides step by step instructions and screen shots on how to create and test a
HCM Extract.
Filter Criteria
Filter Criteria
Detail Record
Sequence 10
Name Population
User Entity Attributes
Overridden
Attribute Short Code HDL Attribute
Person Number
As the image details are available within this user entity, the PersonImage records can be
generated using this data, rather than creating a separate data group.
Parent Data Group Parent Data Group Database Item Database Item
Detail Record
Sequence 10
Name Worker
User Entity Attributes
Overridden
Attribute Short Code HDL Attribute
Rule Attributes
Both rule based attributes will use formulae to convert the value extracted for the attribute that has a short
code of Start_Date, namely ‘Extract Person Effective Start Date’.
Two separate rule attributes are required to output the two different converted values of this attribute. ‘Person
Effective Start Date’ will output the value in the HDL date format. ‘Date of Birth’ will output the date 20 years
prior to be used to mask the date of birth.
Output
Attribute Column Rule HDL Attribute
All rule attributes used for formatting dates should have a Data Type of Text.
Hierarchy Traversal
Record
All hierarchy traversal records must have a Type of Hierarchy traversal only.
Parent Data Group Parent Data Group Database Item Database Item
Terminated Worker Extract Relationship Person Id Extract Person Address Usage Person ID
Detail Record
Sequence 10
Name PersonAddress
User Entity Attributes
Overridden
Attribute Short Code HDL Attribute
Rule Attributes
All rule attributes used for formatting dates should have a Data Type of Text.
Hierarchy Traversal
Record
All hierarchy traversal records must have a Type of Hierarchy traversal only.
Parent Data Group Parent Data Group Database Item Database Item
Detail Record
Sequence 10
Name PersonLegislativeData
User Entity Attributes
Overridden
Attribute Short Code HDL Attribute
Person Start Date is required to filter which records are included by the eText template.
Rule Attributes
Output
Attribute Column Rule HDL Attribute
All rule attributes used for formatting dates should have a Data Type of Text.
Hierarchy Traversal
Record
All hierarchy traversal records must have a Type of Hierarchy traversal only.
Parent Data Group Parent Data Group Database Item Database Item
Terminated Worker Extract Relationship Person Id Extract Historical Person Name Person
Id
Terminated Worker Extract Relationship Date Start Extract Historical Person Name Effective
Start Date
Detail Record
Sequence 10
Name PersonName
User Entity Attributes
Overridden
Attribute Short Code HDL Attribute
Rule Attributes
Output
Attribute Column Rule HDL Attribute
All rule attributes used for formatting dates should have a Data Type of Text.
Hierarchy Traversal
Record
All hierarchy traversal records must have a Type of Hierarchy traversal only.
Parent Data Group Parent Data Group Database Item Database Item
Terminated Worker Extract Relationship Period Of Service Id Extract Relationship Period Of Service Id
Detail Record
Sequence 10
Name WorkRelationship
User Entity Attributes
Overridden
Attribute Short Code HDL Attribute
Rule Attributes
Output
Attribute Column Rule HDL Attribute
All rule attributes used for formatting dates should have a Data Type of Text.
Hierarchy Traversal
Record
All hierarchy traversal records must have a Type of Hierarchy traversal only.
Parent Data Group Parent Data Group Database Item Database Item
Work Relationship Extract Relationship Period Of Service Id Extract Historical Assignment Period of
service ID
Overridden
Attribute Short Code HDL Attribute
Rule Attributes
Output
Attribute Column Rule HDL Attribute
All rule attributes used for formatting dates should have a Data Type of Text.
Hierarchy Traversal
Record
All hierarchy traversal records must have a Type of Hierarchy traversal only.
Parent Data Group Parent Data Group Database Item Database Item
Employment Terms Extract Historical Assignment Work Term Extract Historical Assignment Work Term
ID ID
Employment Terms Extract Historical Assignment Effective Extract Historical Assignment Effective
Start Date - Context Item Start Date - Context Item
Employment Terms Extract Historical Assignment Effective Extract Historical Assignment Effective
Sequence Sequence
Detail Record
Sequence 10
Overridden
Attribute Short Code HDL Attribute
Rule Attributes
Output
Attribute Column Rule HDL Attribute
All rule attributes used for formatting dates should have a Data Type of Text.
Hierarchy Traversal
Record
All hierarchy traversal records must have a Type of Hierarchy traversal only.
Parent Data Group Parent Data Group Database Item Database Item
Detail Record
Sequence 10
Name PersonCitizenship
User Entity Attributes
Overridden
Attribute Short Code HDL Attribute
Hierarchy Traversal
Record
Parent Data Group Parent Data Group Database Item Database Item
Detail Record
Sequence 10
Name PersonDeliveryMethod
User Entity Attributes
Overridden
Attribute Short Code HDL Attribute
Hierarchy Traversal
Record
All hierarchy traversal records must have a Type of Hierarchy traversal only.
Parent Data Group Parent Data Group Database Item Database Item
Detail Record
Sequence 10
Overridden
Attribute Short Code HDL Attribute
Hierarchy Traversal
Record
All hierarchy traversal records must have a Type of Hierarchy traversal only.
Parent Data Group Parent Data Group Database Item Database Item
Terminated Worker Extract Relationship Person Id Person All E-Mail Person All ID
Detail Record
Sequence 10
Name PersonEmail
User Entity Attributes
Overridden
Attribute Short Code HDL Attribute
Hierarchy Traversal
Record
All hierarchy traversal records must have a Type of Hierarchy traversal only.
Detail Record
Sequence 10
Name PersonEthnicity
User Entity Attributes
Overridden
Attribute Short Code HDL Attribute
Hierarchy Traversal
Record
All hierarchy traversal records must have a Type of Hierarchy traversal only.
Parent Data Group Parent Data Group Database Item Database Item
Detail Record
Sequence 10
Name PersonNationalIdentifier
User Entity Attributes
Overridden
Attribute Short Code HDL Attribute
Hierarchy Traversal
Record
All hierarchy traversal records must have a Type of Hierarchy traversal only.
Parent Data Group Parent Data Group Database Item Database Item
Detail Record
Sequence 10
Name PersonPassport
User Entity Attributes
Overridden
Attribute Short Code HDL Attribute
Hierarchy Traversal
Record
All hierarchy traversal records must have a Type of Hierarchy traversal only.
Parent Data Group Parent Data Group Database Item Database Item
Detail Record
Sequence 10
Name PersonPhone
User Entity Attributes
Overridden
Attribute Short Code HDL Attribute
Output
Attribute Column Rule HDL Attribute
All rule attributes used for formatting dates should have a Data Type of Text.
Hierarchy Traversal
Record
All hierarchy traversal records must have a Type of Hierarchy traversal only.
Parent Data Group Parent Data Group Database Item Database Item
Detail Record
Sequence 10
Name PersonReligion
User Entity Attributes
Overridden
Attribute Short Code HDL Attribute
Hierarchy Traversal
Record
All hierarchy traversal records must have a Type of Hierarchy traversal only.
Parent Data Group Parent Data Group Database Item Database Item
Detail Record
Sequence 10
Name PersonVisa
Overridden
Attribute Short Code HDL Attribute
Rule Attributes
Output
Attribute Column Rule HDL Attribute
All rule attributes used for formatting dates should have a Data Type of Text.
Hierarchy Traversal
Record
All hierarchy traversal records must have a Type of Hierarchy traversal only.
Note: The ObfuscateWorkerTemplate.rtf file used in this worked example is available on My Oracle Support from the
same document as this white paper.
Create a single rich text format document with the following sections:
<NEW WORKER_HEADER
RECORD>
<DISPLAY 1=1
CONDITION>
<MAXIUMUM <FORMAT> <DATA> <TAG> <COMMENTS>
LENGTH>
100 Alpha 'METADATA|Worker'
1 Alpha '|'
100 Alpha 'PersonId' PersonId
1 Alpha '|'
100 Alpha 'PersonNumber' PersonNumber
1 Alpha '|'
100 Alpha 'EffectiveStartDate' EffectiveStartDate
1 Alpha '|'
100 Alpha 'DateOfBirth' DateOfBirth
1 Alpha '|'
100 Alpha 'DateOfDeath' DateOfDeath
1 Alpha '|'
100 Alpha 'CountryOfBirth' CountryOfBirth
1 Alpha '|'
100 Alpha 'RegionOfBirth' RegionOfBirth
1 Alpha '|'
100 Alpha 'TownOfBirth' TownOfBirth
1 Alpha '|'
100 Alpha 'ApplicantNumber' ApplicantNumber
1 Alpha '|'
100 Alpha 'BloodType' BloodType
1 Alpha '|'
100 Alpha 'CorrespondenceLanguage' CorrespondenceLanguage
If defining a level it must have the same name as the data group name used to extract the attributes referenced in
the record definition.
<NEW Worker
RECORD>
<DISPLAY 1=1
CONDITION>
<MAXIUMUM <FORMAT> <DATA> <TAG> <COMMENTS>
LENGTH>
100 Alpha 'MERGE|Worker'
1 Alpha '|'
100 Alpha Extract_Person_ID PersonId
<LEVEL> Person_Address
<NEW PersonAddress
RECORD>
<DISPLAY 1=1
CONDITION
>
<MAXIUMUM <FORMAT <DATA> <TAG <COMMENTS>
LENGTH> > >
100 Alpha 'MERGE|PersonAddress'
1 Alpha '|'
100 Alpha Extract_Person_Address_Usage_ID PersonAddrUsageI
d
1 Alpha '|'
100 Alpha Extract_Person_Address_Usage_Person_ID PersonId
1 Alpha '|'
100 Alpha Person_Address_Effective_Start_Date EffectiveStartDa
te
1 Alpha '|'
100 Alpha Extract_Person_Address_Usage_Address_T AddressType
ype
1 Alpha '|'
100 Alpha 'US' Country
1 Alpha '|'
100 Alpha 'Masked Address' AddressLine1
1 Alpha '|'
100 Alpha '#NULL' AddressLine2
1 Alpha '|'
100 Alpha '#NULL' AddressLine3
1 Alpha '|'
100 Alpha '#NULL' AddressLine4
1 Alpha '|'
100 Alpha 'New York' TownOrCity
1 Alpha '|'
100 Alpha 'New York' Region1
1 Alpha '|'
Once you have defined your eText template, follow the instructions provided in the Uploading the eText Template
section. Define the Inbound Interface delivery option and test.
This concludes the worked example for the worker business object.
Users can be loaded using HCM Data Loader. These records will then be processed when running the Send
Pending LDAP Requests process. When using the User HDL object to create Users, a Person Number must be
provided for an existing person. The User HDL Object is used to create the User Account records for those person
records that were already created. HDL can also be used to delete users using the person number. Here is an
example:
METADATA|User|PersonNumber
DELETE|User|1111111
CONNECT W ITH US
blogs.oracle.com/oracle Copyright © 2014, Oracle and/or its affiliates. All rights reserved. This document is provided for information purposes only, and the
contents hereof are subject to change without notice. This document is not warranted to be error-free, nor subject to any other
warranties or conditions, whether expressed orally or implied in law, including implied warranties and conditions of merchantability or
facebook.com/oracle fitness for a particular purpose. We specifically disclaim any liability with respect to this document, and no contractual obligations are
formed either directly or indirectly by this document. This document may not be reproduced or transmitted in any form or by any
twitter.com/oracle means, electronic or mechanical, for any purpose, without our prior written permission.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
oracle.com
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and
are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are
trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group. 1117