Professional Documents
Culture Documents
LSMW
Legacy System Migration
Workbench
Legacy System Migration Workbench
1 PrepareMe
2 TellMe
3 ShowMe
4 LetMe
5 HelpMe
LSM Workbench
1 PrepareMe
2 TellMe
3 ShowMe
4 LetMe
5 HelpMe
What is Data migration?
2 TellMe
3 ShowMe
4 LetMe
5 HelpMe
What is LSMW?
The import technique to be used in an individual case, depends on the business object as
well as on the availability of standard input programs
Structured way of working, because you have to finish every step before starting the next
step
Graphical representation
Pre-requisites for LSMW
2. BAPI’s
4. Batch Input
2 TellMe
3 ShowMe
4 LetMe
5 HelpMe
Getting Started
Here is an example showing the way to use the conversion tool LSMW in SAP.
It starts in the start-up screen of LSMW transaction and ends with a screen on
which the results of the conversion are displayed
If you want to create or change objects, make sure that you are working in
change mode. To activate this mode, click Change in the corresponding
processing step. Only this mode provides all functions required for changing
objects
Step 1 - Enter transaction LSMW
Enter the transaction code (LSMW) or add this transaction to your favourites (right-click
with your mouse on the Favourites map in the start menu and choose Insert transaction,
type lsmw and press enter), since LSMW is an additional transaction, it is not available in
the standard SAP menu.
Step 2 – project, subproject, objects
Subproject Object
In the method to
input data from a
BAPI, one needs
to select the
Business Object
and the
corresponding
method.
Application Toolbar in Process steps
User Menu: Here you can make an individual selection from the displayed processing steps.
Pressing button ‘Main steps’ automatically activates all processing steps mandatory for a data
conversion.
Numbers On or Off: You can activate or deactivate the numbering of the individual processing
steps.
Double click = Display or Double click = Change: Here, you can determine whether display mode
or change mode is selected by double clicking.
Object overview: Displays all object information for the selected object.
Information includes object information, source structures, target structures, structure relations,
source fields, target fields, field mapping.
Action log: Displays a detailed overview for all processing steps already carried out. You can
reset the action log via the menu path Extras -> Reset Action Log. This action is stored with a
reference to the user and the date.
Maintain Source structures
In the step ‘Maintain Source Structures’ you define the structures of the object
with name, description and the hierarchical relationships:
Click on Change button. You can now define, change, reassign or delete
structures. All these functions are available via pushbuttons.
When you define more than one structure, a popup is displayed querying the
relations between the structures: equal/subordinate?
Note: For migration objects created via transaction recording, you may only
define one structure per recording, since only one flat target structure per
recording is available.
Maintain source fields
In the step ‘Maintain Source Fields’, fields are created and maintained for the
source structure defined in the preceding step
Use source fieldnames with the same names as the target fieldnames as much as
possible, because it allows you to use the ‘auto-field mapping’ function in step 5
‘Maintain field mapping and conversion rules’.
Maintain source fields
Different possible ways of defining and maintaining the
source fields:
Make sure that you are in change mode and the cursor is positioned on a source
structure or an existing source field
1. Create Individual source fields - By clicking on the button ‘Create source field’ you can
specify the field name, field label, field length and field type
During data read, you can specify whether date values are converted into the internal
date format (YYYYMMDD) and amount fields are converted into the calculation format
(1234.56)
‘Selection Parameter’ can be set during Read/Convert data. If you select this indicator,
the corresponding field is made available as selection parameter when reading or
converting data.
2. Maintain Source Fields in Table Form – Clicking on the ‘Table Maintenance’ button
displays the fields in a tabular format.
Maintain source structure… contd
• 3. Copy Source Fields from Other Sources : By selecting ‘Copy Source Fields’ displays
the following options:
- Upload (Text separated with Tabs) – The source field description is stored in a text file
the columns of which are separated by tabs
- Copy from Another Object – Source field can be copied from source structure of
another object
- Copy from Data Repository – Source field can be copied from a structure in SAP Data
Repository
- From Data File (Field Name in 1 Line) - Source fields can be copied from a data file
which should be stored on the PC in the form of text separated by tabs and contain the
fields in the first line.
Maintain structure relations
If you want to change the relation, remove the existing relation first. In addition,
you can use Check to check the structural relationships for errors
Maintain Field mapping & conversion rules
• In the step ‘Maintain Field Mapping and Conversion Rules’, you assign source
fields to target fields and define how the field contents will be converted
• All fields of target structure, which you selected in the previous step, will be
displayed.
Layout determination
By clicking this button, after clicking once on a target field (in blue), LSMW
displays the list of available source fields, by choosing one the standard rule ‘move’ is
used to link the 2 fields
By clicking this button, after clicking once on a target field (in blue), the source
field is deleted from the target field
By clicking this button, the display of this step can be changed. There are
possibilities to show or hide several aspects of the field mapping
By clicking this button, a syntax check is performed for the conversion program,
generated from the field mapping
These 3 buttons, which are available for every target field, display the help
function (‘I’), the possible entries (?) and the last one displays the documentation in LSMW
Maintain Fixed values, translations…
Fixed value: Here you can specify the length, type flag for
lowercase/uppercase and value in addition to the name of the field.
Translation: Here you can enter information on the source field and the
target field. If you are creating a new translation you have to save data
first before you can change it
If your legacy data is on the PC: In change mode, position the cursor on the line ‘Legacy data
On the PC (Front-end)’. Select Add entry. A popup is displayed. Specify file path, file name and
description and other properties
If your legacy data is on the R/3 server: In change mode, position the cursor on the line ‘
Legacy data On the R/3 server (application server)’. Select Add entry. A popup is displayed.
Specify file path, file name and description and other properties
File for Imported data: Here, the file name is entered with file extension ’.lsmw.read’.
File for Converted data: Here, the file name is entered with file extension ’.lsmw.conv’. This
file
will contain all your converted data after applying the conversion rules if any.
Process Step – Assign File
In the step ‘Assign Files’, you can assign the file name in step 7 declared as source file to the target
structure defined in step 2 .
If you click on the Assign File button, after clicking once on a target structure (in yellow), LSMW
displays the list of available source files.
If you click on the Delete Assignment button, after clicking once on a target structure (in yellow), the
source file is deleted from the target structure.
Process step – read data
In the step ’Read Data’, the file specified in previous step is, as linked to the target
structures in . Even though you can select a range of transaction numbers, the whole
file is being read, only the amount of transactions written is influenced. So for tests it is
easier to read all data and convert only a certain range, because in that step the
program stops after finishing the range.
Process Step – Display read data
In the step ‘Display Read Data’, you can display the read data, choosing to show all
read data or an interval as shown above. The data are shown as the source structures,
in case more source structures are being used in one transaction, the hierarchy of the
transaction is displayed by the use of a different colour legend. By clicking on one of
the lines, you proceed to the field level of the line, where you can check the read data
as shown below.
Process Step – Convert data
In the step ‘Convert Data’, works like the step ‘read data’, but uses the conversion
program instead of the read program. You can define a range of transactions to be
converted, at the end of this range the conversion program stops running.
Note: It is recommended that when you load big amount of data in production, load
the first 10 records so that you can check and change when necessary.
Process Step - Display converted data
In the step ‘Display Converted Data’, you can display the converted data, choosing
to show all converted data or an interval as shown above. The data are shown as the
target structures, in case more target structures are being used in one transaction,
the hierarchy of the transaction is displayed by the use of a different colour legend.
By clicking on one of the lines, you proceed to the field level of the line, where you
can check the converted data as shown below.
Process Step
After the step ‘Display Converted Data’ the exact content of the next steps may differ,
depending on the import technique that you have chosen in step 1. The steps displayed by
the program for the different import techniques are:
BAPI or IDoc:
Start IDoc creation
Start IDoc processing
Create IDoc overview
Start IDoc post-processing
LSM Workbench
1 PrepareMe
2 TellMe
3 ShowMe
4 LetMe
5 HelpMe
Practical LSM Workbench
Exercise 1
Create LSMW object and upload Vendor Master data to SAP
• Specifications:
Object : 0050 - Customer Master
Method : 0000
Program Name: RFBIDE00
Program Type :B
Using Direct Input method
FLAT_FILE
Using Direct input method
• Step 16: Assign files
The structure XD02S is correlated with the specified
file.
Using Direct input method
• Step 17: Read data from legacy files.
Using Direct input method
• Step18: Display the read data
Using Direct input method
• Step 19: Create batch input session
Using Direct input method
Recording
overview
key
Using Batch Input Method
• Recording..
During the recording the system calls the transaction code
XD02 and prompts you to complete the Change.
Select at
least one
area of
processing .
Using Batch Input Method
• Recording
Default values
Using Batch Input Method
• Process recording
- Replace the default values in the previous slide with Field
names.
- Double click on each of the lines to effect the change.
Using Batch Input Method
The fields
specified in
the recording
Fields part of
are displayed
the structure
available with
Standard
Object 0050
Using BAPI in LSM Workbench
Using BAPI in LSM Workbench
2 TellMe
3 ShowMe
4 LetMe
5 HelpMe
HelpMe
Object Overview
Complete overview of Data Migration object can be obtained from the Menu:
Extras Object Overview
Click on the Activate IDoc Inbound Processing button after entering all the
details above.
HelpMe
To transport data migration objects
This can be done in 2 ways:
• By generating a change request or
• By import/export of a project from one system to another