MD.060 - T S: Mofa Detailed Design Document

MD.
060 - TECHNICAL SPECIFICATION

MOFA
Detailed Design Document
Prepayment Process Document
Author : Rajeswari. Gadam (MSAT)
Created on : 28 FEB, 2013
Last Updated : 23-Oct-20
Document Name : GEFA_APL_MD060_Property_Tax_Report.doc
Reference : GEFA_APL_MD020_Property_Tax_Report.doc
JIRA Ref# : PFA-6
Version : 1.1
Approvals:
Project Manager <Name>
Project Leader Saurabh Kumar (303012324)
Architect Ramakrishna Kotagiri (103021306)
Copyright General Electric Corporation. All Rights Reserved
1 GE Internal
File Ref: GEFA_APL_MD060_Property_Tax_Report_PFA-6.doc
-1-
Sensitivity: Internal & Restricted
2 GE Internal 2

Document Control
Change Record
1
Date Author Version Change Reference
28-Feb-2013 Rajeswari. Gadam Draft Initial Document
30-Apr-2013 Rajeswari. Gadam 1.0 Updated for unit test cases
28-Aug-2013 Rajeswari. Gadam 1.0 Updated for CM010
31-Oct-2013 Venu Mada 1.1 Added CR060 for JIRA#PFA-781
07-Mar-2014 Swamy Yadav 1.2 JIRA#PFA-876 :

GEFA_APL_CR060_GEFA_Property_Tax_REPORT_V1
.1
Reviewers
Name Position
Distribution
Copy No. Name Location
1 GEFA_APL_MD020_Property_Tax_Report.doc http://libraries.ge.com/download?
fileid=346286537101&entity_id=29
900677101&sid=101
2
3 GE Internal 2

Copy No. Name Location
Note To Holders:
Highlighted guidelines are to be preserved and not to be deleted while updating the document.
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.
4 GE Internal 2

Contents
Document Control..............................................................................................................................2
Change Record............................................................................................................................2
Reviewers....................................................................................................................................2
Distribution.................................................................................................................................2
Functional Description.......................................................................................................................4
Business Purpose / Requirement.................................................................................................4
Proposed functional solution.......................................................................................................4
Technical flow chart (To-Be).............................................................................................................5

Technical Environment......................................................................................................................6
Technical Design................................................................................................................................7
Design Steps................................................................................................................................7
Pseudo Code................................................................................................................................7
Layout.........................................................................................................................................7
Assumptions................................................................................................................................7
Prerequisites................................................................................................................................7
Incompatibilities..........................................................................................................................7
Applicability................................................................................................................................7
Performance Considerations.......................................................................................................7
Data Base Objects Design - Database objects creation, usage...........................................................8

Application Objects Design - Value Set/Lookup, Form Definition, Concurrent Program Definition, Menu
............................................................................................................................................................9
Unit Test Cases & Integration Test Cases........................................................................................10
5 GE Internal 2

Installation and setup........................................................................................................................11
Code Reusability Details..................................................................................................................12
Open and Closed Issues....................................................................................................................13
Open Issues...............................................................................................................................13
Closed Issues.............................................................................................................................13
Notes:........................................................................................................................................13
Appendix..........................................................................................................................................14
6 GE Internal 2

Functional Description
Business Purpose / Requirement
As part of the Oracle R12 Fixed Assets implementation project for the GE Appliances, Fixed Assets Accounting
will be required to provide a report containing the GE Appliances Fixed assets records by location to the Tax
Authorities on an Monthly basis. The taxes are calculated and levied by the Tax Authorities based on this
information
MD020 File Name: GEFA_APL_MD020_Property_Tax_Report.doc
JIRA #: PFA-6
JIRA Link: https://devcloud.swcoe.ge.com/tracker/browse/PFA-6
MD020 Cure link: http://libraries.ge.com/download?fileid=346286537101&entity_id=29900677101&sid=101
Proposed functional solution

Existing Process
This program is already developed in existing Oracle 11i system.

The purpose of this document is to modify the existing report to meet the Oracle R12 requirements. This
document describes the File format, required and optional data fields mapping, as well as the submission timing.
Future process / Proposed Solution

1. Create 2 concurrent programs with same name as in existing 11i System. Create a request set ‘GEFA – E-properties
Extract Generation and mailing Notification’ and assign both these programs to the request set
2. The above Programs are already existing in Oracle 11i and needs to be modified to make it compatible to run in
Oracle R12
Existing Program names in 11i
7 GE Internal 2

