Professional Documents
Culture Documents
FBL R7 and R8 User S Guide
FBL R7 and R8 User S Guide
November 2014
File-Based Loader is suitable for loading large volumes (tens of thousands) of complex hierarchical
objects. You can upload data from any source, provided that, when it is loaded to the Load Batch Data
stage tables, it is in a format that satisfies Oracle Fusion business rules. (See the document R7 File-
Based Loader Column Mapping Spreadsheet in My Oracle Support document ID 1595283.1 for
business rules governing supported objects.)
2
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
The key stages of the process are shown in the following figure:
Figure 1. A Summary of the Data-Load Process Using Oracle Fusion HCM File-Based Loader
Each step of this process is covered in more detail beginning on page 12.
3
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
1 Actions None
3 Location None
4 Business Unit None You must map each business unit to a default set
immediately after load.
5 Grade None
10 Establishment None
19 Work Relationship Person, Position Includes contracts for both 2-tier and 3-tier
employment models.
22 Tree None
4
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
Via upload, you can create and update business objects, and you can upload the complete history for
any object. However, you cannot delete objects via upload, nor can you upload attachments.
5
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
In Oracle Fusion Human Capital Management 11g Release 5 (11.1.5), File-Based Loader uses an SFTP
server for data delivery to Oracle Fusion HCM. From Oracle Fusion Human Capital Management 11g
Release 7 (11.1.7) onwards, Oracle WebCenter Content replaces SFTP.
WebCenter Content is a comprehensive suite of content-management tools that is fully integrated in
Oracle Fusion Applications. This document assumes that you are using WebCenter Content for
delivery of data files to Oracle Fusion HCM. (Existing users of SFTP should refer to the Oracle
Fusion Human Capital Management 11g Release 5 (11.1.5) File-Based Loader User’s Guide, Document
ID 1533860.1, for SFTP-related information.)
To load data via Oracle WebCenter Content, you must have one of these job roles:
Human Capital Management Application Administrator
Human Capital Management Integration Specialist
Both of these job roles inherit the duty role File Import and Export Management Duty.
Flexfield Support
File-Based Loader supports the upload of descriptive flexfield data for the following business objects:
Assignment
Department
Grade
Job
Location
Person, Person Citizenships, and Person Ethnicity
(For descriptive flexfields that are not supported by File-Based Loader in Oracle Fusion HCM Release
7 and Release 8, a work-around exists as described in Loading Flexfields on page 30.)
6
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
Full Implementations
If you are performing a full implementation of Oracle Fusion HCM, then you can use File-Based
Loader to bulk-load your existing HCM data at appropriate stages in the implementation. Typically,
you load each type of data once only for this type of implementation. Following a successful upload,
you manage your data in Oracle Fusion HCM.
For more information about full implementations of Oracle Fusion HCM, see:
Oracle Fusion Applications Workforce Deployment Implementation Guide
Oracle Fusion Applications Workforce Development Implementation Guide
Oracle Fusion Applications Compensation Management Implementation Guide
Coexistence Implementations
In a coexistence scenario, you maintain your existing HR applications alongside Oracle Fusion Talent
Management and Oracle Fusion Workforce Compensation. For this type of implementation, you:
Move talent management data permanently to Oracle Fusion HCM, which becomes the
system of record for talent management data.
Upload other types of data, such as person records, periodically to Oracle Fusion HCM. The
source system remains the system of record for this data.
In a standard Coexistence for HCM implementation, the only supported source environments are
Oracle PeopleSoft Enterprise Human Resources and Oracle E-Business Suite Human Resources.
From these environments, data upload is managed using HR2HR.
Note: The Coexistence for HCM feature based on HR2HR is not available for new coexistence
implementations.
The Coexistence for HCM feature is documented in the Oracle Fusion Applications Coexistence for
HCM Implementation Guide.
7
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
To implement a new HCM coexistence scenario, for any source system, you can use File-Based Loader
for data upload. When using File-Based Loader:
You must define the mapping between your source data and Oracle Fusion HCM and manage
the data extract from your source system.
In most cases, you do not have to upload complete business objects in every data upload.
(The exception to this rule is work relationships. You must upload the entire work
relationship object whenever you update any of its components.)
No mechanism exists in File-Based Loader for extracting compensation data from Oracle
Fusion HCM and returning it to the source environment. However, you can use HCM
Extracts to extract compensation data if you plan to use Oracle Fusion Workforce
Compensation in a coexistence scenario.
When implementing a coexistence scenario, you can follow the general guidance in the Oracle
Fusion Applications Coexistence for HCM Implementation Guide and the implementation task
order in the Coexistence Implementation Checklist in the Data Conversion Reference Library on
My Oracle Support (document ID 1595261.1).
However, the details of the data-upload process are as described in this document (the Oracle
Fusion HCM File-Based Loader User’s Guide).
See also: E-Business Suite HCM Extraction Toolkit for Fusion HCM Integration Using File Based
Loader (Document ID 1556687.1).
Security Considerations
To load data via Oracle WebCenter Content, you must have the duty role File Import and Export
Management Duty. By default, these job roles inherit the File Import and Export Management Duty
role:
Human Capital Management Application Administrator
Human Capital Management Integration Specialist
To load data from the Load Batch Data stage tables to the Oracle Fusion application tables, you must
have the HCM Batch Data Loading Duty role. By default, these job roles inherit the HCM Batch Data
Loading Duty role:
Application Implementation Consultant
Human Capital Management Application Administrator
8
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
Best Practices
For successful use of File-Based Loader, follow these recommendations.
Are you moving all of your data to Oracle Fusion HCM or implementing a coexistence scenario?
If your deployment model requires that data be updated via upload, then devise a strategy for
ongoing data maintenance.
Identify the business objects that you are planning to upload to Oracle Fusion HCM and their source
systems. Review and analyze this source data, and verify that it is both accurate and current. If it is not,
then devise a plan to correct any problems before you attempt to load it. In particular:
Ensure that a manager is identified for every worker and that the information is accurate.
For jobs and positions, ensure that accurate job codes and titles exist in the legacy system.
For job history, establish the accuracy of any historical data. Understand whether all historical data
must be uploaded or just key events, such as hire, promotion, and termination.
Cleaning up the legacy data will minimize the problems that can occur when you upload the data to
Oracle Fusion HCM.
Set the configuration parameters for the Load Batch Data process (as defined in Step 1 on page 12)
appropriately.
Understand the Oracle Fusion HCM implementation to which you are importing data. For example,
identify the legal employers, business units, and reference data sets.
Know which Oracle Fusion lookups you need to set and identify required functional mappings (for
example, worker numbers, job definitions, and position definitions).
Design your data transformations. For any business object that you plan to load, refer to the R7 File-
Based Loader Column Mapping Spreadsheet in My Oracle Support document ID 1595283.1 for
information about the structure of the target Oracle Fusion object.
Always perform a test load to the stage environment of a small amount of data for all object types
that you need to load. Only when the test loads are successful and you have validated the data
transformations should you load data to the production environment.
9
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
Validate your data using the Data-File Validator utility, as described in My Oracle Support document
ID 1587716.1. The Data-File Validator enables you to perform most data-formatting validations
before you load data to Oracle Fusion HCM. You run the validator in the source environment to
validate either individual .dat files or all .dat files in a zip file. HTML output from the validator lists
validation errors, which you can correct in the .dat file.
Load objects in the prescribed order to avoid data-dependency errors. For initial loads, you are
recommended to load each object type separately so that any problems can be more easily diagnosed
and fixed. If errors occur, fix them before attempting to load the next object.
Map each business unit to a default set immediately after load, as described in the My Oracle
Support document ID 1458769.1. The default set, also known as the Reference Data Set,
corresponds to the Reference Data Set Code value on the Manage Business Unit Set Assignments
page. More information on Reference Data Set mapping is available in the My Oracle Support
document ID 1521801.1.
Do not mix your use of HCM File-Based Loader with HCM Spreadsheet Data Loader for the same
data in a single environment. File-Based Loader keeps track of the data it loads to determine whether
data is to be created or updated. If you load data either interactively or using HCM Spreadsheet Data
Loader, then File-Based Loader will be unaware of those changes, which may cause errors.
You can use both tools during an implementation. HCM Spreadsheet Data Loader is recommended
for setting up training and conference-room pilot (CRP) environments. File-Based Loader is
recommended for full data uploads to both stage and production environments.
You may need to delete data loaded to the stage environment. Deletion scripts are preinstalled in
your stage environment. Be aware that these scripts delete all data rather than just the rows in error.
10
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
Related Documentation
Business Object Key Map Extract for File-Based Loader, Document 1595283.1
Data File Validation for File Based Loader, Document 1587716.1
Reference Data Set Assignments for Business Unit, Document 1458769.1
E-Business Suite HCM Extraction Toolkit for Fusion HCM Integration Using File Based Loader,
Document 1556687.1
11
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
Configuration Parameters
The configuration parameters and their default values are shown in Table 2. Several of these parameters
are not directly relevant to File-Based Loader, and in most cases you can use the default value shown
here. No value is shown in the table for parameters that are blank by default and that you can leave
blank.
You must set:
Loader Number of Processes to 4 or 8. This parameter is set to 1 by default.
More information about some key parameters is provided in Table 2.
TABLE 2. LOAD BATCH DATA CONFIGURATION PARAMETERS
ODI Password
12
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
From Oracle Fusion HCM Release 7 onwards, this parameter is replaced by the AutoLoad parameter
on the LoaderIntegrationService web service, as described on page 39. (If you are using SFTP rather
than WebCenterContent, then you use the AutoLoad parameter on the InboundLoaderProcess web
service to control automatic loading.)
You do not need to change the default value of this parameter.
The number of top-level business objects to be processed by Load Batch Data before the cache is
cleared.
The number of top-level business objects a single Load Batch Data thread processes in a single action.
Set the chunk size based on the total number of objects to be loaded and the Loader Number of
Processes value.
The maximum number of errors that can occur on a Load Batch Data thread before processing
terminates. If an error occurs during the processing of a complex business object (such as a person
record), then all rows for that business object are rolled back and marked as Error in Row. If you leave
this parameter set to 100, then the load process stops after 100 errors occur.
The number of Load Batch Data threads to run in parallel. This value is 1 by default. You are
recommended to set this value to 4 or 8. If you leave this parameter set to 1, then the Load Batch Data
process does not run multithreaded. For large data volumes, the performance impact can be severe.
The number of top-level business objects to be processed before the objects are committed to the
application tables.
ODI Language
Determines the character set used for data loading. Do not change the default value of this parameter.
Used for staging .dat files. Do not change the default value of this parameter.
13
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
This parameter does not have an effect on the FBL configuration. You can enter a string value and
continue.
From Oracle Fusion HCM Release 7 onwards, this parameter is replaced by the LoadType parameter
on the LoaderIntegrationService web service, as described on page 39. (If you are using SFTP rather
than WebCenter Content, then you use the LoadType parameter on the InboundLoaderProcess web
service to select the load type.)
You do not need to change the default value of this parameter.
Determines how user names are constructed when you import person records. To use the enterprise
default format, leave this parameter value blank. If you prefer, you can specify that either person
numbers or assignment numbers be used as user names by setting User Name Expression to one of
the following expressions:
loaderCtx.getPersonAttr(“PersonNumber”)
loaderCtx.getAssignmentAttr(“AssignmentNumber”)
To set these parameters, you perform the task Manage HCM Configuration for Coexistence from the
Setup and Maintenance work area.
14
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
Figure 2. Navigation: Setup and Maintenance - Manage HCM Configuration for Coexistence
When you run the Load Batch Data process for individual batches, you can override the values of the
Loader Chunk Size, Loader Maximum Errors, and Loader Number of Processes parameters. However,
that should not be necessary. Typically, you set these configuration parameters once only.
15
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
16
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
Figure 3. Navigation: Setup and Maintenance - Manage HCM Configuration for Coexistence
Once the process is submitted, make a note of the process ID and click Search to refresh the results in
the Generate Mapping File for HCM Business Objects section. You may need to click Search more
than once until the process completes. Process Status 12 means that the process completed
successfully.
Process Status values are described in the following table.
TABLE 4. GENERATE MAPPING FILE FOR HCM BUSINESS OBJECTS: PROCESS STATUS VALUES
2 READY The job request has been dispatched and is awaiting processing.
4 COMPLETED The job request has completed and postprocessing has started.
7 CANCELLING The job request has been canceled and is awaiting acknowledgement.
17 FINISHED The job request and all child job requests have finished.
For processes that complete with errors (status 10), search for the process ID in the Scheduled
Processes work area (Navigator - Tools - Scheduled Processes) and view the associated log file.
17
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
If the process does not complete in a reasonable time, search for your process ID in the Scheduled
Processes work area and note the Scheduled Time for your process. This time is set automatically and
may be some time after the submission time.
The Generate Mapping File for HCM Business Objects process creates one or more data files (.dat
files) for each business object. The .dat files are packaged automatically in a zipped data file that is
written to the WebCenter Content server. To download the file:
1. Open the File Import and Export page (Navigator - Tools - File Import and Export).
2. On the File Import and Export page, set the Account value in the Search section to
hcm/dataloader/export and click Search. The zip file of reference information appears in
the search results:
3. Click the file name in the search results. When prompted, save the file locally.
The zip file contains the following individual .dat files for the business objects that you defined in Step
2 of the File-Based Loader process:
18
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
XR_ACTION_REASON.dat
XR_ACTION_REASON_USAGE.dat
XR_ACTION_TYPE.dat
Enterprise XR_ENTERPRISE.dat
XR_HRT_CONTENT_TYPE_RELAT.dat
XR_HRT_QUALIFIER_SET.dat
XR_HRT_RELATION_CONFIG.dat
XR_PAY_ELEMENT_TYPE_SUPPL.dat
XR_PAY_INPUT_VALUE_SUPPL.dat
Notes:
Whenever you make changes to any of the Oracle Fusion business objects identified in Step 2,
remember that you need to regenerate the mapping file of cross-reference information. For example,
if you define additional person types, then you need to regenerate the GUIDs for the Oracle Fusion
instance.
The GUID values associated with an Oracle Fusion instance do not change. However, GUIDs vary
among instances. Therefore, the GUIDs that you generate from the stage environment are different
from those that you generate from the production environment. You need to generate them in both
environments.
As an alternative to running the Generate Mapping File for HCM Business Objects process, you can
use the HCM extract described in the document Business Object Key Map Extract for File-Based
Loader (My Oracle Support article ID 1595283.1).
19
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
Row 2 (from FusionGUID through Description2) identifies the values in each subsequent row:
FusionGUID is the unique, 32-character alphanumeric identifier used by both Oracle Fusion HCM
and source applications such as Oracle PeopleSoft and Oracle EBS.
FusionKey is the value that is used by Oracle Fusion HCM.
PeopleSoftKey is the value that is used by the source system (which may be Oracle PeopleSoft or
some other system).
Description and Description2 describe the value identified by the keys.
More information about how GUIDs are processed for records sourced in either Oracle Fusion HCM
or externally is provided in the remainder of this section.
Key Mapping
Records loaded from an external source to Oracle Fusion HCM must be uniquely identified in both
source and target environments. In addition, a mapping must be maintained between the source and
target keys.
Keys are used to identify:
The row being created or updated
The parent of the row being created or updated
20
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
Each record sourced externally includes a pointer to the external record, which is the record’s Globally
Unique Identifier (GUID). Oracle Fusion HCM maintains a Key Mapping table
(HRC_LOADER_BATCH_KEY_MAP) that records, for each business object, its type, source
GUID, and Oracle Fusion ID (the ID by which it is identified in Oracle Fusion). For example:
OBJECT TYPE SOURCE GUID ORACLE FUSION ID
When a record is imported to the Load Batch Data stage tables, the import process compares the
record’s source GUID and object-type values with values in the Key Mapping table:
If the values exist in the Key Mapping table, then the process replaces the source GUID in the stage
tables with the Oracle Fusion ID.
If the values do not exist in the Key Mapping table, then an Oracle Fusion ID is generated for the
record, recorded in the Key Mapping table, and used to replace the source GUID in the stage tables.
By the time the data in the stage tables is ready for loading to the Oracle Fusion application tables, all
Oracle Fusion IDs have been allocated. The Oracle Fusion object services can process predefined
Oracle Fusion IDs when creating new records.
For each reference object that originates in Oracle Fusion HCM, the process Generate Mapping File
for HCM Business Objects generates a source GUID and creates a row in the Key Mapping table that
holds both the newly generated GUID and the existing Oracle Fusion ID for the object. The process
also generates a zip file of data files containing the GUIDs for the reference objects, which you import
into your source environment (as described in Step 3). When you import source data that references
these objects to the Load Batch Data stage tables, you must ensure that you include the reference-
object GUIDs so that the correct reference objects can be identified.
Key-Mapping Example
Your source data includes the following records and business objects:
OBJECT TYPE SOURCE GUID NAME DESCRIPTION FOREIGN KEY TO RECORD
21
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
REC ABC 1
REC DEF 2
OBJ TUV 3
OBJ XYZ 4
A predefined extract, Business Object Key Map, is available. This optional extract enables you to:
Extract GUID key-mapping information from the HRC_LOADER_BATCH_KEY_MAP
table to a report or an XML-format file.
Generate GUIDs for objects that were not created using File-Based Loader so that you can
update those objects using File-Based Loader.
More information about the Business Object Key Map extract is available in the document Business
Object Key Map Extract for File-Based Loader, which you can find on My Oracle Support in article
1595283.1.
22
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
23
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
Zip-File Structure
The data that you extract from your source system for upload to Oracle Fusion must be delivered as a
set of data files (.dat files), grouped by object type, in a zip file.
For example, jobs comprise job and job grade data, and departments comprise department and
department details data. If you load both in the same zip file, then the file structure will be:
OBJECT FOLDER DATA-FILE NAME
Department F_DEPARTMENT_DETAIL_VO.dat
F_DEPARTMENT_VO.dat
Job F_JOB_GRADE_VO.dat
F_JOB_VO.dat
Action F_ACTIONS_VO.dat
F_ACTION_REASON_USAGES_VO.dat
ActionReason F_ACTION_REASONS_VO.dat
BusinessUnit F_BUSINESS_UNIT_VO.dat
ContentItem F_CONTENT_ITEM_RATING_DESCRIPTION_VO.dat
24
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
F_CONTENT_ITEM_VO.dat
ContentItemRelationship F_CONTENT_ITEM_RELATIONSHIP_VO.dat
Department F_DEPARTMENT_DETAIL_VO.dat
F_DEPARTMENT_VO.dat
DepartmentTreeNode F_PER_DEPT_TREE_NODE.dat
ElementEntry F_ELEMENT_ENTRY_VALUE_VO.dat
F_ELEMENT_ENTRY_VO.dat
Establishment F_ESTABLISHMENT_VO.dat
Grade F_GRADE_VO.dat
GradeRate F_GRADE_RATE_VALUE_VO.dat
F_GRADE_RATE_VO.dat
Job F_JOB_GRADE_VO.dat
F_JOB_VO.dat
JobFamily F_JOB_FAMILY_VO.dat
Location F_LOCATION_VO.dat
Person F_PERSON_ADDRESS_VO.dat
F_PERSON_EMAIL_VO.dat
F_PERSON_ETHNICITY_VO.dat
F_PERSON_LEGISLATIVE_DATA_VO.dat
F_PERSON_NAME_VO.dat
F_PERSON_NATIONAL_IDENTIFIER_VO.dat
F_PERSON_PHONE_VO.dat
F_PERSON_RELIGION_VO.dat
F_PERSON_TYPE_USAGE_VO.dat
F_PERSON_VO.dat
PersonAbsenceEntry F_PERSON_ABSENCE_ENTRY_VO.dat
PersonAccrualDetail F_PERSON_ACCRUAL_DTL_VO.dat
PersonContact F_PERSON_CONTACT_VO.dat
PersonDocumentation F_PERSON_CITIZENSHIP_VO.dat
F_PERSON_DOCUMENTATION_VO.dat
F_PERSON_VISA_VO.dat
F_PERSON_PASSPORT_VO.dat
PersonEntitlementDetail F_PERSON_PLAN_ENTRY_DTL_VO.dat
PersonMaternityAbsenceEntry F_PERSON_MAT_ABS_ENTRY_VO.dat
Position F_POSITION_GRADE_VO.dat
F_POSITION_VO.dat
25
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
Profile F_PROFILE_ITEM_VO.dat
F_PROFILE_RELATION_VO.dat
F_PROFILE_VO.dat
RatingModel F_RATING_LEVEL_VO.dat
F_RATING_MODEL_VO.dat
Salary F_SALARY_COMPONENT_VO.dat
F_SALARY_VO.dat
SalaryBasis F_SALARY_BASIS_VO.dat
Tree F_FND_TREE.dat
TreeVersion F_FND_TREE_VERSION.dat
WorkRelationship F_ASSIGNMENT_SUPERVISOR_VO.dat
F_ASSIGNMENT_VO.dat
F_ASSIGNMENT_WORK_MEASURE_VO.dat
F_WORK_RELATIONSHIP_VO.dat
F_WORK_TERMS_VO.dat
F_CONTRACT_VO.dat
Batch Names
Each business object is processed as a separate batch. The batch name is formed automatically by
prefixing the object directory name (for example, SalaryBasis or GradeRate) with the internal loader
batch ID. For example:
123456789:Person
987654321:WorkRelationship
If you import and load data manually, then you have the opportunity to specify a meaningful batch
name when you schedule the import or load process. If you import and load data automatically, then
the batch names that are generated automatically are used.
26
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
Data-File Format
Each data file has a predefined format; example .dat files and other FBL sample files are provided in
the Data Conversion Reference Library on My Oracle Support (document ID 1595261.1).
You construct the heading row in the data file for each business object type by concatenating the
Datastore Attribute Names with pipe separators. Heading rows must be in capital letters and spelled as
shown in the example .dat files; however, the columns can appear in any order.
The data lines follow this heading row, with data items also being separated by the pipe character.
The following example shows a single data line from a Department data file:
27
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
You upload changed information to Oracle Fusion in a zip file of data files (.dat files), just as for the
initial load. If the zip file contains changes for multiple business objects, then the changes are
processed in multiple batches, one per business object, just as for the initial load.
Many Oracle Fusion HCM business objects comprise a hierarchy of related entities. For example, a
person object comprises not just the person entity but also person addresses, phones, names, ethnicity,
and so on. When you update most of the complex business objects, you do not have to upload the
complete object. For example, if a person’s address changes, then you can upload just the new address:
you do not need to upload the entire person business object.
The exception to this general rule is work relationships.
You must upload all entities of the work relationship when updating.
This requirement exists because of the complexity of the work relationship object, which comprises
multiple dependent entities. Partial updates are likely to cause inconsistencies among dependent
entities. If inconsistencies occur, then the entire work relationship object may have to be deleted and
reloaded.
For date-effective objects you can upload a partial history; you do not need to upload the complete
history of the object.
Example 3 in Appendix A shows update of a complex business object.
You can omit optional columns when creating or updating business objects.
The document R7 File-Based Loader Column Mapping Spreadsheet in My Oracle Support document
ID 1595283.1 identifies mandatory columns for each business object.
Example 4 in Appendix A shows a data file that omits some optional attributes.
When creating or updating business objects, you can specify columns in any order.
Example 5 in Appendix A shows a data file with a nonstandard column order.
28
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
When creating a business object, you can omit optional attributes or leave them blank. File-Based
Loader sets such attributes in new objects to NULL.
When updating a business object, any optional attribute that you omit or leave blank is excluded from
the update and remains unchanged in Oracle Fusion. However, you can set non-NULL attributes to
NULL by specifying a NULL directive value, as follows:
If the attribute is a VARCHAR2 or NUMBER value, then you set it to #NULL.
If the attribute is a DATE value, then you set it to 31-Dec-0001 (or date-format equivalent).
File-Based Loader sets #NULL and 31-Dec-0001 values to NULL.
Note: You cannot leave mandatory attributes blank when you are creating or updating a business
object. If you leave a surrogate key, parent key, or date-effective attribute blank in a business object,
then an error is raised.
See Example 6 in Appendix A for examples of setting attribute values to NULL.
Updating Logical Start and End Dates for Date-Effective Business Objects
You can specify a new start or end date for a logical row in a date-effective business object without
having to load the entire history of the object. For date-effective objects, two additional columns exist
in the relevant data (.dat) file:
LSD (Logical Start Date)
LED (Logical End Date)
Setting either of these columns to Y indicates to Oracle Fusion HCM that a new logical start date
(LSD) or logical end date (LED) is specified for the row. Values other than Y in the LSD and LED
columns are ignored.
In the following example, the logical row for the Sales Director job comprises three physical records:
RECORD JOB JOB CODE EFFECTIVE START DATE EFFECTIVE END DATE
To set the logical end date of the logical row to 31 December 2012, you would specify any mandatory
values and the new effective end date value of 31 December 2012. To indicate that this is the new
logical end date, you would also set the LED column to Y.
Note: You cannot specify a logical end date for a primary object, such as a person’s primary
assignment or mailing address. You must make the object nonprimary before attempting to specify a
logical end date.
29
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
Examples 1, 2, and 3 in Appendix A show how to update logical start and end dates for date-effective
business objects.
Loading Flexfields
Example .dat files and other FBL sample files are provided in the Data Conversion Reference Library
on My Oracle Support (document ID 1595261.1).
To load data for other flexfields, you:
Configure and deploy your flexfields using the Manage Flexfields task.
Enter your flexfield data in a supplied data (.dat) file and save it in .csv format.
Open a service request to have the flexfield data loaded from the .csv file to your environment.
30
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
3. In the Upload File dialog box, browse for your zip file of data, and set the Account value to
hcm/dataloader/import:
4. Click Save and Close. The zip file is uploaded to the hcm/dataloader/import account and
appears automatically in the Search Results section of the File Import and Export page:
WebCenter Content automatically allocates a content ID to uploaded files. To see the content ID for a
file, select View - Columns - Content ID in the Search Results section of the File Import and Export
page. The search results now include the Content ID column:
31
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
The WebCenter Content Document Transfer Utility for Oracle Fusion Applications is a feature-set
Java library that provides content export and import capabilities. You can evaluate the utility from the
Individual Component Downloads section of the Oracle WebCenter Content 11g R1 Downloads tab
on Oracle Technology Network (OTN):
http://www.oracle.com/technetwork/middleware/webcenter/content/downloads/index.html
(Note: Current customers can download the utility from Oracle Software Delivery Cloud.)
Open the Individual Components Download section on the Downloads tab, accept the license
agreement, and download the WebCenter Content Document Transfer Utility. Once the component
zip file is downloaded, extract the JAR file. The zip file also contains a useful readme file describing
the example invocation command shown in Figure 6.
--username=<provide_user_name> --password=<provide_password> --
primaryFile="<file_path_with_filename>" --dDocTitle="<provide_Zip_Filename>" -
dDocAccount=hcm/dataloader/import
e.g.
java -cp "oracle.ucm.fa_client_11.1.1.jar" oracle.ucm.client.UploadTool --
url="https://{host}/cs/idcplg" --username="HCM_IMPL" --password="Welcome1" --
primaryFile="/scratch/HRDataFile.zip" --dDocTitle="Department Load File" --
dSecurityGroup="FAFusionImportExport" --dDocAccount="hcm/dataloader/import"
Sample output:
Upload successful.
[dID=21537 | dDocName=UCMFA021487]
Figure 6. Example Invocation Command for the WebCenter Content Document Transfer Utility
32
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
The dDocName value (which is equivalent to the content ID) returned by the above statement is
required for the LoaderIntegrationService call described on page 39.
Review the readme file downloaded with the WebCenter Content Document Transfer Utility for a list
of all parameters, including advanced networking options for resolving proxy issues.
The RIDC communication API removes data abstractions to Oracle Content Server while still
providing a wrapper to handle connection pooling, security, and protocol specifics. This is the
recommended approach if you want to use native Java APIs.
RIDC supports three protocols: Intradoc, HTTP, and JAX-WS.
Intradoc
The Intradoc protocol communicates with Oracle Content Server over the Intradoc socket port
(typically, 4444). This protocol does not perform password validation and so requires a trusted
connection between the client and Oracle Content Server. Clients that use this protocol are expected to
perform any required authentication. Intradoc communication can also be configured to run over SSL.
HTTP
RIDC communicates with the web server for Oracle Content Server using the Apache HttpClient
package. Unlike Intradoc, this protocol requires authentication credentials for each request.
JAX-WS
The JAX-WS protocol is supported only in Oracle WebCenter Content 11g with Oracle Content
Server running in Oracle WebLogic Server. To provide JAX-WS support, several additional JAR files
are required.
For more information, see:
Oracle WebCenter Content Developer's Guide for Content Server (specifically the section Using
RIDC to Access Content Server)
Oracle Fusion Middleware Developer's Guide for Remote Intradoc Client (RIDC)
Once the RIDC Component Library download file has been unzipped, include the following JAR files
in your project. Figure 7 shows an example from Oracle JDeveloper.
33
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
Figure 8 shows example code for uploading a file into WebCenter Content. Parameter details are
provided in Table 8.
import java.io.File;
import java.io.FileInputStream;
import java.io.InputStream;
import java.io.IOException;
import oracle.stellent.ridc.IdcClient;
import oracle.stellent.ridc.IdcClientException;
import oracle.stellent.ridc.IdcClientManager;
import oracle.stellent.ridc.IdcContext;
import oracle.stellent.ridc.model.DataBinder;
import oracle.stellent.ridc.model.TransferFile;
import oracle.stellent.ridc.protocol.ServiceResponse;
34
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
relevant URL
IdcContext userContext = new IdcContext("HCM_ADMIN", "Password"); // replace with
relevant username password
checkin(idcClient, userContext,
"/scratch/jdoe/ridc/BusinessUnit1.zip",
// Replace with fully qualified path to source file
"Document", // content type
"BusinessUnit1", // doc title
userContext.getUser(), // author
"FAFusionImportExport", // security group
"hcm$/dataloader$/import$", // account
"BU5") // dDocName - this is the ContentId
;
} catch (IdcClientException e) {
e.printStackTrace();
}
/**
* Method description
*
* @param idcClient
* @param userContext
* @param sourceFileFQP fully qualified path to source content
* @param contentType content type
* @param dDocTitle doc title
* @param dDocAuthor author
* @param dSecurityGroup security group
* @param dDocAccount account
* @param dDocName dDocName
*
* @throws IdcClientException
*/
public static void checkin(IdcClient idcClient, IdcContext userContext,
String sourceFileFQP, String contentType,
String dDocTitle, String dDocAuthor,
String dSecurityGroup, String dDocAccount,
String dDocName) throws IdcClientException {
InputStream is = null;
try {
String fileName =
sourceFileFQP.substring(sourceFileFQP.lastIndexOf('/') + 1);
is = new FileInputStream(sourceFileFQP);
// note!!! when using HTTP protocol (not intradoc/jaxws) - one must explicitly
// set the Content Length when supplying an InputStream to the transfer file
// e.g. primaryFile.setContentLength(xxx);
// otherwise, a 0-byte file results on the server
35
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
request.addFile("primaryFile", primaryFile);
request.putLocal("dDocTitle", dDocTitle);
request.putLocal("dDocAuthor", dDocAuthor);
request.putLocal("dDocType", contentType);
request.putLocal("dSecurityGroup", dSecurityGroup);
} catch (IOException e) {
e.printStackTrace(System.out);
} finally {
if (is != null) {
try {
is.close();
} catch (IOException ignore) {
}
}
}
Figure 8. Example Java Code for Uploading Files to Oracle WebCenter Content
dDocName The content ID for the content item. Value passed to LoaderIntegrationService
dDocAccount The account for the content item. Required only if accounts are hcm$/dataloader$/import$
enabled.
primaryFile The absolute path to the location of the file as seen from the server.
36
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
Importing and Loading from the Load HCM Data for Coexistence Page
2. In the Data Exchange work area, select the task Load HCM Data for Coexistence.
3. On the Load HCM Data for Coexistence page, click Import. The Import and Load HCM Data
dialog box opens.
4. In the Import and Load HCM Data dialog box, enter the content ID that you obtained when
loading the file to the WebCenter Content server using the File Import and Export interface.
5. Select an individual business object or All to load all business objects from the zip file.
6. Provide a meaningful batch name. Object names are prefixed with the batch name to provide a
unique batch name for each batch.
7. If you set the Loader Run Type parameter to Import, then data is imported to the stage tables.
You can review the results of this process and correct any import errors before proceeding with the
load to the application tables. When you first start to use File-Based Loader, this is the
recommended approach.
If you set the Loader Run Type parameter to Import and Load Batch Data, then data is
imported to the stage tables. All objects imported successfully to the stage tables are then loaded
automatically to the application tables. You may prefer this approach when import errors are few
and your data-loading is routine.
37
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
8. Click Submit.
Your data is imported to the stage tables and also loaded to the application tables, if appropriate. For
next steps, see Reviewing the Import Log and Fixing Import Errors on page 44.
Importing and Loading Using the Loader Integration Service Web Service
You can find service invocation details for the LoaderIntegrationService in the public Oracle
Enterprise Repository (OER) at http://fusionappsoer.oracle.com.
38
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
Several ways exist of invoking Oracle Fusion web services. This section explains how to invoke web
services using generated proxy classes. You can generate your own proxy classes by providing the URL
of the service WSDL file to your generator of choice. These proxy classes are then used to invoke the
web service.
Note: Oracle Fusion Web services are protected by Oracle Web Services Manager (OWSM) security
policies. Refer to the Oracle Fusion Middleware Security and Administrator's Guide for Web Services
for further details.
Figure 10 shows how to call the LoaderIntegrationService.
http://{Host}/hcmCommonBatchLoader/LoaderIntegrationService
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns1:submitBatch
xmlns:ns1="http://xmlns.oracle.com/apps/hcm/common/batchLoader/core/loaderIntegrationSe
rvice/types/">
<ns1:ZipFileName></ns1:ZipFileName>
39
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
<ns1:BusinessObjectList></ns1:BusinessObjectList>
<ns1:BatchName></ns1:BatchName>
<ns1:LoadType></ns1:LoadType>
<ns1:AutoLoad></ns1:AutoLoad>
</ns1:submitBatch>
</soap:Body>
</soap:Envelope>
PARAMETER DESCRIPTION
ZipFileName Content ID of the file on the WebCenter Content server (the same value as dDocName in the WebCenter
Content Java call)
BusinessObjectList Name of the business object to be loaded. Repeat this tag for each business object to be loaded.
LoadType The type of load. Can be either FBL or HR2HR. Use FBL.
N = Import only
Note: This parameter in the service replaces the setup parameter Load HCM Data Files Automatically on the
Manage HCM Configuration for Coexistence page.
40
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
To use this policy, the message must be encrypted using a public key provided by the server. When the
message reaches the server it can be decrypted by the server's private key. A KeyStore is used to import
the certificate and is referenced in the subsequent client code.
The public key can be obtained from the certificate provided in the service WSDL file. See Figure 11
(the certificate is Base64 encoded).
keytool -import -file <Provide the path of the certification.cer file> -alias orakey -
keypass welcome -keystore <Provide the path where the jks file needs to be
created(including the file name)> -storepass welcome
41
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
6. You can find the KeyStore file in the KeyStore path that you set.
Once the client KeyStore has been created, you can call the service using the proxy classes. The
following parameters are used by the proxy class to encrypt and decrypt the message.
PARAMETER DESCRIPTION
WSBindingProvider.USERNAME_PROPERTY User name of the application user who has relevant privileges for importing
and processing FBL data files.
ClientConstants.WSSEC_KEYSTORE_TYPE: Type of the KeyStore you created. JKS (Java KeyStore) is widely used and is
the most common type.
ClientConstants.WSSEC_ENC_KEY_ALIAS Alias of the key you use to decrypt the SOAP message from the server.
ClientConstants.WSSEC_ENC_KEY_PASSWORD: Password of the key you use to decrypt the SOAP message.
ClientConstants.WSSEC_RECIPIENT_KEY_ALIAS: Alias of the key you use to encrypt the SOAP message to the server.
Generate the JAX-WS proxy class for the LoaderIntegrationService using the wsimport command,
which is available at JAVA_HOME/bin:
wsimport -s <Provide the folder where the generated files need to be placed> -d
<Provide the folder where the generated files need to be placed> <The Loader
Integration Service URL>
e.g. wsimport -s "D:\LoaderIntegrationService" -d "D:\LoaderIntegrationService"
https://{host}/hcmCommonBatchLoader/LoaderIntegrationService?wsdl
42
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
package com.oracle.xmlns.apps.hcm.common.batchloader.core.loaderintegrationservice;
import java.util.ArrayList;
import java.util.Map;
import java.util.StringTokenizer;
import javax.xml.ws.BindingProvider;
import javax.xml.ws.WebServiceRef;
import weblogic.wsee.jws.jaxws.owsm.SecurityPolicyFeature;
loaderIntegrationService_Service =
new LoaderIntegrationService_Service();
SecurityPolicyFeature[] securityFeatures =
new SecurityPolicyFeature[] { new
SecurityPolicyFeature("oracle/wss11_username_token_with_message_protection_client_policy")
};
LoaderIntegrationService loaderIntegrationService =
loaderIntegrationService_Service.getLoaderIntegrationServiceSoapHttpPort(securityFeatures);
BindingProvider wsbp = (BindingProvider)loaderIntegrationService;
Map<String, Object> requestContext = wsbp.getRequestContext();
requestContext.put(BindingProvider.USERNAME_PROPERTY,"Provide the applications username");
requestContext.put(BindingProvider.PASSWORD_PROPERTY, "Provide the password");
requestContext.put("oracle.webservices.security.keystore.type", "JKS");
requestContext.put("oracle.webservices.security.keystore.location",
"Provide the location of the default-keystore.jks (including the file name)");
requestContext.put("oracle.webservices.security.keystore.password", "welcome");
requestContext.put("oracle.webservices.security.encryption.key.alias", "orakey");
requestContext.put("oracle.webservices.security.encryption.key.password", "welcome");
requestContext.put("oracle.webservices.security.recipient.key.alias", "orakey");
String fileName = args[0];
String batchName = args[1];
String autoLoad = args[2];
String businessObj = args[3];
StringTokenizer strTok = new StringTokenizer(businessObj, ",");
ArrayList businessObjList = new ArrayList();
while (strTok.hasMoreTokens()) {
businessObjList.add(strTok.nextToken());
}
String response;
try {
response =
loaderIntegrationService.submitBatch(fileName, businessObjList,
batchName, "FBL",
autoLoad);
System.out.println("The response received from the server is ...");
System.out.println(response);
} catch (ServiceException e) {
System.out.println("Error occurred during the invocation of the service ...");
e.printStackTrace();
}
}
}
43
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
To generate the class file you need the following JAR file:
ws.api_1.1.0.0.jar
This JAR file is available at the following location:
$MIDDLEWARE_HOME/modules
If necessary, you can download the JAR file as part of JDeveloper. The JAR file is available at the
following location in the JDeveloper installation.
modules/ ws.api_1.1.0.0.jar
If you specify AutoLoad=N when you invoke the Loader Integration Service, then you need to import
and load data manually. If you specify AutoLoad=Y, then you can proceed to review the import log (as
described in Reviewing the Import Log and Fixing Import Errors).
To import your zip file, open the Data Exchange work area and select the task Load HCM Data for
Coexistence. On the Load HCM Data for Coexistence page, click Schedule. On the Schedule Request
page, select your zip file and specify either Import or Import and Load as the Run Type value. If you
select Import, then no attempt is made to load the data to the application tables. In this case, you run
the load process separately. You also specify a batch name value. This value forms the prefix for each
business object in your file. For example, if your file contains Job and Job Family objects and you
specify the batch name MyData, then your batch names are MyData:Job and MyData:JobFamily.
In the Search Results section on the Load HCM Data for Coexistence page, click Refresh to see the
results of the import process. All import processes produce a log file. For successful imports, the log
file summarizes the process of unzipping the file and creating the object batches. If errors occur during
import to the stage tables, then the errors are written to the log file. You can access the log file for a
selected zip file in the Log column of the Search Results region.
44
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
Figure 12. Navigation: Data Exchange - Load HCM Data for Coexistence
Click the Log icon to download the log file to your desktop.
Errors identified in the log file relate to records that cannot be imported to the stage tables. Typically,
the errors relate to missing primary or parent keys, incorrect or missing reference-data GUIDs, invalid
data formats, or incorrect date-effective records. You need to correct these errors in the source data
before attempting to import the records to the stage tables again.
45
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
Step 9: Load Data from the Stage Tables to the Application Tables
The Load Batch Data process runs automatically for batches imported successfully to the stage tables
if you specify:
AutoLoad=Y, when you invoke the Loader Integration Service
Import and Load HCM Data, when you import and load from the Load HCM Data for Coexistence
page
Otherwise, you need to load your data manually to the application tables.
To load data to the application tables, you schedule the Load Batch Data process from the Load Batch
Data page, which you can access from either the Data Exchange work area or the Setup and
Maintenance work area:
In the Batch Name field, select the name of a batch to load. Each batch contains a single object type.
The remaining parameters are as set during Step 1 of this process; you do not need to change these
values.
Note:
For the initial load, you must load objects in the order defined on page 4 to respect dependencies
between business objects.
46
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
Figure 14. Navigation: Setup and Maintenance - Load Batch Data - Search Results
Refresh AM The data-load process for the batch is performing an internal refresh against the Application Module (clearing
the loader cache).
Canceled The data-load process for the batch has been canceled.
Complete with Data-load processing for the batch is complete; object instance errors exist.
Errors
System Error The data-load process for the batch was terminated by a system error.
47
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
Detailed information about any data load that you select in the Search Results section appears in the
Details section of the page.
Figure 15. Navigation: Setup and Maintenance - Load Batch Data - Details
Many business objects comprise a hierarchy of entities and attributes. For example, the Person object
includes entities such as Person Address, Person E-Mail, Person Legislative Data, Person Name, and
so on. In turn, each entity is made up of multiple attributes. When creating a business object, Load
Batch Data processes all data for that object as a single unit; therefore, an error in any entity or
attribute of the business object is recorded as an error for the object itself.
From the Batch Summary and Failed tabs in the Details section of the Load Batch Data page, you can
display information about the load status of individual business objects. The object-status values are
described in the following table:
TABLE 11. OBJECT-STATUS VALUES
Pending Action During the import phase, a validation error occurred for the object instance.
Ready to The object has not been processed but is ready for processing.
Process
Error in Row The object is in error. Either the object itself is in error or the complex business object to which it belongs is in
error.
On the Failed tab in the Details section for a batch data load, you can see the details of any errors.
48
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
Figure 16. Navigation: Setup and Maintenance - Load Batch Data - Details
To resolve the errors and complete the data load, click the number in the Total Objects column to
navigate to the Details page for the object.
Figure 17. Navigation: Setup and Maintenance - Load Batch Data - Details > Object Details
The Object Level ID is an internal key that uniquely identifies object instances. You can display source
keys by making the Source Object and Source ID columns visible. (For example, select View -
Columns - Source ID.)
Once in the Details page, you can change the status of objects with errors to Ignore to prevent them
from being processed when you next run the data load.
Alternatively, in the Details section on this page, you can review the attributes of a selected object and
correct any errors in the stage tables. This approach is helpful if you want to be sure that the correction
has fixed the original error before applying it to the source data or you do not need to maintain the
source data. If you make corrections, then you can set the object status to Ready to Process.
If you want to remove objects in error from the original batch, you can do so on the Load Batch Data
page. On the Failed tab in the Details section, select the objects that you want to remove and click
Create Batch. The selected objects are removed from the original batch and added to a new batch, so
that you can fix the errors later.
After correcting any errors, you can select the batch file in the Search Results section and click Run.
Any object with the status Error in Row is reset to Ready to Process and included in the load.
Objects with the status Successful or Ignore are not processed.
Post-Load Processes
After an initial or incremental load of person records, you run a set of processes to complete data setup
in the Oracle Fusion HCM environment. You run these processes in the following order from the
Scheduled Processes work area:
1. Synchronize Person Records
2. Update Person Search Keywords
3. Calculate Relationship Strength
49
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
This process communicates changes to person and assignment records that have occurred since the
last data load to consuming applications, such as Oracle Fusion Trading Community Model and Oracle
Identity Management (OIM).
This process copies attributes of person, employment, and profile records that are used as search
keywords to the PER_KEYWORDS table, where they are indexed to improve search performance.
The process updates the entire PER_KEYWORDS table.
In the Person Gallery, search results can appear in order of the strength of the relationship between
the person performing the search and each person in the search results: the stronger the relationship,
the nearer to the top of the results a person's assignment appears. This process updates stored
relationship-strength information.
For performance reasons, the complete manager hierarchy for each person is extracted from live data
tables and stored in a separate manager-hierarchy table, known as the denormalized manager hierarchy.
This process populates the denormalized manager hierarchy tables with latest information after each
data load.
When you load person records, user-account requests are created automatically by default. This process
sends those bulk requests to OIM immediately to create (and also suspend or re-enable) user accounts,
as appropriate. In addition, roles are provisioned to users in accordance with role-provisioning rules in
effect when the accounts are created.
Note: Before you run this process, review your data conversion fully and confirm its accuracy. If you
need to purge your data and repeat the conversion, it will take much longer if you have created user
accounts and notified users of their sign-in details.
You can control aspects of the provisioning process for the enterprise by setting the User and Role
Provisioning options on the Manage Enterprise HCM Information page. For example, you can
suppress the automatic creation of user accounts.
50
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
Compensation Processes
Depending on the business objects that you are loading and how you plan to use them, you may also
need to run the following processes:
Start Compensation Cycle. You run this process when all data is loaded and the compensation cycle
is ready to be started.
Refresh Workforce Compensation. You run this process if changes that you upload to Oracle Fusion
HCM need to be reflected in the compensation cycle.
You can find more information about these post-load processes in the Workforce Deployment
Implementation Guide, the Compensation Management Implementation Guide, and the Coexistence
for HCM Implementation Guide.
You can validate your data interactively by searching for a representative sample. For example, you can
search for person records in the Person Gallery and jobs on the Manage Jobs page. You could also use
predefined Oracle Transactional Business Intelligence (OTBI) reports, or use BI Publisher to define
your own reports.
To delete data loaded to the stage environment, you can use the deletion scripts that are preinstalled in
your stage environment. Be aware that these scripts delete all data rather than just the rows in error.
51
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
Appendixes
Note: In the figures included in these examples, attributes for which data appears in a data line are
shown in bold text in the header line.
This example shows how to change the hire date of an existing worker from 2004-01-03 to 2005-01-
03. Notice that you must change the hire date in all objects in the work relationship hierarchy (that is,
in F_WORK_RELATIONSHIP_VO.dat, F_ASSIGNMENT_VO.dat,
F_ASSIGNMENT_SUPERVISOR_VO.dat, F_ASSIGNMENT_WORK_MEASURE_VO.dat, and
F_WORK_TERMS_VO.dat). Of these five objects, four are effective-dated; therefore, the LSD
attribute is included in those objects to indicate a change to the logical start date of the object.
The following five figures show how the worker’s hire date is changed in each object in the work
relationship hierarchy. Attributes of interest are highlighted in the data line in each object.
52
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
53
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
In this example, a person record is created and one of the person’s addresses is subsequently updated.
Figures 2.1 through 2.3 show the F_PERSON_VO.dat, F_PERSON_NAME_VO.dat, and
F_PERSON_ADDRESS_VO.dat files that create the person record. Figure 2.4 shows the
F_PERSON_ADDRESS_VO.dat file that specifies a new logical end date for the worker’s mail
address. Notice that you do not need to upload the entire person object again to update the address;
you can upload the updated address object only.
54
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
55
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
Figure 2.3 includes two address lines, one for home and one for mail. The addresses have different
effective start dates but the same effective end date (4712-12-31). To change the effective end date of
the mail address from 4712-12-31 to 2010-12-31, you upload the following data file:
56
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
The LED value at the start of the data line indicates that this record includes a new logical end date for
the object.
This example shows the data files F_POSITION_VO.dat (Figure 3.1) and
F_POSITION_GRADE_VO.dat (Figure 3.2), which create a position and the associated position
grade object. To change the effective start and end dates of the position grade, you upload the
F_POSITION_GRADE_VO.dat file shown in Figure 3.3. This example demonstrates that you do not
need to upload the complete object hierarchy to make a change to one of its entities. It also shows how
to specify both LSD and LED for a single object.
57
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
The effective start date of the grade is now 2000-01-01 and the effective end date is 2010-12-31. LSD
and LED columns are both included, and both are set to Y. After this update, the grade is attached to
the position from 2000-01-01 through 2010-12-31 only.
58
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
This example shows that you can omit optional attributes from an object. Figure 4.1 shows a typical
F_ASSIGNMENT_VO.dat file that does not include all possible attributes of the object. Figure 4.2
shows all possible attributes of the assignment object; attributes omitted from Figure 4.1 are
highlighted in Figure 4.2. These attributes are set to null in the assignment object.
59
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
This example demonstrates that you can upload the attributes of a business object in any order. Figure
5.1 shows the standard column order of a work relationship object. Figure 5.2 shows a valid work
relationship object where the order of the columns has been changed.
60
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
This example shows how to set date (Figure 5.1), number (Figure 5.2), and VARCHAR2 (Figure 5.3)
values to NULL.
Figure 6.1 Setting the Effective Start Date of a Location to NULL - F_LOCATION_VO.dat
Figure 6.2 Setting the Annualization Factor of a Grade Rate to NULL - F_GRADE_RATE_VO.dat
61
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
62
Oracle Fusion HCM File-Based Loader R7 and R8 User’s Guide
Oracle Fusion HCM File-Based Loader R7 and Copyright © 2012, Oracle and/or its affiliates. All rights reserved. This document is provided for information purposes only and the
R8 User’s Guide contents hereof are subject to change without notice. This document is not warranted to be error-free, nor subject to any other
November 2014 warranties or conditions, whether expressed orally or implied in law, including implied warranties and conditions of merchantability or
fitness for a particular purpose. We specifically disclaim any liability with respect to this document and no contractual obligations are
Oracle Corporation
formed either directly or indirectly by this document. This document may not be reproduced or transmitted in any form or by any
World Headquarters
means, electronic or mechanical, for any purpose, without our prior written permission.
500 Oracle Parkway
Redwood Shores, CA 94065
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
U.S.A.
Worldwide Inquiries: Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and
Phone: +1.650.506.7000 are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are
Fax: +1.650.506.7200 trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group. 0612
oracle.com
63