Introduction to Data Migration Templates

Version S4CORE 104 - 19.08.2020 © 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.
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 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: PS - WBS element
Version S4CORE 104 - 19.08.2020 © Copyright SAP SE. All rights reserved.

Sheet Name Group Name Field Description Importance Type Length Decimal
Project definition (mandatory)
Key Project definition mandatory for sheet Text 80

WBS Element (mandatory)

Key Project definition mandatory for sheet Text 80
Work Breakdown Structure Element mandatory for sheet Text 80
Basic Data (WBS El
Short description (1st text line) Text 40
Project type Text 80
Priority Text 80
Responsibilities Number of the Responsible Person Text 80
Applicant number Text 80
Controlling area for respons. cost cente Text 80
Responsible cost center Text 80
Controlling area for reqe. cost cente Text 80
Requesting cost center Text 80
Requesting company code Text 80
Operative Indicator: Planning element Text 1
indicators Indicator: Account assignment element Text 1
Indicator: Billing element Text 1
Indicator: Grouping WBS element Text 80
Dates - Basic Basic start date Date
Dates Basic finish date Date
Duration Number 5 1
Unit for duration Text 80
Dates - Forecaset Forecast start Date Date
Dates Forecast finish Date Date
Duration Number 5 1
Unit for duration Text 80
Assignments Plant Text 80
Location Text 80
Functional Area Text 80
Profit Center Text 80
Calendar Text 80
Equipment Number Text 80
Functional Location Text 80
Object class Text 80
WBS element currency Text 80
Changing NO. Text 80
Tax Jurisdiction Text 15
Control - Statistical WBS element Text 1
Accounting Costing Sheet Text 80
Overhead key Text 6
Indicator for Integrated Planning Text 1
Interest Profile for Project/Order Inter Text 80
Investment Measure Profile Text 80
Results Analysis Key Text 80
Control - Scale of investment objects Text 80
Investment Investment Reason Text 80
Management
Reason for Environmental Investment Text 80
User Fields - Fields key Text 80
General fields Text 1 Text 20
Text 2 Text 20
Text 3 Text 10
Text 4 Text 10
User Fields - Quantity 1 Number 13 3
Numeric fields Unit for quantity fields 1 Text 80
Quantity 2 Number 13 3
Unit for quantity fields 2 Text 80
Value 3 Number 13 3
Unit for quantity fields 3 Text 80
Value 4 Number 13 3
Unit for quantity fields 4 Text 80
User Fields - Dates Date 1 Date
User Fields - Dates
Date 2 Date
User Fields - Indicator 1 Text 1
Checkbox Indicator 2 Text 80
Source Data for Migration Object: PS - WBS element
Version S4CORE 104 - 19.08.2020 © Copyright SAP SE. All rights reserved.

Key
Project definition*

A framework for a business

undertaking with a fixed goal to
achieve with given resources.

The project definition contains

dates and organizational
information that are binding for the
entire project.

Type: Text
Length: 80
S element
Source Data for Migration Object: PS - WBS element
Version S4CORE 104 - 19.08.2020 © Copyright SAP SE. All rights reserved.

Key Basic Data

Project definition* Work Breakdown Structure Short description (1st text line) Project type
Element (WBS El*
A framework for a business Type: Text Key identifying a project type.
undertaking with a fixed goal to Enter a WBS element here, if the Length: 40
achieve with given resources. system should automatically Type: Text
statistically post transactions on Length: 80
The project definition contains this asset to this WBS element.
dates and organizational The external key of the WBS
information that are binding for the element is transferred in this field.
entire project. The system uses this key to
display the WBS element in the
interface of the system.
Type: Text In the Customizing definition of
Length: 80 the transaction types, you can
specify whether automatic
statistical posting should always
take place for given transactions.

Type: Text
Length: 80

Yes
lement

ata Respo
Priority Number of the Responsible Applicant number Controlling area for respons. cost
Person cente
Use this key to specify the priority. Type: Text
Type: Text Length: 80 Type: Text
Type: Text Length: 80 Length: 80
Length: 80

Yes
 Responsibilities
Responsible cost center Controlling area for reqe. cost Requesting cost center Requesting company code
cente
The key of the cost center of the Key for the cost center that Key of the company code that
WBS element where the activity is Type: Text requested the investment requests the investment measure
being carried out. Length: 80 measure. Organizationally the (order or WBS element).
WBS element is assigned to the
Type: Text responsible cost center; this can Type: Text
Length: 80 be the requesting cost center. Length: 80

Type: Text
Length: 80

YES
 Operative indicators
Indicator: Planning element Indicator: Account assignment Indicator: Billing element Indicator: Grouping WBS element
element
This indicator defines the WBS This indicator defines the WBS This indicator determines whether
element as a planning element. If you set this indicator, the WBS element as a billing element. a WBS element is used as a
element will be defined as an grouping WBS element.
Type: Text account assignment element. Type: Text
Length: 1 Length: 1 The indicator has two
Type: Text characteristic values:
Length: 1
1 Grouping WBS element for all
materials

2 Grouping WBS element for

selected MRP groups

Type: Text
Length: 80
 Dates - Basic Dates
Basic start date Basic finish date Duration Unit for duration

Type: Date Type: Date Length (duration) of the basic Unit for duration of basic WBS
dates in the WBS element element dates

Type: Number Type: Text

Length: 5 Length: 80
Decimal: 1

Yes Yes Yes

 Dates - Forecaset Dates
Forecast start Date Forecast finish Date Duration Unit for duration

Type: Date Type: Date Forecasted length (duration) of Unit for duration of WBS element
the WBS element planned dates

Type: Number Type: Text

Length: 5 Length: 80
Decimal: 1
 Plant Location Functional Area Profit Center

Key that uniquely identifies a Key that identifies the location. Structure criterion for an Key which together with the
plant. The location is subordinate entity enterprise or government based controlling area uniquely identifies
in a plant. on functional aspects. a profit center.
Type: Text Use
Length: 80 Type: Text Use for Cost-of-Sales Accounting: You can make an organizational
Length: 80 The functional area is required to assignment of a profit center to a
create a profit and loss account in controlling object (an order, cost
Financial Accounting using cost- center,…). The system posts
of- automatically on the profit center
sales accounting. The following when you make a posting on
are examples of structure criteria: controlling object
- Manufacturing (an order, cost center,…).
- Administration
- Sales
- Research and development
Type: Text
Length: 80
Type: Text
Length: 80

YES YES Yes

 Assignments
Calendar Equipment Number Functional Location Object class

Key that uniquely identifies the Number by which a piece of Label that uniquely identifies a The object class categorizes
factory calendar that is valid for equipment can be clearly functional location. Controlling objects according to
this plant. identified. their business function and
If alternative labels exist for a enables you to analyze cost flows
Type: Text Type: Text functional location, you can define within Controlling from different
Length: 80 Length: 80 in your user profile which label business perspectives.
should be displayed in this field.
The following object classes are
available:
Type: Text •Overhead
Length: 80 •Production
•Investment
•Profitability analysis and sales

Type: Text
Length: 80

YES
 WBS element currency Changing NO. Tax Jurisdiction Statistical WBS element

Costs and payments incurred in a Type: Text The tax jurisdiction is used for Use this indicator to specify
WBS element are managed in Length: 80 determining the tax rates in the whether a WBS element is only
controlling area currency and in USA. It defines to which tax for statistical purposes or whether
the object currency for the WBS authorities you must pay your it may carry actual costs.
element. When you create a WBS taxes. It is always the city to which
element, the system defaults the the goods are supplied. Costs and if required revenues
currency entered in the project are carried on such a WBS
definition as the object currency. Type: Text element for statistical purposes.
You can change the WBS element Length: 15 This means that:
object currency in the organization •For business transactions that
data for the WBS element. lead to actual costs/revenues
However, you cannot change the another object is required to carry
object currency once costs and/or the actual costs.
payments have been posted to •A statistical WBS element cannot
the WBS element. be settled.

Type: Text Additional Restriction:

Length: 80 You cannot settle overheads on
statistical WBS elements.

Type: Text
Length: 1
 Control - Accounting
Costing Sheet Overhead key Indicator for Integrated Planning Interest Profile for Project/Order
Inter
Type: Text The overhead key is used to This indicator specifies whether
Length: 80 determine order-specific or an order/project participates in The interest profile contains the
material-related overhead rates. integrated planning or not. You rules governing the interest
define this per project profile for calculation for projects.
Type: Text projects in Customizing: •The interest rate and update
Length: 6 control are defined when you
For orders, you can store a assign an interest indicator to the
default value in the order type, interest profile.
which you can change in the order •You also use the profile to define
master data when required. the interest relevance of costs,
revenues, and paymentss for the
Activity inputs planned in a plan- interest profile/interest indicator
integrated order/project are combination.
updated directly on the sending
cost center if 'Integrated planning
with Cost Center Accounting' is Type: Text
activated in the version. You can Length: 80
then also settle plan-integrated
orders/projects to cost centers.

Plan data is passed on to the

profit center and the extended
general ledger if both 'Integrated
planning with Cost Center
Accounting' and the "Integrated
planning" indicator are activated in
the version.

Type: Text
Length: 1
 Control - Investment Management
Investment Measure Profile Results Analysis Key Scale of investment objects Investment Reason

The investment profile is assigned Key that defines the valuation of Classifies measures, You can use this field to specify
to an internal order or work the order during period-end appropriation requests and the reason for an asset
breakdown structure element, and closing. investment program positions investment or a capital investment
then these objects are designated according to their size and scope. program position
as capital investment measures. Type: Text (for example, replacement
Length: 80 acquisition or investment for
You assign the investment profile Type: Text expansion).
by means of the order type or the Length: 80
project profile. Type: Text
Length: 80
You can specify, for example, the
following features of the capital
investment measure:

•Asset class(es) for the asset

under construction
•Asset class for depreciation
simulation

Type: Text
Length: 80
nt Management User Fields - General fields
Reason for Environmental Fields key Text 1 Text 2
Investment
Type: Text Type: Text Type: Text
You can enter the reason for an Length: 80 Length: 20 Length: 20
environmental investment in this
field.
In Configuration for Asset
Accounting, you can define any
number of environmental criteria
as allowed entries for this field.

Type: Text
Length: 80
eneral fields
Text 3 Text 4 Quantity 1 Unit for quantity fields 1

Type: Text Type: Text Type: Number Type: Text

Length: 10 Length: 10 Length: 13 Length: 80
Decimal: 3
 User Fields - Numeric fields
Quantity 2 Unit for quantity fields 2 Value 3 Unit for quantity fields 3

Type: Number Type: Text Type: Number Type: Text

Length: 13 Length: 80 Length: 13 Length: 80
Decimal: 3 Decimal: 3
 User Fields - Dates
Value 4 Unit for quantity fields 4 Date 1 Date 2

Type: Number Type: Text Type: Date Type: Date

Length: 13 Length: 80
Decimal: 3
 User Fields - Checkbox
Indicator 1 Indicator 2

Type: Text Type: Text

Length: 1 Length: 80