You are on page 1of 28

HDL Desktop Integrator

HDLdi

Prasanna Borse
Fusion HCM Center of Excellence (CoE)
October, 2015

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

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


Before we start….
• HDL Desktop Integrator a.k.a. HDLdi is not a supported product of Oracle. You will not
be able to enter any SR or Bug for this app but you can report issues or enhancement
requests via My Oracle Support Communities.
• Your opinion is very important to us. Please provide the feedback which can help us to
support you even better.

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 3
Agenda
• Overview
– Introduction
– Generate Sample Files
– File Transfer and Registration
– Highlights
• Live Demonstration
• Appendix A- HDLdi Installation
• Appendix B- HDLdi Demo data

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 4
Why HDLdi?
• Learning
– Learning HDL?
– Conducting a training workshop with many participants?
– Looking for HDL sample files?
• Application Setup for Demos
– In hurry for a CRP?
– Need to setup new application in 60mins or less?

• Support
– Supporting your customers with HDL related questions?
• Automation
– Don’t want to spend days & nights in writing lines and lines for code for automating file transfer and
registration service calls?

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 5
Overview
• Introduction
• Generate Sample Files
• File Transfer and Registration
• Highlights

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 6
Introduction
• HDLdi is a stand-alone desktop
application that can assist you with
file transfer & registration involved
in HDL conversion.
• It can be used as a learning tool.
• It can be used via command line or
java program to automate inbound
integration.
• It also provides you with sample
files specifically tailored for your
setup data.

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 7
Generate Sample Files
• Jump start your conversion with your
setup and our data.
• You can customize the demo data for
your POD using your enterprise setup
information.
• No more searching workspaces for
sample files…

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 8
File Transfer and Registration
• HDLdi can help you simplify
manual steps involved in HDL
conversion.
• With click of a button you can
transfer your file to cloud UCM
and also register business objects
with Fusion.

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 9
Highlights
• Simplified mapping for enterprise setup
• UCM file transfer support via ridc as well as generic soap-port services
• Support encrypted file transfer
• Provides Java api & command line for easy automation
• Learning HDL is made simpler by supporting key steps involved in the data loading process
• Improved demo database
Demo data for 10 employees with core HR transactions e.g. Hire, Flexfields
Rehire, Term, Promotion, etc.
Multiple Assignments Talent Profile
Multiple Managers Area of Responsibilities
Historical Information Photos and Attachments
Salary Information Several use cases for worker object
Workstructures

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 10
Live Demonstration

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 11
Profile Setup (Save and Reuse Profile)
• Protocol: SOAP or RIDC. (Use SOAP if you have enabled the
Single Signon)
• UCM Server URL: UCM URL for your pod
• UCM Username: Fusion Technical User account
• Password: Fusion User’s password
• Inbound Folder: hcm/dataloader/import
• Outbound Folder: hcm/dataloader/export
• WSDL URL: HDL File registration URL
hcmCommonDataLoader/HCMDataLoader
• HCM Username: Fusion Technical User account
• HCM Password: Fusion User’s password
• Sequence#: Default 1. You may use the sequence number
1,2,3,4..N in order to conduct a training class where each
student can load the demo data in same POD without any
conflicts.

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 12
Generate Sample Files

• Reset Defaults: Pre seeded


defaults from properties file
• Make sure you have setup a
valid source system owner
value using Manage
Common Lookup task.

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 13
File Transfer-n-Registration
• Step1 – Select File: Select the
input file from your computer. If
the zip file is formatted right, you
should see list of business
objects in the Results window.
• Step 2 – UCM : Transfer file to
your UCM server, results window
should display cotent id upon
successful transfer.

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 14
File Transfer-n-Registration • Step3 – File Registration: In this step you will invoke the HDL web
service and register the file (and objects within it) to fusion to kick off
the data loading process.

• UCM ContentID: Auto populated (from step2)

• Encryption Type: Type of file encryption

• Import Maxiumum Errors: % of file lines in error that can occur in a


business object before the import process stops

• Load Maxium Errors: %of business object instances in error that can
occur for a business object before the validation and load processes
stop

• Load Concurrent Threads: Number of concurrent threads when


validating or loading

• Load Group Size: Number of business objects processed as a single


unit of work by a concurrent thread

• Delete Source File: Y or N value. If set to Y or left blank, deletes the


source file from the WebCenter Content server once the file content
has been transferred into HDL stage tables and is no longer required

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 15
File Transfer-n-Registration

You can then view your batch online on Data Exchange- HCM Data Loader – Import and Load Data UI.

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 16
Appendix A – HDLdi Installation

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 17
Java (JRE) Download & System Setup
• You need to have Java (JRE) installed on your computer in order to run
HDLdi
• Link to download Java Runtime Environment
• Instructions to update PATH environment variable – to allow executing the
jar file without typing the full command.

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 18
HDLdi Download
• My Oracle Support links to download the App Note 2056538.1

• Extract\unzip the zip file to your computer. Due to file size


limitations, zip file is broken into 2 parts. You will have to
download both parts and then extract, as shown in the first
diagram.
Once you extract the zip file, folder structure should look like what's shown
• To start the app, double click on the .jar file below

• If the app does not start then you can double click the
backup_plan.bat file to start the app via command line.
(Recommended way is to add java to system path as listed on
previous slide)