Request Set: GEFA - E-Properties Extract Generation and Mailing Notification Request Set
Request1: GEFA - E-Properties Reporting Extract
Request 2: GEFA - E-Properties Mailing Program
3. The first concurrent program ‘GEFA - E-Properties Reporting Extract ‘ should generate an output file in
Text/delimited format with the following information
 Company Code/LEID (see appendix for example)

 DDA Code (see appendix for example and mapping)
 GEIS Code
 Location - Country Code
 Location –State Code
 Location- City
 Location- Street Address
 Location- ZIP Code
 Asset Category –Major
 Asset category –Minor
 Business- Cost Center
 Activity Code
 Date Placed in Service
8 GE Internal 2

 Asset Number
 Asset Description
 Retirement Status
 Retirement date
 Original Asset Cost
 Current year Reserve
 Prior Year Reserve
 NBV (Net Book Value)
The output file should be grouped by each location (State)

The file would be placed in the path '/erg2dapp/common/ERPG2D/edi/outbound';
The parameters for this program would be the following:

1. Entity Name
2. Period
Both would be mandatory parameters
Following is the output /Data file of the above program in 11i
GEFA___E_Propertie Property Tax Report

s_Reporting__150113.txt _output format.xlsx
4. The second concurrent program ‘GEFA - E-Properties Mailing Program’ will send a mail to Support user id as
specified in the report parameter. Any error messages would be sent to Error user_id as specified in the Report
parameter
A sample of the mail message is as under:
9 GE Internal 2

Data Validation Rules
The output data file would be validated with the following rules:
1. Date of Acquisition of Asset:

The date of Acquisition of Asset should on or before System Date
2. Net Book Value (NBV):

The Net Book Value of the Asset should not be more than the Original Asset Cost
3. Asset Number:
All Asset numbers in the file must be unique. There should be no duplication of Asset Numbers
4. First Cost:
The First cost total should match with the balances in the corresponding GL Accounts
10 GE Internal 2

11 GE Internal 2

Technical flow chart (To-Be)
Start
Concurrent Program “GEFA Property Tax Report – APL” is created to

generate Property_tax_Report.xsl report output file in $APPLPTMP/outbound
directory.
Program “GEFA Property Tax Report – APL” is based on procedure

“GEFA_APL_PROPERTY_TAX_REP_PRC” which retrieves all eligible records and write into a
file, which will be FTP to the remote server and email the report output to the email id passed in the
program parameter.
Archive the output file to $APPLPTMP/archive directory and send email notification to the
mail id passed as a program parameter with number of records ftp’ed to the remote server.
12 GE Internal 2

Submit the Request “ GEFA Property Tax Report – APL”
Verify RequestInternal
Sensitivity: Completion Status
& Restricted
No
Technical Environment
RDBMS : 11.2.0.3.0
Oracle Applications : 12.1.3
13 GE Internal 2

Technical Design
Design Steps
Design Steps
1. Concurrent program “GEFA Property Tax Report - APL” is created with executable file name “
GEFA_APL_PROPERTY_TAX ” based on pl/sql stored procedure “GEFA_APL_PROPERTY_TAX_REP_PRC”
to create Property_tax_Report.xsl file in $APPLPTMP/outbound directory.
The program has following parameters
Period
Entity
To email Id
Support Mail ID
Remote Server name
FTP User ID
FTP Password
Remote Server Path
File name
2. Procedure GEFA_APL_PROPERTY_TAX_REP_PRC is created.

3. Add the request to request group.
Error Handling Steps
1. Concurrent Program might fail at the time of execution of the Report when there is a mismatch of the data type
between the Value and the Variable.
2. All the Exceptions should be written to log file with detailed user friendly error messages.
3. When the Program Errors out User looks for error messages.
4. Based on the error message User will take corrective action and resubmit the Program.
5. IF the program completes in Error then email would be sent to the support user
Pseudo Code
1. Create a Procedure GEFA_APL_PROPERTY_TAX_REP_PRC with Out Parameters
p_errbuf ,p_retcode and In Parameters p_period, p_entity, p_email_id , p_support_user_mail p_remote_server_name,
p_ftp_user_id , p_ftp_password , p_remote_server_path, p_file_name
2. Using UTL_FILE write the query data to Property_tax_Report.xsl file in $APPLPTMP/outbound directory.
query.txt
3. Query :
14 GE Internal 2

