GLConversions

Author:

M.Anil Pullam Raju

Creation Date:
Last Updated:
Last Updated By:

M.Anil Pullam Raju

Version:

DRAFT 1A

Approvals

Name

Title

Date

Contents

Approvals..........................................................................................................1
Overview......................................................................................................................4
Assumptions......................................................................................................5
Import steps......................................................................................................5
High level program information................................................................................6
Load program....................................................................................................6
Validate program...............................................................................................7
Import program components.....................................................................................8
Concurrent programs........................................................................................8
PL/SQL packages..............................................................................................8
Loader scripts....................................................................................................8
Profile options...................................................................................................8
Indexes..............................................................................................................9
Load<ObjectName> Program..................................................................................10
Import file format............................................................................................10
Data mapping..................................................................................................11
Loadt<ObjectName> program parameters....................................................13
Special logic....................................................................................................13
Validate <ObjectName> Program...........................................................................14
Defaults...........................................................................................................14
Conversions.....................................................................................................15
Validations.......................................................................................................17
Other logic......................................................................................................17
Validate <ObjectName> program parameters................................................17
PL/SQL Package Design.................................................................................18
Global constants and variables........................................................................18
Procedure Validate_<ObjectName>................................................................18
Open/Closed Issues...................................................................................................22
Open issues.....................................................................................................22
Closed issues...................................................................................................22
3

Overview
Oracle General Ledger use journal entry for maintainace of accounts . The journal
import program allows the import of journals
The

from external systems.

GL- Interface program imports all journals information from flat files

extracted from the legacy system into Oracle Applications 11i.

We will build the following concurrent programs to implement the GLs Import
program:
1. Load staging table (GLs) using

(SQL*Loader)

2. Validate (PL/SQL)
The load program reads data from a flat file into the following GL Routing
Interface tables of 11i.

HW_ TEMP _GL_INTERFACE

The Validate program processes interface data in order to make it ready for the
standard journal and Routing open Interface program. It performs the following
basic functions:

All the Accounting information will be checked for their existence in the
temp table .

The date format will be changed to DD-MON-YYYY.

Routing Standard Interface program will read, validate and then move the data into
the 11i GL tables.

Assumptions
This design document assumes the following:

The journals

from the legacy system extracted in a flat file will be

selected for conversion.

Routings are not in the scope of this interface.

Import steps
The import process takes place in 4 steps:
1. Move import file to $HW_TOP\DATA\IN
2.

Load Data into stagging table(HW_ TEMP _GL_INTERFACE)

