Browser version script Skip Headers

Oracle® Fusion Applications Coexistence for HCM Implementation Guide
11g Release 1 (11.1.3)
Part Number E20378-01
Go to contents  page
Contents
Go to Previous  page
Previous
Go to previous page
Next

12 Load Coexistence Data for Work Structures Records

This chapter contains the following:

HCM Data for Coexistence: How It Is Loaded

Loading Business Objects in the Required Order: Explained

Loading Batch Data into Oracle Fusion: Explained

Load Batch Data Parameters

Data-Load Batch-Status Values: Explained

Data-Load Object-Status Values: Explained

FAQs for Load Coexistence Data for Work Structures Records

HCM Data for Coexistence: How It Is Loaded

To transfer data from a source application, such as Oracle PeopleSoft HRMS or Oracle E-Business Suite HRMS, to Oracle Fusion, you use the Load HCM Data for Coexistence process. You run Load HCM Data for Coexistence manually from the Data Exchange work area.

Settings That Affect the Load HCM Data for Coexistence Process

The following parameters to the Load HCM Data for Coexistence process control its operation.


Parameter Name

Description

File Name

The zipped data file to be loaded.

Business Object to Import

The business object to be loaded. To load all business objects in the zipped data file, select All. For an initial load, process business objects individually. For incremental loads, you can select All.

Loader Run Type

Indicate whether to import the data or both import and load the data. If you select Import, then you must load the data subsequently using the Load Batch Data process. For an initial data load, you are recommended to select Import so that you can identify and resolve any issues as they occur. For incremental data loads, select Import and Load Batch Data, unless you have reasons for performing the steps separately.

Batch Name

A name that identifies the data load.

Loader Maximum Errors Allowed

The maximum number of errors in a thread before processing terminates. If an error occurs when processing a complex logical business object (such as a person record) then all rows for that business object are rolled back and marked as Error in Row.

Loader Number of Processes

The number of Load Batch Data threads to run in parallel. If you are processing large amounts of data (for example, more than 1000 rows) or complex data (such as person and work relationship data) consider running 4 or 8 threads in parallel.

Loader Chunk Size

The number of logical business objects a single Load Batch Data thread processes in a single action.

How HCM Data for Coexistence Is Loaded

The Load HCM Data for Coexistence process retrieves the zipped file of source data from the Oracle Data Integrator (ODI) root directory, validates the data, and loads it into Oracle Fusion. The process has three phases:

During the file unzip phase, the Load HCM Data for Coexistence process:

During the import business object phase, the Load HCM Data for Coexistence process:

During the load business object phase, the Load HCM Data for Coexistence process:

Note

In an incremental data load, you cannot upload date-effective changes to terminated work relationships. If you cannot avoid making such changes in your source application, you must apply those changes manually to the Oracle Fusion data using the Oracle Fusion interface before attempting an incremental data load. Otherwise, the data load to Oracle Fusion will fail.

When you run Load HCM Data for Coexistence, the Loader Run Type parameter determines whether both the import and load phases of the process are run. If you set Loader Run Type to Import (for example, to complete checks for basic errors before attempting to load the data), then you must run the load phase manually using the Load Batch Data process.

Loading HCM Data for Coexistence Automatically

During implementation of HCM coexistence, you can specify that the Load HCM Data for Coexistence process is to run automatically for the enterprise. In this case:

Loading Business Objects in the Required Order: Explained

To load business objects from a source application to Oracle Fusion, you perform the Load HCM Data for Coexistence task. You invoke this task from the Oracle Fusion Functional Setup Manager when you load HCM data for the first time. For subsequent or incremental loads, you perform the Load HCM Data task in the Data Exchange work area.

Business Object Load Order

When you load business objects, whether for the first time or subsequently, you must respect the general load order shown in the following table so that dependencies between business objects are satisfied. For example, you must load all work structure records before salary bases. Within the work structure records grouping, you must load locations before business units, business units before grades, grades before grade rates, and so on. All business objects to be loaded can be in the same zip file.

Note

For the initial data load, you are recommended to load one business object at a time, following the load order shown in the following table, and select the Loader Run Type value Import rather than Import and Load. This approach enables you to diagnose any loading issues as they occur and fix them before loading the next business object.