• For issues\enhancements\feedback – Please use MOS Community

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 19
Appendix B – HDLdi Demo Database

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 20
HDLdi Demo Database
In scope for first release In progress (ETA- end of the month)
1 Action Reasons
2 Actions 1 PersonSecurityProfile
3 LegislativeData Group 2 CountrySecurityProfile
4 Person Type 3 LdgSecurityProfile
5 ContentItem 4 OrganizationSecurityProfile
6 Education Establishment 5 PositionSecurityProfile
7 Grade 6 RoleMapping
8 GradeRate
9 JobFamily
10 Job
11 Location
12 Department\Organization
13 Position
Roadmap (~ end of the Nov2015)
14 Rating Model
1 Additional use cases
15 Salary Basis
2 5 more business objects
16 Worker (Person, Work relationship)
17 Salary
18 TalentProfile
19 Contact
20 Documents Of Record
21 Person Image
22 Areas Of Responsibility

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 21
HDLdi Demo Database
• Demo data for 10 employees
Folder Structure
• Core transactions e.g. Hire, Promotion, Transfer, Termination,
Rehire, etc
• Multiple Assignments
• Multiple Managers
• Historical Information
• Salary Information
• Work structures
• Flexfields
• Talent Profile
• Area of responsibility
• Photos and Attachments
** Please start with Step1 to begin the initial data loading process.
• Several use cases for worker object

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 22
HDLdi Demo Database
Manager Hierarchy

James Harrington

Chris Fisher Nancy Rao


CIO VP Human Resources

Prasanna Borse Rupesh Varma Demo data is loaded


Program Manager HR Manager with proper manager
hierarchy so that
one can even test
employee self
Jason Pike Beverly Hill Gary Norman Victoria Lopez Willams Hong service, manager
Product Manager Fusion Consultant Contractor HR Analyst Contractor
self service and
workflow approvals
using these demo
employees.

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 23
HDLdi Demo Database – Specific Use Cases
Folder Name Description
Step7_Hire New Hire - Example to demonstrate loading new hire information.

Step8_Termination Termination - Incremental mode updates to term employee or


- Example for doing mass terminations using user keys
Step9_Rehire Rehire - Example to demonstrate rehires by loading new work
relationship for existing person record.
Step10_Primary2Secondary Assignment switch - Switching between primary and secondary assignments

Step11_Secondary2Primary Assignment switch - Example to demonstrate switch from secondary to


primary assignment
Step12_MultipleChangesPerDay Multiple changes on same day (MCPD) - Example to demonstrate loading multiple changes on
same day type historical information

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 24
Appendix B – Automation (Command Line\Java)

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 25
Command Line
• To view the usage use - > upload ucm –h
• usage: upload ucm [-prop <arg>] -f <arg> [-i [-ime <arg>] [-lme <arg>] [-lct <arg>] [-lgs <arg>] [-et <arg>] [-dsf <arg>]] [-proxy -host <host> -port
<port>] [-output <xml_file>]

• Example: upload ucm -prop D:\Prasanna\HDLdi2.3.6\profiles\MXF_HDL.TM -f D:\temp\demo.zip -i -ime 100 -lme 100 -lct 1 -lgs 200 -et NONE
–dsf Y -output result.xml

-h,--help Print help message


-prop,--property-file <arg> Optional. The setup file of ucm server configuration. The default properties file is profiles/ucmcli.tm.
-f,--upload-file <arg> File to upload
-i,--invoke Optional. Invoke HDL service after upload
-dsf,--delete-source-file <arg> Delete source file. Y/N. This parameter is effective only when invoke is enabled.
Encrypt types are: PGPSIGNED, PGPUNSIGNED, PGPX509SIGNED, PGPX509UNSIGNED. NONE or leave blank for no encryption. This parameter is
-et,--encrypt-type <arg> effective only when invoke is enabled.
-ime,--import-maximum-err <arg> Import Maximum Errors. Numeric value. Default value is 100. This parameter is effective only when invoke is enabled.
-lct,--load-concurrent-thread <arg> Load Concurrent Thread.Numeric value. Default value is 1. This parameter is effective only when invoke is enabled.
-lgs,--load-group-size <arg> Load Group Size. Numeric value. Default value is 200. This parameter is effective only when invoke is enabled.
-lme,--load-maximum-err <arg> Load maximum Errors. Numeric value. Default value is 100. This parameter is effective only when invoke is enabled.
-output,--output-file <arg> xml file to ouput the result
-host,--proxy-host <arg> http proxy host
-port,--proxy-port <arg> proxy port
-proxy A flag to use http proxy to connect server

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 26
Java API
• You can invoke HDLdi from a java program by simply using -
oracle.hcm.cx.app.CommandInvoker class
• Example 1:
public String invoke(String[] args) throws Exception
usage:
CommandInvoker ci = new CommandInvoker();
String result = ci.invoke(new String[]{"ucm", "-prop","D:/ucmdata/MXF_HDL.TM", "-f", "D:/ucmdata/person1.zip", "-i", "-ime",
"100", "-lme", "100", "-lct", "1", "-lgs", "200", "-et", "PGPSIGNED", "-dsf", "Y"});

• Example 2:
public String invokeUCM(String fileName, String profileName, String invoke, String importMaxErr, String loadMaxErr, String
loadConThread, String loadGroupSize, String encryptType, String deleteSourceFile) throws Exception
usage:
CommandInvoker ci = new CommandInvoker();
String result = ci.invokeUCM("D:/ucmdata/person1.zip", "D:/ucmdata/MXF_HDL.TM", "-i", "100", "100", "1", "200", "NONE", "Y");

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

You might also like