Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Status

Page Status

Owner
Stakeholders

Purpose

The purpose of this document is to define the conversion approach to upload Materials - Class Type 001 into S/4 HANA as part of the Material Data Migration.

Link to MDS: DD-FUN-050 Master Data Standard_2017-Material master - Class Type 001


Conversion Scope

The scope of this document covers the approach for converting active Class data linked to Class Type 001 from Legacy Source Systems into S/4HANA following the Material Master Data Design Standard.

Click here to go to the Conversion Spec for 2019 to see the full set of relevancy rules.

List of source systems and approximate number of records

  The Business and S2P Functional Team have decided not to use legacy Classes, but instead to create 4 new Classes linked to Class Type 001.  (It is possible that this number may change in the future.)

The 4 new Classes are documented in the MDS on the "Governance" sheet in the "Field Governance Rules" section, in rule #1, Class, as part of the Rule Description.

Click here to go to the Conversion Spec for 2019 to see the full set of relevancy rules for Materials.


List of source systems and approximate number of records

SourceScope

Source Approx No. of Records

Target SystemTarget Approx

No. of Records

PF2 & WP2

4 new To-Be Classes linked to Class Type 001 has been defined by the Business and the S2P Functional Team.  The new Classes will be captured in a DCT

SourceScope

Source Approx No. of Records

Target SystemTarget Approx

No. of Records

PF2,WP2Scope is Classes that fall under CLASS TYPE 001, are linked to Material records that have been identified as part of Basic Data and have descriptions in languages that are in the Core or Additional list

.


Service Master records that will become Materials in the target are out of scope.  See the mail from Simran. Service Master Data Used in 2017 CLASS TYPE 001 in S4H.pdf

WP2: 22,838 (3,001 **)

PF2: 5,167 (6 **)

** Linked to relevant materials for info purposes
** No Classes are linked to Service Materials 

S4H

28,005 (3,007 **)

** Linked to relevant

materials

materials for info purposes
** No Classes are linked to Service Materials 

DCTLinking Classes to Characteristics (2018 Materials - Characteristics of Class Type 001)Classes: 4
Characteristics: 43
S4H53


Jira Task to Jira Task to track the Classes that will be added to CLASS TYPE 001:

Jira
serverSyensqo's Jira
serverIdd8efc1ef-48bd-3b4e-8714-ad827f4f059b
keyPDM-770

Configuration Document containing the above classes: <To Be Add>

Profiling

Legacy SystemTotal Relevant MaterialsRelevant Materials assigned to Classes
PF2104,4844,224
WP272,37825,866

Top 30 Classes by Legacy system

Legacy SystemCLASSMaterial Count
PF2Z_MAT_PL_ARCH3,202
SPARE_PARTS_TC989
Z_ORTEMS6
DANGEROUS_GOOD7
Z_SAD_MM7
Z68-421691
WP2Z_CM_MAT6,043
LIP00201483,447
M0012,898
Z_MAT_PL_ARCH2,088
MATERIAL_SEGMENTS935
LIP0034040842
Z_MAT_ADDITIONAL456
Z_MAT_CRIT418
LIP0008485343
CRIT_IND333
LIP0007716226
LIP0031355210
LIP0032812120
LIP003403094
LIP003248482
LIP000848481
LIP003248878
LIP003134569
LIP003457169
LIP000841168
LIP003456861
LIP000836760
LIP003405060
M002_H_05_AH57
LIP000825854
LIP003400054
M002_A_08_AT52
LIP003132451
LIP002016850
LIP000839446

Predecessor Objects

                           Material Master - Basic View (2019) → Material (Characteristics of CLASS TYPE -001) (2018)Material - Class Type 001 (2017).
Material (Characteristics of CLASS TYPE -001) (2018) ↗ 

Additional Information

Multi-language Requirement

Multi language is supported for Materials - Class Type 001. Login via a different language will show the description displayed in the logon language if the language key is maintained.

The following languages are allowed:

  • Core languages: EN - English, FR - French, IT - Italian and ZH - Mandarin.
  • Additional languages: PT - Portuguese, DE - German and ES - Spanish.

It is now mandatory that a Description is required for each Core and Additional language. 

Document Management

Not Applicable

Legal Requirement

Not Applicable

Special Requirements

Not Applicable


Target Design

The technical design of the target for this conversion approach.

