FS030 Functional Specifications

GL Conversions

Author:

M.Anil Pullam RajuCreation Date:

Last Updated:

Last Updated By:M.Anil Pullam RajuVersion:

DRAFT 1A

Approvals

NameTitleDate

Contents

1Approvals

Overview4Assumptions5Import steps5High level program information6Load program6Validate program7Import program components8Concurrent programs8PL/SQL packages8Loader scripts8Profile options8Indexes9Load Program10Import file format10Data mapping11Loadt program parameters13Special logic13Validate Program14Defaults14Conversions15Validations17Other logic17Validate program parameters17PL/SQL Package Design18Global constants and variables.18Procedure Validate_18Open/Closed Issues22Open issues22Closed issues22

Overview

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

The 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_INTERFACEThe 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 program information:

Load program

PropertyValue

NameHW_STAGLOAD.CTL

Concurrent program nameHW_LOADCON.PROG

Import file format TEXT

Incompatibility

Replace or AppendReplace

Initial record status

Full import file nameHW_DATA.TXT

Restart restrictions If Yes, Explain

Validate program

PropertyValue

NameHW_VALIDATE.SQL

Concurrent program nameHW_VALIDCON

Incompatibility

Processing modeAll

Pre-requisitesHW_LOADCON must run before it.

Restart restrictionsNone

Import program components

The following list contains all components required to completely install the Import 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 Program

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

HW_TEMP_GL_INTERFACE

Import file format

The import file is and has the following format:

Column nameSpecial Format (date format, decimal points)Position/Max Length

STATUSVARCHAR2(50)

SET_OF_BOOKS_IDNUMBER(15)

ACCOUNTING_DATEDD-MON-YYYYDATE

CURRENCY_CODEVARCHAR2(15)

DATE_CREATEDDD-MON-YYYYDATE

CREATED_BYNUMBER(15)

ACTUAL_FLAGVARCHAR2(1)

USER_JE_CATEGORY_NAMEVARCHAR2(25)

USER_JE_SOURCE_NAMEVARCHAR2(25)

SEGMENT1VARCHAR2(25)

SEGMENT2VARCHAR2(25)

SEGMENT3VARCHAR2(25)

SEGMENT4VARCHAR2(25)

SEGMENT5VARCHAR2(25)

ENTERED_DRNUMBER

ENTERED_CRNUMBER

ACCOUNTED_DRNUMBER

ACCOUNTED_CRNUMBER

TRANSACTION_DATEDD-MON-YYYYDATE

GROUP_IDNUMBER (15)

Data mapping

Oracle table nameOracle column nameExtract column nameTransformation logic

HW_TEMP_GL_INTERFACESTATUSSTATUS

HW_TEMP_GL_INTERFACESET_OF_BOOKS_IDSET_OF_BOOKS_ID

HW_TEMP_GL_INTERFACEACCOUNTING_DATEACCOUNTING_DATE

HW_TEMP_GL_INTERFACECURRENCY_CODECURRENCY_CODE

HW_TEMP_GL_INTERFACEDATE_CREATEDDATE_CREATED

HW_TEMP_GL_INTERFACECREATED_BYCREATED_BY

HW_TEMP_GL_INTERFACEACTUAL_FLAGACTUAL_FLAG

HW_TEMP_GL_INTERFACEUSER_JE_CATEGORY_NAMEUSER_JE_CATEGORY_NAME

HW_TEMP_GL_INTERFACEUSER_JE_SOURCE_NAMEUSER_JE_SOURCE_NAME

HW_TEMP_GL_INTERFACESEGMENT1SEGMENT1

HW_TEMP_GL_INTERFACESEGMENT2SEGMENT2

HW_TEMP_GL_INTERFACESEGMENT3SEGMENT3

HW_TEMP_GL_INTERFACESEGMENT4SEGMENT4

HW_TEMP_GL_INTERFACESEGMENT5SEGMENT3

HW_TEMP_GL_INTERFACEENTERED_DRENTERED_DR

HW_TEMP_GL_INTERFACEENTERED_CRENTERED_CR

HW_TEMP_GL_INTERFACEACCOUNTED_DRACCOUNTED_DR

HW_TEMP_GL_INTERFACEACCOUNTED_CRACCOUNTED_CR

HW_TEMP_GL_INTERFACETRANSACTION_DATETRANSACTION_DATE

HW_TEMP_GL_INTERFACEGROUP_IDGROUP_ID

Loadt program parameters

The Load program has one parameters:

Parameter namePromptValue set nameDefaultRequired

Special logic

Validate 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_INTERFACESET_OF_BOOKS_ID1

GL_INTERFACEACCOUNTING_DATESYSDATE

GL_INTERFACEDATE_CREATEDSYSDATE

GL_INTERFACETRANSACTION_DATESYSDATE

Conversions

Source table and column names Target table and column namesConversion logic

HW_TEMP_GL_INTERFACE.STATUS GL_INTERFACE.STATUSHW_TEMP_GL_INTERFACE.STATUS = GL_INTERFACE.STATUS

