Introduction to Data Migration Templates

Version S4CORE 102 - 08.01.2019 © Copyright SAP SE. All rights reserved.

Overview

A migration template (Microsoft Excel XML Spreadsheet 2003 file) consists of different sheets which are visible at the bottom of the migration template. You
use the different sheets to specify the data that belongs to different data structures. For example the migration template for the migration object 'Material',
contains a sheet for basic data, a sheet for plant data, and so on. Some sheets are mandatory, and some are optional.

A migration template is based on the active view of the relevant migration object. You can find information about the active view in the Microsoft Excel XML
file. In the file, navigate to File -> Info. You can find the active view name under Properties -> Tags.

Prerequisites
In the Microsoft Excel XML Spreadsheet 2003 file, navigate to 'File' -> 'Options' -> 'Advanced'. Under the option 'When calculating this workbook:', ensure that
the option 'Set precision as displayed' is selected.

The Field List Sheet

The 'Field List' sheet is one of the first sheets in the migration template. You use this sheet to get an overview of the expected data in one central location.

It contains information about the mandatory and optional sheets, as well as detailed information for each sheet (for example the expected data type and
length for the fields in each sheet).
On the 'Field List' sheet, you can view the following information for each field in the migration template:
• The name of the sheet, and whether it is mandatory or optional. Only mandatory sheets have the suffix 'Mandatory', for example 'Basic Data
(Mandatory)'. All other sheets are optional.

Note:
You can quickly get an overview of the mandatory and optional sheets by looking at the color of the sheet names at the bottom of the migration template. The
name of the mandatory sheets have the color orange, while the optional sheets have the color blue.
• The group name for the fields in a sheet.
• The individual fields in each sheet, as well as whether fields are mandatory for a sheet.
• Information about the expected format of the individual fields, for example the data type and length.

Working with Sheets

For each migration template, you need to specify data for the mandatory sheets, and for the optional sheets that are relevant for your project:
• Mandatory sheets (orange)
Mandatory sheets represent the minimum set of data you must provide for data migration. Fill in all mandatory fields.
• Optional sheets (blue)
Use optional sheets depending on your migration scope and available legacy data.

Viewing Additional Information for Each Column

In row 8, you can view the field names in SAP S/4HANA, as well as additional information such as the expected format (for example the data type and
length). Note that you must expand the row to view this additional information.
Some fields are mandatory, and some are optional. The wildcard character (‘*’) beside the name of a field indicates that the field is mandatory.

Note:
Although an optional sheet may contain mandatory columns, if the sheet is not relevant for your project, there is no need to fill the mandatory columns in the
sheet with data.

Working with Different Data Types

You can view the data type for a field in row 8 (see 'Viewing Additional Information for Each Column' above). Depending on the field, one of the following data
types may be required:
• Text
Letters, numbers, and special characters are permitted. In the SAP S/4HANA migration cockpit, you can map the values of certain fields with the data type
text (usually those fields with Length: 80) to their correct SAP S/4HANA target values. You can do this value mapping in the SAP S/4HANA migration cockpit
when you start the transfer (in the step 'Convert Values').

• Number
Enter numbers with decimals in the relevant country-specific format, for example 12.34 (United States) or 12,34 (Germany). For fields with decimals, the
declared length includes decimals (if required), for example if the information for the column states: Length: 8, Decimals: 3, then a number such as
12345.678 is permitted. Note that decimal places are not mandatory. In is this example, you can specify a whole number up to length 8 without decimal
places, for example ‘1’. This number would be set to ‘1.000’ internally. For negative numbers, ensure that a minus sign ('-') directly precedes the number, for
example '-100'.

• Date
Enter the date in your country-specific format, for example 12/31/1998 (United States) or 31.12.1998 (Germany). Note that Microsoft Excel automatically
recognizes different date formats and transforms them automatically to the correct XML format.
• Time
Enter the time in the format HH:MM:SS, for example 02:52:40
• Date-Time
Enter the date in your country-specific format followed by the time in the format HH:MM:SS, for example 12/31/1998 02:52:40 (United States) and 31.12.1998
02:52:40 (Germany). Separate the date and time with a blank space.

