LSMW Tutorial

LSMW - Tutorial
Legacy System Migration Workbench
Copyright http://www.SAPTricks.com
page 1
Table of Contents
LSMW - TUTORIAL
Legacy System Migration Workbench
Table of Contents
Copyrights
Acknowledgments
Preface
Introduction to the LSMW Tutorial
Step 1 - LSMW Initial screen
Step 2 - Create a Project, Subproject and Object
Step 2 .1 - Create a Project
5
Step 2 .2 - Create a Subproject
5
Step 2 .3 - Create an Object
6
Step 3 - Record the Customer Master Creation transaction
Step 4 - Perform Mapping
Step 4.1 - Maintain object attributes
10
Step 4.2 - Maintain source structures
12
Step 4.3 - Maintain source fields
13
Step 4.4 - Maintain field mapping and conversion rules
14
16
Step 4.6 - Maintain structure relations
18
19
Step 4.8 - Maintain fixed values, translations, user-defined routines 21
Step 4.9 - Excel Spreadsheet
21
Step 4.10 - Specify files
22
Step 4.11 - Assign files
24
Step 5 - Read data
Step 5.1 - Display read data
24
Step 6 - Convert data
Step 6.1 - Display converted data
26
Step 7 - Create batch input session
Step 7.1 - Run batch input session
28
3
4
5
5
5
6
9
24
25
27
Glossary of Terms
29
Table of Figures
30
page 2
Copyrights
This publication is protected under international copyright laws. All reproduction, duplication and sharing
of this publication in full or in any part, in all printed and digital formats is strictly prohibited unless
express permission is obtained from the author or SAPWW SAP Worldwide in writing.
SAP is a trademark of SAP Aktiengesellschaft, Systems, Applications and Products in Data Processing,
Neurottstrasse 16, 69190 Walldorf, Germany. The publisher gratefully acknowledges SAPs kind
permission to use its trademark in this publication. SAP AG is not the publisher of this book and is not
responsible for it under any aspect of press law.
Acknowledgments
Thank you to Dustin Ainsworth for his technical and functional expertise and assistance in creating this
material. Any queries can be sent to da@sapww.com.
page 3
Preface
The LSMW- Legacy Systems Migration Workbench, is a SAP tool which supports one during the once-off
and periodic transfer of data from non-SAP systems ("legacy systems") to the R/3 System.
The tool supports the conversion of the legacy system data to be transferred into the R/3 System in a userfriendly manner.
The LSM Workbench supports the following standard data interfaces in its newest version (see below):
Batch input
Direct input
BAPIs (Business Application Programming Interfaces)
IDocs (Intermediate Documents)
Furthermore, the transaction recorder (batch input recorder) is connected to the LSMW. In this way a data
migration object can be generated from the recording of a transaction.
This tutorial helps you to learn to use LSMW using the standard data interface method of Batch input.
The LSMW comprises the following main functions:
Read data (legacy data in spreadsheet tables and/or sequential files).

You can use any combination of PC and server files
Convert data (from the source into the target format)
Import data (to the database used by the SAP application).
This tutorial is used to introduce you to the functionality within LSMW and will permit you to use its basic
functions, this will assist you by giving you a platform by which you may explore the additional functionality
LSMW is able to provide.
page 4
Introduction to the LSMW Tutorial

In this Tutorial you will learn to use the LSMW to create customer master records. However this is an
example which may be copied to create any master data within SAP.
Step 1 - LSMW Initial screen
Enter the transaction code LSMW
Confirm your entry with Enter
to start LSMW.
You are now in the Legacy System Migration Workbench screen:
Figure 1 Legacy System Migration Workbench
Step 2 - Create a Project, Subproject and Object

Step 2 .1 - Create a Project
The project serves as an organizational unit used to combine mapping and field assignments
Click inside the Project field and then click on the create
pushbutton
You are now in the Create Project screen
Figure 2 Create Project
Enter a suitable Project name, such as ZPROJECT
Enter a suitable Project description.
Click on the Enter
pushbutton
Step 2 .2 - Create a Subproject