For incremental data loads, you can load all business objects at once (select the All option) and specify the Loader Run Type value Import and Load. When you load all business objects at once, the data-load process automatically loads them in the appropriate order. The automated loading process (where the Load HCM Data for Coexistence process runs automatically on receipt of a file) can be used for incremental data loads.


Order

Business Object Group

Business Object

1

Work Structures

  1. Locations

  2. Business units

  3. Grades

  4. Grade rates

  5. Job families

  6. Jobs

2

Workforce Compensation

  1. Salary bases

3

Talent Management

  1. Establishments

  2. Rating models

  3. Content items

  4. Content item relationships

4

Person

  1. Persons

  2. Person documentation

  3. Departments

  4. Department trees

  5. Positions

5

Employment

  1. Work relationships

6

Workforce Compensation

  1. Salary elements

  2. Element entries

7

Profile Management

  1. Profiles

Note

After loading business units, you need to open each one using the Oracle Fusion Manage Business Unit Set Assignment task and save the default reference data set assignments; otherwise, set-enabled data may not be visible to users.

For incremental loads, you do not load establishments, rating models, content items, or profile data. After the initial load, Oracle Fusion Applications are the source of truth for this data.

The remainder of this topic provides details of the dependencies between business objects. By following the general load order described above you will respect these dependencies.

Dependencies Between Workforce Compensation Business Objects

The following figure illustrates dependencies between business objects relevant to workforce compensation.

These dependencies determine the order in which you must load workforce compensation business objects. For example, positions require jobs and departments to be loaded first, and work relationships require persons and positions to be loaded first. Arrows point from business objects to other business objects that they are dependent on.

Dependencies between workforce compensation
business objects

Dependencies Between Talent Management Business Objects

The following figure illustrates dependencies between business objects relevant to talent management.

These dependencies determine the order in which you must load talent management business objects. For example, profiles require work relationships, establishments, and content items to be loaded first, and content items require rating models to be loaded first. Arrows point from business objects to other business objects that they are dependent on.

Dependencies between talent management
business objects

Loading Batch Data into Oracle Fusion: Explained

The Load Batch Data process, which you run from the Data Exchange work area, imports data into Oracle Fusion from external sources.

From the Load Batch Data page, you can:

Loading Data for HCM Coexistence

To load data for HCM coexistence, you run the HCM coexistence process Load HCM Data, which comprises two phases: Import and Load. If you select both phases of that process, then the Load Batch Data process runs automatically to complete the Load phase. If you select the Import phase only, then you must run the Load Batch Data process manually to complete the Load phase. In this case, when running Load Batch Data you select the batch name that you created for the HCM coexistence process Load HCM Data.

Monitoring Data Loads

You can monitor the status of a data load in the Batch Status column of the Search Results section of the Load Batch Data page. Detailed information about any data load that you select in the Search Results section appears in the Details section of the page.

Correcting Data Errors

On the Failed tab in the Details section for a batch data load, you can see the details of any errors.

To resolve the errors and complete the data load, you can:

Rerunning Data Loads

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.

Load Batch Data Parameters

The Load Batch Data process imports batch data into Oracle Fusion from external sources. You run Load Batch Data from the Data Exchange work area.

Load Batch Data Parameters

Batch Name

The name of the batch file to be loaded.

Loader Chunk Size

The number of logical business objects that a single Load Batch Data thread processes in a single action.

Loader Maximum Errors Allowed

The maximum number of errors in a thread before processing terminates. If an error occurs during the processing of a complex logical business object (such as a person record), then all rows for that business object are rolled back and marked as Error in Row.

Loader Number of Processes

The number of Load Batch Data threads to run in parallel. If you are processing large amounts of data (for example, more than 1000 rows) or complex data (such as person and work relationship data) consider running 4 or 8 threads in parallel.

Data-Load Batch-Status Values: Explained

The Data Exchange work area displays batch-status values for the Load Batch Data and Load HCM Data tasks. This topic explains the batch-status values.


Batch Status

Description

New

The batch is new and has not been processed.

Processing

The data-load process for the batch is currently running.

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 Errors