4. Concurrent program “GEFA Property Tax Report - APL” is created with executable file name “
GEFA_APL_PROPERTY_TAX” based on pl/sql stored procedure “GEFA_APL_PROPERTY_TAX_REP_PRC” to generate an
output file “Property_tax_Report.xsl” in $APPLPTMP/outbound directory. The program has following parameters
Period
Entity
To email Id
Support Mail ID
Remote Server name
FTP User ID
FTP Password
Remote Server Path
File name
5. Upon successful creation of file FTP the file to remote server .
6. After successful FTP send email notification to Email id passed in program parameter with number of records ftp’ed.
7. Send the report output to the To email id passed in the program parameter.
8. If any error in the program notify to the support team.
9. Archive the file “Property_tax_Report.xls” to $APPLPTMP/archive directory.
10. Attach the Request to Request Group.
Layout
Property_tax_Repor
t.xls
Layout attached below
Assumptions
None
Prerequisites
None
Incompatibilities
Program is incompatible to itself
Scheduling
Program will be run manually by the users during month end closing process.
15 GE Internal 2

Performance Considerations
158000 Records per LE
Monthly once during closing process
Explain Plan
Property_tax explain
plan.xlsx
Query
Query-Property_tax.
txt
16 GE Internal 2

Database objects creation/usage
Procedure : GEFA_APL_PROPERTY_TAX_REP_PRC.sql
Table or View Name Used in this Select Insert Update Delete Source / Target
Solution
fa_additions X
fa_asset_keywords X
fa_distribution_history X
fa_locations X
fa_categories_b X
gl_code_combinations X
fa_books X
fa_books_summary X
fa_deprn_summary X
fa_deprn_periods X
fa_retirements X
xxcp_gateway_process_history_v X
xxcp_gl_interface X
xxcp_gateway_trans_rules_v xxcp X
xxcp_instance_coa_seg_vals_v X
xxcp_gateway_custom_data_v
17 GE Internal 2

Application Objects Design - Value Set/Lookup, Form Definition, Concurrent Program
Definition, Menu
Concurrent Program Executable
Executable GEFA_APL_PROPERTY_TAX
Short Name GEFA_APL_PROPERTY_TAX
Application GE Assets
Description Property Tax report
Execution Method PL/SQL Stored Procedure
Execution File Name GEFA_APL_PROPERTY_TAX_REP_PRC
Concurrent Program
Program GEFA Property Tax Report - APL
Short Name GEFA_APL_PROPERTY_TAX
Application GE Asset s
Description Property Tax Report
Executable GEFA_APL_PROPERTY_TAX
Output Text
Request
Parameters
Seq. Parameter Validation Req Display Default Value

uire
(value set)
d
10 p_period 30 Characters Y Y
20 p_entity GEFA_APL_Leg Y Y
al_Entity_VS
30 p_emailid 240 Characters Y Y
40 p_support_user_mail 240Characters Y Y
50 p_remote_server_name 100 Characters Y Y
18 GE Internal 2

60 p_ftp_user_id 30 Characters Y Y
70 p_ftp_password 30 Characters Y Y
80 p_remote_server_path 100 Characters Y Y
90 p_file_name 30 Characters Y Y
Incompatibilities
GEFA Property Tax Report - APL
19 GE Internal 2

Unit Test Cases & Integration Test Cases
Property_Tax_Repor
t_Test Case Approval_081213 (2).xlsx
Sign off mail
FWREQUEST CODE
REVIEW PFA-6.msg
CM010
GEFA_APL_CM010_P
roperty_Tax_Report_PFA-6.doc
20 GE Internal 2

Installation and setup
1. Create Procedure using the script
GEFA_APL_PROPERTY_TAX_REP_PRC.sql
2. Migrate the concurrent program “GEFA Property Tax Report - APL”
3. Attach Request “GEFA Property Tax Report - APL “ to the request group
Queries
query.txt
21 GE Internal 2

Code Reusability Details
Concurrent Programs:
1. GEFND Generic FTP Program
2. GEFND Generic Email Program with Attachment
3. GEFND Generic Archive Program – APL
Procedure
4. ge_generic_email_prc
List of CEMLI’s Introduced/Modified

 Procedure :
Path: $GEFA_TOP/install/sql/
File Name: GEFA_APL_PROPERTY_TAX_REP_PRC.sql (I-3)
• Concurrent Program Name: GEFA Property Tax Report - APL (C-1)

 Value Set: GEFA_APL_DDA_CODE_VS Value set [C-1]