Copying Data to a Sheet

When copying data to a sheet from Microsoft Excel, always right-click the relevant cell and choose the paste option 'Values (V)'. Avoid pasting data that
includes formatting and formulas into the migration template, as this will corrupt the structure of the XML migration template.

Using the Find and Replace Function

Do not use the Microsoft Excel function 'Find and Replace'. If you change data by using this function, you may also unintentionally change the field names
and corrupt the structure of the XML migration template.

Saving the Migration Template

Ensure that you only save the migration template as a Microsoft Excel XML Spreadsheet 2003 file. Other file types are not supported by the SAP S/4HANA
migration cockpit.

Important Information

Do not make any changes to the structure of the migration template, specifically:
• Do not delete, rename or change the order of any sheet in the migration template.
• Do not change the formatting of any cells.
• Do not use formulas.
• Do not hide, remove, or change the order of any of the columns in the migration template.

Note:
Any changes to the sheets will result in a corrupted XML structure. Such modified migration templates are not supported by the SAP S/4HANA migration
cockpit.
Field List for Migration Object: Equipment
Version S4CORE 102 - 08.01.2019 © Copyright SAP SE. All rights reserved.

Sheet Name Group Name Field Description Importance Type Length Decimal
Equipment master data (mandatory)
Key Legacy Equipment Number mandatory for sheet Text 18
General Data Equipment category mandatory for sheet Text 80
Description of technical object Text 40
Technical object type Text 80
Technical object authorization group Text 80
Dates Valid-From Date mandatory for sheet Date
General Data Size/dimension Text 18
Weight of object Number 13 3
Unit of weight (ISO Format) Text 80
Inventory number Text 25
Dates Start-up Date of the Technical Object Date
General Data Acquisition Value Number 13 2
Currency Key (ISO Format) Text 80
Dates Acquisition date Date
General Data Manufacturer of asset Text 30
Country of manufacture Text 80
Manufacturer model number Text 20
Year of construction Text 4
Month of construction Text 2
Manufacturer part number Text 30
Manufacturer serial number Text 30
Location Maintenance plant Text 80
Location of maintenance object Text 80
Plant section Text 80
Work center In Location Text 80
ABC indicator for technical object Text 80
Org. Data Company Code Text 80
Business Area Text 80
Main Asset Number Text 80
Asset Subnumber Text 80
Cost Center Text 80
WBS Element Text 80
Standing order number Text 80
Settlement order Text 80
Maintenance Planning Plant Text 80
Planner Group for Cust. Serv. & Plant Text 80
M.
Plant associated with main work Text 80
center
Main work center for maintenance Text 80
tasks
Catalog Profile Text 80
Structure Functional Location Text 80
Superordinate Equipment Text 80
Position in superior technical object Text 4
Construction type material of the Text 80
Sales and object
Sales Organization Text 80
Distribution Distribution Channel Text 80
Division Text 80
Sales Office Text 80
Sales Group Text 80
Serial Data Material Number Text 80
Serial Number Text 18
Source Data for Migration Object: Equipment
Version S4CORE 102 - 08.01.2019 © Copyright SAP SE. All rights reserved.

Key General Data

Legacy Equipment Number* Equipment category* Description of technical object Technical object type

Key fields are mandatory and Key for distinguishing individual Type: Text Key that describes the type of
must always be filled with a technical objects according to Length: 40 technical object.
unique key. their use.
If there is internal numbering, you Type: Text
can provide the key of your Type: Text Length: 80
source system or any other Length: 80
unique key.
The key is technically mandatory
for the tool to internally connect
the records of subordinated
sheets with
the records of the superordinate
sheets.

Type: Text
Length: 18
 Dates General Data
Technical object authorization Valid-From Date* Size/dimension Weight of object
group
Type: Date Type: Text Type: Number
Authorization group of a technical Length: 18 Length: 13
object in Plant Maintenance. Decimal: 3

With an entry in this field, you

