94152896 supplier data migration

8/11/2019 94152896 Supplier Data Migration

http://slidepdf.com/reader/full/94152896-supplier-data-migration 1/43

Government Financial Management Information Systems (GFMIS)

Supplier Data MigrationPrepared By

Mohammed Rizk Ibrahim

Oracle Technical Consultant



2

Main Topics

- Part I

1. What's data migration?

2. Most common Tools used for data uploading

3. API’s used

4. Testing the API script : Uploading One supplier

5. Validating of supplier data after uploading

6. Creating custom Objectsa) Custom Table

b) Custom Package

c) Custom Concurrent Program

7. Importing suppliers data into custom table

8. Filtering Data to avoid the duplicate suppliers



3

Main Topics

- Part II

1. What’s concurrent program

2. Types of concurrent program

3. Creating concurrent program

4. Uploading data process

5. Exercises on uploading the suppliers



4

Part I

Main Topics



Data Migration Definition & phases

Data Migration ,it’s the process of transferring data from asystem to another ,data migration is necessary when anorganization decides to use a new system to use any datathat was used in the old system

Data Migration phases

1. Data should be collected by MOF Technical Team

2. TRANSFER(MAP) : transfer or map data from the old format tothe new format

3. LOAD : upload the mapped data to the new system and test itto check if it is fully functional .

4. Oracle Base Tables AP_SUPPLIERS,AP_SUPPLIER_SITES_ALL andPER_ALL_PEOPLE_F.

5



6

Oracle Data LoaderIt’s a tool is used by functional consultants to upload data through filling in

an excel sheet, But Data loader is form-based i.e. Used only with forms or

you can only enter the data from a certain form .

Interface Table

It’s a tool used by functional consultants through importing data excel

sheets into interface tables .after that through oracle application you canrun a program that is responsible for transferring data from the interface

tables to oracle base table.

APIApplication Program Interfaces are standard stored procedure packages

or functions created for performing specific activities in the Oracle Apps E-

Business Suite. One of these activities is inserting the data into the a certaintable ( like supplier or customer tables ) while insuring the integrity of the

application .

Main Tools used for data upload




Our Action Plan :

1. EXTRACT : define Format of the extracted files , what’s the fileformat that will be extracted from PACI system : Excel,Text…etc?

2. Creation of a custom table (A temp table for suppliersmapping data provided by PACI )

3. Addition of constraints ,Checking for UNIQUE columns andNOT NULL columns like original tables for customers andsuppliers in oracle apps.

7



Data Migration Definition & phases


4. Running Loading utility & Creation of LOG file ,Load thesedata from temp table by using TOAD tool after which a logfile is created, the log file will contain data about theuninserted row .

5. Verify Data, Review invalid rows and fix it, use TOAD to reimport the rows again

8



API’S used

The Following API’s are used to upload supplier data :

o API Header

POS_VENDOR_PUB_PKG.CREATE_VENDOR ( parameters )

o API Sites

POS_VENDOR_PUB_PKG.CREATE_VENDOR_SITE( parameters )

10



API Header Example

DECLARE

l_vendor_rec ap_vendor_pub_pkg.r_vendor_rec_type;

l_return_status VARCHAR2(10);

l_msg_count NUMBER;

l_msg_data VARCHAR2(1000);

l_vendor_id NUMBER;

l_party_id NUMBER;

BEGIN

-- Required

l_vendor_rec.segment1 := '00002359'; -- Civil ID

l_vendor_rec.vendor_name := 'ABC'; -- Supplier Name-- Optional

l_vendor_rec.match_option:='R' ;

pos_vendor_pub_pkg.create_vendor(

p_vendor_rec => l_vendor_rec,

x_return_status => l_return_status,

x_msg_count => l_msg_count,

x_msg_data => l_msg_data,

x_vendor_id => l_vendor_id,x_party_id => l_party_id);

COMMIT;

dbms_output.put_line('return_status: '||l_return_status);

dbms_output.put_line('msg_data: '||l_msg_data);

dbms_output.put_line('vendor_id: '||l_vendor_id);

dbms_output.put_line('party_id: '||l_party_id);

END;

11



API Header Example

12



API Sites Example

DECLARE

l_vendor_site_rec ap_vendor_pub_pkg.r_vendor_site_rec_type;

l_return_status VARCHAR2(10);

l_msg_count NUMBER;

l_msg_data VARCHAR2(1000);

l_vendor_site_id NUMBER;

l_party_site_id NUMBER;

l_location_id NUMBER;

BEGIN-- Required

l_vendor_site_rec.vendor_id :=57023

l_vendor_site_rec.vendor_site_code := 'MOF';

l_vendor_site_rec.address_line1 := ' لكوي

