Week 2: Migration Object Modeler (File/Staging)

Unit 1: Getting Started with the Migration Object

Modeler
Getting Started with the Migration Object Modeler
SAP S/4HANA migration cockpit – file and staging approach (recap)

Data provisioning Process & content Data load

Template file upload

API-based

Staging* SAP S/4HANA Cloud

SAP S/4HANA

SAP S/4HANA Cloud 1911: 100+

SAP S/4HANA 1909: 80+

Migration objects *Available for on-premise as of 1709 FPS02, available for cloud on request
© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 2
Getting Started with the Migration Object Modeler
Introduction

Typical Questions:
▪ How can I adapt the delivered content to my customers' needs?
▪ Is it possible to adjust the existing SAP migration objects? SAP S/4HANA
▪ I am missing a field in my Excel template or staging table – how can I add this field?
▪ How can I adjust the selection of data for the direct transfer approach?
▪ How can I create my own migration objects to transfer customer-specific data?

Migration Object Modeler: Modeling Environment of the SAP S/4HANA Migration Cockpit

© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 3

Getting Started with the Migration Object Modeler
Modeling environment of the SAP S/4HANA migration cockpit

Flexible and Extendable

Easily integrate custom objects and enhancements into the migration project SAP S/4HANA

▪ Customer-specific enhancements to SAP standard objects delivered with the SAP S/4HANA
migration cockpit
– Easily adjust input structure (file/staging)
▫ Add new fields
▫ Hide a field in the template
– Add or change migration object selection criteria (direct transfer)
– Map structures and fields
▪ Integration of newly created objects:
– Custom objects Transaction:
– SAP standard objects that are not yet in the scope of the SAP S/4HANA migration cockpit LTMOM
– Use standard APIs or code your function module
▪ Available for SAP S/4HANA and included in this license
© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 4
Getting Started with the Migration Object Modeler
Focus of this week – file and staging approach

Unit 1: Getting Started with the Migration Object Modeler

Unit 2: Copying and Extending Delivered Content SAP S/4HANA

Unit 3: Creating your Own Migration Object

Unit 4: Creating your Own Translation Objects and Rules
Unit 5: Simulating and Debugging a Migration Object

© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 5

Getting Started with the Migration Object Modeler
Transaction and role

To start the migration object modeler, use transaction

/nLTMOM.

NOTE:
To run the necessary transaction, your user needs the following role:
SAP_CA_DMC_MC_DEVELOPER

© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 6

Getting Started with the Migration Object Modeler
Demo

Migration Object Modeler

Getting Started (based on 1909)

© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 7

Getting Started with the Migration Object Modeler
SAP Logon settings in the demo system

In the demo system the following SAP Logon

setting was used:
• Corbu Theme
• “Accept SAP_Fiori visual theme” unmarked

Note: Depending on the theme you have chosen,

the screens in the migration object modeler may
look different, especially if the SAP_Fiori option is
marked.

© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 8

Getting Started with the Migration Object Modeler
Transaction and role

To start the migration object modeler, use transaction

/nLTMOM.

NOTE:
To run the necessary transaction, your user needs the following role:
SAP_CA_DMC_MC_DEVELOPER

© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 9

Getting Started with the Migration Object Modeler
Migration object or migration project overview

You can select either the migration object screen

or the migration project screen.

When you open a project, you can view all objects

that are assigned to your project in one central
location, for example you can view all the
migration objects and rules for a project.

© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 10

Getting Started with the Migration Object Modeler
Source structures

Under Source Structures, you can adjust the source structure so that your data can be transferred to the
SAP S/4HANA system.
Example: You can add a new field and specify the relevant information for the field.
Choose ‘Insert Field’

© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 11

Getting Started with the Migration Object Modeler
As of 1909
Source structures – Download XML file

The XML template file can be downloaded via LTMOM as well (in source structure definition).

The button to download the XML file is available in the

header section if the Source Structures screen is selected

© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 12

Getting Started with the Migration Object Modeler
Target structures

Under Target Structures, you can get an overview of the target structures associated with the migration
object.
Structures can be single fields, multiple fields, or tables.
Example: Before you add a new field to the source structure, you can determine which target structure the source field
should be mapped to.

© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 13

Getting Started with the Migration Object Modeler
Structure mapping

Under Structure Mapping, you can check how the source structure is mapped to the corresponding target
structure.
As a prerequisite, the source structure must be mapped to a target structure before you can map the fields
of the source to the target structure (see Field Mapping).

© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 14

Getting Started with the Migration Object Modeler
Field mapping

Under Field Mapping, you can map fields from the source structure to fields in the target structure.
Simply drag the relevant field from the left-hand side to the target structure field on the right-hand side.
If a field from a source structure has been mapped to a target field, the system displays a green icon, and a
red icon if it has not been mapped.
Filter for mapped/ unmapped fields

© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 15

Getting Started with the Migration Object Modeler
Additional information

Information

Generate Runtime Object Display Generated Function Group

▪ Generate Runtime Object: In this activity, the application generates the programs required to read data
from the source system and to transfer data to SAP S/4HANA.
▪ If required, you can view the function modules (internal SAP programs) that facilitate the transfer of data to
the SAP S/4HANA system. To view the function modules, choose Display Generated Function Group.
▪ To view additional information and documentation on the migration object modeler you can choose the
Information icon.

© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 16

Getting Started with the Migration Object Modeler
Documentation

Information button

Depending on the migration

approach, different
documentation is shown when
you click the information button.

© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 17

Getting Started with the Migration Object Modeler
Outlook

Week 2: Migration Object Modeler (File/Staging)

Unit 2: Copying and Extending Delivered Content
© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 18
Thank you.
Contact information:

open@sap.com
Follow all of SAP

www.sap.com/contactsap

© 2019 SAP SE or an SAP affiliate company. All rights reserved.

No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of
SAP SE or an SAP affiliate company.
The information contained herein may be changed without prior notice. Some software products marketed by SAP SE and its
distributors contain proprietary software components of other software vendors. National product specifications may vary.
These materials are provided by SAP SE or an SAP affiliate company for informational purposes only, without representation or
warranty of any kind, and SAP or its affiliated companies shall not be liable for errors or omissions with respect to the materials.
The only warranties for SAP or SAP affiliate company products and services are those that are set forth in the express warranty
statements accompanying such products and services, if any. Nothing herein should be construed as constituting an additional
warranty.
In particular, SAP SE or its affiliated companies have no obligation to pursue any course of business outlined in this document or
any related presentation, or to develop or release any functionality mentioned therein. This document, or any related presentation,
and SAP SE’s or its affiliated companies’ strategy and possible future developments, products, and/or platforms, directions, and
functionality are all subject to change and may be changed by SAP SE or its affiliated companies at any time for any reason
without notice. The information in this document is not a commitment, promise, or legal obligation to deliver any material, code, or
functionality. All forward-looking statements are subject to various risks and uncertainties that could cause actual results to differ
materially from expectations. Readers are cautioned not to place undue reliance on these forward-looking statements, and they
should not be relied upon in making purchasing decisions.
SAP and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered
trademarks of SAP SE (or an SAP affiliate company) in Germany and other countries. All other product and service names
mentioned are the trademarks of their respective companies.
See www.sap.com/copyright for additional trademark information and notices.