Loading Data Using Batch Loader in Fusion Payroll Applications
Loading Data Using Batch Loader in Fusion Payroll Applications
Contents
Loading data using Batch Loader – Technical Essay ..... Error! Bookmark not defined.
1 Features of Batch Loader ................................................................................................ 3
1.1 Transforming and loading the source data into batches ................................. 3
1.1.1 Load Batch from File ........................................................................................ 3
1.1.2 Batch Loader Spreadsheet................................................................................ 7
1.1.3 Batch Service .................................................................................................... 10
1.1.4 Create Batch from an Object Group ............................................................. 11
4 FAQ .................................................................................................................................. 31
4.1 Batch Loader: Spreadsheet................................................................................... 31
5 Appendix ........................................................................................................................ 32
5.1 Kronos Integration Sample Formula and Data File ....................................... 32
5.1.1 Formula ............................................................................................................ 32
Loading Data Using Batch Loader in Fusion Payroll Applications Payroll
Transformation Formula is based on “Batch Loader” Formula Type. This formula holds the
information on how to read the source file, how to transform and any conversion before
mapping to the Fusion Batch objects.
Please note if the batch doesn’t exist then a new batch will be created. Once the file is uploaded
and user clicks on the “Done” button then this task will be marked as complete.
Via this UI the spreadsheet can be downloaded to view and verify the content of the batch.
Formula Type
Batch Loader
Inputs
OPERATION (text): Such as FILETYPE, DELIMITER, READ and MAP .
LINENO (number) : Line number to be used for the Batch Line Sequence.
LINEREPEATNO (number): This is only needed if a single line in the file can be used to create
multiple batch lines. Please refer to Section 5.1.1 for an formula where it splits a single line
from the file into two batch lines in the batch.
POSITION1..X (text) : This is needed if the file is delimited or position based. Also only need to
pass those columns that will be referenced in the formula, such as POSITION1, POSITION2,
etc.
<XML TAG NAME> (text): If the file is XML based then name of the tags can be passed.
Please refer to Use Case and Appendix sections for sample usage of this feature.
Loading Data Using Batch Loader in Fusion Payroll Applications Payroll
NOTE: Before navigating to Batch Content sheet or Batch Message sheet then please ensure the
user have selected a batch by double clicking the name.
The Batch lines can be created or viewed via the Batch Content sheet;
Loading Data Using Batch Loader in Fusion Payroll Applications Payroll
If the batch name is not shown in the title then the batch is not selected.
In here user can add additional lines, but prior to that they need to either by clicking “Add”
button to add a Task/Task Action or select an existing one;
Loading Data Using Batch Loader in Fusion Payroll Applications Payroll
Please note that if the batch name is not shown in the title then the batch is not selected.
Loading Data Using Batch Loader in Fusion Payroll Applications Payroll
Service Methods
Batch Header: createBatchHeader, updateBatchHeader, deleteBatchHeader and
mergeBatchHeader
Batch lines values takes one row for each parameter. E.g. in the Element Entry case, operations
needs to be called for Reason, Effective Start Date, Assignment Number and Amount. When
the service is available then the corresponding documentation also will be available via Oracle
Enterprise Repository.
Loading Data Using Batch Loader in Fusion Payroll Applications Payroll
2 Supported Objects
The values for the questionnaire matches the values entered in the UI. Supported list of
values for each can be seen on the UI for the given template and questionnaire.
However please note that in the Batch Loader there may be more questionnaire than
what it appears in the UI. These are hidden questionnaires with defaults and are used in
connection with other questionnaires in the UI. In such case the way to find the values
is by creating the element via UI and then downloading it.
It is recommended that this task action to be used to create element based on another
element created via the UI. For example, an element created in a test environment can
be downloaded into a batch via the “Create Batch for an Object”, where by the content
of the batch can be copied a batch in the production environment. This is because the
defaulting and validation on questionnaire is limited when compared to the UI. Please
refer to section 3.3 for an example of how this can be used to clone elements from one
environment to another.
Update Element
Delete Element
Create Input Value
Update Input Value
Delete Input Value
Download Supported via Create Batch for an Object process
Update User-Defined Row: Currently this only allows the correction of existing records,
where by the user needs to pass the Effective Start Date and Effective End Date of the existing
record.
Create User-Defined Column Instance
Update User-Defined Column Instance: Currently this only allows the correction of
existing records, where by the user needs to pass the Effective Start Date and Effective End
Date of the existing record.
2.7 Payroll Relationship
Add Payroll
End Payroll
2.8 Bank
Create Bank
2.9 Bank Branch
Create Bank Branch
2.10 External Bank Account
Create External Bank Account
2.11 Personal Payment Method
Create Personal Payment Method
2.13 Balance
Initialize Balance
NOTE: This is not a Batch Loader object. This object is used in connection with Balance
Initialization feature. Please refer to Balance Initialization documentation for more
information.
3 Use Cases
3.1 Kronos Integration
Existing EBS solution
Payroll Flow can be created to automate the import of Kronos data in bi-weekly frequency
Loading Data Using Batch Loader in Fusion Payroll Applications Payroll
Define the above flow in the Manage Payroll Flow Pattern user interface.
Verify Batch
This is a manual task where user can launch the spreadsheet. User can open up the loaded
batch via the spreadsheet and verify the content before transferring them.
Transfer Batch
This is an automatic task that transfers the content of the batch into the Fusion objects. In this
example the Batch Name can be defaulted to the name of the Flow instance.
Verify Transfer
This is a manual task where the user can be provided with the navigation to the Manage
Element Entry user interface. Therefore user can go there and do some sample check to see
whether the data is loaded or not.
Loading Data Using Batch Loader in Fusion Payroll Applications Payroll
Key
AAAAAAAAAAAAA – Batch Name
BBBBBB - Employee Number
CC - Element Code
D - “0” for positive and “–“ for negative
EE.EE - Hours
The file name might indicate the period in which these time cards need to be created.
How can these be mapped to Element Entry in Fusion via the Batch Loader?
Task/Task Action/Element Name – The two digit code can be converted to the corresponding
action in the formula rule mechanism. E.g. code of 01 can be mapped to “Quick Create –
Normal Hours”.
Assignment Number – If the implementation has only single assignment then prefixing it with
“E” to the passed employer number/person number should do the trick. This can be done in
the formula rule as well, but performance is the concern. However if it involves multiple
assignment then it might be preferable to convert prior to passing this to Fusion.
Effective Start Date – This will be the Start Date
Effective End Date – This will be the End Date
For generated or user defined input values;
e.g. by taking the hours * rate element
Calculated Hour or Hours Worked – This can take the Hours from the imported file.
Date Earned – This can take the Date Earned from the imported file.
Loading Data Using Batch Loader in Fusion Payroll Applications Payroll
Enter the Object as Element and the record name to filter the elements that are to be
downloaded.
Once the process is complete then the given batch can be viewed via the Batch Loader’s
Spreadsheet.
Loading Data Using Batch Loader in Fusion Payroll Applications Payroll
Likewise if there is an update to the given Input Value then there will be additional line for
“Update Input Value”.
4 FAQ
4.1 Batch Loader: Spreadsheet
How to navigate to the spreadsheet?
Navigation: Payroll Administrator work area => Batch Loader
Why my batch lines are not querying or why the task or task actions are not querying?
Please re-query the batch and select the batch, before coming to the batch line sheet. Once you
are in there it should show the batch header name in the line sheet.
Why the spreadsheet is not rendering the field and button properly?
If Oracle ADF Desktop Integration for Excel is not installed then please download and install.
Please refer to Oracle ADF Desktop Integration for Excel documentation for further details on
this.
However if it is already installed and not working ,the try uninstalling and installing the
Oracle ADF Desktop Integration for Excel client or make sure the Oracle ADF Desktop
Integration for Excel add on is not disabled.
Why the columns heading for the batch content are chopped?
5 Appendix
/* Inputs */
INPUTS ARE OPERATION (text), LINENO (number), LINEREPEATNO (number), POSITION1
(text), POSITION2 (text), POSITION4 (text)
/* Calculations */
IF OPERATION=''FILETYPE'' THEN
OUTPUTVALUE=''DELIMITED''
ELSE IF OPERATION=''DELIMITER'' THEN
OUTPUTVALUE=''|''
ELSE IF OPERATION=''READ'' THEN
OUTPUTVALUE=''NONE''
ELSE IF OPERATION=''MAP'' THEN
(
/*Batch Related Outputs*/
TASK=''Element Entry''
TASKACTION=''Quick Create - PM US Sun Power - PM YS Overtime''
LINESEQUENCE=LINENO
IF LINEREPEATNO < 2 THEN
LINEREPEAT=''Y''
ELSE
LINEREPEAT=''N''
/* Returns */
IF OPERATION=''MAP'' THEN
RETURN
TASK,TASKACTION,LINESEQUENCE,LINEREPEAT,Effective_Start_Date,Assignment_Number,Units
ELSE
RETURN OUTPUTVALUE
/* Inputs */
INPUTS ARE OPERATION (text),LINENO (number),POSITION1 (text),POSITION2
(text),POSITION3 (text),POSITION4 (text),POSITION5 (text),POSITION6
(text),POSITION7 (text)
/* Calculations */
IF OPERATION='FILETYPE' THEN
OUTPUTVALUE='DELIMITED'
ELSE IF OPERATION='DELIMITER' THEN
OUTPUTVALUE=','
ELSE IF OPERATION='READ' THEN
OUTPUTVALUE='NONE'
ELSE IF OPERATION='MAP' THEN
(
IF POSITION1='1' THEN
(
/*Batch Related Outputs*/
TASK='Element Entry'
TASKACTION='Quick Create - PM US Sun Power - PM YS Overtime'
LINESEQUENCE=LINENO
/* Returns */
IF OPERATION='MAP' THEN
IF POSITION1='1' THEN
RETURN
TASK,TASKACTION,LINESEQUENCE,Effective_Start_Date,Effective_End_Date,A
ssignment_Number,Units
ELSE IF POSITION1='5' THEN
RETURN
TASK,TASKACTION,LINESEQUENCE,Effective_Start_Date,Effective_End_Date,A
ssignment_Number,Amount
ELSE IF POSITION1='5' THEN
RETURN
TASK,TASKACTION,LINESEQUENCE,Effective_Start_Date,Effective_End_Date,A
ssignment_Number,Hours_Worked
ELSE
RETURN OUTPUTVALUE
in same
period
Element Update Element Additio This takes a value of either Yes or No
nal No.
entry
Element Update Element Closed This takes a value of either Yes or No
for No.
entry
Element Update Element Defaulti Name of the formula. No
ng
Formula
Element Update Element Calculat Name of the formula. No
ion
Formula
Element Update Element Validati Name of the formula. No
on
Formula
Element Update Element Validati Message name, such as No
on PAY_6306_INPUT_VALUE_FORM
Overrid AT.
e
Messag
e
Element Update Input Effectiv Date in the format of YYYY-MM- Yes
Value e As Of DD
Date
Element Update Input Element Name of the element. Yes
Value
Element Update Input Input Name of the input value Yes
Value Value
Element Update Input Unit Of Values from the Lookup Type No
Value Measur UNITS. E.g. Money
e
Element Update Input Require This takes a value of either Yes or No
Value d No.
Element Update Input Display Display sequence of the input value. No
Value Sequenc E.g. 1 or 2 or 3 etc.
e
Element Update Input Default Value in internal format. E.g. if is No
Value date then it will be YYYY-MM-DD.
Or if it is number then 12.1 without
any trailing spaces.
Element Update Input Apply This takes a value of either Yes or No
Value default No.
at run
time
Element Update Input Minimu Value in internal format. E.g. if is No
Value m date then it will be YYYY-MM-DD.
Or if it is number then 12.1 without
Loading Data Using Batch Loader in Fusion Payroll Applications Payroll
Monetary/Numeric in numerical
value with dot as the decimal, etc.
External Create External Bank This must be an existing Bank. Yes
Bank Bank Account Name
Account
External Create External Bank This must be an existing Bank Yes
Bank Bank Account Branch Branch.
Account Name
External Create External Account This is the Account number for the Yes
Bank Bank Account Number given Bank Account.
Account
External Create External IBAN This is the IBAN for the given No
Bank Bank Account account.
Account
External Create External Account This will be based on No
Bank Bank Account Type IBY_BANKACCT_TYPES lookup
Account type; CHECKING - Checking
Account, MONEYMRKT - Money
Market Account, SAVINGS -
Savings Account
Payroll Create Payroll Cutoff Number of days that cutoff date Yes
Definition Definition Days falls before or after the base date.
Payroll Create Payroll Payslip Indicates whether payslip Yes
Definition Definition Availabl availability should fall on, after, or
e Before before the base date for the payroll
or After processing event.
Base
Date
Payroll Create Payroll Date Indicates whether date earned Yes
Definition Definition Earned should fall on, after, or before the
Before base date for the payroll processing
or After event. The exact value must be
Base either O or A or B.
Date
Payroll Create Payroll Payroll Indicates whether payroll run Yes
Definition Definition Run should fall on, after, or before the
Before base date for the payroll processing
or After event. The exact value must be
Base either O or A or B.
Date
Payroll Create Payroll Cut off Indicates whether the cutoff date Yes
Definition Definition Before should fall on, after, or before the
or After base date for the payroll processing
Base event. The exact value must be
Date either O or A or B.
Payroll Create Payroll Date Indicates whether date paid should Yes
Definition Definition Paid fall on, after, or before the base date
Before for the payroll processing event. The
or After exact value must be either O or A or
Base B.
Date
Payroll Create Payroll Date The type of days used to calculate Yes
Definition Definition Paid payroll processing event dates can
Day be calendar days (C) or work days
Type (W).
Payroll Create Payroll Payslip The type of days used to calculate Yes
Definition Definition Availabi payroll processing event dates can
lity Day be calendar days (C) or work days
Type (W).
Payroll Create Payroll Cut off The type of days used to calculate Yes
Definition Definition Day payroll processing event dates can
Type be calendar days (C) or work days
(W).
Payroll Create Payroll Payroll The type of days used to calculate Yes
Definition Definition Run payroll processing event dates can
Date be calendar days (C) or work days
Day (W).
Type
Loading Data Using Batch Loader in Fusion Payroll Applications Payroll
Payroll Create Payroll Date The type of days used to calculate Yes
Definition Definition Earned payroll processing event dates can
Day be calendar days (C) or work days
Type (W).
Payroll Create Payroll Payslip Date that is used as the basis for Yes
Definition Definition Availabi scheduling the payslip availability
lity Base date. This can be either Period End
Date Date (E) or Period Start Date (S).
Payroll Create Payroll Cut off Date that is used as the basis for Yes
Definition Definition Base scheduling the cutoff date, which is
Date the last date for entering payroll
information. This can be either
Period End Date (E) or Period Start
Date (S).
Payroll Create Payroll Payroll Date that is used as the basis for Yes
Definition Definition Run scheduling the payroll run date.
Date This can be either Period End Date
Base (E) or Period Start Date (S).
Date
Payroll Create Payroll Date Date that is used as the basis for Yes
Definition Definition Earned scheduling the date earned, which is
Base the date on which element entries
Date are added to the payroll run. This
can be either Period End Date (E) or
Period Start Date (S).
Payroll Create Payroll Date Date that is used as the basis for Yes
Definition Definition Paid scheduling the date paid date. This
Base can be either Period End Date (E) or
Date Period Start Date (S).
Payroll Create Payroll Legislati Name of a grouping of payroll data Yes
Definition Definition ve Data within a legislation.
Group
Payroll Create Payroll Default Payment method used for people No
Definition Definition Paymen who have not specified a personal
t payment method.
Method
Payroll Create Payroll Reporti Name for the payroll definition that No
Definition Definition ng is displayed on reports.
Name
Payroll Create Payroll Ledger General ledger used to cost entries No
Definition Definition for the payroll run results.
Payroll Create Payroll Allow Indicates if the prepayments process Yes
Definition Definition Negativ can include negative payments.
e This can be either Yes and No.
Paymen
ts
Payroll Update Payroll Name Name of the payroll definition that Yes
Definition Definition groups workers who are processed
together with the same processing
Loading Data Using Batch Loader in Fusion Payroll Applications Payroll
Name
HCM User- Update User- Formula Name of the compiled User Table No
Defined Defined Column Name Validation formula.
Table
HCM User- Update User- Legislati Name of the grouping of payroll Yes
Defined Defined Column ve Data data within a legislation.
Table Instance Group
HCM User- Update User- User- Name of the user-defined table. Yes
Defined Defined Column Defined
Table Instance Table
Name
HCM User- Update User- User- Name of the user-defined column. Yes
Defined Defined Column Defined
Table Instance Column
Name
HCM User- Update User- Row Name of the user-defined row. Yes
Defined Defined Column Name
Table Instance
HCM User- Update User- Effectiv Date in the format of YYYY-MM- Yes
Defined Defined Column e Start DD.
Table Instance Date
HCM User- Update User- Effectiv Date in the format of YYYY-MM- Yes
Defined Defined Column e End DD.
Table Instance Date
HCM User- Update User- Value User-defined column instance value. No
Defined Defined Column
Table Instance
HCM User- Update User- Legislati Name of the grouping of payroll Yes
Defined Defined Row ve Data data within a legislation.
Table Group
HCM User- Update User- User- Name of the user-defined table. Yes
Defined Defined Row Defined
Table Table
Name
HCM User- Update User- Row Name of the user-defined row. Yes
Defined Defined Row Name
Table
HCM User- Update User- Effectiv Date in the format of YYYY-MM- Yes
Defined Defined Row e Start DD.
Table Date
HCM User- Update User- Effectiv Date in the format of YYYY-MM- Yes
Defined Defined Row e End DD.
Table Date
HCM User- Update User- Match Either the value to match, if for No
Defined Defined Row Value Match type, or the low range value,
Table Or Low for Range type.
Range
Value
HCM User- Update User- High Maximum value in range. No
Defined Defined Row Range
Table
Loading Data Using Batch Loader in Fusion Payroll Applications Payroll
HCM User- Update User- Sequenc This must be an integer value for No
Defined Defined Row e the sequence.
Table
HCM User- Update User- Legislati Name of the grouping of payroll Yes
Defined Defined Table ve Data data within a legislation.
Table Group
HCM User- Update User- User- Name of the user-defined table. Yes
Defined Defined Table Defined
Table Table
Name
HCM User- Update User- User- Name to use as a title in the user- No
Defined Defined Table Defined defined table for a group of rows.
Table Row
Title
Element Create Element Effectiv Start date of the entry in YYYY-MM- Yes
Entry Entry e Start DD format.
Date
Element Create Element Effectiv End date of the entry, where No
Entry Entry e End applicable, in YYYY-MM-DD
Date format.
Element Create Element ENTRY Entry values for the given input No
Entry Entry VALUE value of the element. Maximum of
1..50 50 supported via this loader. Values
must be in internal format. E.g.
DATE is in YYYY-MM-DD format,
Monetary/Numeric in numerical
value with dot as the decimal, etc.
The order of the entry value
matches the order of the input value
based on the display sequence.
Element Create Element SEGME Value entered should be the code No
Entry Entry NT1..30 rather than the meaning of the
corresponding Value Set.
Element Update Element Effectiv Value in YYYY-MM-DD format. Yes
Entry Entry e Start
Date
Element Update Element Element Name of the Element. Yes
Entry Entry
Element Update Element Entry Sequence of the entry, especially if No
Entry Entry Sequenc there is more than one entry exists
e for the given element.
Element Update Element Person Number that identifies a person's Yes
Entry Entry Number assignment or employment term or
payroll relationship.
Element Update Element Assign Number that identifies a person's No
Entry Entry ment assignment, such as E100. Only
Number needed if there were more than one
assignment for the given person.
Element Update Element Term Number that identifies a person's No
Entry Entry Number employment term, such as ET100.
Only needed if there were more
than one employment term for the
given person.
Element Update Element Relation Number that identifies a person's No
Entry Entry ship payroll relationship, such as 100.
Number Only needed if there were more
than one payroll relationship for the
given person.
Element Update Element Payroll Name of the Payroll if the entry No
Entry Entry needs to be created at employment
term level. Only needed if there
were more than one payroll for the
given person.
Element Update Element Reason Lookup code from the lookup type No
Entry Entry PAY_ELE_ENTRY_REASON.
Element Update Element Subprio Numerical value. No
Entry Entry rity
Element Update Element ENTRY Entry values for the given input No
Entry Entry VALUE value of the element. Maximum of
Loading Data Using Batch Loader in Fusion Payroll Applications Payroll