1 IS Migration Workbench
1.1 Introduction to the IS Migration Workbench
1.2 Proven Concepts
1.3 General Description
2 Functions in Detail
2.1 Load Program
2.2 Migration Company
2.3 User Parameters
2.4 Field Rules
2.4.1 Field Rule Initial Value
2.4.2 Field RuleFixed Value
2.4.3 Field RuleTransfer
2.4.4 Field RuleABAP Rule
2.4.5 Field Rulevia KSM
2.4.6 Field RuleConversion
2.4.7 Field Rule Customer Field
2.5 Key and Status Management
2.5.1 General Description
2.5.3 Use of the KSM in Field Rules
2.5.4 Planning for Unique Oldkeys
2.6 Data Import
2.6.2 Import File Transformation
2.6.3 Import File Editor
2.6.5 Migration Statistics
2.7 Distributed Import
2.7.1 General Description
2.7.4 Alternative Job Distribution
2.7.5 User-Exit in Master Job
2.8 Migration Lock Mechanism
2.10 Change Requests
2.10.1 Transport with Change Requests
2.10.2 Transport of Migration Objects in Text Files
3 Migration Object
3.2 Migration Class
3.3 Pre-Configured Migration Objects
3.3.1 Migration Objects for all Solutions
3.3.2 Migration Objects for Regional Structure
3.3.3 Migration Objects for Business Master Data
3.3.4 Migration Objects for Financial Data
3.3.5 Migration Objects for Miscellaneous Data
3.3.6 Migration Objects Specific to SAP for Utilities
3.3.7 Migration Objects Specific to SAP for Waste and Recycling
3.3.8 Migration Objects for Budget-Billing Plans
3.3.9 Migration Object for Plant Maintenance (PM)
3.3.10 Migration Objects specific to SAP for Insurance
3.3.11 Migration Objects specific to SAP for Public Sector
3.4 Generation of Own Migration Objects
3.4.1 Generation of a BDC Migration Object
3.4.2 Generation of a BAPI Migration Object
3.5 Hyper Object
3.5.3 Creation Procedure (Hyper Object)
3.5.4 Creation Procedure (Reference to Migration Object)
3.5.5 Generation of the Load Report
o Generation of the load report
3.6 Migration Control Parameter
3.6.1 General Control Parameters
3.6.2 Control Parameters Specific to SAP for Utilities
3.6.3 Configuring Control Parameters
3.6.4 Function Module ISU_MIG_STATUS
4 Enhancing a Load Program
4.2 Layout of the Load Program
4.3 Custom Code in a Load Program
4.3.1 Code on Field level
4.3.2 Code on Structure Level
4.3.3 Code on Report Level
4.3.4 Error Handling in Custom Code
4.4 Customer-Defined or Additional Fields
4.4.1 Additional Fields in the IS Migration Workbench
4.4.2 Enhancement Fields in the Solution
4.4.3 Enhancement Fields for Technical Master Data (SAP for Utilities)
4.4.4 Enhancement Fields for a Point of Delivery (SAP for Utilities)
4.4.5 Enhancement Fields for Business Partners
4.4.6 Enhancement Fields for Contract Accounts
5 Migrating Custom Tables (z-Table)
5.2 Migrating Custom Tables Using an Existing Migration Object
5.3 Migrating Custom Tables Using an Own Migration Object
6 Migration Strategies (SAP for Utilities)
6.2 Installation Structure History
6.2.1 Standard Scenario (No Installation Structure History)
6.2.2 Extended Device History
6.2.3 Extended Billing History
6.3 Historical Billing Document
6.3.1 Migration Objects Relevant for Migrating Billing Documents
6.3.2 Easy Bill Correction Framework (EBF)
6.4 Historical Rate Data
6.5 Historical Consumption
6.6 Device Group
6.7 Disconnection and Reconnection
6.8 Sample Lots
6.9 Point of Delivery
6.10 Service Provider
6.11 Energy Data Management (EDM)
6.12 Installment Plan
6.13 Dunning History
6.14 Collection Agency
6.15 Cash Security Deposit
6.16 Budget-Billing Plan
6.17 Payment Scheme
6.18 Replication to SAP CRM
6.18.1 Data Model
6.18.2 Replication Strategies
7 FAQ (Frequently Asked Questions)
7.2 FAQ Usage of the IS Migration Workbench
7.2.1 One or more fields cannot be found in a migration object
7.2.2 Why is it required to transfer default information?
7.2.3 Error EM 024: Object in import file header does not correspond
7.2.4 Error EM 044: Change not possible due to blocking status
7.2.5 Warning EM 188: Mandatory indicator deleted
7.2.6 Error EM 104: Table x not supplemented
7.2.7 How canTEMKSV database table become part of a client copy?
7.2.8 Can the rows inTEMKSV database be deleted after go-live?
7.2.9 Why to re-generate the load report after a transport request?
7.2.10 Data Migration works in one system but not in a second system
7.2.11 Why does delta replication not work during data migration?
7.2.12 Why does theCRM_REPL_OFF control parameter not work?
7.3 FAQ Migration of Addresses
7.3.1 Can the address validation be deactivated during data migration?
7.3.2 How to deal with uncleansed addresses in test migration cycles
7.4 FAQ Migration of Business Partner
7.4.1 How to migrate addresses of a business partner?
7.4.2 How to change a migrated address of a business partner
7.4.3 How to create SD customers while migrating business partner
7.4.4 How transfer data for only fields which are subject to be changed?
7.4.5 Error R1 140: Specify at least one valid business partner role
7.4.6 How to migrate identification numbers of business partners?
7.4.7 Migration of direct input structures that are not part of the standard?
7.4.8 Error AM 890: Internal Error - Value range of LV_DEF_CNR
7.5 FAQ Migration of Contract Account
7.5.1 Error >3 047: Specify bank details for incoming payment methods
7.5.2 Error >3 399: Specify a standard company code of contract accounts
7.5.3 Error >0 425: Field DFKKLOCKS-LOTYP is not ready for input
7.5.4 Error >1 004: Administrative data not defined for application T
7.5.5 How transfer data for only fields which are subject to be changed?
7.6.2 Error >0 200: Posting period for company code already closed
7.7 FAQ Migration of Open Item
7.7.1 Error >0 009: Reconciliation key already in use
7.7.2 Is it possible to reuse reconciliation keys?
7.7.3 Migrating open items with division but without contract information?
7.7.4 Migrating open items with VAT tax amounts
7.7.5 Can migrated financial documents be reversed?
7.7.6 Are there any migration specific FI-CA events?
7.8 FAQ Migration of Payment
7.8.1 Why do migrated payments not clear open items?
7.8.2 Error due to competing processes
7.8.3 Error >0 009: Reconciliation key already in use
7.8.4 Is it possible reusing reconciliation keys
7.8.5 Is it possible to use theDOCUMENT migration object for payments?
7.8.6 Error >4 036: “Document does not exist” when paying security deposits
7.9 FAQ Meter Reading
7.9.1 Creating move-in meter reading during device installation
7.9.2 Creating different meter reading types during device installation
7.9.3 Billing Error “Move-in meter reading missing or incorrect”
7.10 FAQ Creation of Inactive Contracts
7.10.1 How suppress billing triggers when migrating inactive contracts
7.10.2 Error AH385: Contract must be billed first?
7.10.3 Creating meter reading orders with reason move-out?
7.10.4 Creating active contracts with theMOVE_IN_H migration object?
7.11 FAQ SAP for Utilities
7.11.1 No update of business partner addresses during move-in
7.11.2 Migration of multiple time slices for an installation
7.11.3 The start date of the device group is set to the system date?
7.11.4 PRUEFKLE field remains empty after device installation
7.11.5 No migration of custom fields for device locations
7.11.6 Error AH 348: The facts are not consistent
7.11.7 Error M3 897: Plant data of material is locked
7.11.8 How to migrate equipments?
7.11.9 How to migrate historical service notifications?
7.11.10 Error IO 151: Error while processing theMASE record?
7.11.11 How to use mass processing for BBP_MULT migration object?
7.11.12 How to use mass processing forSECURITY migration object?
7.11.13 How to migrate long texts of functional locations?
7.11.14 How to migrate classification data of function locations?
7.12 FAQ Miscellaneous
7.12.1 What are the correct dates for migrating data?
7.12.2 Runtime error with conditionOBJECT_NOT_FOUND?
7.12.3 How to send e-mails and SMS during data migration?
7.12.4 How to debug a load program
7.12.5 How to create a migration object to execute an ABAP program?
7.12.6 How to Execute Programs in a Group Import?
8 Migration from SAP System to SAP System
9 Appendix with ABAP Code Snippets
9.1 Service Function Module for EDM RTP Interface
9.2 Direct Input Modules for Contract Account (BDT)
9.3 Service function Module to Migrate a Custom Table
9.4 Function Module to Determine Reconciliation Keys for a Reuse
9.5 Function Module to Send a Status Email During Data Import
9.6 Service Function Modules for Service Notifications
9.7 Service Function Module to Execute a Program
10 Getting Started
10.2 Start of the IS Migration Workbench
10.3 Creation of a Migration Company
10.4 Creation of a Migration User
10.5 Copy of a Migration Object
10.6 Maintenance of the Structure Customizing
10.7 Maintenance of the Field Customizing
10.8 Creation of an Import File
10.9 Execution of a Data Import