TableFieldField DescriptionData TypeLengthRequirement
KLAHCLINTInternal Class NumberNUMC10Required
KLAHKLART

Class Type

CHAR3Required
KLAHCLASSClassCHAR18Required
KLAHSTATUStatusCHAR1System
KLAHLOCLALocal classCHAR1Conditional

Not Required

KLAHVONDTValid fromDATS8System
KLAHBISDTValid toDATS8System
KLAHPRAUSSame classificationCHAR1System
KLAHANAMECreated ByCHAR12System
KLAHADATUCreated OnDATS8System
KLAH

ANZUO

No of AssignmentsCHAR1System
SWORCLINTInternal Class NumberNUMC10Required
SWORSPRASLanguage KeyLANG1Required
SWORKLPOSItem NumberNUMC2Required
SWORKSCHLClass DescriptionCHAR40Required
SWORKSCHGKeyword (Upper Case for Matchcode)CHAR40Required
Data Cleansing
Table
ID
Field
CriticalityError Message/Report DescriptionRuleOutputSource SystemSyniti Report Required1MediumNo Class Description in Allowed LanguagesThe following language are allowed as being either core, or additional: DE, EN, ES, FR, IT, PT, ZH.KLAH-KLART and KLAH-CLASS

PF2 & WP2

YES

Field DescriptionData TypeLengthRequirement
KSMLCLINTInternal Class NumberNUMC10Required
KSMLPOSNRItem NumberNUMC3Required
KSMLIMERKInternal CharacteristicNUMC10Required
KSMLKLARTClass TypeCHAR3Required


Data Cleansing


IDCriticalityError Message/Report DescriptionRuleOutputSource SystemSyniti Report Required


Not Applicable







Conversion Process

The high-level process for Classes that will be migrated are represented by the diagram below:

Image Added

The high level process for Classes that will be captured in a DCT are represented by the diagram below:

Image Added


Field Governance Rules

These governance rules apply to the individual fields within the data record.

Rule #

Field Label

Rule Description

Validation Method

Conditional Logic

Cleansing Rule (Also see Data Cleansing section above)

1

KLAH-KLART

Only records with CLASS TYPE 001 are being migrated.

Upfront Automated

KLART = '001'

3

SWOR-SPRAS

The following language are allowed

Conversion Process

The high-level process is represented by the diagram below:

Image Removed

Field Governance Rules

These governance rules apply to the individual fields within the data record.

Rule #

Field Label

Rule Description

Validation Method

Conditional Logic

Cleansing Rule (Also see Data Cleansing section above)

1

KLAH-KLART

Only records with CLASS TYPE 001 are being migrated.

Upfront Automated

KLART = '001'

2

KLAH-CLINT

Only records where the material is relevant.

Upfront Automated

KLAH-CLINT = KSSK-CLINT and KSSK-OBJEC = MARA-MATRN

3

SWOR-SPRAS

The following language are allowed: DE, EN, ES, FR, IT, PT, ZH..

Upfront Automated


No Class Description in Allowed Languages

Data Privacy and Sensitivity

Not Applicable


Extraction