You are now in the Create Subproject screen
Figure 3 Create Subproject
A subproject is an organizational unit subordinated to the project

page 5
Enter a suitable subproject name, such as SD
Enter a suitable subproject description, such as SALES & DISTRIBUTION SUBPROJECTS.
Take note, all SD related LSMWs can now be created within this subproject.
Click on the Enter
pushbutton
Step 2 .3 - Create an Object

You are now in the Create Object screen
Figure 4 Create Object
An object is a unit (Business Object) combined from the business point of view, which is used to transfer the
data of a project to the SAP system.
Enter a suitable Object name, such as CUSTOMERS
Enter a suitable object description, such as SOLD TO PARTY UPLOAD
Click on the Enter
pushbutton
You have successfully created an LSWM Project, subproject and object.
Step 3 - Record the Customer Master Creation transaction
Click on the Goto Recordings
You use the recording function to create a new object (or a new "import method") if neither a standard batch
input program nor a standard direct input program nor the BAPI/IDoc method is available for a data object.
You are now in the Recordings of project ZPROJECT: Overview screen
Figure 6 Recordings of project ZPROJECT

page 6
Click on the
icon to name and create a new recording.
You are now in the Recordings of project ZPROJECT: Overview screen
Figure 7 Recordings of project ZPROJECT: Overview
Enter a suitable Recording name
Enter a suitable Description
Your SAP logon name will default as the owner name
Click on the Enter
pushbutton
You are now in the Transaction code screen
Figure 8 Transaction code
Enter the transaction code to create a Customer Master - XD01
Click on the Enter
pushbutton
You are now in the Create Customer: Initial screen
Figure 9 Create Customer: Initial screen
Run through the transaction and enter data in the fields that you will need populated when uploading the
LSMW.
page 7
TAKE NOTE this should be done in the Development client, as an actual data record will be created.
The system will indicate, Customer 001000999 has been created. (Number may vary.)
TAKE FURTHER NOTE if you do not enter data into a field, the LSMW will not record against
that field and you will not be able to load data into that field with this specific recording.
You are now in the Create Recording screen
Figure 10 Create Recording
Click once on the Transaction code XD01
Click on the
pushbutton
Take note that the SAP table names and descriptions have been defaulted against the fields that you entered
data against in the recording of your transaction.
TAKE NOTE It is possible, but rare, that the technical field name has been used more than once
in a recording, for example in 2 different tables. Make sure you change the technical name of the
field, so that it is not the same in both screen input fields, or else the system will not be able to
differentiate the fields.
Click on the
Once the recording is saved, click on the
icon. The system indicates that the data was successfully saved.
icon twice.
You are now in the Legacy System Migration Workbench screen:
page 8
Step 4 - Perform Mapping
Click on the Execute
pushbutton.
You are now in the LSM Workbench: ZPROJECT, SD, CUSTOMERS: SOLD TO PARTY UPLOAD
screen:
Figure 13 LSM Workbench: ZPROJECT, SD, CUSTOMERS: SOLD TO PARTY UPLOAD
Tip - Click on the Numbers on

