Académique Documents
Professionnel Documents
Culture Documents
IndustriesIndustries
SupportSupport
TrainingTraining
CommunityCommunity
DeveloperDeveloper
PartnerPartner
AboutAbout
Search
o
o
o
o
o
o
o
Home / Community /Blogs
Actions
Getting started with the S/4Hana Migration Cockpit
(OnPremise)
February 28, 2017 | 8,930 Views |
Jrg Knaus
more by this author
SAP S/4HANA migration cockpit
SAP S/4HANASAP S/4HANA migration object modeler
share 1
share 1
tweet
share 74
like8
Follow
Overview
The S/4HANA Migration Cockpit is available from S/4HANA Release 1610 in the OnPremise
Version.
As it is the first Version, i dont have too much expectations, but i am sure we will see very
interesting updates in the future.
Basically, it is a Web Based Tools to migrate Legacy Data into S/4HANA. It allows to Download
predefined Excel Sheet-Templates, so you can easily extract legacy data into this format and
upload in S/4HANA by using the Migration Cockpit. Basic Mapping Functionality is provided (e.g.
Map Unit of Measure Codes and so on) but dont expect too much here yet.
Target group seems to be smaller and medium businesses (SMB). The handling of the Import
Process and Validations are made very easy (cloud style)
To Import the Data, the SAP Standard BAPIs are used. There is an error Log provided with
information on Warnings or Errors.
Existing Documentation
Added 6.7.2017:
SAP Help
https://help.sap.com/doc/PRODUCTION/bf1d5c82ea1c45ba8f1d7d1f7757f04d/1610%20001/en-
US/frameset.htm?8f97f0b407024465a283809f0bbe000c.html
https://help.sap.com/doc/PRODUCTION/bf1d5c82ea1c45ba8f1d7d1f7757f04d/1610%20001/en-
US/frameset.htm?9a02076c76354f6a93aefc9bdf943e68.html
Best Practice Explorer S/4Hana OnPremise, Data Management:
Business Object
Area Business Object Type Migration Cockpit Object Name Technical Object Name
Name
Migration of Customer
Customer Master FI, SD Master data SIF_CUSTOMER
(FILE2S4)
FI, MM-
Vendor Master Master data Migration of Vendor (FILE2S4) SIF_VENDOR
PUR
Migration of Materials
Material Master LO-MD Master data SIF_MATERIAL
(FILE2S4)
QM, SD,
Batches Master data Migration of Batches (FILE2S4) SIF_BATCHES
PP-PI
Migration of Equipment
Equipment PM Master data SIF_EQUIPMENT
(FILE2S4)
Migration of Functional
Functional Location PM Master data SIF_FUNC_LOC
locations (FILE2S4)
Migration of Characteristics
Characteristics CA Master data SIF_CHARACT
(FILE2S4)
Migration Process
In the first Screen you can create or open a Migration Project.
then you can activate one or multiple migration objects
Now Open the Migration Object
all actions are performed in background (as a batch-job/SM37), but you can wait until process is
finished 100 % and then immediately see the results or let it run in background and come back later.
Excel Format
The Excel Templates are in XML Format
it looks like this
<?xml version=1.0?>
<?mso-application progid=Excel.Sheet?>
<Workbook xmlns=urn:schemas-microsoft-com:office:spreadsheet
xmlns:o=urn:schemas-microsoft-com:office:office
xmlns:x=urn:schemas-microsoft-com:office:excel
xmlns:dt=uuid:C2F41010-65B3-11d1-A29F-00AA00C14882
xmlns:ss=urn:schemas-microsoft-com:office:spreadsheet
xmlns:html=http://www.w3.org/TR/REC-html40>
<DocumentProperties xmlns=urn:schemas-microsoft-com:office:office>
<Title>MATERIAL</Title>
<Author>HHE</Author>
<LastAuthor>Heiko Herrmann</LastAuthor>
<Created>2017-01-03T00:00:00Z</Created>
<LastSaved>2017-02-08T14:11:35Z</LastSaved>
<Company>HHE</Company>
<Version>16.00</Version>
</DocumentProperties>
<CustomDocumentProperties xmlns=urn:schemas-microsoft-com:office:office>
<APPLICATION dt:dt=string>SLO</APPLICATION>
<OBJECT_NAME dt:dt=string>MATERIAL</OBJECT_NAME>
<LANGUAGE dt:dt=string>D</LANGUAGE>
</CustomDocumentProperties>
<OfficeDocumentSettings xmlns=urn:schemas-microsoft-com:office:office>
<AllowPNG/>
<Colors>
<Row ss:AutoFitHeight=0>
https://msdn.microsoft.com/en-us/library/aa140066(v=office.10).aspx
https://wiki.scn.sap.com/wiki/display/Snippets/XML+TAGS+simplifies+Excel+Download
i faced problems with SPACE for empty columns, they should be <null> otherwise the ss:Index gets
confused and the Values are linked to the wrong columns when importing into the migration cockpit,
even if they are in correct order
Import Processing
It helps if you are familiar with the Standard BAPI Structures and SAP Input Data (for example how
to create a material master)
Abap Skills are not required, but ABAP Debugging skills are useful for the Root Cause Analysis in
cases where the Error Log isnt enough.
The BAPI used for the Data Inport can be found in Transaction LTMOM
you can also see how the input fields are mapped.
currently i was not able to change the standard mappings, i can only add customer fields.
you can set an external Breakpoint (external as the import is always performed by a batch job)
here you can also save the data (after mapping/conversion) as testdata for SE37 (right click on
toolbox) if you need to do some troubleshooting
in some cases i added an implicit enhancement at begin of function (ABAP Enhancement Concept)
in the importing BAPI to change the conversion.
if you come from LSMW or other ABAP Migration Tools you will find yourself familiar shortly.
Fugr /1LT/S4H500000000000003
INCLUDE /1LT/LS4H500000000000003U01.
/1LT/S4HIL_500000000000003
INCLUDE /1LT/LS4H500000000000003U02.
/1LT/S4HOLC_500000000000003
INCLUDE /1LT/LS4H500000000000003U03.
/1LT/S4HOLO_500000000000003
INCLUDE /1LT/LS4H500000000000003U04.
/1LT/S4HACS_500000000000003
FUNCTION /1LT/S4HIL_500000000000003.
*
**Lokale Schnittstelle:
* IMPORTING
* VALUE(IM_ALLOG) TYPE DMC_ALLOG OPTIONAL
* VALUE(IM_DEBUG) TYPE BOOLEAN OPTIONAL
* VALUE(IM_DEBUG_LEVEL) TYPE CHAR1 OPTIONAL
* VALUE(IM_TEST_MODE) TYPE BOOLEAN OPTIONAL
* VALUE(IM_ROLLBACK) TYPE BOOLEAN OPTIONAL
* VALUE(IM_VALIDATE) TYPE BOOLEAN OPTIONAL
* EXCEPTIONS
* INSERT_IT_ERROR
* LOG_ERROR
* STOPPED_BY_RULE
*
* Project : ZSIN_MIG_001
* Subproject : ZSIN_MIG_001
* Migration Object : Z_MATERIAL_001
* Layer : Conversion layer
* Generated : 13.02.2017 07:53:07 by SENS_MM
*
* Generate time related processing = X
* Generate interlinkage processing =
* Generate IMPORT FROM MEMORY =
* Generate EXPORT TO MEMORY =
* Generate LDU initialize =X
* Generate Call next function module =
*
*** <__UNIT_0001__> ************************************
*** Targetstructure : HEADER
*** Primary relation source : S_MARA
*** Primary relation type : 1:1
*** Primary relation number : 0001
********************************************************
* CONVERSION: call BEGIN OF LOOP routine
* CONVERSION: Primary relation read
init receiver work area
CLEAR _WA_HEADER.
LOOP AT _IT_S_MARA
INTO _WA_S_MARA
.
CLEAR _actual.
_actual-sstruct1 = S_MARA.
_actual-sddicname = .
* CONVERSION: Init receiver work area
CLEAR _WA_HEADER .
CLEAR l_mapping_error.
* CONVERSION: Init SKIP_TRANSACTION
_FLG_SKIP_TNX_ = FALSE.
* CONVERSION: Increment transaction count
<TNX_COUNT> = <TNX_COUNT> + 1.
* CONVERSION: init SKIP_RECORD flag
_FLG_SKIP_REC_ = FALSE.
ENDIF.
* CONVERSION: call BEGIN OF RECORD routine
PERFORM _BEGIN_OF_RECORD_0001_.
* CONVERSION: call field processing routine
IF _FLG_SKIP_REC_ = FALSE.
PERFORM _CONVERT_0001_.
ENDIF.
* BWP: Increment record count
HEADER_NO = HEADER_NO + 1.
IF _FLG_SKIP_REC_ = FALSE.
FORM _CONVERT_0002_.
* RECEIVER: NOAPPLLOG
PERFORM _RULE_MOVE_OP
USING
_WA_VI0001_NOAPPLLOG-NOAPPLLOG
X.
ENDFORM.
FORM _CONVERT_0003_.
* RECEIVER: FUNCTION
PERFORM _RULE_MOVE_OP
USING
_WA_T01_HEADDATA-FUNCTION
INS.
* RECEIVER: IND_SECTOR
PERFORM _RULE_CVT_MBRSH_S
USING
_WA_T01_HEADDATA-IND_SECTOR
_WA_S_MARA-MBRSH.
* RECEIVER: MATL_TYPE
PERFORM _RULE_CVT_MTART_S
USING
_WA_T01_HEADDATA-MATL_TYPE
_WA_S_MARA-MTART.
* RECEIVER: BASIC_VIEW
PERFORM _RULE_SET_X_IF_NOT_INIT_S
USING
_WA_T01_HEADDATA-BASIC_VIEW
_WA_S_MARA_CUST-INDICATOR_K.
* RECEIVER: SALES_VIEW
PERFORM _RULE_SET_X_IF_NOT_INIT_S
USING
_WA_T01_HEADDATA-SALES_VIEW
_WA_S_MARA_CUST-INDICATOR_V.
* RECEIVER: PURCHASE_VIEW
PERFORM _RULE_SET_X_IF_NOT_INIT_S
USING
_WA_T01_HEADDATA-PURCHASE_VIEW
_WA_S_MARA_CUST-INDICATOR_E.
* RECEIVER: MRP_VIEW
PERFORM _RULE_SET_X_IF_NOT_INIT_S
USING
_WA_T01_HEADDATA-MRP_VIEW
_WA_S_MARA_CUST-INDICATOR_D.
* RECEIVER: FORECAST_VIEW
PERFORM _RULE_SET_X_IF_NOT_INIT_S
USING
_WA_T01_HEADDATA-FORECAST_VIEW
_WA_S_MARA_CUST-INDICATOR_P.
* RECEIVER: WORK_SCHED_VIEW
PERFORM _RULE_SET_X_IF_NOT_INIT_S
USING
_WA_T01_HEADDATA-WORK_SCHED_VIEW
_WA_S_MARA_CUST-INDICATOR_A.
* RECEIVER: PRT_VIEW
PERFORM _RULE_SET_X_IF_NOT_INIT_S
FUNCTION /1LT/S4HOLO_500000000000003.
*
**Lokale Schnittstelle:
* IMPORTING
* VALUE(IM_TEST_MODE) LIKE EDITSTRUC-CHANGED OPTIONAL
* VALUE(IM_BEHAVIOUR) TYPE NUM1 DEFAULT 1
* EXPORTING
* VALUE(ET_MESSAGES) TYPE DMC_FM_MESSAGES_T
* CHANGING
* VALUE(CT_PAYLOAD) TYPE DMC_PAYLOAD_TAB
* VALUE(XT_RUN_STAT) TYPE DMC_T_RUN_STAT OPTIONAL
* EXCEPTIONS
* COMMUNICATION_FAILURE
* SYSTEM_FAILURE
* NO_AUTHORIZATION
*
* Project : ZSIN_MIG_001
* Subproject : ZSIN_MIG_001
* Migration Object : Z_MATERIAL_001
* Layer : Outer layer out (Function Module)
* Generated : 13.02.2017 07:53:34 by SENS_MM
*
Job-Controller Functions: (for Debugging purposes)
FORM EXECUTE_LOAD SAPLDMC_DTL LDMC_DTLU25
METHOD START_ACTIVITY CL_DMC_WDA_MIG_JOBS===========CP
CL_DMC_WDA_MIG_JOBS===========CM003
further Tips
Structure XXXX: Number of recipient records generated 0000000000 (or less than in input file)
reason:
the Migration Cockpit is storing all created objects in Table DMC_FM_RESTART, so if your object
number, for example material number, is in this table, it will be skipped and not imported again.
you can delete the entry with transaction code se16
also if a job with the name /1LT/LOAD is scheduled or already running, the import will not
start
(but shows no error message)
Open Items
Export Data from R/3 Source System? in the online help there is a remark: In the ABAP-based SAP
source system, you have installed the DMIS add-on. You can download the add-on from the SAP
Software Download Center at http://support.sap.com/swdc using the following path: Installations and
Upgrades A Z Index L SAP LT Replication Server SAP LT Replication Server 2.0 .
how can i export the data for the Migration Cockpit?
The Excel-Templates are very nice, Examples with Best-Practice Data would help understanding
how to fill the values.
how to create Additional Mapping Rules like we know this from LSMW?
Create Contact Persons for Customers (i could assign them to the Customer, but i had to to a
workaround to create the Contact Persons Business Partner Number)
strangely i could not find any oss notes, nor any blogs, is nobody using the tool yet?