CEMLI Score
-GECSE_FAFA_OAT.xlsx
22 GE Internal 2

Open and Closed Issues
Open Issues
ID Issue Resolution Responsibility Target Date Impact

Date
Closed Issues
ID Issue Resolution Responsibility Target Date Impact

Date
Notes:
23 GE Internal 2

Appendix
< Attach CR060 for any changes to the PRODUCTION objects and screen shots if any >
Ver 1.1 for JIRA#PFA-781
GEFA_APL_CR060_F
A_PROP_TAX.docx
Ver 1.2 for JIRA#PFA-876

CR060 Cure link
http://libraries.ge.com/download?fileid=495479970101&entity_id=31279680101&sid=101
24 GE Internal 2

MD.060 - T S: Mofa Detailed Design Document

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

MD.060 - T S: Mofa Detailed Design Document

Uploaded by

Copyright:

Available Formats

MD.

060 - TECHNICAL SPECIFICATION

Author : Rajeswari. Gadam (MSAT)

Created on : 28 FEB, 2013

Last Updated : 23-Oct-20

Document Name : GEFA_APL_MD060_Property_Tax_Report.doc

JIRA Ref# : PFA-6

Project Manager <Name>

Project Leader Saurabh Kumar (303012324)

Architect Ramakrishna Kotagiri (103021306)

Copyright General Electric Corporation. All Rights Reserved

File Ref: GEFA_APL_MD060_Property_Tax_Report_PFA-6.doc

File Ref: GEFA_APL_MD060_Property_Tax_Report_PFA-6.doc

Sensitivity: Internal & Restricted

Date Author Version Change Reference

28-Feb-2013 Rajeswari. Gadam Draft Initial Document

30-Apr-2013 Rajeswari. Gadam 1.0 Updated for unit test cases

28-Aug-2013 Rajeswari. Gadam 1.0 Updated for CM010

31-Oct-2013 Venu Mada 1.1 Added CR060 for JIRA#PFA-781

07-Mar-2014 Swamy Yadav 1.2 JIRA#PFA-876 :

Copy No. Name Location

File Ref: GEFA_APL_MD060_Property_Tax_Report_PFA-6.doc

Sensitivity: Internal & Restricted

File Ref: GEFA_APL_MD060_Property_Tax_Report_PFA-6.doc

Sensitivity: Internal & Restricted

Proposed functional solution.......................................................................................................4

Technical flow chart (To-Be).............................................................................................................5

Data Base Objects Design - Database objects creation, usage...........................................................8

File Ref: GEFA_APL_MD060_Property_Tax_Report_PFA-6.doc

Sensitivity: Internal & Restricted

File Ref: GEFA_APL_MD060_Property_Tax_Report_PFA-6.doc

Sensitivity: Internal & Restricted

MD020 File Name: GEFA_APL_MD020_Property_Tax_Report.doc

JIRA Link: https://devcloud.swcoe.ge.com/tracker/browse/PFA-6

MD020 Cure link: http://libraries.ge.com/download?fileid=346286537101&entity_id=29900677101&sid=101

Proposed functional solution

This program is already developed in existing Oracle 11i system.

Future process / Proposed Solution

Existing Program names in 11i

File Ref: GEFA_APL_MD060_Property_Tax_Report_PFA-6.doc

Sensitivity: Internal & Restricted

Request1: GEFA - E-Properties Reporting Extract

Request 2: GEFA - E-Properties Mailing Program

 Company Code/LEID (see appendix for example)

File Ref: GEFA_APL_MD060_Property_Tax_Report_PFA-6.doc

Sensitivity: Internal & Restricted

The output file should be grouped by each location (State)

The parameters for this program would be the following:

Both would be mandatory parameters

Following is the output /Data file of the above program in 11i

GEFA___E_Propertie Property Tax Report

A sample of the mail message is as under:

File Ref: GEFA_APL_MD060_Property_Tax_Report_PFA-6.doc

Sensitivity: Internal & Restricted

1. Date of Acquisition of Asset:

2. Net Book Value (NBV):

File Ref: GEFA_APL_MD060_Property_Tax_Report_PFA-6.doc

Sensitivity: Internal & Restricted

File Ref: GEFA_APL_MD060_Property_Tax_Report_PFA-6.doc

Sensitivity: Internal & Restricted

Concurrent Program “GEFA Property Tax Report – APL” is created to

Program “GEFA Property Tax Report – APL” is based on procedure

File Ref: GEFA_APL_MD060_Property_Tax_Report_PFA-6.doc