Data-load processing for the batch is complete; object instance errors exist.

System Error

The data-load process for the batch was terminated by a system error.

Complete

The data-load process for the batch completed successfully.

Data-Load Object-Status Values: Explained

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. This topic explains the object-status values.


Object Status

Description

New

The object is new and has not been processed.

Pending Action

During the import phase, a validation error occurred for the object instance. (Typically, this status is set by Oracle Data Integrator.)

Ready to Process

The object has not been processed but is ready for processing.

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.

Ignore

The object is to be ignored during processing.

Successful

The object has been successfully processed.

FAQs for Load Coexistence Data for Work Structures Records

What happens if I delete source records that have been processed by Load HCM Data for Coexistence?

When you run the Load HCM Data for Coexistence process, differences between the data in the load and any data previously loaded into Oracle Fusion are identified. The differences, including any deletions, are applied to the Oracle Fusion data.

Deletions are applied to the Oracle Fusion data if:

Note

You are recommended not to change the export filter settings once you have performed an upload to Oracle Fusion. Files must contain all records, both changed and unchanged, that were included in the initial data load.

If a deleted person or employment record (such as an assignment) is detected during the Load HCM Data for Coexistence process, an exception is created and the deletion is not applied to the Oracle Fusion data. You must delete any such records manually (or inactivate them, if deletion is not possible) using the Oracle Fusion user interface.

Why did some complex business objects fail validation by the Load HCM Data for Coexistence process?

A complex business object is a logical business object comprising multiple related entities. For example, a person business object comprises a basic person entity and multiple child entities, such as person address details, person e-mail addresses, person national IDs, and so on. Together, these entities constitute the person logical business object.

The data loader processes each logical business object as a single item: all parent and child entities belonging to the logical business object must be validated successfully before the object can be loaded to Oracle Fusion. If any single entity fails validation, then the logical business object itself is in error. For example, if the address details in a person record contain a data error, then the person record itself is in error. You can view details of such errors and determine how to correct them.

What happens if I cancel a Load HCM Data for Coexistence process?

If you cancel the process while it is performing a data import, the import completes but the data is not loaded into Oracle Fusion.

If you cancel the process while it is performing a data load, then the loading of all business objects currently in progress completes, but no further objects are loaded.

What happens if I cancel a Load Batch Data process?

The Load Batch Data process completes the processing of any business objects currently in progress, but does not process further objects.

How can I confirm that data was loaded successfully to HCM coexistence?

Start by reviewing the results of the data load in the Data Exchange work area. You can see the status of the load process, its results once it completes, and the details of any errors. After a successful data load, you can validate the results in relevant Oracle Fusion user interfaces. For example, you can review worker details in the worker's portrait.

When do I load business objects for HCM coexistence?

The initial load of business objects from your source application to Oracle Fusion occurs during implementation of HCM coexistence. The frequency of subsequent loads (referred to as incremental loads) depends on both how you are using Oracle Fusion and the frequency of changes made to your source data. Your data-load schedule must ensure that activities planned for Oracle Fusion Talent Management and Oracle Fusion Workforce Compensation have access to the latest data.

If you are using Oracle Fusion Talent Management infrequently (for example, for yearly or occasional performance reviews), then you load business objects to Oracle Fusion immediately prior to those activities. If you are using Oracle Talent Management more frequently, and your source data is also changing frequently, then you may need to upload business objects weekly or monthly.

If you are using Oracle Fusion Workforce Compensation to perform compensation reviews at specific times (for example, at year end), then you load business objects to Oracle Fusion immediately before the review starts; otherwise, managers may not have access to the latest information about their workers. If you need to load updated business objects to Oracle Fusion after a compensation review cycle has started, you run the Refresh Data process in Oracle Fusion Workforce Compensation after the latest objects are successfully loaded.

Note

You load establishments, rating models, content items, and profile data during the initial implementation of Oracle Fusion Talent Management and not subsequently. For all other business objects, files to be uploaded must contain all records, changed and unchanged, that they contained during the initial upload.

Once a compensation review cycle is complete, you must extract the updated results and send them to the source application (where they must be successfully loaded) before performing further data loads to Oracle Fusion.