Introduction to Data Migration Templates

Version SAP S/4HANA 2023 - Custom Scope - 15.10.2024 © 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 'Product', 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.
Information about File Sizes
SAP S/4HANA Cloud
If you are migrating data to SAP S/4HANA Cloud, the default size limit for each uploaded XML file is 100MB. If required, you can zip several files together. Note that the combined size of all the XML
files you want to add to the zip file must not exceed 160MB. The limit for zip file is still 100MB.

SAP S/4HANA On-Premise

If you are migrating data to SAP S/4HANA, the default size limit for each uploaded XML file is 100MB.
You can increase the size limit for each uploaded XML file to 160MB by changing the system parameter (icm/HTTP/max_request_size_KB). If required, you can zip several files together. Note that the
combined size of all the XML files you want to add to the zip file must not exceed 160MB. The limit for the zip file is still 160 MB with the adjusted system parameter.

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.

Note:
In the field list sheet, certain technical information about the fields is hidden by default. The columns 'SAP Structure' and 'SAP Field' (columns 8 and 9) are hidden by default. The column 'SAP Structure'
is the technical name of the structure that the field belongs to. The column 'SAP Field' is the technical name of the field. To unhide these columns, select the columns adjacent to either side of the
columns that you want to unhide. Right-click your selection, and choose 'Unhide'.

If you want to extract data from SAP ERP, the technical name of structure and the technical name of the field often corresponds to the SAP ERP table name and field name. Also, the SAP Release Note
(2568909) for SAP S/4HANA Cloud data migration content uses the technical names of the structures and fields.

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.

Note:
Rows 4, 5, and 6 are hidden by default. Row 4 is the technical name of the structure (corresponds to the sheet name). Row 5 is the technical name of the field (corresponds to row 8 - the field
description). Row 6 contains technical information such as the data type and length.
To unhide these rows, select the rows adjacent to either side of the rows that you want to unhide. Right-click your selection, and choose 'Unhide'.

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 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'. Note that currencies with more than 3 decimal places are not supported.

Note that the maximum field length supported by Microsoft Excel is 15 digits (including decimals). If you have longer numbers, use the option for transferring data to S/4HANA using staging tables.

• 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

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: VSS Service Package Create
Version SAP S/4HANA 2023 - Custom Scope - 15.10.2024 © Copyright SAP SE. All rights reserved.

Sheet Name Group Name Field Description Importance Type Length Decimal
Package Header (mandatory)
External Package / Variant Key mandatory for sheet Text 60
Package Type mandatory for sheet Text 2
Package Changes in Order Permitted Text 1
Package Status Text 2
Labor Value Main Type Text 15
Package Price Number 11 2
Document currency Text 5
Plant Text 4
Sales Organization Text 4
Distribution Channel Text 2
Division Text 2
OEM Text 10
Country Key Text 3
Date for Pricing and Exchange Rate Date
Tax Destination Country Text 3

VSS Package Item

External Package / Variant Key mandatory for sheet Text 60
Item Number Number 6
Item Category mandatory for sheet Text 4
Labor Value Catalog ID Text 12
Labor Value Number Text 35
Material Number Text 40
OEM Text 10
Target Time Number 13 3
Target Unit Text 3
Order Quantity Number 13 3
Order Unit Text 3
Item Price Number 11 2
Description Text 60
Language Key Text 2

VSS Package Text

External Package / Variant Key mandatory for sheet Text 60
Language Key Text 2
Description Text 60
Source Data for Migration Object: VSS Service Package C
Version SAP S/4HANA 2023 - Custom Scope - 15.10.2024 © Copyright SAP SE. All rights reserved.

External Package / Variant Key* Package Type* Package Changes in Order Permitted

Type: Text Type: Text Type: Text

Length: 60 Length: 2 Length: 1

Package Name Z1- Price Package - A grouping of items for Package can be changed in the VSS order.
pricing purposes, E.g-Summer Package, Default to 'X'
10K Service
Z2 - Chain Package
Z3- Parts Package - kits related to counter
sales only

2MH_SERVICE_30K 02 X
2MH_SERVICE_60K 02 X
2MB_SERVICE_30K 02 X
2MB_SERVICE_60K 02 X
vice Package Create

Package Status Labor Value Main Type Package Price

Type: Text Type: Text Type: Number

Length: 2 Length: 15 Length: 11
Decimal: 2 (the actual number of permitted
decimals depends on the currency you
entered with this amount)

Package Status. Default to '02' Labor Value type defined for the brand header price applies to all the items in the
package

02 MH
02 MH
02 M1
02 M1
Document currency Plant Sales Organization

Type: Text Type: Text Type: Text

Length: 5 Length: 4 Length: 4

Default to 'AED' Plant/Branch/Workshop where the package 3000-Trucks & Heavy Equip
will be used 3100-International Truck
e.-g 3205 BEDA ZAYED 3200-Automative, Land Ser
5106 AL AIN PARTS 5100-AM Automobil
5400-Auto Central

2000 2000
2000 2000
2000 2000
2000 2000
 Distribution Channel Division OEM

Type: Text Type: Text Type: Text

Length: 2 Length: 2 Length: 10

30 - Service/Workshop Brand
40 - spareparts 04 Nissan
05 Infiniti
06 Renault
07 Non-Franchise
08 Renault Trucks
09 UD Trucks
10 UniCarriers Forklift
11 Oshkosh airport prod
12 TCM
13 Dongfeng
14 Automotive Land (Ser

Q3 MH MAHI
Q3 MH MAHI
Q3 M1 MB
Q3 M1 MB
 Country Key Date for Pricing and Exchange Rate Tax Destination Country

Type: Text Type: Date Type: Text

Length: 3 Length: 3

Default to AE Default to .. Default to AE

DE 01.01.2024 DE
DE 01.01.2024 DE
DE 01.01.2024 DE
DE 01.01.2024 DE
Source Data for Migration Object: VSS Service Package C
Version SAP S/4HANA 2023 - Custom Scope - 15.10.2024 © Copyright SAP SE. All rights reserved.

External Package / Variant Key* Item Number Item Category*

Package Name ( maintained in package number increment of 0010. P001 - Labor
header) P002 - Parts in service order
D020 - Parts in counter sales
2MH_SERVICE_30K 0010 P001
2MH_SERVICE_30K 0020 P002
2MH_SERVICE_60K 0010 P001
2MH_SERVICE_60K 0020 P002
2MH_SERVICE_60K 0030 P001
2MH_SERVICE_60K 0040 P002
2MB_SERVICE_30K 0010 P001
vice Package Create

Labor Value Catalog ID Labor Value Number Material Number

PROD_CAT_MH 040101
M4440200210:MAHI
PROD_CAT_MH 040102
M4440200206:MAHI
PROD_CAT_MH 040103
M4440200208:MAHI
PROD_CAT_MB 040101
 OEM Target Time Target Unit

1.000 H
MAHI
1.000 H
MAHI
2.000 H
MAHI
1.000 H
Order Quantity Order Unit Item Price
Price for the item

H 40.00
PC 80.00
H 30.00
PC 65.00
H 50.00
PC 110.00
H 40.00
 Description Language Key

Oil change EN
Oil EN
Filter change EN
Filter EN
V-belt change EN
V-belt EN
Oil change EN
Source Data for Migration Object: VSS Service Package C
Version SAP S/4HANA 2023 - Custom Scope - 15.10.2024 © Copyright SAP SE. All rights reserved.

External Package / Variant Key* Language Key Description

Package Name ( maintained in package Default to EN Package Description
header)
2MH_SERVICE_30K EN Service 30 k
2MH_SERVICE_60K EN Service 60 k
2MB_SERVICE_30K EN Service 30 k
2MB_SERVICE_60K EN Service 60 k
2MBT_SERVICE_30K EN Service 30 k
2MBT_SERVICE_60K EN Service 60 k
2TY_SERVICE_30K EN Service 30 k
2TY_SERVICE_60K EN Service 60 k
vice Package Create