Professional Documents
Culture Documents
May 2013
Oracle HCM Coexistence Integrating Oracle HRMS with Oracle Fusion Talent and Workforce Compensation,
Release 11i
Copyright 2011, 2013, Oracle and/or its affiliates. All rights reserved.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of
their respective owners.
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.
This software and related documentation are provided under a license agreement containing restrictions on
use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your
license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license,
transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse
engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is
prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If
you find any errors, please report them to us in writing.
If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on
behalf of the U.S. Government, the following notice is applicable:
U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software,
any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are
"commercial computer software" pursuant to the applicable Federal Acquisition Regulation and
agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation
of the programs, including any operating system, integrated software, any programs installed on the
hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the
programs. No other rights are granted to the U.S. Government.
This software or hardware is developed for general use in a variety of information management applications.
It is not developed or intended for use in any inherently dangerous applications, including applications that
may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you
shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its
safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this
software or hardware in dangerous applications.
This software or hardware and documentation may provide access to or information on content, products,
and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly
disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle
Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your
access to or use of third-party content, products, or services.
Contents
Preface
1 HCM Coexistence
Overview................................................................................................................................... 1-1
4 Setting Up Data
Set up Data for HCM Coexistence............................................................................................ 4-1
iii
8 Troubleshooting
Extraction Issues........................................................................................................................ 8-1
A Appendix A
Invoking the Fusion Web Service............................................................................................ A-1
B Appendix B
Reference Java Code for Web Service Subscription................................................................ B-1
C Appendix C
Writing Formulas for Discretionary Job Title Mapping..........................................................C-1
D Appendix D
Writing Formulas for Person Number Mapping..................................................................... D-1
E Appendix E
Maintaining Parameters and Parameter Groups...................................................................... E-1
Index
iv
Send Us Your Comments
Oracle HCM Coexistence Integrating Oracle HRMS with Oracle Fusion Talent and Workforce
Compensation, Release 11i
Part No. Not Applicable
Oracle welcomes customers' comments and suggestions on the quality and usefulness of this document.
Your feedback is important, and helps us to best meet your needs as a user of our products. For example:
Are the implementation steps correct and complete?
Did you understand the context of the procedures?
Did you find any errors in the information?
Does the structure of the information help you with your tasks?
Do you need different information or graphics? If so, where, and in what format?
Are the examples correct? Do you need more examples?
If you find any errors or have any other suggestions for improvement, then please tell us your name, the
name of the company who has licensed our products, the title and part number of the documentation and
the chapter, section, and page number (if available).
Note: Before sending us your comments, you might like to check that you have the latest version of the
document and if any concerns are already addressed. To do this, access the new Oracle E-Business Suite
Release Online Documentation CD available on My Oracle Support and www.oracle.com. It contains the
most current Documentation Library plus all documents revised or released recently.
Send your comments to us using the electronic mail address: appsdoc_us@oracle.com
Please give your name, address, electronic mail address, and telephone number (optional).
If you need assistance with Oracle software, then please contact your support representative or Oracle
Support Services.
If you require training or instruction in using Oracle software, then please contact your Oracle local office
and inquire about our Oracle University offerings. A list of Oracle offices is available on our Web site at
www.oracle.com.
v
Preface
Intended Audience
Welcome to Release 11i of the Oracle HCM Coexistence Integrating Oracle HRMS with
Oracle Fusion Talent and Workforce Compensation.
This guide assumes you have a working knowledge of the following:
The principles and customary practices of your business area.
Oracle HRMS.
If you have never used Oracle HRMS, Oracle suggests you attend one or more of
the Oracle HRMS training classes available through Oracle University
See Related Documents for more information about Oracle Applications product
information.
See Related Information Sources on page viii for more Oracle E-Business Suite product
information.
Documentation Accessibility
For information about Oracle's commitment to accessibility, visit the Oracle
Accessibility Program website at
http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.
vii
Access to Oracle Support
Oracle customers have access to electronic support through My Oracle Support. For
information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit
http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.
Structure
1 HCM Coexistence
2 Configuring Oracle EBS
3 Configuring Oracle Fusion
4 Setting Up Data
5 Extracting EBS Data
6 Importing Compensation Changes
7 Frequently Asked Questions
8 Troubleshooting
A Appendix A
B Appendix B
C Appendix C
D Appendix D
E Appendix E
viii
This guide describes the dashboards and reports available for HR Line Managers, Chief
HR Officer, Budget Managers, and Benefits Managers using Daily Business Intelligence
for HRMS. It includes information on using parameters, how DBI for HRMS derives
values, and how to troubleshoot dashboards and reports.
Oracle E-Business Intelligence Daily Business Intelligence Implementation Guide
This guide describes the common concepts for Daily Business Intelligence. It describes
the product architecture and provides information on the common dimensions, security
considerations, and data summarization flow. It includes a consolidated setup checklist
by page and provides detailed information on how to set up, maintain, and
troubleshoot Daily Business Intelligence pages and reports for the following functional
areas: Financials, Interaction Center, iStore, Marketing, Product Lifecycle Management,
Projects, Procurement, Sales, Service, Service Contracts, and Supply Chain.
Oracle E-Business Intelligence Daily Business Intelligence User Guide
This guide describes the common concepts for Daily Business Intelligence. It describes
the product architecture and provides information on the common dimensions, security
considerations, and data summarization flow. It includes a consolidated setup checklist
by page and provides detailed information on how to set up, maintain, and
troubleshoot Daily Business Intelligence pages and reports for the following functional
areas: Financials, Interaction Center, iStore, Marketing, Product Lifecycle Management,
Projects, Procurement, Sales, Service, Service Contracts, and Supply Chain.
OA Personalization Framework and OA Extensibility Framework
Learn about the capabilities of the 11.5.10 Framework technologies.
Oracle Human Resources Management Systems Enterprise and Workforce
Management Guide
Learn how to use Oracle HRMS to represent your enterprise. This includes setting up
your organization hierarchy, recording details about jobs and positions within your
enterprise, defining person types to represent your workforce, and also how to manage
your budgets and costs.
Oracle Human Resources Management Systems Workforce Sourcing, Deployment, and
Talent Management Guide
Learn how to use Oracle HRMS to represent your workforce. This includes recruiting
new workers, developing their careers, managing contingent workers, and reporting on
your workforce.
Oracle Human Resources Management Systems Payroll Processing Management Guide
Learn about wage attachments, taxes and social insurance, the payroll run, and other
processes.
Oracle Human Resources Management Systems Compensation and Benefits
Management Guide
Learn how to use Oracle HRMS to manage your total compensation package. For
example, read how to administer salaries and benefits, set up automated grade/step
ix
progression, and allocate salary budgets. You can also learn about setting up earnings
and deductions for payroll processing, managing leave and absences, and reporting on
compensation across your enterprise.
Oracle Human Resources Management Systems Configuring, Reporting, and System
Administration in Oracle HRMS
Learn about extending and configuring Oracle HRMS, managing security, auditing,
information access, and letter generation.
Oracle Human Resources Management Systems Implementation Guide
Learn about the setup procedures you need to carry out in order to successfully
implement Oracle HRMS in your enterprise.
Oracle Human Resources Management Systems FastFormula User Guide
Learn about the different uses of Oracle FastFormula, and understand the rules and
techniques you should employ when defining and amending formulas for use with
Oracle applications.
Oracle Self-Service Human Resources Deploy Self-Service Capability Guide
Set up and use self-service human resources (SSHR) functions for managers, HR
Professionals, and employees.
Oracle Human Resources Management Systems Deploy Strategic Reporting (HRMSi)
Implement and administer Oracle Human Resources Management Systems Intelligence
(HRMSi) in your environment.
Oracle Human Resources Management Systems Strategic Reporting (HRMSi) User
Guide
Learn about the workforce intelligence reports included in the HRMSi product,
including Daily Business Intelligence reports, Discoverer workbooks, and Performance
Management Framework reports.
Implementing Oracle Approvals Management
Use Oracle Approvals Management (AME) to define the approval rules that determine
the approval processes for Oracle applications. Download this guide from Oracle
MetaLink, Note: 282529.1.
Oracle iRecruitment Implementation and User Guide
Set up Oracle iRecruitment to manage all of your enterprise's recruitment needs.
Oracle Learning Management User Guide
Set up and use Oracle Learning Management to accomplish your online and offline
learning goals.
Oracle Learning Management Implementation Guide
Implement Oracle Learning Management to accommodate your specific business
practices.
x
Oracle Time and Labor Implementation and User Guide
Learn how to capture work patterns such as shift hours so that this information can be
used by other applications such as General Ledger.
Installation and System Administration
Oracle Applications Concepts
This guide provides an introduction to the concepts, features, technology stack,
architecture, and terminology for Oracle Applications Release 11i. It provides a useful
first book to read before an installation of Oracle Applications. This guide also
introduces the concepts behind Applications-wide features such as Business Intelligence
(BIS), languages and character sets, and Self-Service Web Applications.
Installing Oracle Applications
This guide provides instructions for managing the installation of Oracle Applications
products. In Release 11i, much of the installation process is handled using Oracle Rapid
Install, which minimizes the time to install Oracle Applications and the Oracle
technology stack by automating many of the required steps. This guide contains
instructions for using Oracle Rapid Install and lists the tasks you need to perform to
finish your installation. You should use this guide in conjunction with individual
product user guides and implementation guides.
Upgrading Oracle Applications
Refer to this guide if you are upgrading your Oracle Applications Release 10.7 or
Release 11.0 products to Release 11i. This guide describes the upgrade process and lists
database and product-specific upgrade tasks. You must be either at Release 10.7 (NCA,
SmartClient, or character mode) or Release 11.0, to upgrade to Release 11i. You cannot
upgrade to Release 11i directly from releases prior to 10.7.
"About" Document
For information about implementation and user document, instructions for applying
patches, new and changes setup steps, and descriptions of software updates, refer to the
"About" document for your product. "About" documents are available on Oracle
MetaLink for most products starting with Release 11.5.8.
Maintaining Oracle Applications
Use this guide to help you run the various AD utilities, such as AutoUpgrade,
AutoPatch, AD Administration, AD Controller, AD Relink, License Manager, and
others. It contains how-to steps, screenshots, and other information that you need to run
the AD utilities. This guide also provides information on maintaining the Oracle
applications file system and database.
Oracle Applications System Administrator's Guide
This guide provides planning and reference information for the Oracle Applications
System Administrator. It contains information on how to define security, customize
menus and online help, and manage concurrent processing.
Oracle Alert User's Guide
xi
This guide explains how to define periodic and event alerts to monitor the status of
your Oracle Applications data.
Oracle Applications Developer's Guide
This guide contains the coding standards followed by the Oracle Applications
development staff and describes the Oracle Application Object Library components that
are needed to implement the Oracle Applications user interface described in the Oracle
Applications User Interface Standards for Forms-Based Products. This manual also provides
information to help you build your custom Oracle Forms Developer forms so that the
forms integrate with Oracle Applications.
Oracle Applications User Interface Standards for Forms-Based Products
This guide contains the user interface (UI) standards followed by the Oracle
Applications development staff. It describes the UI for the Oracle Applications products
and how to apply this UI to the design of an application built by using Oracle Forms.
Other Implementation Documentation
Oracle Applications Product Update Notes
Use this guide as a reference for upgrading an installation of Oracle Applications. It
provides a history of the changes to individual Oracle Applications products between
Release 11.0 and Release 11i. It includes new features, enhancements, and changes
made to database objects, profile options, and seed data for this interval.
Oracle Workflow Administrator's Guide
This guide explains how to complete the setup steps necessary for any Oracle
Applications product that includes workflow-enabled processes, as well as how to
monitor the progress of runtime workflow processes.
Oracle Workflow Developer's Guide
This guide explains how to define new workflow business processes and customize
existing Oracle Applications-embedded workflow processes. It also describes how to
define and customize business events and event subscriptions.
Oracle Workflow User's Guide
This guide describes how Oracle Applications users can view and respond to workflow
notifications and monitor the progress of their workflow processes.
Oracle Workflow API Reference
This guide describes the APIs provided for developers and administrators to access
Oracle Workflow.
Oracle Applications Flexfields Guide
This guide provides flexfields planning, setup, and reference information for the Oracle
HRMS implementation team, as well as for users responsible for the ongoing
maintenance of Oracle Applications product data. This guide also provides information
on creating custom reports on flexfields data.
xii
Oracle eTechnical Reference Manuals
Each eTechnical Reference Manual (eTRM) contains database diagrams and a detailed
description of database tables, forms, reports, and programs for a specific Oracle
Applications product. This information helps you convert data from your existing
applications, integrate Oracle Applications data with non-Oracle applications, and write
custom reports for Oracle Applications products. Oracle eTRM is available on Oracle
Metalink.
Oracle Applications Message Manual
This manual describes all Oracle Applications messages. this manual is available in
HTML format on the documentation CD-ROM for Release 11i.
xiii
1
HCM Coexistence
Overview
HCM Coexistence enables you to integrate your existing Oracle Human Resource
Applications with a hosted Oracle Fusion Talent Management or Workforce
Compensation implementation. This means that you can use Oracle Fusion Workforce
Compensation and Talent Management functionality alongside your existing
E-business Suite setup.
Using HCM Coexistence, you can extract, transform, and transport files from Oracle
E-Business Suite and intelligently synchronize selected business object data between
your Oracle EBS application and Oracle Fusion HCM applications.
After this implementation, you can use Oracle Fusion Talent Management applications
for all talent related functions and Oracle Fusion Workforce Compensation for the
compensation review process but also continue to use existing EBS HCM applications
for all HR related functions.
HCM Coexistence provides the following responsibilities that you can use to perform
these tasks within the Coexistence Workbench:
HCM Coexistence Administrator to manage configurations
You can use these responsibilities to access various functions required for performing
the EBS HCM tasks such as:
Configure EBS HCM systems for coexistence
Extract the EBS data for importing to Oracle Fusion as a zip file
Place the extracted zip file in Oracle Fusion FTP Inbound server and invoke Oracle
Fusion Web Service
The following graphic illustrates the integration of EBS system with Oracle Fusion
Talent Management and Workforce Compensation using HCM Coexistence.
Perform the steps 1-6 if you are using HCM Coexistence for EBS - Oracle Fusion Talent
Management integration. Perform the steps 1-9 if you are using HCM Coexistence for
EBS - Oracle Fusion Workforce Compensation integration.
Oracle recommends that you perform the steps in the given sequence to ensure a
smooth and error-free integration. Perform the steps 1 - 3 consecutively to set up the
EBS and Oracle Fusion systems. If you encounter any error in any of the steps, Oracle
recommends you to troubleshoot before you proceed to the next step.
Perform the steps 4 and 5 consecutively to extract the EBS data.
1. Step 1 - Configure Oracle EBS and Oracle Fusion systems for coexistence
1-2 Oracle HCM Coexistence Integrating Oracle HRMS with Oracle Fusion Talent and Workforce Compensation
Tip: You are advised to check the concurrent program log to ensure
that there are no failures during the import process.
Tip: Oracle recommends you to check and resolve any error that
you may encounter during the upload process before you proceed
to the next step.
4. Step 4 - Extract the EBS data for importing to Oracle Fusion as a zip file
5. Step 5 - Place the extracted zip file in Oracle Fusion FTP Inbound server
6. Step 6 - Invoke the Oracle Fusion Load HCM Data for Coexistence process
This document describes each of these steps in detail in the following chapters.
Select Configuration to select the current configuration and to check the current
status of the configuration activities.
Setup Data Function to identify business groups to enable for coexistence, to import
cross-reference data from Fusion, to define mapping and validate the mapped
Extract Data Function to export the mapped information and publish to Fusion.
Setup Data Function to identify business groups to enable for coexistence, to import
cross-reference data from Oracle Fusion, to define mapping and validate the
mapped entities.
Extract Data Function to export the mapped information and publish to Fusion.
Extract Data Function to export the mapped information and publish to Fusion.
1-4 Oracle HCM Coexistence Integrating Oracle HRMS with Oracle Fusion Talent and Workforce Compensation
2
Configuring Oracle EBS
Creating a Configuration
Using the HCM Coexistence Administrator responsibility, you can access the function
to create a configuration to set up the EBS data.
Use the Manage Configuration function to create a configuration.
The Create Configuration page enables you to enter a unique name and code for your
configuration. The various concurrent programs refer to this configuration code
internally.
You can specify whether you want to integrate either Oracle Fusion Talent Management
or Oracle Fusion Compensation or both by selecting the appropriate checkboxes in the
Integration Options field.
You can specify the service provider details to enable the application to import and
export data from EBS and Oracle Fusion. The details include:
The FTP protocol and the FTP server port
The server address and user name of the Oracle Fusion FTP server
The Outbound folder in Oracle Fusion FTP server to host the Oracle Fusion
cross-reference data
The Inbound folder in Oracle Fusion server to which the e-Business Suite data is
exported
The Web Service FTP folder on the Fusion server from which the exported data is
loaded into the Fusion application using the Fusion Ready To Load web service
Configuration Details
Configuration Parameters
2-2 Oracle HCM Coexistence Integrating Oracle HRMS with Oracle Fusion Talent and Workforce Compensation
Attributes Required Description
FTP Server Password Key Yes The database vault key used
to store the FTP password
You can also edit, search, and delete your configurations using the Manage
Configuration function. You can also review any recent changes to your configurations.
Managing a Configuration
After you have created a configuration, you can select it using the Select Configuration
option to perform the various tasks such a setting up data, extracting, and importing
content.
Selecting Configuration
Using the Select Configuration option, you can view the configuration details of the
selected configuration. You can also choose to view the activities being performed on
the configuration or any requests. You also have the option to remove any previously
created extracts.
View Recent Activities
2-4 Oracle HCM Coexistence Integrating Oracle HRMS with Oracle Fusion Talent and Workforce Compensation
This option enables you to view a log of the various actions performed on a selected
configuration such as configuration parameter update, import data from Fusion,
entity extraction, and extract to file.
View My Requests
- You can view the status of all your requests whether pending, running, or
completed using the View My Requests option for all the actions performed on a
selected configuration.
Extract If you want to remove a particular extract, select from the list of values
under the selected configuration.
Older than - Optionally, you can specify to delete all the extracts created prior
to the specified number of days.
You must manually set up a few entities in Oracle Fusion prior to running the
integration and then generate a cross-reference file for EBS. You perform these steps
within Oracle Fusion applications. Ensure to have the Oracle Fusion system running
with the appropriate roles to perform this task.
See: Oracle Fusion Applications Coexistence for HCM Implementation Guide for setting
up the business objects.
3-2 Oracle HCM Coexistence Integrating Oracle HRMS with Oracle Fusion Talent and Workforce Compensation
4
Setting Up Data
HCM Coexistence provides WebADI spreadsheets that enable you to perform each of
these mapping tasks.
The following section outlines the steps that you can perform on the Setup functions
Use the Setup: Mapping : Talent function using the HCM Coexistence Manager
responsibility to perform the following task:
Map Qualification Type Categories to Content Type in Fusion (For Oracle Fusion
Talent Management only)
Use the Setup: Mapping : Compensation function using the HCM Coexistence Manager
responsibility to perform the following task:
Map Elements (For Oracle Fusion Compensation Workforce only)
If you are using Workforce Compensation for integration, you must also map the
salary component codes. Use the Map Action Reasons to map the salary component
codes.
4-2 Oracle HCM Coexistence Integrating Oracle HRMS with Oracle Fusion Talent and Workforce Compensation
Important: Certain fields are pre-populated and you cannot add new
rows. You can update the existing data.
4-4 Oracle HCM Coexistence Integrating Oracle HRMS with Oracle Fusion Talent and Workforce Compensation
Column Name Required Description
After you have identified the business groups for integration and have completed the
Import Setup task, the spreadsheet gets pre-populated with the business group
information that you have selected. Additionally a new row gets populated with a
value of Default for which you need map a Default Set. Global entities such as Global
Locations are mapped to this set in Fusion. It is not necessary to specify the remaining
columns in the spreadsheet for this Default row.
Map HR Organizations to Fusion Legal Employers
HR Organization to Legal Employer mapping is an optional step.
You use the HR Organization to Fusion Legal Employer mapping if you want to
employ employees from different HR Organizations to a specific Fusion Legal
Employer.
As part of the Provide Business Group Defaults mapping in the earlier step, you
provide a default Fusion Legal Employer for each business group. When you do not
specify any HR Organization to Fusion Legal Employer mapping, then all employees in
the selected business group will be employed under the default Fusion Legal Employer
as specified in the Map Business Group Defaults spreadsheet for the business group.
You cannot map legal employers from multiple business groups to a single Fusion
Legal Employer. For each business group defined in EBS, you must define and map
atleast one legal employer in Fusion.
Legislation Data Group The name of the Legislative Data Group for
the legal employer selected previously. This is
an optional field for Talent integration and
mandatory for Compensation integration.
Legislative Data Group The name of the Legislative Data Group for
the legal employer selected previously. This is
an optional field for Talent integration and
mandatory for Compensation integration.
4-6 Oracle HCM Coexistence Integrating Oracle HRMS with Oracle Fusion Talent and Workforce Compensation
Map Key Flexfield
For job, position, grade, and competency definitions defined using the flexfield
structure in EBS, map them to Fusion equivalents. You can do the mapping by
identifying the segment or a combination of segments to the entity code (for example
Job code) and entity name (for example Job Name) for each of the entities. Use the Map
Key Flexfield function to download a spreadsheet to map the segments for each of these
flexfields.
Note: While providing the Expression for Job Code mapping ensure
that Job code does not exceed more than 25 characters.
EBS Lookup Type Consists of list of lookup type that exist in EBS
for the entities that are transferred to Fusion.
Fusion Lookup Code User to provide fusion lookup code for the
user defined ones in EBS.
Note: You must map all the user defined lookup codes for type
NATIONALITY to its corresponding Fusion Lookup code to ensure
successful upload of Person data to Oracle Fusion.
4-8 Oracle HCM Coexistence Integrating Oracle HRMS with Oracle Fusion Talent and Workforce Compensation
Column Name Description
Column Description
Fusion Assignment Status Type Fusion Assignment Status type LOV. User
maps an EBS assignment status type to a
Fusion assignment status type.
4-10 Oracle HCM Coexistence Integrating Oracle HRMS with Oracle Fusion Talent and Workforce Compensation
Column Name Description
EBS Element Input Value Name Input Values for the Element selected
Fusion Element Input Value Name Input Values for the Fusion Element selected
You can add rows in the Map: Elements spreadsheet to add the elements and then map
each of these EBS to the Oracle Fusion elements.
Review Mapping
Note: Ensure that the Job code value does not exceed more than 25
characters.
The validation process identifies duplicate objects based on the mapped information
and flags these values by setting Yes in the Duplicate column in the spreadsheet.
Review Mapping
After you have completed the validation process, you can review and correct the
invalid codes or invalid name identified by the validation process.
You can use the Review Mapping task to view the duplicate objects and correct them, if
required. You can correct these duplicate entities either manually or using the Define
Mapping > Map Flexfields option.
To correct the duplicate values manually, select the entity in the Default entity
column, edit it, and set the Duplicate column to No.
2. Select the Define Mapping > Map Flexfields option to change the expression.
Repeat the Process and Validate task until there are no duplicates
If you want to edit any flexfield expressions after you have run the Process and Validate
task, then you must Clear the Derived Value cells (set the cell value as blank) in the
Review Mapping spreadsheet for which you want the expression to be recomputed.
After making your changes to the mapping expression, you also need to run the Process
and Validate task to recompute the values.
4-12 Oracle HCM Coexistence Integrating Oracle HRMS with Oracle Fusion Talent and Workforce Compensation
5
Extracting EBS Data
The following tables list the entities that you can extract:
Entity
Work Structures
Department Trees
Talent Setup
Compensation Setup
Profile
Compensation
5-2 Oracle HCM Coexistence Integrating Oracle HRMS with Oracle Fusion Talent and Workforce Compensation
Load for subsequent extractions.
Work Structures
Department Trees
Talent Setup
Compensation Setup
Profile
Compensation
You can choose to publish to the Oracle Fusion system by selecting Yes in the Publish
option.
Prior to running the request set, ensure to add the request set to the appropriate request
group assigned to your responsibility.
You run the Fusion Coexistence Extraction Request Set from the Submit Request Set
window.
To run the Fusion Coexistence Extraction Request Set:
1. Select Request Set from the Submit a New Request window.
5-4 Oracle HCM Coexistence Integrating Oracle HRMS with Oracle Fusion Talent and Workforce Compensation
6
Importing Compensation Changes
Run ID
Effective Date
Debug Level
6-2 Oracle HCM Coexistence Integrating Oracle HRMS with Oracle Fusion Talent and Workforce Compensation
7
Frequently Asked Questions
Is there any mechanism to send across a subset of people during initial testing or as a
part of phased rollout?
Yes. You can define an eligibility profile to filter the person and associate it with a
Business Group.
Please refer to Provide Business Group Defaults section in Data Mapping between EBS
and Oracle Fusion entities.
Can I update the expression for entity code or entity name for job, position, grade, and
competency already mapped using Map Key Flexfield spreadsheet?
Yes. You can update the expression for the entity code or entity name or job, position,
grade, and competency already mapped using Map Key Flexfield spreadsheet. To
update the values already defined in the Define Mapping option, perform the following
steps:
1. Clear the Derived Value cells in the Review Mapping spreadsheet for which you
want the expression to be recomputed.
2. Select the Define Mapping > Map Flexfields option to change the expression.
4. Run the Review Mapping task to review the invalid codes/name identified by the
7-2 Oracle HCM Coexistence Integrating Oracle HRMS with Oracle Fusion Talent and Workforce Compensation
validation process.
Can I move the data from multiple configurations from EBS to a single enterprise in
Oracle Fusion?
No. You cannot move the data from multiple configurations to a single enterprise in
Oracle Fusion.
Is there any request set that I can use to schedule the extraction and publishing of
extracted data to Oracle Fusion?
Yes. Oracle Coexistence provides the Fusion Coexistence Extraction Request Set that
you can run to schedule the extraction and publishing of extracted data to Oracle
These organization hierarchies can be modified to reflect any simple changes in the
reporting lines. A new version of an existing hierarchy can be created and it's structure
can be modified.
As a part of EBS HCM to Fusion Talent and Compensation Coexistence solution, HR
Organizations in EBS are migrated as Departments in Fusion.
Department Trees in Fusion are used to build hierarchical representations of the
departments within an organization. The top node of the tree is a department, and all
the child nodes are also departments.
EBS does not have a concept of Department Trees. EBS has Organization hierarchies or
trees where each of the tree node represents an Organization (of any classification). You
can select any type of organization for the top node and for the child nodes.
From a migration perspective, the Extraction Process follows the rule given below to
identify a Department tree from the existing Organization Hierarchies in EBS :
An organization hierarchy in which EVERY organization/node is classified as a HR
Organization ONLY is considered for data extraction as Department Tree.
Any organization hierarchy that has an organization that is NOT classified as HR Org is
not considered for data extraction.
How can the EBS Coexistence Extraction process extract and create Work Relationships
in Fusion when there is a change in Legal Employer in EBS?
In Fusion, a WorkRelationship (WR) can only have one Legal Employer (LE) associated
with it. The Work Terms (WT) and Work Assignments (A) for the WorkRelationship
must have the same Legal Employer.
If there is a change in Legal Employer (LE1 to LE2) in the EBS system, then two Work
Relationships (WRs) must be created in Fusion - WorkRelationship 1 (WR1) for Legal
Employer (LE1) and WorkRelationship 2 (WR2) for Legal Employer 2 (LE2).
7-4 Oracle HCM Coexistence Integrating Oracle HRMS with Oracle Fusion Talent and Workforce Compensation
Follow the steps given below to ensure that the EBS Coexistence Extraction process
extracts the data accurately and creates WorkRelationships in Fusion appropriately
when there is a change in Legal Employer.
1. Create a new assignment and associate with the new Legal Employer (LE2). You
can use this assignment as the primary assignment going forward.
2. Terminate the assignment associated with Legal Employer 1 (LE1). Set the
Assignment Status accordingly.
Creating a new assignment ensures that the existing WorkRelationship (WR1) is either
terminated or kept active, based on the assignment status specified, and a new
WorkRelationship (WR2) is created in Fusion for the new Legal Employer (LE2).
Please note that there are no changes to the Performance documents and Goals defined
for assignment associated with Legal Employer (LE1) and WorkRelationships (WR1),
even after the creation of a new WorkRelationships (WR2), WorkTerms (WT2) , and
assignment in Fusion for the new Legal Employer (LE2).
You must follow the above process to ensure that the EBS Coexistence Extraction
process extracts the data accurately and creates WorkRelationships in Fusion
appropriately when there is a change in Legal Employer.
Extraction Issues
If the extraction process - Fusion Coexistence Entity Extraction process ends in an error
or you observe a discrepancy from your expected data, then you must perform the
following steps to identify and resolve the issues.
1. Check for Error or Exception messages in the log files for the following processes:
Fusion Coexistence Entity Extraction
The error or exception messages are displayed within the following section in the
log files
+-----------------------------------------------------------------+
Start of log messages from FND_FILE
+-----------------------------------------------------------------+
+-----------------------------------------------------------------+
End of log messages from FND_FILE
+-----------------------------------------------------------------+
The error in the above example indicates that the extraction process failed for one or
more persons in the person id range [5452 - 8029]. The extraction process skips all
Troubleshooting 8-1
the persons within the person id range from 5452 to 8029.
2. Verify the person and assignment data for these persons for data integrity issues.
Extraction failures can happen due to data integrity issues such as:
Person has multiple primary assignments for a given period
Multiple records exist in person type usages for a specific system person type
You can use the following queries to identify the data integrity issues.
SELECT * FROM per_all_people_f WHERE person_id IN (<person id>)
ORDER BY effective_start_date
SELECT * FROM per_all_assignments_f WHERE person_id IN (<person id>)
ORDER BY effective_start_date
SELECT * FROM per_person_type_usages_f WHERE person_id IN (<person
id>) ORDER BY effective_start_date
SELECT * FROM per_periods_of_placement WHERE person_id IN (<person
id>)
SELECT * FROM per_periods_of_service WHERE person_id IN (<person
id>)
The following table illustrates the possible errors and their causes:
Error Cause
APP-PAY-06881: Error ORA-01436: Start date is later than the End date.
CONNECT BY loop in user data
3. Resolve the data extraction issues by correcting the data and re-run the extraction
process.
8-2 Oracle HCM Coexistence Integrating Oracle HRMS with Oracle Fusion Talent and Workforce Compensation
A
Appendix A
3. On the Business Events > Events tab, select your configuration. Search for the
Fusion Coexistence event
oracle.apps.per.ri.coexistence.service.ReadyToLoad.<Configuration_Code>
Appendix A A-1
oracle.apps.per.ri.coexistence.service.ReadyToLoad.<Configuration_Code> event
6. In the Create Event Subscription step, select the Action Type as Custom and click
Next.
8. Specify the subscription parameters. The Fusion web service uses the Username
Token based WS-Security headers. Specify the Fusion Application username /
password to the subscription as subscription parameters. The Fusion application
user password should be stored in EBS database vault. The password can be loaded
into the vault using the following command :
sqlplus apps/apps@database @$FND_TOP/sql/afvltput.sql
.<Module><Key><Value>
9. In the Subscription Parameters step region, add the following parameters and click
Apply to save the subscription.
This table lists the values that you must enter:
A-2 Oracle HCM Coexistence Integrating Oracle HRMS with Oracle Fusion Talent and Workforce Compensation
Creating an Error Subscription
1. Login into EBS application as System Administrator.
3. On the Business Events > Events tab, select your configuration. Search for the
Fusion Coexistence event
oracle.apps.per.ri.coexistence.service.ReadyToLoad.<Configuration_Code>
See: Configuring Oracle EBS for HCM Coexistence
Phase - 90
Status - Enabled
8. Click Apply.
Appendix A A-3
If any error occurs while executing the subscription, the above error subscription sends
a notification to SYSADMIN alongwith the error details. Please review the SYSADMIN
notifications for any errors.
A-4 Oracle HCM Coexistence Integrating Oracle HRMS with Oracle Fusion Talent and Workforce Compensation
B
Appendix B
Appendix B B-1
package custom.coexistence.subscription;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.io.OutputStreamWriter;
import java.io.Reader;
import java.io.Writer;
import java.io.BufferedReader;
import java.io.PrintWriter;
import java.io.StringReader;
import java.io.StringWriter;
import java.net.HttpURLConnection;
import java.net.MalformedURLException;
import java.net.URL;
import java.sql.Connection;
import oracle.apps.fnd.common.Log;
import oracle.apps.fnd.wf.bes.BusinessEvent;
import oracle.apps.fnd.wf.bes.BusinessEventException;
import oracle.apps.fnd.wf.bes.SubscriptionInterface;
import oracle.apps.fnd.wf.bes.server.Subscription;
import oracle.apps.fnd.wf.common.WorkflowContext;
import oracle.apps.per.ri.integration.common.CommonException;
import oracle.apps.per.ri.integration.common.Vault;
public ReadyToLoadSubscription() {
}
public void onBusinessEvent(Subscription eo, BusinessEvent event,
WorkflowContext context)
throws BusinessEventException {
try {
B-2 Oracle HCM Coexistence Integrating Oracle HRMS with Oracle Fusion Talent and Workforce Compensation
log.write(this, "Parameter Value:" + username, Log.ERROR);
String passMod = eo.getParameterByName(PARAM_PASSWORD_MOD);
String passKey = eo.getParameterByName(PARAM_PASSWORD_KEY);
String password = Vault.retreiveInformation(jdbcConnection, passMod,
passKey);
log.write(this, "The payload is -" + username, Log.ERROR);
String payload = event.getData();
log.write(this, payload, Log.ERROR);
String message = prepareSOAPMessage(payload, username,password);
log.write(this, "SOAP Message -", Log.ERROR);
log.write(this, message, Log.ERROR);
log.write(this, "Opening HTTP Connection ...", Log.ERROR);
HttpURLConnection connection =
(HttpURLConnection)endPointURL.openConnection();
connection.setRequestMethod("POST");
connection.addRequestProperty("Accept","text/xml, text/html," +
"image/gif, image/jpeg, *; q=.2, */*; q=.2");
connection.addRequestProperty("Content-Type",
"text/xml; charset=utf-8");
connection.addRequestProperty("Content-Length",
String.valueOf(message.length()));
connection.addRequestProperty("SOAPAction", "process");
connection.setDoOutput(true);
connection.setDoInput(true);
connection.setUseCaches(false);
connection.setAllowUserInteraction(false);
OutputStream out = connection.getOutputStream();
log.write(this, "Writing to HTTP Stream ...", Log.ERROR);
Writer writer = new OutputStreamWriter(out, "UTF-8");
writer.write(message);
writer.close();
out.close();
log.write(this, "Write Complete.", Log.ERROR);
log.write(this, "Reading Response ...", Log.ERROR);
InputStream in = connection.getInputStream();
Reader reader = new InputStreamReader(in);
StringBuffer response = new StringBuffer();
char[] chrs = new char[4096];
while (true) {
int size = reader.read(chrs);
if (size == -1)
break;
response.append(chrs, 0, size);
}
reader.close();
in.close();
log.write(this, "Read Complete.", Log.ERROR);
if(response.length() > 0) {
String responseText = response.toString();
if(responseText.indexOf("fault") >= 0) {
log.write(this, "Web Service Returned Error Response - ",
Log.ERROR);
log.write(this, responseText, Log.ERROR);
connection.disconnect();
throw new BusinessEventException ("Web Service failed " +
"with message - " + responseText);
}
}
log.write(this, "Exit ReadyToLoadSubscription - SUCCESS",
Log.ERROR);
connection.disconnect();
Appendix B B-3
} catch (MalformedURLException e) {
log.write(this, "MalformedURLException - " + e.getMessage(),
Log.ERROR);
printErrorStackToLog (log, e);
throw new BusinessEventException("Error creating endpoint URL - ",
e);
} catch (CommonException e) {
log.write(this, "CommonException - " + e.getMessage(),
Log.ERROR);
printErrorStackToLog (log, e);
throw new BusinessEventException("Error retreiving information " +
"from DB vault",e);
} catch (IOException e) {
log.write(this, "IOException:" + e.getMessage(), Log.ERROR);
printErrorStackToLog (log, e);
throw new BusinessEventException("Error calling web service", e);
}
}
private String prepareSOAPMessage(String payload, String username,
String password) {
return "<soap:Envelope xmlns:" +
"soap=\"http://schemas.xmlsoap.org/soap/envelope/\">\n" +
" <soap:Header>\n" +
" <wsse:Security soap:mustUnderstand=\"1\" " +
"xmlns:wsse=\"http://docs.oasis-open.org/wss/2004/01/oasis" +
"-200401-wss-wssecurity-secext-1.0.xsd\">\n" +
" <wsse:UsernameToken>\n" +
" <wsse:Username>" + username +
"</wsse:Username>\n" +
" <wsse:Password " +
"Type=\"http://docs.oasis-open.org/wss/2004/01/oasis-" +
"200401-wss-username-token-profile-1.0#PasswordText\">" +
password + "</wsse:Password>\n" +
" </wsse:UsernameToken>\n" +
" </wsse:Security>\n" + " </soap:Header>\n" +
" <soap:Body " +
"xmlns:ns1=\"http://xmlns.oracle.com/apps/hcm/common/" +
"batchLoader/inboundLoaderProcess\">\n" +
payload + " </soap:Body>\n" + "</soap:Envelope>";
}
private void printErrorStackToLog (Log log, Throwable t) {
final StringWriter sw = new StringWriter();
final PrintWriter pw = new PrintWriter(sw);
t.printStackTrace(pw);
StringBuffer buf = sw.getBuffer();
StringReader sr = new StringReader(buf.toString());
BufferedReader br = new BufferedReader(sr);
try {
while(true) {
String line = br.readLine();
if(line == null)
break;
log.write(this, line, Log.ERROR);
}
} catch(IOException ex) {
;
}
}
}
B-4 Oracle HCM Coexistence Integrating Oracle HRMS with Oracle Fusion Talent and Workforce Compensation
C
Appendix C
Important: You must define the formula for each of the business group
and the formula must have the name
HCM_COEX_ASG_CUSTOM_MAP. The formula has no effect if you
do not use the specified name and the specified list of input and output
parameters.
Input Parameters:
Assignment_ID
Appendix C C-1
Effective_Start_Date
Effective_End_Date
Output Parameters:
Assignment_Name
Sample Formula
/* -------------------------------------------------------------------
NAME : HCM_COEX_ASG_CUSTOM_MAP
This formula provides user an option to map Discretionary Job Title
to Assignment Name.
------------------------------------------------------------------*/
INPUTS ARE ASSIGNMENT_ID
,EFFECTIVE_START_DATE (DATE)
,EFFECTIVE_END_DATE (DATE)
/* -------------------------------------------------------------------
Provide the logic to derive the value for Discretionary Job Title or
Business Title from EBS DFF or custom fields using a database items
or formula functions
-----------------------------------------------------------------*/
ASSIGNMENT_NAME = ''
RETURN ASSIGNMENT_NAME
C-2 Oracle HCM Coexistence Integrating Oracle HRMS with Oracle Fusion Talent and Workforce Compensation
D
Appendix D
Important: You must define the formula for each of the business group
and the formula must have the name
HCM_COEX_PER_CUSTOM_MAP. The formula has no effect if you
do not use the specified name and the specified list of input and output
parameters.
Input Parameters:
PERSON_ID
Output Parameters:
PERSON_NUMBER
Appendix D D-1
Sample Formula:
/* -------------------------------------------------------------------
NAME : HCM_COEX_PER_CUSTOM_MAP
This formula provides user an option to map custom value for
Person Number in Fusion.
------------------------------------------------------------------*/
/* -------------------------------------------------------------------
Provide the logic to derive the value for Person Number using
database items or formula functions.
-----------------------------------------------------------------*/
RETURN PERSON_NUMBER
D-2 Oracle HCM Coexistence Integrating Oracle HRMS with Oracle Fusion Talent and Workforce Compensation
E
Appendix E
To create your own parameter group, enter the name of the group.
Appendix E E-1
Action Parameters, Oracle HRMS Implementation Guide.
2. If you do not specify any values for the parameters that you select, then the values
held at the global level default to the group level. But, if values are specified at the
group level, then the group level values take precedence over the global parameter
values.
E-2 Oracle HCM Coexistence Integrating Oracle HRMS with Oracle Fusion Talent and Workforce Compensation
Index
C S
compensation changes, 6-1 Setting up data, 4-1
configure EBS system, 2-1
configure Fusion, 3-1
Configuring Oracle EBS, 2-1
Configuring Oracle Fusion, 3-1
cross reference data import, 4-1
D
Defining Business Objects, 3-1
E
extracting, 5-1
Extracting cross-reference data, 3-1
Extracting EBS Data, 5-1
Extraction Process, 5-1
H
HCM Coexistence, 1-1
HCM Coexistence Administrator, 2-1
I
Importing, 6-1
Importing compensation changes, 6-1
Importing Cross-reference data, 4-1
importing data, 4-1
Integration, 1-1
M
Manage Configuration, 2-1
Index-1