AIM
MD.070 APPLICATION
EXTENSION TECHNICAL DESIGN
Royal Guard of Oman
Item Codification Utility
Author: Sultan Mohammed
Creation Date: 03-Mar- 2015
Last Updated: 03-Mar- 2015
Document Ref: 1.0
Version: DRAFT
Approvals:
Mr. Salah A. Al Za’ abi Project Manager – RGO
Mr. Rajendra Sharma Signing Authority - RGO
Mr. Said Hamad Al Malki Signing Authority - RGO
Mr. Pramesh Kumar Srinivasan Project Manager – BCT
Document Control
Change Record
Date Author Version Change Reference
1.0
Reviewers
Name Position
Mr Pramesh Kumar Project Manager
Distribution
Copy No. Name Location
1
2
3
4
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.
2
Contents
Technical Overview.......................................................................................................................................................... 5
Approach........................................................................................................................... 5
Custom Module List......................................................................................................... 5
OAF Pages ..........................................................................................................................5
AME ...................................................................................................5
Database Objects .........................................................................................................6
Extension Logic........................................................................................................................ 8
VO Extension Logic........................................................................................................... 8
Calling Arguments.......................................................................................................... 08
Concurrent Program Registration..................................................................................08
Data Definition Registration........................................................................................... 09
Data Template.........................................................................................................................09
Template Registration..................................................................................................... 09
Table and View Usage.................................................................................................... 09
Incompatibility................................................................................................................. 09
Performance Considerations..........................................................................................09
Other Considerations...................................................................................................... 10
Restart Strategy.......................................................................................................................10
Crash Recovery.......................................................................................................................10
Integration Issues................................................................................................................... 10
Changes Required........................................................................................................... 10
Within Product........................................................................................................................10
Other Products........................................................................................................................10
Shared Components........................................................................................................ 11
INV........................................................................................................................................... 11
BOM......................................................................................................................................... 11
ENG......................................................................................................................................... 11
MPS/MRP...............................................................................................................................11
WIP.......................................................................................................................................... 11
Alert conditions............................................................................................................... 11
Incompatibilities.............................................................................................................. 11
Performance Issues.......................................................................................................... 11
Database Design..................................................................................................................... 11
Desired Table Changes – N/A.......................................................................................11
New/Updated Seed Data...............................................................................................11
Descriptive Flex fields..................................................................................................... 11
Value Sets......................................................................................................................... 11
Grants/Synonyms........................................................................................................... 12
Archiving......................................................................................................................... 12
Database Diagram........................................................................................................... 12
Tables, Indexes, Sequences............................................................................................. 12
Installation Requirements...................................................................................................... 13
3
Implementation Notes........................................................................................................... 14
Design Summary............................................................................................................. 14
Functional Design...................................................................................................................14
Functional Design Approval..................................................................................................14
Technical Design.....................................................................................................................14
Design Review.........................................................................................................................14
Final Acceptance.....................................................................................................................15
Coding Summary............................................................................................................ 15
Program Files..........................................................................................................................15
Testing Summary............................................................................................................ 15
Installation....................................................................................................................... 15
Open and Closed Issues for this Deliverable.......................................................................15
Open Issues...................................................................................................................... 15
Closed Issues................................................................................................................... 15
4
Technical Overview
This document defines the technical components required to design and develop the
Item Codification Utility.
Approach
All the Items in RGO were classified as into 5 Segments, which include Class,
Segment1, Segment2, Segment3 and Segment4. Based on the combination of these 5
segments a unique code will be generated. This utility will generate the unique code
based on the 3 Different OAF pages.
Custom Module List
OAF Pages
Item Codification Utility includes the following forms and they address the
requirements referred to carried forward from BR 30 and Reference no from
MD050:
Form Name Description Process ID # from BR
030/Ref # from MD050
Item Classification Page This page is used to create -
new Classes and also to
query the current classes
Item Segments Page This page is used to create
new Segment values for
the Classes created and
also current classes
Item Creation/Update This page is used to create
Page the Item based on the
classes and segments and
assign templates, uom,
category, description and
Organization.
5
AME N/A
Item Codification Utility includes the following AME and they address the
requirements referred to by Process ID# carried forward from BR 30 and Reference
no from MD050:
AME Name Description Process ID # from BR
030/Ref # from MD050
Item Creation Approval This AME is used to send
the Approval to a person
defined in the list.
Workflow N/A
Item Codification Utility includes the following programs and they address the
requirements referred to by Process ID# carried forward from BR 30 and Reference
no from MD050::
Workflow Name Description Process ID # from BR
030/Ref # from MD050
Item Creation Approval This workflow will direct
Workflow the approval to the person
defined in the AME and
once approved will call the
related code and create the
Item with the details
mentioned.
Database objects N/A
Item Codification Utility includes the following reports and they address the
requirements referred to by Process ID# carried forward from BR 30 and Reference
no from MD050::
Trigger Name Description Process ID # from BR
030/Ref # from
6
MD050
XXRGO_ITEMCOD_CLASSIFY This table stores the
Class codes
XXRGO_ITEMCOD_SEG1_V This table stores the
Segment1 codes and
values
XXRGO_ITEMCOD_SEG2_V This table stores the
Segment2 codes and
values
XXRGO_ITEMCOD_SEG3_V This table stores the
Segment3 codes and
values
XXRGO_ITEMCOD_SEG4_V This table stores the
Segment4 codes and
values
XXRGO_CREATE_ITEM_CODIF This table stores the
Item codes and related
information
XXRGO_CREATE_ITEM_ID_S Item Id Sequence
XXRGO_CREATE_ITEM This Package is used to
create the Item.
XXRGO_ITEM_CREATION_WF This package is used to
Call the workflow and
on Approval will call
the appropriate
package.
Extended VO List
Extension Logic
Navigation Logic
N/A
Block Relationship Diagram
N/A
7
Table and View Usage
Table Name Select Insert Update Delete
X
XXRGO_ITEMCOD_CLASSIFY Yes Yes Yes Yes
XXRGO_ITEMCOD_SEG1_V Yes Yes Yes Yes
XXRGO_ITEMCOD_SEG2_V Yes Yes Yes Yes
XXRGO_ITEMCOD_SEG3_V Yes Yes Yes Yes
XXRGO_ITEMCOD_SEG4_V Yes Yes Yes Yes
XXRGO_CREATE_ITEM_CODIF Yes Yes Yes Yes
Zone and Field Summary
N/A
Special Logic
N/A
8
Concurrent Program Logic
N/A
Calling Arguments
N/A
Concurrent Program Registration
N/A
Data Definition Registration
N/A
Template Registration
N/A
Table and View Usage
1) N/A
Incompatibility
N/A
Performance Considerations
N/A
Other Considerations
Restart Strategy
N/A
9
Integration Issues
Changes Required
Within Product
No changes required
Other Products
No changes required
Shared Components
INV
None
BOM
None
ENG
None
MPS/MRP
None
WIP
None
Alert conditions
None.
Incompatibilities
None.
10
Database Design
Desired Table Changes – N/A
New/Updated Seed Data
Rows added to <App Prefix>_LOOKUPS:
Code Meaning
Lookup Type
Descriptive Flex fields
Application:
Form Name:
Base Table:
Segment Name Prompt Size Value Set Default Value
Application:
Form Name:
Base Table:
Segment Name Prompt Size Value Set Default Value
Value SetsN/ANNN
N/A
Grants/Synonyms
Owner Object Grantees
N/A N/A N/A
11
Archiving
No need to archive.
Database Diagram
Tables, Indexes, Sequences
1) XXRGO_ITEMCOD_CLASSIFY - Table
2) XXRGO_ITEMCOD_SEG1_V - Table
3) XXRGO_ITEMCOD_SEG2_V - Table
4) XXRGO_ITEMCOD_SEG3_V - Table
5) XXRGO_ITEMCOD_SEG4_V - Table
6) XXRGO_CREATE_ITEM_CODIF – Table
7) XXRGO_CREATE_ITEM_ID_S - Sequence
12
Installation Requirements
Installation scripts must be prepared to perform the following actions in an
automated way:
1. All the OAF Pages, Java Files and Class Files need to be moved into Server
and run the import Scripts.
2. Bounce the apache server.
3. Clear the cache from Functional Administrator.
4. Create all the tables in the respective schemas.
.
13
Implementation Notes
This document describes exactly how Item Codification Utility was developed.
Design Summary
Functional Design
All the Items in RGO were classified into 5 Segments which include Class,
Segment1, Segment2, Segment3 and Segment4.
Based on the class the Segment description and values change.
For creating and querying the Classes a screen need to be developed and all the
classes will be unique.
Once the Class is created, Segment values need to be assigned to the Classes.
Once these segment values are provided then we can create an Item based on the
combination of all the Class and Segments.
In the process of creation of an Item, we can give the Category, Sub-Category, Min
Value, Max Value, Item Template, UOM, Item Description and Long Description,
other attributes of an item, Encumbrance account and Expense Account, List Price
and assign the Item to any of the Inventory Organization
Once all the above values are given the user can send the Item creation for Approval
to the assigned supervisor and once the supervisor reviews and Approves the Item
will be created in the Item Master.
If the supervisor rejects the Item creation then he need to create again with the
correct values.
Functional Design Approval
Technical Design
1) The Primary Key in XXRGO_CREATE_ITEM_CODIF is Item_id and it is a
sequence.
2) The Item_code column in the XXRGO_CREATE_ITEM_CODIF will be
combination of 5 Segments- Class_code from XXRGO_ITEMCOD_CLASSIFY,
Segment1_code from XXRGO_ITEMCOD_SEG1_V, Segment2_code from
XXRGO_ITEMCOD_SEG2_V, Segment3_code from
XXRGO_ITEMCOD_SEG3_V, and Segment4_code from
XXRGO_ITEMCOD_SEG4_V
14
3) The Primary key in XXRGO_ITEMCOD_CLASSIFY is CLASS_CODE and this
code will be the max+1 code of the previous CLASS_CODE
4) The Primary key in XXRGO_ITEMCOD_SEG1 is SEGMENT1_CODE
5) The Primary key in XXRGO_ITEMCOD_SEG2 is SEGMENT2_CODE
6) The Primary key in XXRGO_ITEMCOD_SEG3 is SEGMENT3_CODE
7) The Primary key in XXRGO_ITEMCOD_SEG4 is SEGMENT4_CODE
Design Review
Final Acceptance
Coding Summary
Development was done on <description of hardware>, to work with Release R12 of
Oracle Applications. All coding follows the standards defined in the Build
Standards document for RGO
Program Files
The files required for this customization are as follows:
File Description Coded By
Testing Summary
The customizations were tested in RGO’s test environment before being moved to
production. See the Link Test scripts for more information.
Installation
N/A
15
Open and Closed Issues for this Deliverable
Open Issues
ID Issue Resolution Responsibility Target Date Impact
Date
Closed Issues
ID Issue Resolution Responsibility Target Date Impact
Date
1 Query Screen for Segments Developed a query screen Sultan Mohammed
2 Segment Duplicate Values Restricted the Segment duplicate Sultan Mohammed.
values
16