step is next in the execution of the Recording.
pushbutton. This makes it easier to keep track of which
Tip - The screen above may have more than 14 steps. Click on the Personal Menu
pushbutton.
You are now in the Personal Menu screen:
page 9
Figure 14 Personal Menu
We are only concerned with the steps selected for the purposes of this Tutorial.
Tip - Once we have completed Step 4.14 (14. Run Batch Input session) the LSMW is complete and can be
executed
Tip - Remember if you have more than one upload file for the same Object (i.e. Sold to Party Upload
object), steps 1 to 6 need to be maintained/set up only once, but steps 7 to 14 will have to be revisited for
every upload activity.
Step 4.1 - Maintain object attributes
Maintenance of the object attributes is the first step carried out in the LSM Workbench
Double click on Maintain object attributes or select the radio button and click on the execute
pushbutton
You are now in the LSM Workbench: Display object attributes screen:
page 10
Figure 15 LSM Workbench: Display object attributes
Click on the Display <-> Change
Do not change the Data Transfer selection. However, if you plan to run an LSMW periodically, then
select the Periodic radio button
Select the Batch Input Recording radio button.
Click on the drop down
Select the Recording that you created in Step 3 above.
Click on the Save
Click on the Back arrow
pushbutton
pushbutton in the Recording field
pushbutton. The system will indicate that the data was successfully saved
.
You are now in the LSM Workbench: ZPROJECT, SD, CUSTOMERS: SOLD TO PARTY UPLOAD
screen:
page 11
Take note - the system automatically proceeds to the next radio button.
Step 4.2 - Maintain source structures
The source structures have to be defined before they can be adjusted to the SAP target structures and fields
Double click on Maintain source structures or click on the execute
pushbutton.
You are now in the LSM Workbench: Display source structures screen:
Figure 17 LSM Workbench: Display source structures
Click on the Create
pushbutton
pushbutton.
You are now in the Create source structures screen:
Figure 18 Create source structures
Enter a name in the Source structure field and a description
Click on the Enter
pushbutton.
You are now in the LSM Workbench: Change source structures screen:
page 12
Figure 19 LSM Workbench: Change source structures
Click on the Save
pushbutton. The system will indicate that the data was successfully saved
.

