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. Note: A full Data Construct will be created for Class, as the SyWay design is changing and a complete standardization will be performed. While data may already exist, it cannot be easily transformed to align with the new SyWay data setup. | 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 |
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 Class 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: Each Class must have at least one corresponding Class Keyword, which should be identical to the 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 |
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 as reference point to identify the records that are applicable for the data construction in the DCT.
| 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.
Delta Data Management: Initial collection will be done via the report and one-time load to the DCT will be performed. Any delta after the initial collection within the DCT will require business to take due diligence to ensure any subsequent delta cleansing is verified and aligned within the DCT.
Note: All rules specified below should be documented as a tooltip in the DC Page.
Format:
1. Class Data Construction 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. A General Class(EAM_GNRL / EAM_9999) shall be created to group all the Characteristics that range across all the Master Data Objects |
| KLART | Class Type | Mandatory. Allowed Values: 001-Material Class Classes are created within the class type for the respective technical objects |
| 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 | Conditional. User must provide a value indicating when this characteristic will be valid for use. Otherwise, leave blank. |
| BISDT | Valid-to date | Conditional.
|
| KSCHL_EN | Description (English) | Mandatory. Ensure to that this Class Description is in English. Class description should be in Title Case. Duplicate descriptions will not be allowed. |
| KSCHL_FR | Description (French) | Mandatory. Ensure to that this Class Description is in French. Class description should be in Title Case. Duplicate descriptions will not be allowed. |
| KSCHL_IT | Description (Italian) | Mandatory. Ensure to that this Class Description is in Italian. Class description should be in Title Case. Duplicate descriptions will not be allowed. |
| KSCHL_ZH | Description (Mandarin) | Mandatory. Ensure to that this Class Description is in Mandarin. Class description should be in Title Case. Duplicate descriptions will not be allowed. |
| KSCHL_BR | Description (Brazilian) | Mandatory. Ensure to that this Class Description is in Brazilian. Class description should be in Title Case. Duplicate descriptions will not be allowed. |
| KSCHL_PT | Description (Portuguese) | Mandatory. Ensure to that this Class Description is in Portuguese. Class description should be in Title Case. Duplicate descriptions will not be allowed. |
| KSCHL_DE | Description (German) | Mandatory. Ensure to that this Class Description is in German. Class description should be in Title Case. Duplicate descriptions will not be allowed. |
| KSCHL_ES | Description (Spanish) | Mandatory. Ensure to that this Class Description is in Spanish. Class description should be in Title Case. Duplicate descriptions will not be allowed. |
2. Class Keyword Data Construction Rules
| Field Name | Field Description | Rule |
|---|---|---|
| CLASS | Class number | Mandatory. Class Number + Class Number: Should exist in Class DCT Rules |
| KLART | Class Type | Mandatory. Class Number + Class Number: Should exist in Class DCT Rules |
| KSCHL_EN | Keyword (English) | Mandatory. Ensure to that this Class Description is in English. Class description should be in Title Case. Duplicate descriptions will not be allowed. |
| KSCHL_FR | Keyword (French) | Mandatory. Ensure to that this Class Description is in French. Class description should be in Title Case. Duplicate descriptions will not be allowed. |
| KSCHL_IT | Keyword (Italian) | Mandatory. Ensure to that this Class Description is in Italian. Class description should be in Title Case. Duplicate descriptions will not be allowed. |
| KSCHL_ZH | Keyword (Mandarin) | Mandatory. Ensure to that this Class Description is in Mandarin. Class description should be in Title Case. Duplicate descriptions will not be allowed. |
| KSCHL_BR | Keyword (Brazilian) | Mandatory. Ensure to that this Class Description is in Brazilian. Class description should be in Title Case. Duplicate descriptions will not be allowed. |
| KSCHL_PT | Keyword (Portuguese) | Mandatory. Ensure to that this Class Description is in Portuguese. Class description should be in Title Case. Duplicate descriptions will not be allowed. |
| KSCHL_DE | Keyword (German) | Mandatory. Ensure to that this Class Description is in German. Class description should be in Title Case. Duplicate descriptions will not be allowed. |
| KSCHL_ES | Keyword (Spanish) | Mandatory. Ensure to that this Class Description is in Spanish. Class description should be in Title Case. Duplicate descriptions will not be allowed. |
Note: Each Class must have at least one corresponding Class Keyword, which should be identical to the Class Description.
3. Characteristic Assignment Data Construction Rules
| Field Name | Field Description | Rule |
|---|---|---|
| CLASS | Class number | Mandatory. Class Number + Class Number: Should exist in Class DCT Rules |
| KLART | Class Type | Mandatory. Class Number + Class Number: Should exist in Class DCT Rules |
| IMERK | Internal characteristic | Mandatory. Should exist in Characteristics DCT Rules for the same Class Type. (Exception: characteristics that are specific to a Measuring Point and intended for use only on that object assigned to Characteristics Group called MP_GNRL) |
| ATBEZ | Characteristic Description | Non-Editable. Derive the Characteristic Description from the Characteristic DCT based on the specified Characteristic Name |
List the steps that need to occur before extraction can commence
| Item # | Step Description | Team Responsible |
|---|---|---|
| Not Applicable |
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 Data Team |
2 | In dspMigrate, select the wave – S4/HANA – Plant Maintenance | Syniti |
3 | Go to Process Area Launch and Process the Object – Class | Syniti |
4 | Review and Validate Error and Preload Reports | Syniti |
5 | Execute the transformation to prepare the target tables | Syniti |
6 | Validate data from pre-load and error reports | Business/Data owner |
7 | Generate load files | Syniti |
Transformation Rules
1. Class
| Rule # | Source system | Source Table | Source Field | Source Description | Target System | Target Table | Target Field | Target Description | Transformation Logic |
|---|---|---|---|---|---|---|---|---|---|
| 1 | DCT | KLAH | CLASS | Class number | S/4 Hana | KLAH | CLASS | Class number | Direct Mapping A Global Value Mapping (Class A2D) will be created to reference old PM Classes. |
| 2 | DCT | KLAH | KLART | Class Type | S/4 Hana | KLAH | KLART | Class Type | Direct Mapping |
| 3 | DCT | KLAH | STATU | Class status | S/4 Hana | KLAH | STATU | Class status | Default to "1" |
| 4 | DCT | KLAH | KLAGR | Class Group | S/4 Hana | KLAH | KLAGR | Class Group | Direct Mapping |
| 5 | DCT | KLAH | VONDT | Valid-From Date | S/4 Hana | KLAH | VONDT | Valid-From Date | If has value in DCT, Direct Mapping. If blank, derive the date as per Value Mapping: OTH_Migration_Date Relevant Values A2D (using Object ID "1009" and Field Name = "Valid-From Date". |
| 6 | DCT | KLAH | BISDT | Valid-to date | S/4 Hana | KLAH | BISDT | Valid-to date | If has value in DCT, Direct Mapping. Otherwise, Default to 31.12.9999 |
| 7 | DCT | KLAH | PRAUS | Same Classification/ Do Not Check | S/4 Hana | KLAH | PRAUS | Same Classification/ Do Not Check | Default to "X" (Tick box checked) |
2. Class Description
| Rule # | Source system | Source Table | Source Field | Source Description | Target System | Target Table | Target Field | Target Description | Transformation Logic |
|---|---|---|---|---|---|---|---|---|---|
| 1 | DCT | KLAH | CLASS | Class number | S/4 Hana | KLAH | CLASS | Class number | Direct Mapping |
| 2 | DCT | KLAH | KLART | Class Type | S/4 Hana | KLAH | KLART | Class Type | Direct Mapping |
| 3 | DCT | SWOR | KSCHL | Description | S/4 Hana | SWOR | DATUV | Valid-From Date | Direct Mapping Value Mapping: OTH_Informal Words and OTH_Informal Characters |
| 4 | DCT | SWOR | SPRAS | Language Key | S/4 Hana | SWOR | KLBEZ | Description | Direct Mapping |
Note: Each Class must have 1 entry for each language in scope: English, French, Italian, Mandarin, Brazilian, Portuguese, German and Spanish
3. Class Keyword
| Rule # | Source system | Source Table | Source Field | Source Description | Target System | Target Table | Target Field | Target Description | Transformation Logic |
|---|---|---|---|---|---|---|---|---|---|
| 1 | DCT | KLAH | CLASS | Class number | S/4 Hana | KLAH | CLASS | Class number | Direct Mapping |
| 2 | DCT | KLAH | KLART | Class Type | S/4 Hana | KLAH | KLART | Class Type | Direct Mapping |
| 3 | DCT | SWOR | SPRAS | Language Key | S/4 Hana | SWOR | DATUV | Valid-From Date | Direct Mapping |
| 4 | DCT | SWOR | KSCHL | Keyword | S/4 Hana | SWOR | KLBEZ | Description | Direct Mapping |
Note: Each Class must have at least one corresponding Class Keyword, which should be identical to the Class Description.
4. Characteristic Assignment
| Rule # | Source system | Source Table | Source Field | Source Description | Target System | Target Table | Target Field | Target Description | Transformation Logic |
|---|---|---|---|---|---|---|---|---|---|
| 1 | DCT | KLAH | CLASS | Class number | S/4 Hana | KLAH | CLASS | Class number | Direct Mapping |
| 2 | DCT | KLAH | KLART | Class Type | S/4 Hana | KLAH | KLART | Class Type | Direct Mapping |
| 3 | DCT | KSML | IMERK | Internal characteristic | S/4 Hana | KSML | DATUV | Valid-From Date | Direct Mapping |
| Mapping Table Name | Mapping Table Description |
|---|---|
| Characteristic A2D | Old to New Class A2D |
| OTH_Informal Words | List of Informal Words and the words used to replace |
| OTH_Informal Characters | List of Informal Characters |
| OTH_Migration_Date Relevant Values A2D | Dates to be defaulted for A2D objects for each Migration Cycle |
| Item # | Step Description | Team Responsible |
|---|---|---|
| 1 | Ensure DCT tables completeness | SyWay Data Team |
| 2 | Ensure all Transformation mappings are up to date. | SyWay 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 | Ensure Pre-load sign-offs are obtained. | SyWay Data team |
2 | Go to the load tool and select the correct load Program. | SyWay Data team |
3 | Proceed with Data load. | SyWay Data team |
4 | Validate few records loaded by accessing standard transactions. | SyWay Data team |
5 | Generate the post load reports in the tool. | SyWay Data team |
6 | Log errors as defects, if any and address resolutions. Close defects. | SyWay Data team |
7 | Resolve defects by re-upload and re-generate post load reports if necessary. | SyWay Data team |
8 | Business to validate the post load files as part of post-load validation, raise data defects or provide the post-load sign-off. | Business |
9 | Repeat steps 5 to 7 if necessary. | SyWay Data team |
Load Phase and Dependencies
Pre-Cutover
List the Configurations required before loading can commence
| Item # | Configuration Item |
|---|---|
| 1 | T002-Language Keys |
| 2 | TCLA-Class Types |
| 3 | TCLG-Class Groups |
| 4 | 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 Language Key | Engage Functional team to expedite and fix the error in the system |
| 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.