S/4HANA How-To-Guide RELEASED FOR CUSTOMERS

Document Version: 1.0 – January 2018

SAP S/4HANA - Migration Object Modeler

Document History

The following table provides an overview of the most important document changes.

Table 1

Version Date Description

1.0 December 14, 2017 Initial Version – Chelliah Soundar

1.0 January 3, 2018 Reviewed - Alexander Roebel

1.0 January 16, 2018 Released for customers

Typographic Conventions

Type Style Description

Example Words or characters quoted from the screen. These include field names, screen titles,
pushbuttons labels, menu names, menu paths, and menu options.
Textual cross-references to other documents.

Example Emphasized words or expressions.

EXAMPLE Technical names of system objects. These include report names, program names,
transaction codes, table names, and key concepts of a programming language when they
are surrounded by body text, for example, SELECT and INCLUDE.

Example Output on the screen. This includes file and directory names and their paths, messages,
names of variables and parameters, source text, and names of installation, upgrade and
database tools.

Example Exact user entry. These are words or characters that you enter in the system exactly as
they appear in the documentation.

<Example> Variable user entry. Angle brackets indicate that you replace these words and characters
with appropriate entries to make entries in the system.

EXAMPLE Keys on the keyboard, for example, F 2 or E N T E R .

Table of Contents

1 Introduction ................................................................................................................................... 5

2 Documentation Links ..................................................................................................................... 6

3 Step by Step Guide......................................................................................................................... 7

a. Create migration project

b. Create migration object
c. Create and map source structure
d. Migrate data
 1. Introduction

SAP S/4HANA Migration Object Modeler is part of the SAP S/4HANA Migration Cockpit and is available beginning
S/4HANA 1610 FPS02. This modeler is available for the on-premise SAP S/4HANA and private option of SAP
S/4HANA Cloud.
This tool is used to upload data for
• Custom objects
• Customer-specific enhancements (e.g. add new fields) to SAP standard objects delivered with the SAP
S/4 HANA Migration Cockpit
• SAP standard objects that are not yet in the scope of the SAP S/4HANA Migration Cockpit
This document is a step by step guide for the complete migration process for a custom object which includes
creating migration project, migration object and the migration steps.

SAP S/4HANA On-Premise Fiori Configuration for Multiple Clients.docx P a g e |5

 2. Documentation Links

Below are the links to various S/4HANA 1709 OP documentation that can be used as reference for Migration
Object Modeler.

Documentation

SAP S/4HANA 1709 Help

SAP S/4HANA Migration Object Modeler Help

SAP Note 2537549 - Collective SAP Note and FAQ for SAP S/4HANA Migration cockpit (on-
premise)

SAP Note 2481235 - SAP S/4HANA Migration Cockpit (on-premise) - restrictions and extensibility
of pre-delivered migration objects

SAP S/4HANA On-Premise Fiori Configuration for Multiple Clients.docx P a g e |6

3. Step by Step guide

Action Screenshot

a. Create Migration Project

Login to S/4HANA
Backend system
Launch migration
cockpit (T Code:
LTMC)

Click Create to
create a migration
project

Enter a name,
select “On-premise
– Enterprise
management
scope” as Default
View and click
Create.
As explained in the
screenshot, Mass
Transfer ID is used
for transport
purposes.

SAP S/4HANA On-Premise Fiori Configuration for Multiple Clients.docx P a g e |7

Migration Project
created.
Close the browser

b. Create Migration Object

Login to S/4HANA
Backend system
Launch migration
object modeler (T
Code: LTMOM)

More -> Migration

Object Modeler ->
Create Migration
Object ->

-> User Defined

SAP S/4HANA On-Premise Fiori Configuration for Multiple Clients.docx P a g e |8

Select the project
created earlier
(Test Project CS4)
and a migration
object (AIRPORT).
Enter a description
for the object.
Note: AIRPORT is a
custom object

Click Next

Enter the function

module name. The
FM used here
(Z_SAIRPORT_CRE
ATE) is a custom
function module
developed for
creating the object
AIRPORT
Select, Process One
Instance at a Time
Parameter that
Returns Result =
RETURN
Parameter for
Simulation =
SIMULATION_RUN
Value for
Simulation = x
Note: The
parameters above
are not FM specific,
rather relevant to
the object modeler.

SAP S/4HANA On-Premise Fiori Configuration for Multiple Clients.docx P a g e |9

Click Continue

Migration Object
“Airport” is created.
The migration
object created is
shown in display
mode

c. Create and map source structure

In this section the source structure for uploading data is created. The system uses this structure to
generate a template for uploading data. The source structure represents the table and fields of the
migration object that are uploaded. The target structure is the migation object table in the system.

Change from
Display to Change
mode

Double click on
Source Structures

SAP S/4HANA On-Premise Fiori Configuration for Multiple Clients.docx P a g e | 10

Right click on
Source Structures
on the right-hand
side of the screen
and select Append
Structures to Lower
Level

On the Create
Source Structure
screen, enter a
name and
description.
Click Continue

Click Add Field

Enter field name,
data type, and
length for each
field.
Remember to
check the box for
key fields
Save before moving
to the next step.

Double click on
Structure Mappings

SAP S/4HANA On-Premise Fiori Configuration for Multiple Clients.docx P a g e | 11

Drag and drop the
Source Structure
(Source data) to
both the function
module and the
object in Target
Structures.
Save

Double click on
Field Mapping

Drag and drop fields

from Source
Structures to
corresponding
fields in Target
Structures.
Save

SAP S/4HANA On-Premise Fiori Configuration for Multiple Clients.docx P a g e | 12

Choose “Generate
Runtime Object”

Save and exit

d. Migrate data

Launch migration
cockpit (T Code:
LTMC)
Choose the project
(Test Project CS4)

Migration Project is
displayed.
Choose Migration
Object “Airport”

SAP S/4HANA On-Premise Fiori Configuration for Multiple Clients.docx P a g e | 13

Migration Object is
displayed.
Choose Edit

Select Active View

as “Customer View”
Save

Migration Object
saved successfully

Download Template
and save the Excel
file locally

Fill in data in the

appropriate field
columns.
Save and close the
excel file

SAP S/4HANA On-Premise Fiori Configuration for Multiple Clients.docx P a g e | 14

Go back to
Migration Object
screen.
Choose Upload File

Provide the file path

and choose upload

File uploaded
successfully.
Select the line and
click Activate

Data file is now

active
Begin the guided
process of
uploading data by
clicking Start
Transfer

SAP S/4HANA On-Premise Fiori Configuration for Multiple Clients.docx P a g e | 15

Data Validation
starts
Click Close on
completion

At the end of
validation, the
system shows
errors if there is
any.
Click Next to review
the errors

System allows you

to correct the errors
here.
Click on the error
and enter the
correct value or
confirm the existing
value
Click Next

Data simulation
starts.
Click Close on
completion

SAP S/4HANA On-Premise Fiori Configuration for Multiple Clients.docx P a g e | 16

Data Simulation
completed.
Click Next

Data import starts

Click Close on
completion

Data import
completed.
Click Finish to end
the process

Validation Validate the new values in table AIRPORT using T Code SE16

SAP S/4HANA On-Premise Fiori Configuration for Multiple Clients.docx P a g e | 17

www.sap.com/contactsap

© 2017 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.
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. Please see
www.sap.com/corporate-en/legal/copyright/index.epx for
additional trademark information and notices.

Material Number: