Interface
Technical Specification
New Extractor for Master Data
Version 0.8
SAP BI 15399_ETD_E558_NewExtractorForMasterDataEWM_V0.
8
Page 1 of 19
DOCUMENT REVISION HISTORY
Version Revision Date Author(s) Revision Notes
0.1 Initial Draft
SAP BI 15399_ETD_E558_NewExtractorForMasterDataEWM_V0.
8
Page 2 of 19
CONTENTS
1.0 Request Details.......................................................................5
2.0 General Information..................................................5
3.0 Functional Interpretations.........................................5
3.1 Technical Description............................................................................................................................. 5
3.2 Security / Authorization / Control Implemented......................................................................................6
3.3 Functional and Technical Clarifications.................................................................................................. 6
3.4 Dependencies........................................................................................................................................ 6
3.5 Additional Information............................................................................................................................ 6
4.0 Interface Details........................................................6
4.1 Tables.................................................................................................................................................... 6
4.2 Input File Details.................................................................................................................................... 7
4.3 Configuration values.............................................................................................................................. 7
4.3.1 Info sources / Data sources................................................................................................................ 7
4.3.2 Transformations.................................................................................................................................. 7
4.3.3 DSO.................................................................................................................................................... 8
4.3.4 Cube................................................................................................................................................... 8
4.3.5 Process Chain..................................................................................................................................... 8
4.4 File Layout and Data Mapping............................................................................................................... 8
4.5 Selection Screen.................................................................................................................................... 8
No Selection screen required as this an creation of new extractor..............................................................8
4.6 Selection Screen and Report Output Layout.......................................................................................... 8
4.7 Selection Screen Validation................................................................................................................... 8
4.8 Processing Logic.................................................................................................................................... 9
4.9 Flow diagram (Optional)....................................................................................................................... 12
4.10 Processing Steps............................................................................................................................... 18
4.11 Error Messages.................................................................................................................................. 18
5.0 Other Details...........................................................19
5.1 Error Handling...................................................................................................................................... 19
5.2 Logging................................................................................................................................................ 19
5.3 Restart and Recovery procedures....................................................................................................... 19
6.0 Conversion specific Information...............................19
6.1 Data cleansing..................................................................................................................................... 19
6.2 Conversion Steps................................................................................................................................. 19
SAP BI 15399_ETD_E558_NewExtractorForMasterDataEWM_V0.
8
Page 3 of 19
7.0 Open Design Questions............................................19
8.0 Processing Report Output Details.............................20
9.0 Unit Test Plan......................................................................... 20
SAP BI 15399_ETD_E558_NewExtractorForMasterDataEWM_V0.
8
Page 4 of 19
1.0 Request Details
Program Title P&A Reporting
Program Name GMC/IO_FM_MATMAS Type Interface
Function Spec ID NewExtractorForMasterDataE Version 0.8
WM_v1.doc
Developer On Site Coordinator
Phone
Email
Process Team IBM P&A Functional Contact
Phone
Email
SAP System and Version SAP BI 7 Process Doc. NA
Reference
SAP Module and SCM Workstep/ Task NA
Sub module
Priority X Essential ( Business critical) Release
Complexity High
2.0 General Information
Direction From SCM to BI
Interface / Conversion EWM Extractors, Generic extractors
Technology
Transaction Code RSA5 , RSA6 , RSA1
Package /GMC/BP2
Message Class Standard message class will be used
Authorization Group No authorization group
Initiation Process Manual/Batch/Ad-Hoc
Run Frequency Daily
3.0 Functional Interpretations
3.1 Technical Description
This interface is for extracting Extended Warehouse Management Master data into SAP BI system from
SAP BI 15399_ETD_E558_NewExtractorForMasterDataEWM_V0.
8
Page 5 of 19
SCM. Warehouse Product, Packaging Specification data, Resources, Hazardous Goods, Dangerous
goods details are required for EWM reports, hence Master data needs to be maintained for each object
in the BI system.
3.2 Security / Authorization / Control Implemented
No access required for Business Users as data will be seen only via reports. Access required for the
development and support teams
3.3 Functional and Technical Clarifications
Assumptions
Any modification to master data is done at source.
All the required master data is available in source for extraction timely
IBM to ensure all data is present in BI system
Report design to be completed by Business and IBM in Realization phase
3.4 Dependencies
Master data is maintained in SCM which must contain all the reporting attributes.
3.5 Additional Information
This is not applicable
4.0 Interface Details
4.1 Tables
Standard tables used List of table and fields are as below
C:\Documents and
Settings\Administrator\Desktop\kickoff_docs\558_Material_master_mapping_EWM.xls
Custom tables used No custom tables will be used
Standard objects used
Custom objects created Datasources Name
GSDWM_MD_SAPAPOMATLWH_WHSEPROD
GSDWM_MD_PNODID_PACKAGINGSPEC
GSDWM_MT_GMC_IO_V_PNODID_ELGPT
GSDWM_MT_GMC_IO_V_PNODID_PKTXT
GSDWM_MT_GMC_IO_V_PNODID_WSTPT
SAP BI 15399_ETD_E558_NewExtractorForMasterDataEWM_V0.
8
Page 6 of 19
GSDWM_MT_GMC_IO_T_HAZARD_HZMAT
GSDWM_MD_GMC_IO_V_HAZMAT_HZTXT
GSDWM_MD_GMC_IO_V_RESOUR_RSRC
GSDWM_TD_SCWM_BINMAT_FIXBIN_EX
Structure Names: /GMC/IO_DS_WHPROD, /GMC/IO_DS_PKDATA,
/GMC/IO_DS_RSRC, /GMC/IO_DS_HZMAT,
/GMC/IO_DS_DGGOODS, /GMC/IO_DS_HZDESC,
/GMC/IO_DS_ELGPDESC, /GMC/IO_DS_WSTPDESC,
/GMC/IO_DS_PKDESC
Function Module name: /GMC/IO_FM_WHPROD, /GMC/IO_FM_PKDATA,
/GMC/IO_FM_RSRC, /GMC/IO_FM_HZMAT,
/GMC/IO_FM_DGGOODS, /GMC/IO_FM_HZDESC,
/GMC/IO_FM_ELGPDESC, /GMC/IO_FM_WSTPDESC,
/GMC/IO_FM_PKDESC
0WM_PRODNO Product
0WM_PSID Packaging Specification ID
GWMHAZMAT Product Number - HAZ
0WM_RSRC Resource (Means of Transportation or User)
GWMFIXBIN Warehouse Number - Fix Bin
4.2 Input File Details
Not applicable
File Name
File Type
File Delimiter
Location
Logical File Name
Comments
4.3 Configuration values
4.3.1 Info sources / Data sources
Custom Material Master Data source fields are in the attachment below
Data source name:
GSDWM_MD_SAPAPOMATLWH_WHSEPROD - Extractor for Warehouse product
GSDWM_MD_PNODID_PACKAGINGSPEC - Extractor for Pack Spec Data
GSDWM_MD_GMC_IO_V_RESOUR_RSRC - Extractor for Resources
SAP BI 15399_ETD_E558_NewExtractorForMasterDataEWM_V0.
8
Page 7 of 19
GSDWM_MD_GMC_IO_V_HAZMAT_HZTXT – Extractor for Hazardous Material
GSDWM_MT_GMC_IO_T_HAZARD_HZMAT - Extractor for HazMat Substance description
GSDWM_MT_GMC_IO_V_PNODID_ELGPT - Extractor for Element group description
GSDWM_MT_GMC_IO_V_PNODID_WSTPT - Extractor for workstep description
GSDWM_MT_GMC_IO_V_PNODID_PKTXT- Extractor for Pack Spec description
GSDWM_TD_SCWM_BINMAT_FIXBIN_EX – Extractor for Fix Bin and Product assignment
Master Data Source
558.xls
4.3.2 Transformations
Transformation from EWM Master Data Extractors can be seen below:
Transformations to
Info Objects_558.xls
4.3.3 DSO
N/A
4.3.4 Cube
N/A
4.3.5 Process Chain
Process will be automated in subsequent Process chains for Master data loading.
4.4 File Layout and Data Mapping
Please find the mapping document attached in section 4.1 and 4.3
4.5 Selection Screen
No Selection screen required as this an creation of new extractor
4.6 Selection Screen and Report Output Layout
No Selection screen required as this an creation of new extractor
4.7 Selection Screen Validation
No Selection screen required as this an creation of new extractor
SAP BI 15399_ETD_E558_NewExtractorForMasterDataEWM_V0.
8
Page 8 of 19
4.8 Processing Logic
Following are the data extraction logics:
Step 1: Go to transaction SE11 and create the following structures :
/GMC/IO_DS_WHPROD
/GMC/IO_DS_PKDATA
/GMC/IO_DS_RSRC
/GMC/IO_DS_HZMAT
/GMC/IO_DS_DGGOODS
/GMC/IO_DS_HZDESC
/GMC/IO_DS_ELGPDESC
/GMC/IO_DS_WSTPDESC
/GMC/IO_DS_PKDESC
Step 2: Create the following new data sources using transaction RSO2:
/GMC/IO_EX_WHPROD
/GMC/IO_EX_PKDATA
/GMC/IO_EX_RSRC
/GMC/IO_EX_HZMAT
/GMC/IO_EX_DGGOODS
/GMC/IO_EX_HZDESC
/GMC/IO_EX_ELGPDESC
/GMC/IO_EX_WSTPDESC
/GMC/IO_EX_PKDESC
Step 3: The function modules and structures will be assigned to relevant data sources as mentioned
below.
Datasource Function Module Structure
/GMC/IO_EX_WHPROD /GMC/IO_FM_WHPROD /GMC/IO_DS_WHPROD
/GMC/IO_EX_PKDATA /GMC/IO_FM_PKDATA /GMC/IO_DS_PKDATA
/GMC/IO_EX_RSRC /GMC/IO_FM_RSRC /GMC/IO_DS_RSRC
/GMC/IO_EX_HZMAT /GMC/IO_FM_HZMAT /GMC/IO_DS_HZMAT
/GMC/IO_EX_HZDESC /GMC/IO_FM_HZDESC /GMC/IO_DS_HZDESC
/GMC/IO_EX_ELGPDESC /GMC/IO_FM_ELGPDESC /GMC/IO_DS_ELGPDESC
/GMC/IO_EX_WSTPDESC /GMC/IO_FM_WSTPDESC /GMC/IO_DS_WSTPDESC
/GMC/IO_EX_PKDESC /GMC/IO_FM_PKDESC /GMC/IO_DS_PKDESC
Step 4: The data source is delta enabled using the Generic Data option available on the screen.
Step 5: Go to SE37 and create a function modules. These function modules will
have the following parameters:
FM Name : /GMC/IO_FM_WHPROD
IMPORT Parameters:
I_REQUNR TYPE SRSC_S_IF_SIMPLE-REQUNR
I_DSOURCE TYPE SRSC_S_IF_SIMPLE-DSOURCE
I_MAXSIZE TYPE SRSC_S_IF_SIMPLE-MAXSIZE
I_INITFLAG TYPE SRSC_S_IF_SIMPLE-INITFLAG
TABLES Parameter will have the following:
I_T_SELECT TYPE SRSC_S_IF_SIMPLE-T_SELECT
SAP BI 15399_ETD_E558_NewExtractorForMasterDataEWM_V0.
8
Page 9 of 19
I_T_FIELDS TYPE SRSC_S_IF_SIMPLE-T_FIELDS
E_T_DATALIKE /GMC/IO_DS_WHPROD
FM Name : /GMC/IO_FM_PKDATA
IMPORT Parameters:
I_REQUNR TYPE SRSC_S_IF_SIMPLE-REQUNR
I_DSOURCE TYPE SRSC_S_IF_SIMPLE-DSOURCE
I_MAXSIZE TYPE SRSC_S_IF_SIMPLE-MAXSIZE
I_INITFLAG TYPE SRSC_S_IF_SIMPLE-INITFLAG
TABLES Parameter will have the following:
I_T_SELECT TYPE SRSC_S_IF_SIMPLE-T_SELECT
I_T_FIELDS TYPE SRSC_S_IF_SIMPLE-T_FIELDS
E_T_DATALIKE /GMC/IO_DS_PKDATA
FM Name : /GMC/IO_FM_RSRC
IMPORT Parameters:
I_REQUNR TYPE SRSC_S_IF_SIMPLE-REQUNR
I_DSOURCE TYPE SRSC_S_IF_SIMPLE-DSOURCE
I_MAXSIZE TYPE SRSC_S_IF_SIMPLE-MAXSIZE
I_INITFLAG TYPE SRSC_S_IF_SIMPLE-INITFLAG
TABLES Parameter will have the following:
I_T_SELECT TYPE SRSC_S_IF_SIMPLE-T_SELECT
I_T_FIELDS TYPE SRSC_S_IF_SIMPLE-T_FIELDS
E_T_DATALIKE /GMC/IO_DS_RSRC
FM Name : /GMC/IO_FM_HZMAT
IMPORT Parameters:
I_REQUNR TYPE SRSC_S_IF_SIMPLE-REQUNR
I_DSOURCE TYPE SRSC_S_IF_SIMPLE-DSOURCE
I_MAXSIZE TYPE SRSC_S_IF_SIMPLE-MAXSIZE
I_INITFLAG TYPE SRSC_S_IF_SIMPLE-INITFLAG
TABLES Parameter will have the following:
I_T_SELECT TYPE SRSC_S_IF_SIMPLE-T_SELECT
I_T_FIELDS TYPE SRSC_S_IF_SIMPLE-T_FIELDS
E_T_DATALIKE /GMC/IO_DS_HZMAT
FM Name : /GMC/IO_FM_DGGOODS
IMPORT Parameters:
I_REQUNR TYPE SRSC_S_IF_SIMPLE-REQUNR
I_DSOURCE TYPE SRSC_S_IF_SIMPLE-DSOURCE
I_MAXSIZE TYPE SRSC_S_IF_SIMPLE-MAXSIZE
I_INITFLAG TYPE SRSC_S_IF_SIMPLE-INITFLAG
TABLES Parameter will have the following:
I_T_SELECT TYPE SRSC_S_IF_SIMPLE-T_SELECT
I_T_FIELDS TYPE SRSC_S_IF_SIMPLE-T_FIELDS
E_T_DATALIKE /GMC/IO_DS_DGGOODS
FM Name : /GMC/IO_FM_HZDESC
IMPORT Parameters:
I_REQUNR TYPE SRSC_S_IF_SIMPLE-REQUNR
I_DSOURCE TYPE SRSC_S_IF_SIMPLE-DSOURCE
I_MAXSIZE TYPE SRSC_S_IF_SIMPLE-MAXSIZE
I_INITFLAG TYPE SRSC_S_IF_SIMPLE-INITFLAG
TABLES Parameter will have the following:
I_T_SELECT TYPE SRSC_S_IF_SIMPLE-T_SELECT
SAP BI 15399_ETD_E558_NewExtractorForMasterDataEWM_V0.
8
Page 10 of 19
I_T_FIELDS TYPE SRSC_S_IF_SIMPLE-T_FIELDS
E_T_DATALIKE /GMC/IO_DS_HZDESC
FM Name : /GMC/IO_FM_ELGPDESC
IMPORT Parameters:
I_REQUNR TYPE SRSC_S_IF_SIMPLE-REQUNR
I_DSOURCE TYPE SRSC_S_IF_SIMPLE-DSOURCE
I_MAXSIZE TYPE SRSC_S_IF_SIMPLE-MAXSIZE
I_INITFLAG TYPE SRSC_S_IF_SIMPLE-INITFLAG
TABLES Parameter will have the following:
I_T_SELECT TYPE SRSC_S_IF_SIMPLE-T_SELECT
I_T_FIELDS TYPE SRSC_S_IF_SIMPLE-T_FIELDS
E_T_DATALIKE /GMC/IO_DS_ELGPDESC
FM Name : /GMC/IO_FM_WSTPDESC
IMPORT Parameters:
I_REQUNR TYPE SRSC_S_IF_SIMPLE-REQUNR
I_DSOURCE TYPE SRSC_S_IF_SIMPLE-DSOURCE
I_MAXSIZE TYPE SRSC_S_IF_SIMPLE-MAXSIZE
I_INITFLAG TYPE SRSC_S_IF_SIMPLE-INITFLAG
TABLES Parameter will have the following:
I_T_SELECT TYPE SRSC_S_IF_SIMPLE-T_SELECT
I_T_FIELDS TYPE SRSC_S_IF_SIMPLE-T_FIELDS
E_T_DATALIKE /GMC/IO_DS_WSTPDESC
FM Name : /GMC/IO_FM_PKDESC
IMPORT Parameters:
I_REQUNR TYPE SRSC_S_IF_SIMPLE-REQUNR
I_DSOURCE TYPE SRSC_S_IF_SIMPLE-DSOURCE
I_MAXSIZE TYPE SRSC_S_IF_SIMPLE-MAXSIZE
I_INITFLAG TYPE SRSC_S_IF_SIMPLE-INITFLAG
TABLES Parameter will have the following:
I_T_SELECT TYPE SRSC_S_IF_SIMPLE-T_SELECT
I_T_FIELDS TYPE SRSC_S_IF_SIMPLE-T_FIELDS
E_T_DATALIKE /GMC/IO_DS_PKDESC
Logic inside each function modules:
Step 6: The table ROOSGENDLM is read for the last delta execution time stamp.
Step 7: A counter variable will be used. For the first data package, the key fields are selected from driver
table /SAPAPO/MATKEY using OPEN CURSOR.
Step 8: Fetch the records which are changed after the previous delta execution into an internal table
using FETCH NEXT CURSOR statement. Number of records to be read per FETCH is
determined by the Import parameter I_MAXSIZE.
Step 9: Extract the data from the relevant fields of the tables /SAPAPO/MATKEY,
/SAPAPO/MATLOC, /SAPAPO/MATLWHST, /SAPAPO/MATLSIM,
/SAPAPO/MATLWH, /SCWM/PAPAK, HSMT_MD, BUT000, /SCWM/V_RSRC
and the structure /GMC/IO_DS_MATMAS is populated from these tables.
Step 10: If there are no records to be fetched, then the exception NO_MORE_DATA, is raised.
SAP BI 15399_ETD_E558_NewExtractorForMasterDataEWM_V0.
8
Page 11 of 19
Step 11: The loop fetches through all the data, until the maximum packet size is reached and send to
extractor.
Step 12: Increase the counter variable for the next fetch.
Step 13: After processing the last package, call the function module
‘RSA8_GENDELTA_ZDD_REPLAY_GET’ to update the table ROOSGENDLM with the latest
Timestamp.
4.9 Flow diagram (Optional)
Warehouse Product master data flow
YES
First Start init delta
Start
time with data option
data
load?
NO
Start delta load
Function module /GMC/IO_FM_WHPROD
populates the customized DS with ware
house product master data
Ware house product
master data to PSA
from SCM
DTP pulls data from PSA
Attribute change run to GWMLGNUM
End
SAP BI 15399_ETD_E558_NewExtractorForMasterDataEWM_V0.
8
Page 12 of 19
Pack Spec Data flow
YES
First Start init delta
Start
time with data option
data
load?
NO
Start delta load
Function module /GMC/IO_FM_PKDATA populates the
customized DS with pack spec master data
The function modules /GMC/IO_FM_ELGPDESC,
/GMC/IO_FM_WSTPDESC, /GMC/IO_FM_PKDESC
populate the customized DS with text values
Pack spec master data is
loaded to PSA from SCM
DTP pulls data from PSA
Attribute change run to GWMPSID
End
SAP BI 15399_ETD_E558_NewExtractorForMasterDataEWM_V0.
8
Page 13 of 19
Hazardous material data flow
YES
First Start init delta
Start
time with data option
data
load?
NO
Start delta load
Function module /GMC/IO_FM_HZMAT
populates the customized DS with HazMat
master data
Function module /GMC/IO_FM_HZDESC
populates the customized DS with text
data
HazMat master data
loaded to PSA from
SCM
DTP pulls data from PSA
Attribute change run to GWMHAZMAT
End
SAP BI 15399_ETD_E558_NewExtractorForMasterDataEWM_V0.
8
Page 14 of 19
Resource data flow
YES
First Start init delta
Start
time with data option
data
load?
NO
Start delta load
Function module /GMC/IO_FM_RSRC
populates the customized DS with
resource data
Resource data loaded
to PSA from SCM
DTP pulls data from PSA
Attribute change run to GWMRSRC
End
SAP BI 15399_ETD_E558_NewExtractorForMasterDataEWM_V0.
8
Page 15 of 19
Dangerous goods data flow
YES
First Start init delta
Start
time with data option
data
load?
NO
Start delta load
Function module
/GMC/IO_FM_DGGOODS populates the
customized DS with dangerous goods
Dangerous goods data
loaded to PSA from
SCM
DTP pulls data from PSA
Attribute change run to GWMDNGOOD
End
4.10 Processing Steps
1 Activate Data Source for Material Master
2 Replicate in BW
3 Create Info package to load data from SCM to BI
4 If fields are not present in the extract structure then an enhance routine (ABAP) will
SAP BI 15399_ETD_E558_NewExtractorForMasterDataEWM_V0.
8
Page 16 of 19
have to be written to enhance the data source with required fields.
5 If there are tables apart from standard tables that will also fetch Master data fields then
custom data sources will need to be created and data will have to be added directly to
Material Master or a copy of Material Master will have to be created if we do not wish to
alter existing SAP standard object
4.11 Error Messages
Error No. Error Message
1 No Authorization
2 Data not there for the given selection
5.0 Other Details
5.1 Error Handling
If there is a data load failure then the cause of failure should be identified. In case of short dumps failed
request should be deleted from the info provider and data should be reloaded. If the failure is due to
wrong data (wrong date format, master data etc) the sustain team will be informed about the failure. The
sustain team will update the concern team and the data correction should be completed by the concern
team before next load or reload.
5.2 Logging
Logging of SAP BW process chains is automatic.
5.3 Restart and Recovery procedures
Step 1 For delta load failure the QM status should be made red before repeat delta is made.
Step 2 The failed request should be deleted from the info provider
Step 3 The repeat delta should be done
6.0 Conversion specific Information
6.1 Data cleansing
Since all data is from a trusted source, SCM, there is no cleansing required, nor any data conversions.
6.2 Conversion Steps
No conversion is needed
SAP BI 15399_ETD_E558_NewExtractorForMasterDataEWM_V0.
8
Page 17 of 19
7.0 Open Design Questions
No open design questions
No Issue / Resolution Description Name Date Status
SAP BI 15399_ETD_E558_NewExtractorForMasterDataEWM_V0.
8
Page 18 of 19
8.0 Processing Report Output Details
# Report Field Field Report Level Sort length / Processing
Name Format Table-field Description /
Definition Reader/Item
Calculation Logic
9.0 Unit Test Plan
# Step Screenshots Expected Result Actual Executed
Result/ By/Date
Remarks
1 Run info package for Init delta (with N- number of records
data option) should be fetched and
the load status should b
green
2 Run info package for delta load Zero records should be
immediately fetched and the load
status should b green
3 Run info package for delta daily Daily runs should bring
new records
4 Check the values for the each data The data should match
fields in each new data source in in both BI and SCM
SAP BI and same values in SCM
5 Repeat above step for different The data should match
datasets in both BI and SCM
6 Check the time dependent The value should be
characteristics within the validity period
7 Load test data with incorrect values The load should fail
like wrong date format, invalid
characters
SAP BI 15399_ETD_E558_NewExtractorForMasterDataEWM_v0.
8
Page 19 of 19
