You are on page 1of 25

Page

:
China Business Legacy System Migration Workbench
Filename:
Development Guide Page 1 of 25
395939844.doc

Legacy System Migration Workbench
Development Guide
Author: SUNLU
Date: 15/Mar/2006

©
2006 YIHAI Group

Page:
China Business Legacy System Migration Workbench
Filename:
Development Guide Page 2 of 25
395939844.doc

Change History
Enter information about changes made to this section of the document
Date Modified Modified By Brief Description of Changes

Review History
Enter information about changes made to this section of the document
Date Reviewed By Brief Review Comments

Final Approval and Sign Off
The undersigned hereby approves and accepts the attached document on behalf of Yihai.

Name: ……………………………………

Title: ……………………………………

Date: ……../……../……..

©
2006 YIHAI Group

........................................ 4 ORGANIZATIONS INVOLVED IN THE PROJECT............................................................. 25 DATA CONVERSION......................... 10 DATA MAPPING.............. SUB-PROJECT AND OBJECT.................................................. 26 Display read data................................... 22 Assign files.........................................................................................................................................................................................................9 PROGRESS LSMW STEPS.................................... 4 KEY CONTACTS...................................6 Project.................................................................................................................................................................................................................................................................................. 10 Maintain objet attribute........................................................................................................................................................................................................................................................................................................................................................................................................................................................................................... 15 Miantain field mapping and conversion rules................................................................................................................... 13 Maintain structure relations........................................................................................................................................................................................................... 4 ORGANIZATIONAL INFORMATION.............................. 29 Display converted data. 4 Contact Numbers..................................................................... Page: China Business Legacy System Migration Workbench Filename: Development Guide Page 3 of 25 395939844.................. 5 PREPARE LSMW PROJECT....................................................4 LSMW OVERVIEW.................................................................8 PREPARE LEGACY SYSTEM DATA FILE.........................................................................................................16 Specify files..................................................................................................... 10 Maintain source structure...................................................................................... 26 Read data..................................................................................................................................................................................................................................... 30 Data Import................doc Table of Contents PURPOSE OF THIS DOCUMENT.................................................................. 12 Maintain source fields................................... Sub-Project............................ Object Naming rule................................................................. 6 DEFINE PROJECT......4 PROJECT TEAM CONTACT DETAILS................................................................................................ 28 Convert data...................................................... 4 PROJECT LOCATION........... 32 © 2006 YIHAI Group ...............................

doc Purpose of This Document This document is a demonstration of Legacy System Migration Workbech used at the data migration phase from legacy system to SAP System. Key Contacts Name Team Email Address sunlu IT Team Member 021-610060068238 sunlu@yihai.com Organizational Information Project Location Project Name YYH Company Name YIHAI Group Address Project Office Phone Project Office Fax Organizations Involved in the Project Organization Name Role in Project Contact Address Telephone © 2006 YIHAI Group . Page: China Business Legacy System Migration Workbench Filename: Development Guide Page 4 of 25 395939844.

LSMW provides Data Conversion and Data Import to SAP System. Conversion Rules. Data Conversion and Data Import.  Source Structure Definition  Structure Relationship between Legancy and Target  Field Assignments  Conversion rules 3) Progress the Data Import step. Another advantage of LSMW is that IDoc is supported as import method. Page: China Business Legacy System Migration Workbench Filename: Development Guide Page 5 of 25 395939844. IDoc can be used almost all data objects.doc LSMW Overview Data Migration from Legacy System to SAP System consists Data Export. LSMW does not provide Data Export from Legacy System. © 2006 YIHAI Group . Field Assignments. 2) Progress the Data Conversion step. Dat Coversion is relevant step. Structure Relationships. Data Conversion step consists Source Structure Definition. One of the advantages of LSMW is that it is easy to convert the Legacy Data file to SAP format file step by step. LSMW scope Data Export Data Conversion Data Import *Source Structure Definitions -Batch/Direct Input *Structure Relationships -Call Transaction *Field Assignments -IDoc *Conversion rules -BAPI Legacy Legacy Data file Read Data Converted Data SAP (extracted file) (intermediate file) (SAP format) System Database Read Data Convert Data Out of scope List of steps required executing LSMW 1) Make the Legacy data file ready beforehand. Read Data and Convert Data.

Sub-Project.Initial Screen of LSMW 2. ZUPD001) Naming for YYH Project © 2006 YIHAI Group . Obejct are entered Project. Sub-Project and Object To start data migration process from legacy system to SAP system. Sub-Poject. Sub-Project and Object in the first of LSMW(T-cd:LSMW). Project. it is required to define Project.doc Prepare LSMW Project Define Project. Page: China Business Legacy System Migration Workbench Filename: Development Guide Page 6 of 25 395939844. Object Naming rule Project: YYH Sub-Project: Team Name (MM) Object: Program ID (eg. 1.

Legacy system data file needs to be transferred to SAP server by FTP or other methods in advance.For the first time. All data import steps are displayed. This file is checked by using Transaction AL11.doc Project: YYH Sub-Project: Team Name (MM) Object: Program ID (eg. © 2006 YIHAI Group . Check Attribute. Please refer to Appendix. Progress LSMW Steps Data Mapping Maintain objet attribute 1. ZUPD001) Prepare Legacy System Data File It is required to prepare Legacy System Data File extracted from Legacy System as a physical file. The file structure needs to be one source structure (not hierarchical structure). Page: China Business Legacy System Migration Workbench Filename: Development Guide Page 7 of 25 395939844. 2. And select import method below. Tab-delimited or sequential file format are recommended. Example of Legacy Data File.

it is required writing Source structure name and Description. The cursor moves to this step.doc Maintain source structure 1. The cursor moves to Maintain source structure. Page: China Business Legacy System Migration Workbench Filename: Development Guide Page 8 of 25 395939844. Time and User of previous step is recorded. 2. Date. And there is only Start Direct Input program item because of selection of import method in previous step. © 2006 YIHAI Group . Next step of Maintain object attribte. To create source structure.

Date. And click to start editing in block. Time and User of previous step is recorded. Page: China Business Legacy System Migration Workbench Filename: Development Guide Page 9 of 25 395939844. © 2006 YIHAI Group . Time. Maintain source fields 1. Execution Date. Then save and go back. The cursor moves to this step. Set the cursor on DOCU field. 2. Check the Source structure is generated as below. Next step of Maintain source structure. User is recorded. The cursor moves to Maintain source fields.doc 3.

© 2006 YIHAI Group . 4. Then save and go back.doc 3. Page: China Business Legacy System Migration Workbench Filename: Development Guide Page 10 of 25 395939844. Type. Input Field name. Length and Field description all together. Check the Source fields are generated as below.

1. And click on toassign source structure. Time. © 2006 YIHAI Group . User is recorded. Page: China Business Legacy System Migration Workbench Filename: Development Guide Page 11 of 25 395939844. Next step of Maintain source structure. Execution Date.doc Maintain structure relations 1. Set the cursor on target structure. Time and User of previous step is recorded. There is data structure of target data object previously defined. Date. The cursor moves to Maintain source fields. The cursor moves to this step.

doc 2. Assign the legacy file structure to the target data structure. © 2006 YIHAI Group . Page: China Business Legacy System Migration Workbench Filename: Development Guide Page 12 of 25 395939844.

To assign source field. The cursor moves to this step. Page: China Business Legacy System Migration Workbench Filename: Development Guide Page 13 of 25 395939844. 2. set the cursor on the target field and click on . Date. Next step of Maintain source structure. User is recorded. The cursor moves to Maintain source fields. Time. © 2006 YIHAI Group . Execution Date.doc Miantain field mapping and conversion rules 1. Time and User of previous step is recorded.

Select source field from popup window. Check the source field is assign. © 2006 YIHAI Group . 4. another popup window comes up. If source field’s type is DATE(DDMY). And its default conversion rule is Transfer(MOVE).doc 3. Page: China Business Legacy System Migration Workbench Filename: Development Guide Page 14 of 25 395939844.

© 2006 YIHAI Group . set the cursor on the target field and click on . Page: China Business Legacy System Migration Workbench Filename: Development Guide Page 15 of 25 395939844. Then popup window is coming up. Select a rule. To set a rule.doc 3. Please refer to Appendix. These rules detailed description is in the Appendix. 3.

Execution Date. Page: China Business Legacy System Migration Workbench Filename: Development Guide Page 16 of 25 395939844.lsmw. Time. set the cursor on Legacy data field. Date.read(.conv) by default. 4. To secify the Legacy file. And Converted Data file will be used in creating Bacth Input session. Next step of Maintain source structure. But LSMW bug cases these parameter does not appear here.doc Specify files 1. The cursor moves to this step. Input required parameters according to Legacy file structure. Read Data file name and Converted Data file name are “Project Name”_”Sub-Project Name”_”Object Name”. © 2006 YIHAI Group . And click on . The cursor moves to Maintain source fields. User is recorded. 2. Time and User of previous step is recorded.

Next step of Maintain source structure. Date. © 2006 YIHAI Group . The cursor moves to Maintain source fields. Assign files 1. Time and User of previous step is recorded.doc 5. Check the Legacy data file is assigned. Page: China Business Legacy System Migration Workbench Filename: Development Guide Page 17 of 25 395939844.

If Legacy file is only one. Time and User of previous step is recorded. User is recorded. Time.doc The cursor moves to this step. Data Conversion Read data 1. The cursor moves to this step. Next step of Maintain source structure. © 2006 YIHAI Group . Execution Date. User is recorded. Execution Date. Date. file is already assigned. 2. The cursor moves to Maintain source fields. Time. Page: China Business Legacy System Migration Workbench Filename: Development Guide Page 18 of 25 395939844.

input nothing and just click execute button(F8). Both options are selected by default and leave them as they are 3. Page: China Business Legacy System Migration Workbench Filename: Development Guide Page 19 of 25 395939844. © 2006 YIHAI Group . the number of read/written records and so on. written file. There are executiong date/time. input nothing and just click execute button. read file(s). Input numbers of records to be read.doc 2. If select all. If all records must be read. Status of reading legacy file is below.

Page: China Business Legacy System Migration Workbench Filename: Development Guide Page 20 of 25 395939844. The cursor moves to this step. User is recorded. input nothing and execute. Next step of Maintain source structure. © 2006 YIHAI Group . Execution Date. The cursor moves to Maintain source fields. Time. 3.doc Display read data 1. Date. Input line range. Time and User of previous step is recorded. 2. If all lines shoule be displayed. Read data file is below.

If all lines should be displayed. Input record number to be converted. Conversion status log is below. Date. Time and User of previous step is recorded. Execution Date. © 2006 YIHAI Group . The cursor moves to this step. Next step of Maintain source structure. 2.doc Convert data 1. input nothing and execute. The cursor moves to Maintain source fields. 3. Page: China Business Legacy System Migration Workbench Filename: Development Guide Page 21 of 25 395939844. User is recorded. Time.

input nothing and execute. Page: China Business Legacy System Migration Workbench Filename: Development Guide Page 22 of 25 395939844. User is recorded. © 2006 YIHAI Group . Input line range. Time.doc Display converted data 1. Execution Date. The cursor moves to this step. If all lines shoule be displayed. Converted data file is below. 2. 3.

Page: China Business Legacy System Migration Workbench Filename: Development Guide Page 23 of 25 395939844.doc © 2006 YIHAI Group .

Batch Input Recording is showed © 2006 YIHAI Group . Page: China Business Legacy System Migration Workbench Filename: Development Guide Page 24 of 25 395939844. BI is used in this demonstration. The number of steps of Data Import Session is depend on Import Method selected at Data Mapping – Maintain object attribute. Business Object Method(BAPI) and Batch Input Recording. For this case. Direct Input(DI). LSMW supports Batch Input(BI). Call Transaction(CT).doc Data Import This session is data import from converted data on application server. Intermidiate Document(Idoc).

Page: China Business Legacy System Migration Workbench Filename: Development Guide Page 25 of 25 395939844. © 2006 YIHAI Group .doc .