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 Oracles 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
Dont 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 Users 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 Users 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