Post on 02-Jun-2018
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
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 2/43
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
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 3/43
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
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 4/43
4
Part I
Main Topics
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 5/43
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
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 6/43
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
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 7/43
Data Migration phases
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
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 8/43
Data Migration Definition & phases
Data Migration 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
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 9/43
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 10/43
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
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 11/43
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
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 12/43
API Header Example
12
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 13/43
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
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 14/43
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
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 15/43
API Sites Example
15
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 16/43
Search For Supplier
16
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 17/43
Search For Supplier
17
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 18/43
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
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 19/43
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 .
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 20/43
Import supplier data into custom table
• After that will import the supplier data into custom table by using TOAD.
• From TODA menu Database -> Import ->Import Table Data
20
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 21/43
Import supplier data into custom table
• A screen will appear that included the following :
• Press Execute Wizard button
21
Schema name
Custom tablename
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 22/43
Import supplier data into custom table
22
• The next screen will appear ,then we select Excel File (*.xls) and press Nextbutton
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 23/43
Import supplier data into custom table
23
•
Here will request from you to select an excel file that contains on the supplierdata .
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 24/43
Import supplier data into custom table
24
•
Figure shows rejected record output file name and also the file path
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 25/43
Import supplier data into custom table
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
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 26/43
Import supplier data into custom table
• 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
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 27/43
Import supplier data into custom table
• This figure shows us the mapping of field in source and destination then Next
27
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 28/43
Import supplier data into custom table
• Figure shows data after mapping Done then Next
28
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 29/43
Import supplier data into custom table
29
• Here TOAD raises error message to show duplicate data for supplier.
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 30/43
Import supplier data into custom table
30
• After process import data to custom table finished will show summary for
this process as the following
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 31/43
Import supplier data into custom table
• 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
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 32/43
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
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 33/43
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
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 34/43
Creating concurrent Program
34
Navigate to Responsibility Application Developer
(M) ConcurrentExecutableotice that execution
file name is name of
stored procedure
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 35/43
35
Creating concurrent Program
(M) ConcurrentProgramReference the executable
file name that defined in
the previous step
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 36/43
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
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 37/43
What’s Request Group
Navigate to Responsibility System administrator
(M)Security Responsibility Define
37
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 38/43
Assign Request Group
38
Navigate to Responsibility System administrator
(M)Security Responsibility Define
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 39/43
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
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 40/43
Upload Employees
40
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 41/43
Update Employees Assignment (Department)
41
8/11/2019 94152896 Supplier Data Migration
http://slidepdf.com/reader/full/94152896-supplier-data-migration 42/43
Define Employee As Supplier
42