HW_TEMP_GL_INTERFACE.SET_OF_BOOKS_ID GL_INTERFACE.SET_OF_BOOKS_IDHW_TEMP_GL_INTERFACE.SET_OF_BOOKS_ID= GL_INTERFACE.SET_OF_BOOKS_ID

HW_TEMP_GL_INTERFACE. ACCOUNTING_DATE GL_INTERFACE. ACCOUNTING_DATEHW_TEMP_GL_INTERFACE. ACCOUNTING_DATE= GL_INTERFACE. ACCOUNTING_DATE

HW_TEMP_GL_INTERFACE .CURRENCY_CODE GL_INTERFACE .CURRENCY_CODEHW_TEMP_GL_INTERFACE .CURRENCY_CODE= GL_INTERFACE .CURRENCY_CODE

HW_TEMP_GL_INTERFACE.DATE_CREATEDGL_INTERFACE.DATE_CREATEDHW_TEMP_GL_INTERFACE.DATE_CREATED= GL_INTERFACE.DATE_CREATED

HW_TEMP_GL_INTERFACE.CREATED_BYHW_INTERFACE.CREATED_BYHW_TEMP_GL_INTERFACE.CREATED_BY= GL_INTERFACE.CREATED_BY

HW_TEMP_GL_INTERFACE.ACTUAL_FLAGGL_INTERFACE.ACTUAL_FLAGHW_TEMP_GL_INTERFACE.ACTUAL_FLAG= GL_INTERFACE.ACTUAL_FLAG

HW_TEMP_GL_INTERFACE.USER_JE_CATEGORY_NAME GL_INTERFACE.USER_JE_CATEGORY_NAMEHW_TEMP_GL_INTERFACE.USER_JE_CATEGORY_NAME= GL_INTERFACE.USER_JE_CATEGORY_NAME

HW_TEMP_GL_INTERFACE.USER_JE_SOURCE_NAMEGL_INTERFACE.USER_JE_SOURCE_NAMEHW_TEMP_GL_INTERFACE.USER_JE_SOURCE_NAME=GL_INTERFACE.USER_JE_SOURCE_NAME

HW_TEMP_GL_INTERFACE.SEGMENT1GL_INTERFACE.SEGMENT1HW_TEMP_GL_INTERFACE.SEGMENT1= GL_INTERFACE.SEGMENT1

HW_TEMP_GL_INTERFACE.SEGMENT2GL_INTERFACE.SEGMENT2HW_TEMP_GL_INTERFACE.SEGMENT2= GL_INTERFACE.SEGMENT2

HW_TEMP_GL_INTERFACE.SEGMENT3GL_INTERFACE.SEGMENT3HW_TEMP_GL_INTERFACE.SEGMENT3= GL_INTERFACE.SEGMENT3

HW_TEMP_GL_INTERFACE.ENTERED_DRGL_INTERFACE.ENTERED_DRHW_TEMP_GL_INTERFACE.ENTERED_DR= GL_INTERFACE.ENTERED_DR

HW_TEMP_GL_INTERFACE.ENTERED_CRGL_INTERFACE.ENTERED_CRHW_TEMP_GL_INTERFACE.ENTERED_CR= GL_INTERFACE.ENTERED_CR

HW_TEMP_GL_INTERFACE.ACCOUNTED_DRGL_INTERFACE.ACCOUNTED_DRHW_TEMP_GL_INTERFACE.ACCOUNTED_DR= GL_INTERFACE.ACCOUNTED_DR

HW_TEMP_GL_INTERFACE.ACCOUNTED_CRGL_INTERFACE.ACCOUNTED_CRHW_TEMP_GL_INTERFACE.ACCOUNTED_CR= GL_INTERFACE.ACCOUNTED_CR

HW_TEMP_GL_INTERFACE.TRANSACTION_DATEGL_INTERFACE.TRANSACTION_DATEHW_TEMP_GL_INTERFACE.TRANSACTION_DATE=GL_INTERFACE.TRANSACTION_DATE

HW_TEMP_GL_INTERFACE.GROUP_IDGL_INTERFACE.GROUP_IDHW_TEMP_GL_INTERFACE.GROUP_ID

Validations

Table name Column nameValidation logic

GL_INTERFACEENTERED_DRENTERED_DR =ACCOUNTED.DR

GL_INTERFACEENTERED_CRENTERED_CR=ACCOUNTED.CR

Other logic

Validate program parameters

The Validate program runs with the following parameters:

Parameter namePromptValue set nameDefaultRequired

PL/SQL Package Design

Filenamespecification

Body

Directory

$HW_TOP/SQL/

Package name

XXCS_PP_OBJECT_NAME

Conc. program

XXCS_PP_ValidateProcedures

Validate_

Functions

Global constants and variables.

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

Procedure Validate_

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,

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,

'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;

END Validate_;Open/Closed Issues

Open issues

NumIssue descriptionResolutionOwner

Closed issues

NumIssue descriptionResolutionOwner

123