’;

l_vendor_site_rec.country := 'KW';

l_vendor_site_rec.org_id := 85;

-- Optional

l_vendor_site_rec.purchasing_site_flag:='Y';

l_vendor_site_rec.pay_site_flag :='Y';

l_vendor_site_rec.rfq_only_site_flag :='N';

l_vendor_site_rec.phone := '67615006';

pos_vendor_pub_pkg.create_vendor_site(

p_vendor_site_rec => l_vendor_site_rec,

x_return_status => l_return_status,

13



API Sites Example

x_msg_count => l_msg_count,

x_msg_data => l_msg_data,

x_vendor_site_id => l_vendor_site_id,

x_party_site_id => l_party_site_id,

x_location_id => l_location_id);

COMMIT;

dbms_output.put_line('return_status: '||l_return_status);

dbms_output.put_line('msg_data: '||l_msg_data);

dbms_output.put_line('vendor_site_id: '||l_vendor_site_id);dbms_output.put_line('party_site_id: '||l_party_site_id);

dbms_output.put_line('location_id: '||l_location_id);

END;

14



API Sites Example

15



Search For Supplier

16



Search For Supplier

17



Create Custom Objects

Why are we using custom tables ?

• We are using custom table to import all supplier data from excel sheet

into this table .

• After that we are using a Procedure that uses the API to upload

all the suppliers to oracle database table .

• For creating custom table & procedure see the attached

file (Supplier Migration Scripts.txt).

. After that define Custom Concurrent Programs to use them for uploading data

18



Import supplier data into custom table

19

We can import the data supplier into custom table as the following:

• Fill in an excel sheet with the data supplier .

• Column name of excel sheet have to be the same column name of

table data base .




• After that will import the supplier data into custom table by using TOAD.

• From TODA menu Database -> Import ->Import Table Data

20




• A screen will appear that included the following :

• Press Execute Wizard button

21

Schema name

Custom tablename




22

• The next screen will appear ,then we select Excel File (*.xls) and press Nextbutton




23

•

Here will request from you to select an excel file that contains on the supplierdata .




24

•

Figure shows rejected record output file name and also the file path




25

• As we shown in figure we start first row from 2 and we didn't mention number

for last row which means we want to get all data in excel file then Next




• As shown in figure we've retrieve data but we have to make sure that the

column name of source (excel table) match the column name in destination

(oracle table) type by using AutoMap the Next

26




• This figure shows us the mapping of field in source and destination then Next

27




• Figure shows data after mapping Done then Next

28




29

• Here TOAD raises error message to show duplicate data for supplier.




30

• After process import data to custom table finished will show summary for

this process as the following




• We can display data that we already imported from excel file after we

complete the import data process (load) by press on Show Data after we

check the data we should commit data by press on red arrow button

• After that click commit icon

31

Commit Icon



Main Topics

- Part II

1. What’s concurrent program

2. Types of concurrent program

3. Creating concurrent program

4. Uploading data process

5. Exercises on uploading the suppliers

32



concurrent program

• Concurrent program is an executable file that runs simultaneously with otherconcurrent programs and with online operations. Typically, a concurrent

program is a long-running, data-intensive task, such as posting a journal or

generating a report.

•

Types of concurrent program

1. A SQL script

2. A SQL * Loader program

3. Java program

4. Oracle Report

5. Pl/SQL program ( or call it a stored procedure/package procedure)

33



Creating concurrent Program

34

Navigate to Responsibility Application Developer

(M) ConcurrentExecutableotice that execution

file name is name of

stored procedure



35

Creating concurrent Program

(M) ConcurrentProgramReference the executable

file name that defined in

the previous step



Request Group

• How can access and run this concurrent program ?

to run this concurrent program have to assign it to specific request group.

• What’s Request Group ?

Request Group is the collection of requests, request sets, and concurrent

programs that a user, operating under a given responsibility, can select fromthe Submit Requests window

36



What’s Request Group

Navigate to Responsibility System administrator

(M)Security Responsibility Define

37



Assign Request Group

38

Navigate to Responsibility System administrator

(M)Security Responsibility Define



Employee Data Migration

39

The same scenario will repeat for uploading the employees anddefine them as suppliers but will use different Custom concurrentPrograms

The same scenario will repeat for uploading the employees anddefine them as suppliers but will use different Custom concurrent

Programs as the following :1. Upload Employees

2. Update Employees Assignment

3. Define the Suppliers as Employees



Upload Employees

40



Update Employees Assignment (Department)

41



Define Employee As Supplier

42



Notes

• Kindly note that every time after loading data from excel

to custom table by TOAD have to update flag is called

ACTIVE_ROW=‘Y’.

43

94152896 supplier data migration

Documents