BDC FUNCTIONAL SPECIFICATION

1. SAP BDC (BATCH DATA COMMUNICATION) PROJECT
Overview
This project will provide a general overview of a data conversion scenario with SAP.
Specifically, you will use a text file (.csv format) and import Vender Master Data into the
appropriate tables in SAP. Vendor data can use either internal or external numbering
(this concept will be discussed in the lecture). Your application will include logic that
takes both scenarios into consideration. You will write this ABAP application as BDC
program. Good luck!
Part 1- Introduction
During a typical conversion, a functional consultant will work with you (technical ABAP
programmer) to define the fields that need to be populated. The functional consultant
will step through the transaction with you and identify the appropriate fields for the
conversion. In this scenario, I will serve as the Functional Consultant and inform you of
the fields needed for the conversion.
(For the following example, you will be using the Vendor Master screen  MK01 or
Logistics  Materials Management  Purchasing, Master Data  Vendor 
Purchasing Create)
• Proceed to create a fictitious vendor in the system (no special characters). Specify
‘LIEF’ as the account group.
• Once the functional consultant identifies the various fields for the conversion, you
will need to capture the program name, screen number, transaction, and field/table
information. To do this, place your mouse pointer in the ‘name’ field and press
the F1 (Help) key.

2. • From the Help Screen, locate and click on the button ‘Technical Info’. The
following window will appear:
• From this window, record the Program Name, Screen Number, Table, and Field
Name. To get the transaction number, exit out of the window and go to the
System  Status command in the menu bar.
• Note: This data is typically recorded in a documentation template. For this
exercise, use the SAP Q&A Database application (if it’s loaded on your machine)
otherwise, record the info in your own custom template in Word or Excel.
• Proceed to obtain the technical information for the following fields:
Vendor Name
Search Term
City
Zip/Postal Code
Country
Language
Currency
The table above list the minimum required fields for Vendor Master Data. From a logical
perspective, you should ask yourself what fields are specific to SAP. Specific SAP fields
will generally not be populated from your external data source (because some fields in
SAP already have data and you wouldn’t expect it from the legacy system). Once all
your fields are defined, you would typically give these field requirements to a ‘legacy’
person to extract the appropriate data set for the data conversion.

3. • Note: any SAP defined field will contain logic behind it (e.g. drop down arrows
indicate multiple values…this info will not be found in legacy system).
• A good question to ask the functional consultant would be if there is any ‘default’
values for a field.
• In reference to internal & external numbering (this topic will be discussed in
class) the account group drives the vendor number. This is imperative to know in
advance. If you have experience from the functional side or have used the IMG
tool, you can find out the different account groups and numbering schemes based
upon the following menu path in the IMG: Financial Accounting  AR/AP 
Vendor Accounts  Master Records  Preparation for Creating Vendor Master
 Create Number Allocate # Ranges (specify internal/external numbers).
If the client doesn’t have a preference, use Internal.
• Important Account Groups:
KRED – internal SAP numbering
LIEF – external vendor numbering
Here is a scenario for you to consider when performing a data conversion:
The company you are consulting for has a legacy system containing 1000 vendors. The
company has recently performed an analysis of open PO’s (Purchase Orders). The
analysis results indicate there are open PO’s for 200 vendors. For the data conversion,
these 200 vendors will use external vendor numbering (so there’s no conflict with invoice
matching). The remaining vendors without open PO’s will be assigned internal vendor
numbering. The legacy programmer has provided you with 2 separate files. One file
contains a list of vendors with open PO’s, while the other file contains a list of vendors
without outstanding PO’s.
Your task is to write an ABAP BDC program that imports the data in the text files to the
appropriate ABAP tables. Don’t forget, your program needs to contain logic to
determine if the text file is for internal/external vendor numbering.
Part 2 – Process
In part two, you will use batch functions within SAP. The table below lists the different
transaction codes to get started with setting up your batch recording.
Transactions:
Transaction Description
SHDB Batch Input Recording (records a batch session)
SM35 Batch Input Initial Screen (to review recorded batch sessions)

4. • To begin, go to transaction SHDB.
• Name the recording session z_BDC_XX (where XX is the last two numbers of
your assigned logon id). From the menu bar, select Recording  Create.
• For the transaction code, enter MK01 (the initial vendor master create screen).
• Your batch recording session in now initiated. To begin, enter in a fictitious
vendor as performed in Part 1 of this project.

5. • From the Create Vendor: Address screen, input the following fields (remember,
these are the minimum required Vendor Master Data fields for our data
conversion):
• From the next page, select USD as currency type (this may not be an option).
Your batch input recording session should resemble the following:

6. After you record the batch session, generate the program based upon what was recorded
(very similar to a Macro).
• Start by going back to transaction SHDB. Click on the overview toolbar icon, or
press F8.
• Look for your session recording and click once on the line item. When your
session is highlighted, click on ‘Generate Program’ from the tool bar. Name your
program Z_BDC_XX (where XX is the last two digits of your assigned login id).

7. • At the attributes screen, fill in the appropriate values….you may use the following
as a guideline (notice the application is type: M):
After the attributes have been filled out, review the generated ABAP/4 code:

8. Notice all the perform statements that have been coded for you.
PART 3 – Editing the Code
The last part of this project involves editing the code of the generated ABAP/4 BDC
program. This program needs to upload the files the legacy programmer has provided
you, as well as code any special logic. To finish the program, you will need to create an
internal table that will store all the values that need to be populated in the Vendor Master
Data table (LFA1). You will need to setup a Parameters statement to accept the import
files. Finally, you will need to write special logic to get the desired output.
• If the BDC program is not currently open, go to the ABAP Workbench and open
the BDC program. After the reports statement, use the tables statement to call
two tables:
Table Description
LFA1 Vendor Master Data
RLGRAP Structure used when uploading/downloading file formats
• Next, use the parameters statement to accept the input of the text file (path):
parameters: p_file like rlgrap-filename.

9. • Create an internal table that contains the structure of the import file.
data: begin of itab occurs 10,
vendor like lfa1-lifnr,
name like lfa1-name1,
city like lfa1-ort01,
zip like lfa1-pstlz,
end of itab.
• Note: make sure you use the data dictionary to become familiar with the LFA1
table and its fields.
• Review the text files that will be used for the upload. Notice the space that is
separating each value. To account for the space in the import file, use the
following variables (data object):
data: wf_record(80),
wf_split type x value '09'. "this represents a tab in a file
• Question: what do you think ‘bdcrecxx’ is referring to from your code?
• After the ‘Start-of-Selection’ statement, place a new subroutine that gets the data
from the input file:
perform get_data.
• Tip: you can double-click on the get_data name and ABAP/4 will automatically
generate the required entries in your code to initialize the subroutine.
• After the form ‘get_data’ statement, use the open dataset command to get the text
file:
open dataset p_file in text mode.
• Review the following Do Statement (we will go over this command in lecture).
do.
read dataset p_file into wf_record.
if sy-subrc ne 0.
exit.
else.
split wf_record at wf_split into itab-vendor itab-name
itab-city
itab-zip.
append itab.
endif.
enddo.

10. • The last statement in your program (before ‘endform.’) should be:
close dataset p_file.
• After the open_group statement, start looping your program.
loop at itab. "start looping through all all records from file
• Use the table below to replace the BDC Field values with the values from the
internal table:
BDC Field Name Original Value Change to Value
RF02K-LIFNR ZBDCTESTXX itab-vendor.
BDC_CURSOR RF02K-KTOKK Refer to If statement below
LFA1-NAME1 BDC Test Borquez XX itab-name.
LFA1-SORTL BDCTE itab-name+0(5).
LFA1-ORT01 Beverly Hills itab-city.
LFA1-PSTLZ 90211 itab-zip.
• To determine the type of group, use the following if statement:
if itab-vendor = space.
perform bdc_field using 'RF02K-KTOKK'
'kred'.
else.
perform bdc_field using 'RF02K-KTOKK'
'LIEF'.
endif.
• After the statement:
perform bdc_transaction using 'MK01'.
• Refresh the data with the command:
refresh bdcdata. " clear all records in table, not just header record
• Press F8 or Execute to run the program:

11. • When your program runs, use the following parameters (make sure you check the
Keep Session check box):
• Click on Execute.
If you are successful with executing the program, you could expect the following screen:

12. • Test the results of your program by going to transaction SM35.
• If you forget the name of your session, click on the overview button. You should
be able to see your session in the ‘Session still to be processed’ area.

13. • Double-click on your session:
• Click on Process.
The system will now walk you through the batch process for your text file. Notice the
values that are given to each field during this walk through. In the future, you may run
this process in ‘Background’ mode if you are importing thousands of records, rather than
just a few. This is a good test to see if your program can successfully run the text file.
When the batch process completes, you will see the following window:

14. • To check the log, go back to SM35 and click overview. Select your session and
click on Log from the toolbar.
You will see the results from your successful batch input:
That’s all folks!