Data Migration To SAP S/4HANA From File (BH5)
Data Migration To SAP S/4HANA From File (BH5)
Data Migration To SAP S/4HANA From File (BH5)
Table of Contents
1 Purpose 3
2 Prerequisites 4
2.1 System Access 4
2.2 Roles 4
2.2.1 Technical Roles 4
4 Business Conditions 7
5 Overview Table 8
6 Test Procedures 9
6.1 Start the SAP S/4HANA Migration Cockpit 9
6.2 Create Migration Project 10
6.3 Download Migration Template 12
6.4 Prepare Test Data 13
6.5 Transfer Data from Template Files to Staging Tables 15
6.6 Prepare and Simulate the Migration 16
6.7 Migrate Data to the Target System 18
6.8 Validate Imported Data 19
7 Appendix 20
7.1 FAQs 20
7.2 General Topics and Limitations 20
7.2.1 Migration Template File Size 20
7.2.2 Unit of Measure Conversion 20
7.2.3 ALE/IDoc Distribution After Data Migration 20
7.3 Financials 21
7.3.1 Define Settings for Legacy Data Transfer (FINS_MIG_CTRL_1) 21
7.4 Logistics 22
7.4.1 Advanced Variant Configuration 22
7.4.2 How to Handle Cross-Plant Material Status and Plant-Specific Material Status 23
SAP S/4HANA customers can take advantage of template-based migration built into SAP S/4HANA using the SAP S/4HANA Migration Cockpit together with a set of predefined data migration
objects.
Customers using template files to migrate data using the SAP S/4HANA Migration Cockpit should choose the "Local SAP S/4HANA Database Schema" in the "Database Connection" field.
Note SAP S/4HANA refers to the default on-premise suite on the SAP HANA platform, SAP S/4HANA Cloud refers to our cloud suite on SAP Cloud Platform.
This document provides a detailed procedure for testing this scope item after solution activation, reflecting the predefined scope of the solution. Each process step, report, or item is covered in its
own section, providing the system interactions (test steps) in a table view. Steps that are not in scope of the process but are needed for testing are marked accordingly. Project-specific steps must be
added.
Data protection legislation may require that personal data is deleted once the data has served its originally defined purpose and is also no longer subject to additional legal data retention
requirements. If data protection legislation is applicable in your case, then migrating personal data which should have been deleted could be interpreted as the processing of personal data without any
legally justified purpose.
Migration objects are built for initial migration of your data to your SAP S/4HANA or SAP S/4HANA Cloud system. This means that you can create data with a migration object, but you can't
change or update existing data with it.
For some migration objects there are "Extend" migration objects available, that you can use to extend existing data to other organizational levels. If you want to change or update existing data, use
the respective maintenance apps (available for all business objects) or mass processing apps (these are only available for selected business objects). Please note that such apps fall outwith the
responsibility of data migration development.
This section summarizes all the prerequisites for conducting the test in terms of systems, users, master data, organizational data, other test data and business conditions.
System Details
System Accessible via SAP Fiori launchpad. Your system administrator provides you with the URL to access the various apps assigned to your role.
2.2 Roles
Additionally, the corresponding role for each migration object is also required. For example, the Cash Manager (SAP_BR_CASH_MANAGER) role for the Bank migration object.
Key Mapping
Use the following standard role to access the Search Key Mapping (MDG_BS_WD_ANALYSE_IDM) and Manage Key Mapping (MDG_BS_WD_ID_MATCH_SERVICE) apps. You can use these
apps to check the key mappings that were entered in the Unified Key Mapping Service (UKMS) during the data load. Currently, UKMS supports the following migration objects:
● Customer
● Supplier
You can find an extensive table listing all migration objects available for SAP S/4HANA, together with their respective migration object documentation, in the SAP S/4HANA product assistance or
via the short link https://help.sap.com/S4_OP_MO.
The data migration object documentation was moved to the SAP Help Portal with SAP S/4HANA 1909. If you encounter issues opening the documentation from the Migration Cockpit directly, refer
to SAP Note 2667053 and SAP Knowledge Base Article 2793425.
Before this scope item can be tested, the following business conditions to be met:
This scope item consists of several process steps provided in the table below.
This section describes test procedures for each process step that belongs to this scope item.
Test Administration
Test Case ID <X.XX> Tester Name Testing Date Enter a test date.
Business Role(s)
Responsibility <State the Service Provider, Customer or Joint Service Provider and Customer> Duration Enter a duration.
Use
This section describes how you start the SAP S/4HANA Migration Cockpit.
Procedure
Test Step # Test Step Name Instruction Expected Result Pass / Fail / Comment
1 Start SAP Fiori launchpad Log on to your SAP S/4HANA system. The Home page appears.
2 Open Migration Cockpit Choose the Migrate Your Data (F3473) tile.
Note For more information on the SAP S/4HANA Migration Cockpit in SAP S/4HANA, see the product assistance on the SAP Help Portal.
Test Administration
Test Case ID <X.XX> Tester Name Testing Date Enter a test date.
Business Role(s)
Responsibility <State the Service Provider, Customer or Joint Service Provider and Customer> Duration Enter a duration.
Use
This section describes how you create a migration project in the migration cockpit.
Procedure
5. Create Migration Double-check your project settings and choose Create Project.
Project
The system automatically generates a mass transfer ID that is available in the system and can be used for your project.
You can also enter your own mass transfer ID. Your own mass transfer ID must start with the letter M, N, or O.
When you choose Display Next Available, the system will show the next available mass transfer ID.
Further Information
Find further information about project settings in the product assistance on the SAP Help Portal.
Test Administration
Business Role(s)
Responsibility <State the Service Provider, Customer or Joint Service Provider and Customer> Duration Enter a duration.
Use
If you are using template files to populate the staging tables with data, you need download a template file for a migration object and enter the data to be migrated in the file.
Procedure
Note Depending on your internet browser and its version, a download dialog of the browser might appear. If it appears, choose Save to store the migration template on your local PC. If you are not
prompted to save the file, the migration template will automatically be stored in your default download folder.
Result
The Microsoft Excel XML Spreadsheet 2003 template is downloaded and saved on your local PC.
Note Depending on your internet browser, you might have to add the file extension .xml to your downloaded file.
Test Administration
Test Case ID <X.XX> Tester Name Testing Date Enter a test date.
Business Role(s)
Responsibility <State the Service Provider, Customer or Joint Service Provider and Customer> Duration Enter a duration.
Use
This section describes how you enter test data for migration to SAP S/4HANA into the migration template.
Prerequisite
In the Microsoft Excel file navigate to File > Options > Advanced . Under When calculating this workbook:, ensure that Set precision as displayed is selected.
Important Information
Caution The workbook and its sheets are protected. Never change the structure and don’t make any changes on the format of the migration template: Don’t delete, rename, or reorder any sheet in the
XML file, don’t change the cell formatting, don’t use formulas, and don’t hide, remove, or reorder any column in the XML file. Moreover, don't change data by Find and Replace function. If you
change data by Find and Replace you may also accidentally change the field names and corrupt the XML structure. A modified migration template will cause errors when trying to load into the
migration cockpit or will cause errors during the data migration process.
Caution When copying data into the migration template, always use the Paste Option: Values (V). Avoid to paste data including formatting and formulas into the template as this might lead to a
corrupted XML file.
● In migration cockpit there is value mapping available for most fields. This means that you can enter your source data value and later map it in the migration cockpit to a valid SAP S/4HANA
value.
Procedure
6. Close the File Choose Close in the Microsoft Excel application. The Microsoft Excel
application is closed.
Test data is entered into the Microsoft Excel XML Spreadsheet 2003 template.
Test Administration
Test Case ID <X.XX> Tester Name Testing Date Enter a test date.
Business Role(s)
Responsibility <State the Service Provider, Customer or Joint Service Provider and Customer> Duration Enter a duration.
Use
This section describes how you transfer your data from the migration template to staging tables.
Procedure
Test Administration
Test Case ID <X.XX> Tester Name Testing Date Enter a test date.
Business Role(s)
Responsibility <State the Service Provider, Customer or Joint Service Provider and Customer> Duration Enter a duration.
Use
Before migrating your data to the productive system, you need to conduct a couple of preparational steps.
Procedure
Test Administration
Test Case ID <X.XX> Tester Name Testing Date Enter a test date.
Business Role(s)
Responsibility <State the Service Provider, Customer or Joint Service Provider and Customer> Duration Enter a duration.
Use
This section describes how you migrate your data into your target system.
Result
The data is transferred from the staging table to the target system.
Test Administration
Test Case ID <X.XX> Tester Name Testing Date Enter a test date.
Business Role(s)
Responsibility <State the Service Provider, Customer or Joint Service Provider and Customer> Duration Enter a duration.
Use
This section describes how you validate completeness and correctness of the migrated data in the target system using corresponding business functions.
Test Step Test Step Name Instruction Expected Result Pass / Fail /
# Comment
1 Access the Corresponding Open the corresponding transaction of the SAP S/4HANA system and All migrated data is displayed in the corresponding
Transaction check completeness of the imported data. SAP S/4HANA transaction.
Note Check the migration object documentation for the name of the required app and the corresponding business role, or for the required backend transaction to validate the data in the system.
Result
7.1 FAQs
For frequently asked questions regarding migrating data using the SAP S/4HANA Migration Cockpit, see SAP Knowledge Base Article 2733253.
Before you go live with SAP S/4HANA, you may want to do an initial transfer of open balances and open items from a legacy system to your SAP S/4HANA system. You transfer such data using
the SAP S/4HANA Migration Cockpit.
To enable the cockpit to transfer your legacy financial transactional data properly, use the Define Settings for Legacy Data Transfer (FINS_MIG_CTRL_1) app to maintain the migration key date
on which you want to complete all preparatory activities for each company code before the actual data transfer.
Alternatively, you can use the FINS_MIG_CTRL_1 transaction in the backend to maintain the migration key date.
The migration key date must allow for you to complete the following actions:
● Complete all postings available up to this date, in full, in the source system
● Reconcile and close the journals in the source system for the period
● Extract source data and enter it into the migration templates
● Clean and convert data as needed
● Validate the imported data against your legacy system
The date chosen is usually the end of a period (month, quarter, year) since this will fit in with the normal reconciliation cycle.
Please note that the migration key date is also used as the posting date when the legacy data is actually transferred to your SAP S/4HANA system.
Set the Legacy Data Transfer Status for each migration key date provided:
● In Preparation: migration key date is still unclear (migration of transactional data is not possible)
● Ongoing: required for the initial data transfer (migration of transactional data is possible)
● Completed: after successful completion of the initial data transfer (migration of transactional data is not possible)
For the following financial objects, the posting date will be automatically derived by the predefined migration key date for the related company code which is maintained via the aforementioned app:
● FI - Accounts payable open item
● FI - Accounts receivable open item
● FI - G/L account balance and open/line item
● Material inventory balance
● FI - Historical balance (migration key date is required to allow the migration of historical balances only up until this initial transfer date)
● For the financial object FI-CA - Open item, a field for posting date is available on the migration template. The posting date is marked as mandatory on the template and must be provided for each
data record. The migration key date has no additional effect on the provided posting date.
● For the financial object Fixed asset - Master data, use the FAA_CMP transaction to specify the data transfer date, document type, and the legacy data transfer status.
7.4 Logistics
Example
In SAP standard delivery, the material status '01' is configured in such a way that, during posting of inventory, you will receive an error message. Consider that by assigning the status, the use of the
material can be restricted. Depending on the status, the system issues either a warning message or an error message for follow-on postings. Therefore, SAP recommends that you consider this field
carefully so that you will not run into follow-on problems during the data migration process. You can easily set the content of these fields after the initial data migration using the Mass Maintenance
app.
The Master Data Specialist - Product Data (SAP_BR_PRODMASTER_SPECIALIST) business role provides you with several tiles to manage and start the Mass Maintenance app. The app can be
launched from the SAP Fiori launchpad. You can import a file with changed data (supported formats are Comma-Separated Values (CSV) and Office Open XML spreadsheet (XLSX). You have to
provide the following details:
● Which master data objects are updated.
● Which tables and fields to update and the respective values.
For further information, refer to the online documentation of the Mass Maintenance app.