allocate the master record of this
object to a group to which only
certain
users have access for processing
the data. The users that have
access authorization have the
appropriate entry
in their user master record.

Type: Text
Length: 80
General Data Dates General Data
Unit of weight (ISO Format) Inventory number Start-up Date of the Technical Acquisition Value
Object
Type: Text Inventory number under which Type: Number
Length: 80 the technical object is stored in Type: Date Length: 13
Asset Accounting. Decimal: 2

Type: Text
Length: 25
General Data Dates
Currency Key (ISO Format) Acquisition date Manufacturer of asset Country of manufacture

Type: Text Type: Date You can enter the manufacturer Type: Text
Length: 80 of the asset in this field. Length: 80

This field is currently for

informational purposes only.

Type: Text
Length: 30
 General Data
Manufacturer model number Year of construction Month of construction Manufacturer part number

Type: Text Year in which the technical object Month of the year in which the Number which is given to the
Length: 20 was constructed. technical object was constructed. technical object by the
manufacturer and which allows
Type: Text Type: Text him to manage objects of
Length: 4 Length: 2 the same category.

Type: Text
Length: 30
 Location
Manufacturer serial number Maintenance plant Location of maintenance object Plant section

The serial number is the number Number which clearly identifies a The key in this field indicates a Number which clearly identifies a
that is assigned by the maintenance plant. location within a plant. plant section.
manufacturer for an individual
technical object. Type: Text Type: Text Type: Text
Length: 80 Length: 80 Length: 80
You can use the serial number as
a complement to the
manufacturer part number.

Type: Text
Length: 30
on
Work center In Location ABC indicator for technical object Company Code Business Area

Key identifying the work center in An indicator that is assigned by Type: Text Type: Text
the location. the procedure of ABC analysis. Length: 80 Length: 80

This is about the work center Type: Text

from production planning that is Length: 80
represented by this technical
object (for
example, the equipment).

Type: Text
Length: 80
 Org
Main Asset Number Asset Subnumber Cost Center WBS Element

This is the number which, This is the number which, Type: Text Type: Text
together with the asset sub- together with the main asset Length: 80 Length: 80
number, identifies a fixed asset in number, uniquely identifies a
Asset Accounting. fixed asset in Asset
Accounting.
Type: Text
Length: 80 Type: Text
Length: 80
 Org. Data
Standing order number
Number of the standing order
through which settlement of all
the maintenance tasks will take
place that do not
have an individual order.
Type: Text
Length: 80
Settlement order Maintenance Planning Plant Planner Group for Cust. Serv. &
Plant M.
Order on which the PM order Type: Text
should be settled. Length: 80 Key that uniquely identifies the
planner group in Customer
Type: Text Service or Plant Maintenance.
Length: 80
Type: Text
Length: 80
Plant associated with main work Main work center for Catalog Profile Functional Location
center maintenance tasks
Key of the Report schema that is Label that uniquely identifies a
Plant in which the main work Key which uniquely identifies the the basis for the message. functional location.
center that has been entered is to responsible work center for this
be found. technical object in the Type: Text If alternative labels exist for a
organization area. Length: 80 functional location, you can
Type: Text define in your user profile which
Length: 80 Type: Text label should
Length: 80 be displayed in this field.

Type: Text
Length: 80
 Structure
Superordinate Equipment
Number that clearly identifies the
superior equipment associated
with this piece of equipment.
Type: Text
Length: 80
Position in superior technical Construction type material of the Sales Organization
object object
Type: Text
The position of the technical Material number under which Length: 80
object in the superior technical pieces of equipment of the same
object. The superior or construction are grouped.
subordinate technical
object can be either a piece of Type: Text
equipment or a functional Length: 80
location.
Type: Text
Length: 4
 Sales and Distribution
Distribution Channel Division Sales Office Sales Group

Type: Text Type: Text Type: Text Type: Text

Length: 80 Length: 80 Length: 80 Length: 80
 Serial Data
Material Number Serial Number

Type: Text Type: Text

Length: 80 Length: 18