Discover the S/4HANA Migration Cockpit Migration: This Blog describes how it is possible to add custom fields to standard migration objects or even create new migration objects.

Description and Screenshots are created with S/4HANA 1610 FPS2. Some options might not be available before and there will be more features available in 1709.

Be aware the Migration Cockpit and Object Modeler are new Solutions, so at some points there are still bugs and there will be a lot of additional features in the future.

before starting LTMOM, you have to create a migration project using /NLTMC

Link to getting started with the S/4HANA migration cockpit (onpremise)

Update 6.7.2017: Click-Demo/Training of LTMOM

https://cp.hana.ondemand.com/dps/d/preview/76a9ec56a9eb6138e10000000a44147b/1610%20001/en-US/ab242557ea516359e10000000a44147b/content.htm

SAP Notes

Check CA-GTF-MIG / SV-CLD-MIG for predefined content problem, check CA-LT-MC for tools problem.

(use expert search https://launchpad.support.sap.com/#/mynotes?tab=Search)

Start Migration Object Modeler

Call Transaction code /NLTMOM

Select the Migration Object from the value-list (F4)

in most of the cases, it is the easiest solution to use an existing Migration Object and just add some Fields to an existing Source Structure. But it is also possible to create new Migration Objects or Source Structures.

Create a new Migration Object

To Create a new Migration Object select ‘create Migration Object’ from the Menu.

you can eater copy from an existing SAP Migration Object/Template or create a user defined Migration object.

Image001 3365627

User-defined Migration Object

give an Object id(No Z_ required, example MYOBJ) and description. Currently only the option Migration from File by calling Function Module is supported. (see Outlook)

Enter the Name of the Function Module (Example BAPI_MATERIAL_SAVEREPLICA)

Image008 4647912

Parameter for the Return is the Table-Parameter which contains the BAPIRET2-Error Messages (see /NSE37)

Parameter for Simulation see Function Module Description, usually there is an option like TESTRUN, where ‘X’ means no Update.

Define Source Structure / Add Fields to Source/Excel Spreadsheet

in the Section ‘Source Structure’ it is possible to add new Fields to existing structure and add new Structures.

choose ‘Add Field’ to add fields at the end of the structure. choose ‘insert Field’ to insert the field at the cursor position.

add new Source Structures (Optional)

Image010 2531714

in future it will be possible to choose the Structure Definition from DDIC or Remote Databases: Image017 8598204

Foreign Key Relationship: You can maintain foreign Keys for Keyfields like MATNR or KUNNR. (See also Standard Objects Assignment)

for example, i want to add custom fields to the Material BAPI. The BAPI has an Input Parameter for Customer Fields which matches the Structure BAPIE1PAREX:

Image019 1 6957861

Enter Field name, Datatype and Length and Description (Description is shown in generated Excel Template). i usually use CHAR Fields for the Excel/Input Structure and they also can be longer than the target SAP Field.

Press on Button ‘Generate Runtime Object’.

Image027 7791444

next Time you Generate an Excel Template in LTMC, you will also see the new fields.

Target Structure

currently this comes from the assigned Function Module so there is nothing to be changed here.

Structure Mapping

Image033 5502948

each target structure you want to use/fill needs to be assigned to at least one source structure (can also be more than one). this is done by drag and drop.

best thing is to look at the standard assignments first.

the assignment triggers the loop, you can only assign fields of an assigned structure in the field mapping.

Field Mapping

when choosing field mapping, the current mapping is displayed.

i usually choose ‘more/settings/technical names on’.

there might be complex hierarchies with a lot of structures and fields, so i ‘collapse’ the target structure first and then drill down to the relevant structure. you can also use the ‘search’ function to find you target field.

then drag and drop the source field to your target field.

Image043 7894492

some BAPIs have ‘X’ Field Structures, where you have to Mark the Used Fields with an ‘X’:

Image045 7563804

double click the target field to see the mapping-rule:

here you can select from a list of existing mapping rules, or create a new mapping rule. For each Value-Mapping in LTMC, there is a Rule available:

Create new Mapping Rule

Image053 1 7780817

if you click on Create you can create a new Rule:

Image057 1002764

Define Input/Output Parameters

Create a Default Variant

Image061 8844959

Create Documentation

Image065 5040744

Edit Code (ABAP)

Use Mapping Templates:

Image069 2192605

Troubleshooting

Image079 6508441

seems to be a bug, but i could not yet find a note for it. Solution: just start LTMOM again

use display generated function group to see the generated ABAP Code:

Image077 5805707

Error: Different number of parameters in FORM and PERFORM

i did not really see an error as it is a standard MOVE Mapping with a Constant Value. After i changed the Constant to ‘X’, then ok, then change to ‘MYVALUE’ again, the error disappeared.

Update Custom-Specific/Additional Fields to BAPIs

you need to add these to the BAPI, see https://help.sap.com/doc/saphelp_ehsext40/4.0/en-US/3e/0e1089c24611d1ad09080009b0fb56/frameset.htm

Additional Ideas

Create a Batchinput Recording, Generate a Function Module and create a Migration Object for this Function Module. (/NSM35)

Example Material Master, Field Commodity Code MARC-STAWN currently not updated by BAPI_MATERIAL_SAVEREPLICA. I usually do a Z-Report to save it with function /SAPSLL/API_COMCO_CLS_DISTR, but it should be possible also to create a new migration object for this function module.

https://launchpad.support.sap.com/#/notes/2432527/E

Transport DEV/QAS/PRD

in LTMC there is an option to export and import migration Projects.

Image007 7224676

Outlook

it looks as it will be possible to create Migration Objects from IDOC and Direct DB Access to Source R/3 System.

New NetWeaver Information at SAP.com

Very Helpfull

 

 

User Rating: Be the first one !