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