Class data for CLASS TYPE 001 that are linked to Material records that have been identified as part of Basic Data will be extracted.  No are identified by data entered into a DCT and marked in the DCT for migration.  (The DCT also contains data for new Classes that don't exist in the Source Systems.)  No data for Service Master records that will become Materials in the target will be extracted. 

Extraction Run Sheet

Req #Requirement DescriptionTeam Responsible

1

Extract data from source system based on relevancy rulesrecords in the DCT that are marked for migration.

Syniti


Selection Screen

Selection Ref ScreenParameter NameSelection TypeRequirementValue to be entered/set
Not Applicable




Data Collection Template (DCT)

Not Applicable

Extraction Dependencies

Item #Step DescriptionTeam Responsible1

Materials in scope to be loaded as Material Master Basic Data must be identified before the extraction of Class data, so that we can limit the extraction to this sub-set of data.

Cutover

DCT Rules for Class:

FieldField DescriptionRule
KLART

Class Type

Read-only field.  Default to '001'.
CLASSClass
STATUStatusDefault to '1'.
LOCLALocal classDefault to Blank.  MDS changed after CS completed.  No longer required.
VONDTValid fromDefault to Today.
BISDTValid toDefault to '99991231'.
PRAUSSame classificationDefault to Blank.
SPRASLanguage Key

Default to 'EN'.

All Classes must have a description in at least 'EN'.  Allow the Description to be captured in multiple languages, with the following languages allowed: DE, EN, ES, FR, IT, PT, ZH.

Convert to internal code.

KLPOSItem NumberRead-only field.  Counter.  Logic moved to Transformation Rules.
KSCHLClass Description
  • Ensure no duplicate (With other Classes within Class Type 001) and language key.
  • Ensure populated with Description as per specified Language.
  • Approach if the description is more than 40 characters: Abbreviate to required length (40 Chars).
  • Ensure that it does not include any of the below characters: 
    ;        Semi-colon
    :        Colon
    ::        Double Colon
    ?        Question Mark
    /        Forward Slash
    @        At sign
    &        Ampersand
    =        Equal Sign
    +        Plus Sign
    $        Dollar Sign
    %        Percent
    |        Vertical Bar
    []        Left or Right Square Bracket
    "        Double Quotes
KSCHGKeyword (Upper Case for Matchcode)Read-only field.  Upper case version of KSCHL.  Logic moved to Transformation Rules.


DCT Rules for linking Classes to Characteristics (DCT.KSML)**:

FieldField DescriptionRuleTool TipzCommentzDelete
CLASSClass NameMandatory.  Use drop-down based on S4H.KLAH-CLASS.Name used to uniquely identify a class within a class type.

ATNAMCharacteristic NameMandatory.  Use drop-down based on S4H.CABN-ATNAM.Unique technical name identifying the characteristic (e.g. LENGTH, COLOR).

** Load File: 2023-Class to Characteristic Load File.xlsx


Extraction Dependencies

Item #Step DescriptionTeam Responsible
1

The list of Classes will be provided by the Functional Team in the Configuration Document based on the To-Be design.

S2P Functional Team


Transformation

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 Syniti Migrate to make the data Target ready:

  1. Prepare target-ready data in the structure and format that is required for loading via prescribed Load Tool. This step also produces the load data ready for business to perform Pre-load Data Validation

Transformation Run Sheet

Item #Step DescriptionTeam Responsible

1

Verify that data is extracted from the DCT.

Syniti / S2P Data Team

2

Verify that data is extracted from both source systems.

Syniti / S2P Data Team

3

Transformation jobs are ready for execution.

Syniti

4

Review and Validate Error and Preload Reports

Syniti

5

Generate Load Files

Syniti


Transformation Rules

Transformation Rules for Classes:

Rule #Source systemSource TableSource FieldSource DescriptionTarget SystemTarget TableTarget FieldTarget DescriptionTransformation Logic
1DCTKLAHCLINTInternal Class NumberS4HKLAHCLINTInternal Class NumberSystem generated
2DCTKLAHKLARTClass TypeS4HKLAHKLARTClass TypeCopy As-Is (will always be '001')
3DCTKLAHCLASSClassS4HKLAHCLASSClassCopy As-Is
4DCTKLAHSTATUStatusS4HKLAHSTATUStatusCopy As-Is
5DCTKLAHLOCLALocal classS4HKLAHLOCLALocal classCopy As-Is.  MDS changed after CS completed.  No longer required.
6DCTKLAHVONDTValid fromS4HKLAHVONDTValid fromCopy As-Is
7DCTKLAHBISDTValid toS4HKLAHBISDTValid toCopy As-Is
8DCTKLAHPRAUSSame classificationS4HKLAHPRAUSSame classificationCopy As-Is
9DCTKLAHANAMECreated ByS4HKLAHANAMECreated BySystem generated
10DCTKLAHADATUCreated OnS4HKLAHADATUCreated OnSystem generated
11DCTKLAHANZUONo of AssignmentsS4HKLAHANZUONo of AssignmentsSystem generated
12DCTSWORCLINTInternal Class NumberS4HSWORCLINTInternal Class NumberCopy from target KLAH-CLINT that was generated in Rule 1
13DCTSWORSPRASLanguage KeyS4HSWORSPRASLanguage KeyCopy As-Is.
There must be a description for each of the Core and Additional languages.  If a language is missing take if from English.
14



S4HSWORKLPOSItem NumberThis is a counter and it increments by 1 for each Description in a different language for the same S4H.KLAH-CLINT.
15DCTSWORKSCHLClass DescriptionS4HSWORKSCHLClass DescriptionCopy As-Is.
There must be a description for each of the Core and Additional languages.  If a language is missing take if from English.
16



S4HSWORKSCHGKeyword (Upper Case for Matchcode)Upper case version of DCT.SWOR-KSCHL


Transformation Rules for linking Classes to Characteristics:

Rule #Source systemSource TableSource FieldSource DescriptionTarget SystemTarget TableTarget FieldTarget DescriptionTransformation Logic

1

DCT

KSMLCLASSClass NameS4HKSMLCLINTInternal Class NumberCopy S4H.KLAH-CLINT WHERE DCT.KSML-CLASS = S4H.KLAH-CLASS
2



S4HKSMLPOSNRItem NumberInteger counter starting at 1 and incrementing by 1 for each CLINT.  When CLINT changes it starts from 1 again.
3DCTKSMLATNAMCharacteristic NameS4HKSMLIMERKInternal CharacteristicCopy S4H.CABN-ATINN WHERE DCT.KSML-ATNAM = S4H.CABN-ATNAM
4



S4HKSMLKLARTClass TypeDefault to "001"

Transformation

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 Syniti Migrate to make the data Target ready:

  1. Perform value mapping and data transformation rules.
    1. Legacy values are mapped to the to-be values (this could include a default value)
    2. Values are transformed according to the rules defined in
  2. Prepare target-ready data in the structure and format that is required for loading via prescribed Load Tool. This step also produces the load data ready for business to perform Pre-load Data Validation

Transformation Run Sheet

Item #Step DescriptionTeam Responsible

1

Verify that data is extracted from both source systems.

Syniti / S2P Data Team

2

Transformation jobs are ready for execution.

Syniti

3

Review and Validate Error and Preload Reports

Syniti

4

Generate Load Files

Syniti

Transformation Rules

Rule #Source systemSource TableSource FieldSource DescriptionTarget SystemTarget TableTarget FieldTarget DescriptionTransformation Logic1PF2 & WP2KLAHCLINTInternal Class NumberS4HKLAHCLINTInternal Class NumberSystem generated2PF2 & WP2KLAHKLARTClass TypeS4HKLAHKLARTClass TypeCopy As-Is (will always be '001')3PF2 & WP2KLAHCLASSClassS4HKLAHCLASSClassCopy As-Is4PF2 & WP2KLAHSTATUStatusS4HKLAHSTATUStatusCopy As-Is5PF2 & WP2KLAHLOCLALocal classS4HKLAHLOCLALocal classCopy As-Is6PF2 & WP2KLAHVONDTValid fromS4HKLAHVONDTValid fromCopy As-Is7PF2 & WP2KLAHBISDTValid toS4HKLAHBISDTValid toCopy As-Is8PF2 & WP2KLAHPRAUSSame classificationS4HKLAHPRAUSSame classificationCopy As-Is9PF2 & WP2KLAHANAMECreated ByS4HKLAHANAMECreated BySystem generated10PF2 & WP2KLAHADATUCreated OnS4HKLAHADATUCreated OnSystem generated11PF2 & WP2KLAHANZUONo of AssignmentsS4HKLAHANZUONo of AssignmentsSystem generated12PF2 & WP2SWORCLINTInternal Class NumberS4HSWORCLINTInternal Class NumberMap from legacy KLAH-CLINT to KLAH-CLINT generated in Rule 113PF2 & WP2SWORSPRASLanguage KeyS4HSWORSPRASLanguage KeyCopy As-Is14PF2 & WP2SWORKLPOSItem NumberS4HSWORKLPOSItem NumberCopy As-Is15PF2 & WP2SWORKSCHLClass DescriptionS4HSWORKSCHLClass DescriptionCopy As-Is16PF2 & WP2SWORKSCHGKeyword (Upper Case for Matchcode)S4HSWORKSCHGKeyword (Upper Case for Matchcode)Copy As-Is

Joining Material to Class

KSSK-OBJEK = MARA-MATNR.
KLAH-CLINT = KSSK-CLINT & KLAH-KLART = '001'.

The following image shows the various joins for characteristics:

Image Removed


Transformation Mapping

Mapping Table NameMapping Table Description
LinkMaterialXREFMM Config Values - Material MasterCLINTXREFMM Config Values - Classes for 001
Link
Not Applicable


Transformation Dependencies

List the steps that need to occur before transformation can commence
Syniti & S2P Data Team
Item #Step DescriptionTeam Responsible

1

Data has been extracted from sources systems

Syniti

2

Deduplication is completed

3

Configuration should be completed - (Config documents should be complete)

Syniti & S2P Data Functional Team

43

Value mapping and XREF tables are ready

Syniti & S2P Data Team

4

Characteristics for Class Type 001 have been loaded into S4H

Syniti


Pre-Load Validation

Project Team

Completeness

TaskAction

Verify Record Count

The number of records presented after relevancy checks and validation needs to be correct compared to the staged data in between the DCT and the preload tables in Syniti Migrate.

Completeness check

All fields required as per mapping template rules must be completed. Validity  Syniti Migrate standard validity reports checking each field in Syniti must be built.


Accuracy

TaskAction

Conversion Accuracy

Data team to verify Verify that the data staged in the preload tables are correct in terms of the mapping rules. This will be done via Syniti DSP Migrate standard reports.


Business

Completeness

TaskAction

Count and Completeness check

All fields required as per mapping template rules must be completed.  Validity Syniti Migrate standard validity reports checking each field in ADMM must be built to help check.


Accuracy

TaskAction

Conversion Accuracy

Business team to verify that the data staged in the preload tables are correct in terms of the mapping rules. This will be done via Syniti ADMM Migrate reports/SAP reports.


Load

The load process includes:

  1. Execute the automated data load into target system using the appropriate load tool.
  2. Once the data is loaded to the target system, it will be extracted and prepared for Post Load Data Validation.

Load Run Sheet

Item #Step DescriptionTeam Responsible

1

Verify data extracted

Data Specialist/Functional - S2P

2

Verify data combined from both source systems

Data Specialist/Functional - S2P

3

Verify Material XREF is ready (based on load of 2019 Material Master - Basic View)

Data Specialist/Functional - S2P

4

Stage data for transformations

Syniti

54

Run transforms

Syniti

85

Execute pre-load report

Syniti

96

Validate preload report - release

Data Specialist/Functional - S2P

107

Prepare and simulate

Syniti

118

Pre-load verification and approval to load

Functional/Data Owner - S2P

129

Load to S4

Syniti

1310

Complete Jira steps, Volumes and Timings

All - where applicable

1411

Execute post-load report

Syniti

1512

Post-load report verification/validation

Data Specialist/Functional/Data Owner - S2P

1613

Object load completion approval

Data Owner - S2P


Load Phase and Dependencies

Configuration

Item #Configuration Item

1

TCLA-Class Types

2

TCLG-Class Groups

3

TCLU-Class Status

Not Applicable

Conversion Objects

Object #Preceding Object Conversion Approach
1Material Master - Basic View (2019(Characteristics of CLASS TYPE -001) (2018)

Error Handling

Fix incorrect data
Error TypeError DescriptionAction Taken

Data

Classes not linked to a Target Material

Action Taken

Data

Incorrect Language

Fix incorrect data

Data

Duplicates

Fix incorrect data

Load

Authorization errors

Apply for the applicable authorization permission and retry

Load

Technical load failures - If using MC - Simulation errors, etc

Investigate error and rectify. Retry simulation and/or load


Post-Load Validation

Project Team

Post-Load Steps

Step Description

Team Responsible

Execute post-load report

Syniti

Post-load report verification/validation

Data Specialist/Functional/Data Owner - S2P

Object load completion approval

Data Owner - S2P

Completeness

TaskAction

Verify count

The number of records presented in the post-load needs to be compared to the preload – Syniti report

Field by field check

Compare source data staged in the preload tables to target data in the load tables.


Accuracy

TaskAction

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.).


Business

Completeness

TaskAction

Verify Count

The number of records presented in the preload needs to be compared to the post-load Syniti report.

Missing data

Check missing data which was supposed to be loaded.

Reconciliation

Participate in Post-load walkthroughs.


Accuracy

TaskAction

Conversion Accuracy

Business team to verify Verify that the data staged in the preload tables are correct in terms of the mapping rules. This will be done via Syniti/SAP in S/4 HANA was loaded correctly via Syniti Migrate post-load reports.


Key Assumptions

  • Master Data Standard is up to date as on the date of documenting this conversion approach and data load.
  • Materials - Class Type 001 is 001 is in scope based on data design and any exception requested by business.


See also

Change log

Change History
limit10

Workflow history

Workflow Report
parent@self
hideheadertrue
typeapprovals