OUM

DS.140 Design Specification

BOK
EBS Employee Payroll Costing to
OIC Interface
Author : Mohan NS
Creation Date : May 14, 2021
Last Updated :
Document Ref : AN100 BOK EBS to Fusion Integration –
Employee Payroll Costing Details
Version : V1

Approvals:

Noella M. MUPOLE

File Ref: 535553342.docx Page 1 of 15

1 DOCUMENT CONTROL

1.1 Change Record

22

Date Author Version Change Reference

03-MAR-2021 Mohan NS 1.0 No Previous Version

1.2 Reviewers

Name Position
Vijay Allala Project Manager
Kalaichelvi Chandramohan Functional Lead

1.3 Distribution

Copy Name Location

No.

Note to Holders:
If you receive an electronic copy of this document and print it out, please write your
name on the equivalent of the cover page, for document control purposes.
If you receive a hard copy of this document, please write your name on the front
cover, for document control purposes.

Contents

File Ref: 535553342.docx Page 2 of 15

1 Document Control.........................................................................................................................2
1.1 Change Record.......................................................................................................................2
1.2 Reviewers..............................................................................................................................2
1.3 Distribution............................................................................................................................2
1 Technical Overview.........................................................................................................................4
1.1 Integration Cloud Service.......................................................................................................4
1.1.1 Oracle EBS to OIC Process Flow:....................................................................................4
1.1.2 Block Diagram................................................................................................................5
2 INTEGRATION ARCHITECTURE.......................................................................................................6
3 Building Blocks...............................................................................................................................7
3.1 EBS to OIC Integration..........................................................................................................7
3.1.1 EBS to OIC Integration - Process Flow Steps..................................................................7
3.1.2 Ebs Employee Payroll costing to OIC Integration - Interface Design..............................8
3.2.2.1 EBS GlInterface-Payroll_id-MON-YYYY.zip.pgp file creation Screen Design..........................8
4 Custom program parametr........................................................................................................11
5 Custom Concurrent program - Query........................................................................................12
5.1 Generate . csv file script.........................................................................................................12
EBS – Generate .csv file script......................................................................................................12
5.2 Generate . properties file script.............................................................................................12
EBS - Generate . properties file script..........................................................................................12
5.3 Host Program.........................................................................................................................12
EBS – Host Program.....................................................................................................................12
6 Scheduling..................................................................................................................................13
7 Unit Testing................................................................................................................................14
8 Open and Closed Issues............................................................................................................15
8.1 Open Issues........................................................................................................................15
8.2 Closed Issues........................................................................................................................15

File Ref: 535553342.docx Page 3 of 15

1 TECHNICAL OVERVIEW
The purpose of this document is to describe how to automate the transfer of Generated payroll
costing and Payroll payment costing for worker from EBS to embedded SFTP server in OIC

The scope of the system being built is as defined in the User Requirement Document.

1.1 Integration Cloud Service

1.1.1 ORACLE EBS TO OIC PROCESS FLOW:

C o s ti n g in fo rm a ti o n " .C S V " g e n e ra te d b y p a y ro ll c o s ti n g d e ta ils h o st p ro g ra m

in E B S S e rv e r

P ro p e rti e s in fo r m a ti o n " . p ro p e rti e s " g e n e ra te d b y p a y ro ll c o s ti n g

d e ta ils h o s t p ro g ra m in E B S S e rv e r

" z ip " fo ld e r p re p a re d c o n ta in in g " . C S V " fi le a n d

" . p ro p e rti e s " fi le b y p a y ro ll c o s ti n g d e ta ils h o st p ro g ra m in E B S
S e rv e r

E n c ry p t th e z ip e d fi le (p g p e n c ry p ti o n ) b y p a y ro ll c o s ti n g d e ta ils h o s t
p ro g ra m in E B S S e rv e r

T ra n sfe r th e e n c rip te d fi le to e m b e d d e d S F T P s e rv e r in O IC b y p a y ro ll c o s ti n g
d e ta ils h o s t p ro g ra m in E B S S e rv e r

File Ref: 535553342.docx Page 4 of 15

 1.1.2 Block Diagram
The block diagram below represents the data flow between source and target.

Fus
EBS
OIC ion
Application

File Ref: 535553342.docx Page 5 of 15

2 INTEGRATION ARCHITECTURE

Encrypted OIC program

1.zip
Oracle
file 2. SFTP
Encrypted PickOIC
the ZIP
EBS
containing Server
zip file file in SFTP
".CSV" and placed In server and
".properties" SFTP server initates data
generated loading

File Ref: 535553342.docx Page 6 of 15

2 BUILDING BLOCKS
1. Oracle OIC
 Connections
 Integrations
 Agent
2. Oracle EBS
 Oracle Database
3. Oracle Fusion ERP Cloud

