| Status | |
|---|---|
| Owner | |
| Stakeholders | The business stakeholders involved in making, reviewing, and endorsing this decision. Type @ to mention people by name |
The purpose of this document is to define the conversion approach to create EAM Class in S/4 HANA.
Legacy Plant Maintenance Class is using a diverse range of formats across the different systems. There are instances where the same classes are duplicated within and across sources, with informal words. This results in data inconsistency. As per SyWay design, EAM classes will be standardized.
The scope of this document covers the approach for converting active EAM Classes from Legacy Source Systems into S/4HANA following the EAM Class Master Data Design Standard.
Grouping of objects with particular features can be achieved by creating Classes in the S/4 HANA system. A large number of objects can be managed and logically organized using this functionality.
Syensqo will utilize SAP Classification system (class and characteristic functionality) to assign any additional data attributes to following objects:
Classes allow you to group objects based on specific criteria that you define.
From the current source systems’ perspective, Class and Characteristic concepts already exist (but in slightly different structure). Class data values are independently managed between PF2 and WP2. While these have been identified as source systems, a considerable amount of data construction will be required to support the production of data load sheets in the desired format.
The data from legacy system includes:
The data from legacy system excludes:
List of source systems and approximate number of records
| Source | Scope | Source Approx No. of Records | Target System | Target Approx No. of Records |
|---|---|---|---|---|
| PF2, WP2 | Class will be collected via DCT. An initial extract of the relevant classes will be provided in google sheet format to assist business in decision making on including any relevant classes from PF2 and WP2 as EAM Class. Any additional classes that need to be created to support the new design may be added in the DCT. A review and standardization will be done across all classes in the DCT. Please see an indication of what will be baselined from source systems below and what will be constructed in the DCT. | 1,500 | 3,000 |
EAM Class description will be made available in English.
Multi language is supported for EAM Class. Login via a different language will have its description displayed in the logon language if the language key is maintained in the Class.
Not Applicable
Not Applicable
Not Applicable
The technical design of the target for this conversion approach.
1. Class
| Table | Field | Data Element | Field Description | Data Type | Length | Requirement |
|---|---|---|---|---|---|---|
| KLAH | CLASS | KLASSE_D | Class number | CHAR | 18 | Mandatory |
| KLAH | KLART | KLASSENART | Class Type | CHAR | 3 | Mandatory |
| KLAH | STATU | KLSTATUS | Class status | CHAR | 1 | Mandatory |
| KLAH | KLAGR | KLASSENGR | Class Group | CHAR | 10 | |
| KLAH | VONDT | VONDAT | Valid-From Date | DATS | 8 | Mandatory |
| KLAH | BISDT | BISDAT | Valid-to date | DATS | 8 | Mandatory |
| KLAH | PRAUS | GLKLAFZ | Same Classification/ Do Not Check | CHAR | 1 | Mandatory |
| SWOR | KSCHL | KSCHL | Description | CHAR | 40 | Mandatory |
| SWOR | KSCHL | KSCHL | Keyword | CHAR | 40 | Mandatory |
2. Class Descriptions
| Table | Field | Data Element | Field Description | Data Type | Length | Requirement |
|---|---|---|---|---|---|---|
| KLAH | CLASS | KLASSE_D | Class number | CHAR | 18 | Mandatory |
| KLAH | KLART | KLASSENART | Class Type | CHAR | 3 | Mandatory |
| SWOR | KSCHL | KSCHL | Description | CHAR | 40 | Mandatory |
| SWOR | SPRAS | SPRAS | Language Key | LANG | 1 | Mandatory |
Note: Each Characteristic must have 1 entry for each language in scope: English, French, Italian, Mandarin, Brazilian, Portuguese, German and Spanish
3. Class Keywords
| Table | Field | Data Element | Field Description | Data Type | Length | Requirement |
|---|---|---|---|---|---|---|
| KLAH | CLASS | KLASSE_D | Class number | CHAR | 18 | Mandatory |
| KLAH | KLART | KLASSENART | Class Type | CHAR | 3 | Mandatory |
| SWOR | SPRAS | SPRAS | Language Key | LANG | 1 | Mandatory |
| SWOR | KSCHL | KSCHL | Keyword | CHAR | 40 | Mandatory |
Note: One Class should have at least one corresponding Class Keyword which is the same as Class Description.
4. Characteristic Assignment
| Table | Field | Data Element | Field Description | Data Type | Length | Requirement |
|---|---|---|---|---|---|---|
| KLAH | CLASS | KLASSE_D | Class number | CHAR | 18 | Mandatory |
| KLAH | KLART | KLASSENART | Class Type | CHAR | 3 | Mandatory |
| KSML | IMERK | ATINN | Internal characteristic | NUMC | 10 | Mandatory |
| CABN | ATBEZ | ATBEZ | Characteristic Definition | CHAR | 40 |
No data cleansing is required for Classes in the legacy systems. If any cleansing is deemed necessary, it will be performed outside of the systems.
As a result, the cleansed Characteristics data will be populated directly in the Data Collection Template (DCT).
| ID | Criticality | Error Message/Report Description | Rule | Output | Source System |
|---|---|---|---|---|---|
| Not Applicable |
The high-level process is represented by the diagram below:

Collection will be done manually in the Data Collection Template for the following scenarios:
Data Privacy and Sensitivity
Not ApplicableExtract data from a source into Syniti Migrate. There are 2 possibilities:
The agreed Relevancy criteria is applied to the extracted records to identify the records that are applicable for the Target loads
| Req # | Requirement Description | Team Responsible |
|---|---|---|
| 1 | Extract data from source system based on relevancy rule | SyWay Data Team |
| 2 | Google Sheet report pre-populated with PF2 and WP2 information to be generated based on relevancy criteria. | SyWay Data Team |
| Selection Ref Screen | Parameter Name | Selection Type | Requirement | Value to be entered/set |
|---|---|---|---|---|
| Not Applicable |
Target Ready Data Collection Template will be created for EAM Class data with exception of some fields which require transformation as mentioned in the transformation rule.
1. Class DCT Rules
| Field Name | Field Description | Rule |
|---|---|---|
| CLASS | Class number | Mandatory. NAMING CONVENTION: Class Name for Functional Location and Equipment will be: EAM_X_XX_XXX: Classes shall be created such that they can be Reusable. |
| KLART | Class Type | Mandatory. Allowed Values: 001-Material Class Classes are created within the class type for the respective technical objects |
| STATU | Class status | Mandatory. Allowed Values: 0: In Preperation |
| KLAGR | Class Group | Conditional. If the Class belongs to a group of similar Classes, assign it to the appropriate Class group. Otherwise, leave the field blank.
|
| VONDT | Valid-From Date | Mandatory. User must provide a value indicating when this characteristic will be valid for use. Otherwise, leave blank. |
| BISDT | Valid-to date | Conditional. User must provide a value indicating when this characteristic will be valid for use. Otherwise, leave blank. |
| PRAUS | Same Classification/ Do Not Check | Mandatory |
| KSCHL | Description | Mandatory |
| KSCHL | Keyword | Mandatory |
| IMERK | Internal characteristic | |
| ATBEZ | Characteristic Definition |
2. Class Description DCT Rules
| Field Name | Field Description | Rule |
|---|---|---|
| CLASS | Class number | Mandatory |
| KLART | Class Type | Mandatory |
| KSCHL | Description | Mandatory |
| SPRAS | Language Key | Mandatory |
3. Class Keyword DCT Rules
| Field Name | Field Description | Rule |
|---|---|---|
| CLASS | Class number | Mandatory |
| KLART | Class Type | Mandatory |
| SPRAS | Language Key | Mandatory |
| KSCHL | Keyword | Mandatory |
4. Characteristic Assignment DCT Rules
| Field Name | Field Description | Rule |
|---|---|---|
| CLASS | Class number | Mandatory |
| KLART | Class Type | Mandatory |
| IMERK | Internal characteristic | Mandatory |
| ATBEZ | Characteristic Definition |
List the steps that need to occur before extraction can commence
| Item # | Step Description | Team Responsible |
|---|---|---|
| 1 | Relevancy Criteria for PM Assembly / Construction Types | SyWay A2D Data Team |
| 2 | Relevancy Criteria for Functional Location | SyWay A2D Data Team |
| 3 | Relevancy Criteria for Equipment | SyWay A2D Data Team |
| 4 | Relevancy Criteria for Task List | SyWay A2D Data Team |
| 5 | Relevancy Criteria for Work Centre | SyWay A2D Data Team |
| 6 | Relevancy Criteria for Measuring Point | SyWay A2D Data Team |
The Target fields are mapped to the applicable Legacy field that will be its source, this is a 3-way activity involving the Business, Functional team and Data team. This identifies the transformation activity required to allow to make the data Target ready:
| Item # | Step Description | Team Responsible |
|---|---|---|
| 1 | Obtain DCT Sign-off from Business | SyWay A2D Data Team |
| 2 | <Add steps from Syniti Migrate here> | SyWay A2D Data Team |
| 3 | Review and Validate Error and Preload Reports | SyWay A2D Data Team |
| 4 | Generate Load Files | SyWay A2D Data Team |
Transformation Rules
There are no transformation rules all values will be copied from DCT.
| Rule # | Source system | Source Table | Source Field | Source Description | Target System | Target Table | Target Field | Target Description | Transformation Logic |
|---|---|---|---|---|---|---|---|---|---|
| DCT | CLASS | Class number | KLAH | CLASS | Class number | Direct Mapping | |||
| DCT | KLART | Class Type | KLAH | KLART | Class Type | Direct Mapping | |||
| DCT | VONDT | Valid-From Date | KSML | DATUV | Valid-From Date | Direct Mapping | |||
| DCT | KLBEZ | Description | SWOR | KLBEZ | Description | Direct Mapping | |||
| DCT | STATU | Class status | KLAH | STATU | Class status | Direct Mapping | |||
| DCT | KLAGR | Class Group | KLAH | KLAGR | Class Group | Direct Mapping | |||
| DCT | VONDT | Valid-From Date | KLAH | VONDT | Valid-From Date | Direct Mapping | |||
| DCT | BISDT | Valid-to date | KLAH | BISDT | Valid-to date | Direct Mapping | |||
| KLAH | PRAUS | Same Classification/ Do Not Check | |||||||
| KLAH | BGRKP | Class maintenance authorization group | |||||||
| KLAH | BGRKL | Class authorization group | |||||||
| KLAH | BGRSE | Authorization group for finding objects | |||||||
| KLAH | ANZUKZ | Indicator Assignments Exist | |||||||
| KLAH | ERNAM | Name of Person who Created the Object | |||||||
| KLAH | ERDAT | Date on Which Record Was Created | |||||||
| KLAH | AENAM | Name of Person who Changed the Object | |||||||
| KLAH | ADATU | Date on Which Record Was Changed | |||||||
| KSML | KSCHL | Keyword | |||||||
| DCT | ATNAM | Characteristic Name | CABN | ATNAM | Characteristic Name | Direct Mapping |
| Mapping Table Name | Mapping Table Description |
|---|---|
| Not Applicable |
| Item # | Step Description | Team Responsible |
|---|---|---|
| 1 | Ensure DCT tables completeness | SyWay A2D Data Team |
| 2 | Run relevancy procedures in Syniti Migrate | |
| 3 | Value Mappings are according to the latest design - None for Class | SyWay A2D Data Team |
| Task | Action |
|---|---|
| Verify Record Count | SyWay A2D Data Team to verify that the total number of relevant records from the DCT is equal to the total number of records in the Preload and Load Sheets. |
| Task | Action |
|---|---|
| Conversion Accuracy | SyWay A2D Data Team to verify that all fields below meet pass the checks:
|
| Review Error Reports | Review and correct the errors. Achieve a zero-error record count as much as possible. Raise defects for data remediated and requiring a correction in the source data. |
| Task | Action |
|---|---|
| Verify Record Count | Business Data Owner/s to verify that the total number of relevant records from the the DCT is equal to the total number of records in the Preload and Load Sheets. |
| Task | Action |
|---|---|
| Conversion Accuracy | Business Data Owner/s to verify that all the data in the load table/file is accurate as per endorsed transformation/mapping rules (and signed-off DCT data). |
The load process includes:
| Item # | Step Description | Team Responsible |
|---|---|---|
| 1 | Go to <Load Tool> | SyWay A2D Data Team |
| 2 | Load 3 records for "Create Class" function to validate if data is loaded successfully without errors | SyWay A2D Data Team |
| 3 | Load 3 records for "Assign Characteristics" function to validate if data is loaded successfully without errors | SyWay A2D Data Team |
| 4 | Proceed with full load if steps 2 and 3 are validated | SyWay A2D Data Team |
| 5 | Validate few records loaded by accessing standard transactions from S/4HNA E.g. CL03 / CL6AN for Class | SyWay A2D Data Team |
| 6 | Generate post load report if step 5 is validated | SyWay A2D Data Team |
Load Phase and Dependencies
Identify the phase as to “when” the load for this object will occur. <Pre-Cutover, Cutover, Post Cutover> and list the steps that need to occur before the load can commence
List the Configurations required before loading can commence
| Item # | Configuration Item |
|---|---|
| 1 | TCLA-Class Types |
| 2 | TCLG-Class Groups |
| 3 | TCLU-Class Status |
| Object # | Preceding Object Conversion Approach |
|---|---|
| 1015 | Characteristics |
The table below depicts some possible system errors for this data object during data load. All data load error is to be logged as defect and managed within the Defect Management
| Error Type | Error Description | Action Taken |
|---|---|---|
| Configuration | Invalid Class Type | Engage Functional team to expedite and fix the error in the system |
| Configuration | Invalid Class Group | Engage Functional team to expedite and fix the error in the system |
| Configuration | Invalid Class Status | Engage Functional team to expedite and fix the error in the system |
Invalid Data | Invalid or Inactive Characteristic assigned | Expedite whether the master data is changed in the system |
| Task | Action |
|---|---|
Verify Count | SyWay A2D Data Team to verify the record count created in target S/4 HANA by accessing post load reports in dspMigrate or standard reports from S/4 HANA. |
Verify Logs | Check if there is data that failed to load and perform the necessary actions (e.g. register as post load issue or attempt to load the record again, etc.). |
| Task | Action |
|---|---|
Conversion Accuracy | Verify that the EAM Class data in target S/4 HANA were loaded correctly via dspMigrate post load reports or standard reports from S/4 HANA. |
| Task | Action |
|---|---|
Verify Count | Download Post Load Reports from dspMigrate and verify that the record count loaded in the target S/4 HANA is the same count as of the endorsed load file. |
| Task | Action |
|---|---|
Conversion Accuracy | Verify that the EAM Class data in target S/4 HANA were loaded correctly via dspMigrate post load reports or standard reports from S/4 HANA. |
Any additional key assumptions.
Insert links and references to other documents which are relevant when trying to understand this decision and its implications. Other decisions are often impacted, so it's good to list them here with links. Attachments are also possible but dangerous as they are static documents and not updated by their authors.