3. Validate(Validate GLs program and load into (GL_INTERFACE)

4. Move import and log files into GL_BALANCE Table

High level program information

The following lists summarize the Import <ObjectName> program information:

Load program

Property

Value

Name

HW_STAGLOAD.CTL

Concurrent program name

HW_LOADCON.PROG

Import file format

TEXT

Incompatibility

<Itself/Program1/Program2/>

Replace or Append

Replace

Initial record status

<Records are immediately available for Standard interface

program/ Records in NEW status and which are processed by
the Validate<SGI_ObjectName> program before they are
available for the standard interface program>

Full import file name

HW_DATA.TXT

Restart restrictions

<None/Yes> If Yes, Explain

Validate program

Property

Value

Name

HW_VALIDATE.SQL

Concurrent program name

HW_VALIDCON

Incompatibility

<Itself/Program1/Program2/>

Processing mode

All

Pre-requisites

HW_LOADCON must run before it.

Restart restrictions

None

Import program components

The following list contains all components required to completely install the
Import<ObjectName> program:

Concurrent programs
Name: HW_LOADCON
Type: Concurrent Program for importing journal

PL/SQL packages
Package name : HW_VALIDATE
Filenames: HW_TEMP_GL_INTERFACE

Loader scripts
Filename HW_STAGED.CTL

Profile options
Profile option name : Set Of Books Name & Set Of Books Id should remain
constant for a batch.

Indexes
Index name :
Filename

Running User:
Value sets
Name: company.dept.accounting
Values:

Load<ObjectName> Program
The Load HW_STAGLOAD.CTL program is a SQL*Loader script. It loads an
import file into the following table(s)
n

HW_TEMP_GL_INTERFACE

Import file format

The import file is <Comma delimited/Positional> and has the following format:

Column name

Special Format
(date format,
decimal points)

Position/Max
Length

STATUS

VARCHAR2(50)

SET_OF_BOOKS_ID

NUMBER(15)

ACCOUNTING_DATE

DD-MONYYYY

CURRENCY_CODE

DATE
VARCHAR2(15)

DATE_CREATED

DD-MONYYYY

DATE

CREATED_BY

NUMBER(15)

ACTUAL_FLAG

VARCHAR2(1)

USER_JE_CATEGORY_NAME

VARCHAR2(25)

USER_JE_SOURCE_NAME

VARCHAR2(25)

SEGMENT1

VARCHAR2(25)

SEGMENT2

VARCHAR2(25)

SEGMENT3

VARCHAR2(25)

10

SEGMENT4

VARCHAR2(25)

SEGMENT5

VARCHAR2(25)

ENTERED_DR

NUMBER

ENTERED_CR

NUMBER

ACCOUNTED_DR

NUMBER

ACCOUNTED_CR

NUMBER

TRANSACTION_DATE

DD-MONYYYY

GROUP_ID

DATE
NUMBER (15)

Data mapping

Oracle table name

Oracle column name

Extract column name

Transformati
on logic

HW_TEMP_GL_I

STATUS

STATUS

SET_OF_BOOKS_ID

SET_OF_BOOKS_ID

ACCOUNTING_DATE

ACCOUNTING_DATE

CURRENCY_CODE

CURRENCY_CODE

DATE_CREATED

DATE_CREATED

CREATED_BY

CREATED_BY

NTERFACE
HW_TEMP_GL_I
NTERFACE
HW_TEMP_GL_I
NTERFACE
HW_TEMP_GL_I
NTERFACE
HW_TEMP_GL_I
NTERFACE
HW_TEMP_GL_I
NTERFACE

11

HW_TEMP_GL_I

ACTUAL_FLAG

ACTUAL_FLAG

NTERFACE
HW_TEMP_GL_I

USER_JE_CATEGORY_ USER_JE_CATEGORY_NAME

NTERFACE

NAME

HW_TEMP_GL_I

USER_JE_SOURCE_N

NTERFACE

AME

HW_TEMP_GL_I

SEGMENT1

SEGMENT1

SEGMENT2

SEGMENT2

SEGMENT3

SEGMENT3

SEGMENT4

SEGMENT4

SEGMENT5

SEGMENT3

ENTERED_DR

ENTERED_DR

ENTERED_CR

ENTERED_CR

ACCOUNTED_DR

ACCOUNTED_DR

ACCOUNTED_CR

ACCOUNTED_CR

TRANSACTION_DATE

TRANSACTION_DATE

GROUP_ID

GROUP_ID

USER_JE_SOURCE_NAME

NTERFACE
HW_TEMP_GL_I
NTERFACE
HW_TEMP_GL_I
NTERFACE
HW_TEMP_GL_I
NTERFACE
HW_TEMP_GL_I
NTERFACE
HW_TEMP_GL_I
NTERFACE
HW_TEMP_GL_I
NTERFACE
HW_TEMP_GL_I
NTERFACE
HW_TEMP_GL_I
NTERFACE
HW_TEMP_GL_I
NTERFACE
HW_TEMP_GL_I
NTERFACE

12

Loadt<ObjectName> program parameters

The Load<ObjectName> program has one parameters:

Parameter name

Prompt

Value set name

Default

Required

Special logic
<List here any special transformations or logic you need to put in the SQL script>

13

Validate <ObjectName> Program

The validate HW_VALIDATE.SQL program is a PL/SQL concurrent program that
performs the following:
1.

Converts some column values into their Oracle equivalents

2.

Validates some interface table columns

3.

Assigns defaults to records inGL_INTERFACE interface table(s).

4.

Inserts additional records in the GL_INTERFACE table for every loaded

record.

5.

Other.

Defaults
Table name

Column name

Default

GL_INTERFACE

SET_OF_BOOKS_ID

GL_INTERFACE

ACCOUNTING_DATE

SYSDATE

GL_INTERFACE

DATE_CREATED

SYSDATE

GL_INTERFACE

TRANSACTION_DAT

SYSDATE

14

Conversions

Source

table

and Target

column names
HW_TEMP_GL_INTE
RFACE.STATUS
HW_TEMP_GL_INTE

table

and Conversion logic

column names
GL_INTERFACE.ST HW_TEMP_GL_INTERFACE.STAT
ATUS

US = GL_INTERFACE.STATUS

GL_INTERFACE.SE HW_TEMP_GL_INTERFACE.SET_

RFACE.SET_OF_BOO T_OF_BOOKS_ID

OF_BOOKS_ID=

KS_ID

GL_INTERFACE.SET_OF_BOOKS_
ID

HW_TEMP_GL_INTE

GL_INTERFACE. HW_TEMP_GL_INTERFACE.

RFACE.

ACCOUNTING_DAT

ACCOUNTING_DATE=

ACCOUNTING_DAT

GL_INTERFACE.

E
HW_TEMP_GL_INTE
RFACE

ACCOUNTING_DATE
GL_INTERFACE HW_TEMP_GL_INTERFACE
.CURRENCY_CODE

.CURRENCY_CODE

.CURRENCY_CODE=
GL_INTERFACE
.CURRENCY_CODE

HW_TEMP_GL_INTE

GL_INTERFACE.DA

HW_TEMP_GL_INTERFACE.DATE

RFACE.DATE_CREAT TE_CREATED

_CREATED=

ED

GL_INTERFACE.DATE_CREATED

HW_TEMP_GL_INTE

HW_INTERFACE.CR

HW_TEMP_GL_INTERFACE.CREA

RFACE.CREATED_B

EATED_BY

TED_BY=

GL_INTERFACE.CREATED_BY

HW_TEMP_GL_INTE

GL_INTERFACE.AC

HW_TEMP_GL_INTERFACE.ACTU

RFACE.ACTUAL_FL

TUAL_FLAG

AL_FLAG=

AG
HW_TEMP_GL_INTE

GL_INTERFACE.ACTUAL_FLAG
GL_INTERFACE.US HW_TEMP_GL_INTERFACE.USER

RFACE.USER_JE_CA

ER_JE_CATEGORY_

_JE_CATEGORY_NAME=

TEGORY_NAME

NAME

GL_INTERFACE.USER_JE_CATEG
15

ORY_NAME
HW_TEMP_GL_INTE

GL_INTERFACE.US

HW_TEMP_GL_INTERFACE.USER

RFACE.USER_JE_SO

ER_JE_SOURCE_NA _JE_SOURCE_NAME=GL_INTERF

URCE_NAME

ME

ACE.USER_JE_SOURCE_NAME

HW_TEMP_GL_INTE

GL_INTERFACE.SE

HW_TEMP_GL_INTERFACE.SEGM

RFACE.SEGMENT1

GMENT1

ENT1=
GL_INTERFACE.SEGMENT1

HW_TEMP_GL_INTE

GL_INTERFACE.SE

HW_TEMP_GL_INTERFACE.SEGM

RFACE.SEGMENT2

GMENT2

ENT2=
GL_INTERFACE.SEGMENT2

HW_TEMP_GL_INTE

GL_INTERFACE.SE

HW_TEMP_GL_INTERFACE.SEGM

RFACE.SEGMENT3

GMENT3

ENT3=
GL_INTERFACE.SEGMENT3

HW_TEMP_GL_INTE

GL_INTERFACE.EN

HW_TEMP_GL_INTERFACE.ENTE

RFACE.ENTERED_D

TERED_DR

RED_DR=

GL_INTERFACE.ENTERED_DR

HW_TEMP_GL_INTE

GL_INTERFACE.EN

HW_TEMP_GL_INTERFACE.ENTE

RFACE.ENTERED_C

TERED_CR

RED_CR=

GL_INTERFACE.ENTERED_CR

HW_TEMP_GL_INTE

GL_INTERFACE.AC

HW_TEMP_GL_INTERFACE.ACCO

RFACE.ACCOUNTED

COUNTED_DR

UNTED_DR=

_DR

GL_INTERFACE.ACCOUNTED_DR

HW_TEMP_GL_INTE

GL_INTERFACE.AC

HW_TEMP_GL_INTERFACE.ACCO

RFACE.ACCOUNTED

COUNTED_CR

UNTED_CR=

_CR

GL_INTERFACE.ACCOUNTED_CR

HW_TEMP_GL_INTE

GL_INTERFACE.TR

HW_TEMP_GL_INTERFACE.TRAN

RFACE.TRANSACTI

ANSACTION_DATE

SACTION_DATE=GL_INTERFACE.

ON_DATE

TRANSACTION_DATE

HW_TEMP_GL_INTE

GL_INTERFACE.GR

HW_TEMP_GL_INTERFACE.GROU

RFACE.GROUP_ID

OUP_ID

P_ID
16

Validations

Table name

Column name

Validation logic

GL_INTERFACE

ENTERED_DR

ENTERED_DR
=ACCOUNTED.DR

GL_INTERFACE

ENTERED_CR

ENTERED_CR=ACCO
UNTED.CR

17

Other logic
<List all other logic>

Validate <ObjectName> program parameters

The Validate <ObjectName> program runs with the following parameters:

Parameter name

Prompt

Value set name

Default

PL/SQL Package Design

Filename

specification
Body

Directory

$HW_TOP/SQL/

Package name

XXCS_PP_OBJECT_NAME

Conc. program

XXCS_PP_Validate<ObjectName>

18

Required

Procedures

Validate_<ObjectName>

Functions

Global constants and variables.

These constants are global only to the package. Meaning, they should be defined in the package body.

Procedure Validate_<ObjectName>
PROCEDURE HW_VALIDATE
IS
CURSOR C1 IS SELECT * FROM GL_TEMP_INTERFACE;
ID NUMBER;
BEGIN
ID := FND_GLOBAL.USER_ID;
FOR V1 IN C1
LOOP
If (entered_dr != accounted_dr) then
accounted_dr:= entered_dr;
If (entered_cr!=accounted_cr) then
Accounted_cr:=entered_cr;
INSERT INTO GL_INTERFACE(
STATUS,
SET_OF_BOOKS_ID,
ACCOUNTING_DATE,
19

CURRENCY_CODE,
DATE_CREATED,
CREATED_BY,
ACTUAL_FLAG,
USER_JE_CATEGORY_NAME,
USER_JE_SOURCE_NAME,
SEGMENT1,
SEGMENT2,
SEGMENT3,
SEGMENT4,
SEGMENT5,
ENTERED_DR,
ENTERED_CR,
ACCOUNTED_DR,
ACCOUNTED_CR,
TRANSACTION_DATE,
GROUP_ID
)
VALUES
(
V1.STATUS,
V1.SET_OF_BOOKS_ID,
20

'01-JAN-2001',
'USD',
SYSDATE,
ID,
V1.ACTUAL_FLAG,
'EXAMPLE_CATEGORY',
'EXAMPLE_SOURCE',
V1.SEGMENT1,
V1.SEGMENT2,
V1.SEGMENT3,
V1.SEGMENT4,
V1.SEGMENT5
V1.ENTERED_DR,
V1.ENTERED_CR,
V1.ACCOUNTED_DR,
V1.ACCOUNTED_CR,
V1.TRANSACTION_DATE,
V1.GROUP_ID
);
/*DBMS_OUTPUT.PUT_LINE(V1.SET_OF_BOOKS_ID);*/
END LOOP;
END;
21

END Validate_<ObjectName>;

22

Open/Closed Issues
Open issues

Num

Issue description

Resolution

Owner

Resolution

Owner

Closed issues

Num

Issue description

23