2.1 EBS to OIC Integration

2.1.1 EBS to Fusion Integration - Process Flow Steps
The below section explains the business rules for the payroll costing interface between Oracle
EBS Payroll and OIC.
 The GlInterface-Payroll_id-MON-YYYY folder is created by "BK: Payroll Costing
Details Host program" and placed in
($XXBK_TOP/XX_BOK_GlInterface/XX_BOK_GlInterfaceData) server path. The name
of the folder must include payroll ID and date in order to be unique.
 The CSV file should be generated by "BK: Payroll Costing Details Host program" and
pleased under GlInterface-Payroll_id-MON-YYYY folder. The name of the ".CSV" file
should always be GlInterface.csv
 The properties file should be generated by "BK: Payroll Costing Details Host
program" and pleased under GlInterface-Payroll_id-MON-YYYY folder. The name of the
".properties" file should always be GlInterface.properties.
 The prepared GlInterface-Payroll_id-MON-YYYY folder would be zipped (GlInterface-
Payroll_id-MON-YYYY.zip) by "BK: Payroll Costing Details Host program".
 After preparing zip GlInterface-Payroll_id-MON-YYYY.zip will be encrypted by pgp
encryption (GlInterface-Payroll_id-MON-YYYY.zip.pgp) by "BK: Payroll Costing Details
Host program".
 The host program (BK: Payroll Costing Details Host program) would upload the file
GlInterface-Payroll_id-MON-YYYY.zip.pgp the SFTP into embedded SFTP server in OIC.

File Ref: 535553342.docx Page 7 of 15

 2.1.2 Ebs Employee Payroll Costing to OIC Integration - Interface
Design.

3.2.2.1 EBS GlInterface-Payroll_id-MON-

YYYY.zip.pgp file creation Screen Design
Below are the screenshots for the Executable Files, Concurrent Programs and also the request of the
program.
System Administrator Concurrent Program  Executable

System Administrator Concurrent Program Define

File Ref: 535553342.docx Page 8 of 15

System Administrator Security Responsibility Request

BOK Payroll Implementer -> Run Request

File Ref: 535553342.docx Page 9 of 15

BOK Payroll Implementer -> View Request

File Ref: 535553342.docx Page 10 of 15

 4 Custom program parameters

Parame Requ Disp Value Set Defau Default Value

ter ired lay lt
Type
Busines Y Y HR_BUSINESS_GR
s Group OUP_NAME
Payroll Y Y CAGR_PAYROLL
Costing N Y XX_BK_ACTION_T
Type YPE_VS
Costing Y Y 10 Characters SQL SELECT TO_CHAR(sysdate,'MON-
Period State YYYY') FROM dual
ment
Mode Y Y XX_BK_MODE_VS
Folder Y N 100 Characters Const /
Path ant u01/app/ebstest/fs2/EBSapps/appl/xxb
k/XX_BOK_GlInterface
Respon Y N 15 Number SQL SELECT FRESP.responsibility_id
sibility State FROM fnd_responsibility_tl FRESP
ID ment WHERE
UPPER(FRESP.responsibility_name) =
UPPER('BOK Payroll Implementer')
Applicati Y N 15 Number SQL SELECT FRESP.application_id FROM
on ID State fnd_responsibility_tl FRESP WHERE
ment UPPER(FRESP.responsibility_name) =
UPPER('BOK Payroll Implementer')
Destinati Y N 100 Characters Const /
on Path ant home/users/ERPINTEGRATIONUSER/
journalimport/input
Destinati Y N 15 Number Const 5023
on Port ant
Destinati Y N 100 Characters Const ERPINTEGRATIONUSER
on User ant
Destinati Y N 100 Characters Const 138.1.16.137
on IP ant
Destinati Y N 100 Characters Const KGLerp1!@#$%
on ant
Passwor
d

File Ref: 535553342.docx Page 11 of 15

 5 Custom Concurrent program -
Query
5.1 Generate .csv file script

EBS – Generate .csv file script

xx_bok_spool.sql

5.2 Generate .properties file script

EBS -Generate .properties file script

xx_bok_spool.sql

5.3 HOST PROGRAM.

EBS – HOST PROGRAM.

XX_BOK_COSTING.prog

File Ref: 535553342.docx Page 12 of 15

6 Scheduling

File Ref: 535553342.docx Page 13 of 15

7 Unit Testing

Log in to fusion application and follow below navigation for testing.

General Accounting -> Journals -> Manage Journals -> search with accounting period and verify.

File Ref: 535553342.docx Page 14 of 15

8 Open and Closed Issues

8.1 Open Issues

ID Issue Resolution Responsibility Target Date Impact Date

8.2 Closed Issues

ID Issue Resolution Responsibility Target Date Impact Date

File Ref: 535553342.docx Page 15 of 15