The source fields also have to be defined before they can be adjusted to the SAP target structures and fields
Double click on Maintain source fields or click on the execute
pushbutton.
You are now in the LSM Workbench: Display source fields screen:
Figure 20 LSM Workbench: Display source fields
Click once on the Source Structure
Click on the Table Maintenance
pushbutton
pushbutton.
You are now in the Source fields of source structure SOLD_TO_SOURCE screen:
Figure 21 Source fields of source structure SOLD_TO_SOURCE
Tip - You can drastically reduce the effort of maintaining every field by following the next steps carefully.
Enter only one field name that you maintained data against when you recorded your Transaction code
i.e. BUKRS
Enter Type C
Enter Length 4 (Take note, this usually the length of the Field (i.e. 4), but I always extend it to 60.
Click on the Enter
pushbutton
The system automatically populates the Field Description
page 13
Save the changes by clicking on the Yes pushbutton
again.
TIP - as mentioned above you can drastically reduce the effort of maintaining every field in this step. You
will now go to radio button # 5 Maintain field mapping and conversion rules where all the fields needed to
complete step 4.4 above can be found.
Skip past the radio button # 4 Maintain structure relations.
Double click on # 5 Maintain field mapping and conversion rules or click on the execute
pushbutton.
You are in the LSM Workbench: Display Fieldmapping and conversion rules screen:
Figure 23 LSM Workbench: Display Fieldmapping and conversion rules

page 14
All the fields have been defaulted by the system from the action carried out in Step 4.3.
TIP - During this step we will also maintain the upload file that will be used to populate our data in.
Copy the entire list of Field Names in this screen and Paste the list into an excel sheet.
Your excel sheet will look something like this
Figure 24 Microsoft excel
Now copy this column A and right click in Column B, Cell 1.
Click on Paste Special
Figure 25 Microsoft excel paste special
Then select Transpose
and O.K.
Figure 26 Microsoft excel paste special Transpose
The field names are populated across the worksheet.

page 15
Now copy the field description from the LSMW and paste as above into the spreadsheet
Your upload file should look something like this.
Figure 27 Microsoft excel paste
Delete the entries that run down the columns and save your spreadsheet someplace where you can find
it later.
Now go back to radio button # 3 Maintain source fields.
You are now in the LSM Workbench: Display source fields screen:
Click on the Table Maintenance
pushbutton
pushbutton.
Go to the spreadsheet that you have just created.
Copy the Field Names from the spreadsheet and Paste Special - Transpose onto the spreadsheet. Once
again copy this column.
Your excel sheet will look something like this:
page 16
Figure 30 Microsoft Excel
Now paste into the Field Name column in figure above:
You should see something like this Source fields of source structure SOLD_TO_SOURCE screen:
Before you click on Enter, maintain the same data in the Type and Length fields - C and 60
Take note, if the number of fields you paste exceeds the length of the screen, you must scroll down and
copy and paste the remainder of fields.
Obviously if the field you intend to input is more than 60 characters, you need to lengthen the field
value.
After you have maintained all the fields and clicked on enter, the screen should look something like this
page 17
again.
Step 4.6 - Maintain structure relations
This is a very simple step to perform. You establish the field relationships between the project and the
SAP system
Simple double click step or click on the Execute
pushbutton.
pushbutton
page 18
You are now in the LSM Workbench: Change structure relations screen:
Figure 33 LSM Workbench: Change structure relations
Click on the Save
The exit the screen via the back arrow
pushbutton
Double click on # 5 Maintain field mapping and conversion rules or click on the execute
pushbutton.
You are now in the LSM Workbench: Display Fieldmapping and Conversion Rules screen:
Figure 34 LSM Workbench: Display Fieldmapping and Conversion Rules
Click once on any field, then click on the Change <-> Display
Click on Extras --> Auto Fieldmapping
pushbutton
page 19
Figure 35 Auto Fieldmapping screen dump
You are in the Auto-Fieldmapping: Settings screen.
Figure 36 Auto-Fieldmapping: Settings
Click on the Enter
pushbutton
Auto field mapping is useful in case if fields with identical or similar names/descriptions exist in the source
and target structures. This is particularly the case if data is transferred from one SAP system to another SAP
system.
page 20
You are in the Auto-Fieldmapping: Proposals screen
Figure 37 Auto-Fieldmapping: Proposals
Click on the
Take note - you will click through all the fields specified in the recorded LSMW.
pushbutton until the following screen appears.
Figure 38 Information
Click on the Enter
Click on the Save
Click on the Check syntax
The following message should appear on the bottom of the screen - The conversion program could be
generated successfully.
pushbutton.
pushbutton.
pushbutton.
Step 4.8 - Maintain fixed values, translations, user-defined routines
Ignore # 6 Maintain fixed values, translations, user-defined routines
Step 4.9 - Excel Spreadsheet
It is assumed that you are able populate the spreadsheet with clean data.
Tip - before maintaining the Excel sheet with data, highlight the entire worksheet by clicking on the far top
left-hand corner of the sheet. Now right click and click on Format Cells. Select Text and click on OK.
page 21
This allows numbers to be used in the Excel spreadsheet.
Tip - Before saving the spreadsheet as a Text file, delete the extra sheets from the workbook. There should
only be one sheet per excel file.
If you have copied the descriptions of the field, delete them from the Spreadsheet.
Your spreadsheet will look something like this
Save the Spreadsheet as a Text file
Your Text file will look something like this
Figure 40 Text File
Step 4.10 - Specify files
Select # 7 Specify files radio button.
If you need to load several sheets of data and you use the exact same format, you can reuse this LSMW.
Simply start at # 7 Specify files radio button. You do not need to run through numbers 1 --> 7.
You are in the LSM Workbench: Specify Files (Display) screen:
Figure 41 LSM Workbench: Specify Files (Display)
We assume you have saved the Text file on your own PC. Therefore, double click on the File - Legacy
Data - On the PC (front-end)
pushbutton
The File on Front-end: Edit properties screen appears
page 22
Figure 42 File on Front-end: Edit properties
Search for your Text file via the File Field.
Maintain a description
Select radio button Tabulator
Tick the Field names at the beginning of the file checkbox
The File on Front-end: Edit properties screen should look like this:
page 23
Click on the Enter
Click on the Save
pushbutton
pushbutton and the back
arrow.
Step 4.11 - Assign files
Double click on # 8 Assign files or click on the execute
Click on the Save
pushbutton.
pushbutton
pushbutton and the back
arrow.
Step 5 - Read data
Double click on # 9 Read data or click on the execute
pushbutton.
The LSM Workbench: Read Data for ZPROJECT, SD, CUSTOMERS screen is displayed
Figure 44 LSM Workbench: Read Data for ZPROJECT, SD, CUSTOMERS
Click on the Execute
pushbutton.
The LSM Workbench: Read Data for ZPROJECT, SD, CUSTOMERS screen is displayed
The screen above displays the number of records that the Text file consists of. Check this number to
the number of lines in the excel spreadsheet. There should be one extra line in the spreadsheet, which is
the line containing the SAP Field names.
Click on the back
arrow twice
Step 5.1 - Display read data
Double click on # 10 Display read data or click on the execute
pushbutton.
page 24
The Display Read Data screen is displayed
Figure 46 Display Read Data
Click on the Enter
pushbutton.
The LSM Workbench: Display Read Data screen is displayed
Figure 47 LSM Workbench: Display Read Data
Take note, for this Tutorial, only one record has been loaded.
Click on the record (s) and verify that the data is correct.
The LSM Workbench: Display Read Data screen is displayed
The above display is per record
Click on the back arrow
twice.
Step 6 - Convert data
Double click on # 11 Convert data or click on the execute
pushbutton.
The LSM Workbench: Convert Data for ZPROJECT, SD, CUSTOMERS is displayed
page 25
Figure 49 LSM Workbench: Convert Data for ZPROJECT, SD, CUSTOMERS
Click on the execute
pushbutton.
The LSM Workbench: Convert Data for ZPROJECT, SD, CUSTOMERS is displayed
The above screen displays the number of records, read and converted.
twice.
Step 6.1 - Display converted data
Double click on # 12 Display converted data or click on the execute
pushbutton.
The Display Converted Data screen is displayed
Figure 51 Display Converted Data
Click on the Enter
pushbutton.
The LSM Workbench: Display Converted Data screen is displayed
page 26
Figure 52 LSM Workbench: Display Converted Data
Click on the converted data record (s) and verify that the data is correct.
The LSM Workbench: Display Converted Data screen is displayed
twice.
Step 7 - Create batch input session
Double click on # 13 Create batch input session or click on the execute
pushbutton.
The LSM Workbench: Create Batch Input Session screen is displayed
Figure 54 LSM Workbench: Create Batch Input Session
Click on the execute
pushbutton.
The following Information screen is displayed
page 27
Click on the Enter
pushbutton.
Step 7.1 - Run batch input session
Double click on # 14 Run Batch Input session or click on the execute
pushbutton.
The Batch Input: Session Overview screen is displayed
Figure 56 Batch Input: Session Overview
Highlight the Session name and click on the Process
pushbutton
The Process Session CUSOTMER screen is displayed
Figure 57 Process Session CUSOTMER1
Select Run mode - Display errors only
Click on the Process
pushbutton
The Information screen is displayed
The batch session is complete
Click on the Session overview
pushbutton
The Batch Input: Session Overview screen is displayed

page 28
The batch session is no longer visible.
Click on the
back arrow.
You have successfully migrated data from a non-SAP system to SAP.
Glossary of Terms
Legacy system this term indicates a non-SAP system. However, it usually also refers to the current system
(old) which is being replaced.
R/3 System this term is commonly used when referring to a SAP system.
The project serves as an organizational unit used to combine mapping and field assignments
A subproject is an organizational unit subordinated to the project
An object is a unit (Business Object) combined from the business point of view, which is used to transfer the
data of a project to the SAP system.
page 29
Table of Figures
Figure 2 Create Project
Figure 3 Create Subproject
Figure 4 Create Object
Figure 6 Recordings of project ZPROJECT
Figure 7 Recordings of project ZPROJECT: Overview
Figure 8 Transaction code
Figure 9 Create Customer: Initial screen
Figure 14 Personal Menu
10
Figure 15 LSM Workbench: Display object attributes
11
12
Figure 17 LSM Workbench: Display source structures
12
Figure 18 Create source structures
12
Figure 19 LSM Workbench: Change source structures
13
13
13
page 30
14
Figure 23 LSM Workbench: Display Fieldmapping and conversion rules
14
15
Figure 25 Microsoft excel paste special
15
Figure 26 Microsoft excel paste special Transpose
15
Figure 27 Microsoft excel paste
16
16
16
Figure 30 Microsoft Excel
17
17
18
Figure 33 LSM Workbench: Change structure relations
19
Figure 34 LSM Workbench: Display Fieldmapping and Conversion Rules
19
Figure 35 Auto Fieldmapping screen dump
20
Figure 36 Auto-Fieldmapping: Settings
20
Figure 37 Auto-Fieldmapping: Proposals
21
21
22
Figure 40 Text File
22
Figure 41 LSM Workbench: Specify Files (Display)
22
23
24
24
24
Figure 46 Display Read Data
25
25
25
26
26
Figure 51 Display Converted Data
26
27
27
Figure 54 LSM Workbench: Create Batch Input Session
27
27
28
Figure 57 Process Session CUSOTMER1
28
28
29
page 31

LSMW Tutorial

Caricato da

Informazioni sul documento

Titolo originale

Copyright

Formati disponibili

Condividi questo documento

Condividi o incorpora il documento

Opzioni di condivisione

Hai trovato utile questo documento?

Questo contenuto è inappropriato?

Copyright:

Formati disponibili

LSMW Tutorial

Caricato da

Copyright:

Formati disponibili

LSMW - Tutorial

Legacy System Migration Workbench

Legacy System Migration Workbench

BAPIs (Business Application Programming Interfaces)

IDocs (Intermediate Documents)

Read data (legacy data in spreadsheet tables and/or sequential files).

Convert data (from the source into the target format)

Import data (to the database used by the SAP application).

Introduction to the LSMW Tutorial

Step 1 - LSMW Initial screen

Enter the transaction code LSMW

Confirm your entry with Enter

You are now in the Legacy System Migration Workbench screen:

Figure 1 Legacy System Migration Workbench

Step 2 - Create a Project, Subproject and Object

You are now in the Create Project screen

Figure 2 Create Project

Enter a suitable Project name, such as ZPROJECT

Enter a suitable Project description.

Click on the Enter

Step 2 .2 - Create a Subproject

Figure 3 Create Subproject

A subproject is an organizational unit subordinated to the project

Enter a suitable subproject name, such as SD

Enter a suitable subproject description, such as SALES & DISTRIBUTION SUBPROJECTS.

Click on the Enter

Step 2 .3 - Create an Object

Figure 4 Create Object

Enter a suitable Object name, such as CUSTOMERS

Enter a suitable object description, such as SOLD TO PARTY UPLOAD

Click on the Enter

You have successfully created an LSWM Project, subproject and object.

Step 3 - Record the Customer Master Creation transaction

Click on the Goto Recordings

Figure 5 Legacy System Migration Workbench

Figure 6 Recordings of project ZPROJECT

icon to name and create a new recording.

You are now in the Recordings of project ZPROJECT: Overview screen

Figure 7 Recordings of project ZPROJECT: Overview

Enter a suitable Recording name

Enter a suitable Description

Your SAP logon name will default as the owner name

Click on the Enter

You are now in the Transaction code screen

Figure 8 Transaction code

Enter the transaction code to create a Customer Master - XD01

Click on the Enter

You are now in the Create Customer: Initial screen

Figure 9 Create Customer: Initial screen

You are now in the Create Recording screen

Figure 10 Create Recording

Click once on the Transaction code XD01

Figure 11 Create Recording

Once the recording is saved, click on the

You are now in the Legacy System Migration Workbench screen:

Figure 12 Legacy System Migration Workbench

Step 4 - Perform Mapping

Click on the Execute

Figure 13 LSM Workbench: ZPROJECT, SD, CUSTOMERS: SOLD TO PARTY UPLOAD

Tip - Click on the Numbers on

pushbutton. This makes it easier to keep track of which

Figure 14 Personal Menu

Figure 15 LSM Workbench: Display object attributes