Status

Owner
Stakeholders


Purpose

The purpose of this document is to define the conversion approach to create Template Project in S/4 HANA. .

As per SyWay design, Template projects are standardized reusable Project structures used for creating Project and/or WBS quickly and consistently in S/4 Hana.  

Templates Projects consists of both a Project definition and/or WBS element hierarchy structure. These templates are created as Operative Project templates starting with letter T, these are not the STANDARD Projects and Standard WBS elements. Once created, the template project status is locked.


Conversion Scope

The scope of this document covers the approach for active Template Project into S/4HANA following the 1019 - Template Project Master Data Design Standard.

Scope include:

There will be 2 types of Template Project Definitions

  1. Template Project definition assigned to PPM Item types - Used to create Project structure automatically from PPM item.
  2. Template Project Definition which are not assigned to PPM item types - Used to create sub-hierarchy of WBS on an existing project rather than creating WBS element individually.

Project Templates can be created for any of the below mentioned project profile. The profiles contain default values and control parameters for processing objects and functions in the project.

ZPS0001

CAPITAL/ Operational Expense

ZPS0002

Operational Expense

ZPS0003

Statistical Expense

ZPS0004

Intercompany Recharges

ZPS0005

Provisional Expense

Applicable Project code as per design for project template:

Project ID

Coding Mask

Description

T

-000000-00-00-XX-XX-XX

Coding Mask for Project Templates

The data from legacy system includes:

  1. NA

The data from legacy system excludes:

Template projects to be excluded for Company Code not in scope.

Refer Company code in scope catalog:


List of source systems and approximate number of records

SourceScope

Source Approx No. of Records

Target SystemTarget Approx

No. of Records

DCT

Project Definition
S/4HANA20

DCT

WBS element
S/4HANA

Additional Information

Multi-language Requirement

Project Definition / WBS description will be made available in English. Login via a different language XXXXXX

Document Management

Not Applicable

Legal Requirement

Not Applicable

Special Requirements

Not Applicable

Target Design

The technical design of the target for this conversion approach.

TableFieldData ElementField DescriptionData TypeLengthRequirement
PROJPSPIDPS_PSPIDProject definitionCHAR24Mandatory
PROJPOST1PS_POST1PS: Short descriptionCHAR40Mandatory
PROJSTSPRPS_STSPRWBS status profileCHAR8Mandatory
PROJVBUKRPS_VBUKRCompany codeCHAR4Mandatory
PROJVKOKRPS_VKOKRControlling area for the projectCHAR4Mandatory
PROJPWHIEPS_PWHIEWBS currency (project definition)CHAR5Mandatory
PROJPLFAZPS_PLFAZ_CHGProject planned start dateDATS8Mandatory
PROJVGPLFPS_VGPLFPlanning method for project basic datesNUMC1Mandatory
PROJEWPLFPS_EWPLFPlanning method for project forecast datesNUMC1Mandatory
PROJPROFLPROFIDPROJProject ProfileCHAR7Mandatory
PROJBPROFBP_BPROFILBudget ProfileCHAR6Mandatory
PROJBESTAPS_BESTANDProject StockCHAR1Mandatory
PROJSCOPESCOPE_CVObject ClassCHAR2Mandatory
PROJXSTATPS_XSTATStatistical WBS elementCHAR1Conditional
PROJSCPRFPS_SCHDPRFProfile for WBS schedulingCHAR12Mandatory
PROJPPROFBP_PPROFILPlanning ProfileCHAR6Mandatory
PROJPLINTPLINTIndicator for Integrated PlanningCHAR1Mandatory
PROJSCHTYPPS_SCHED_TYPEScheduling scenarioCHAR1Mandatory
PROJFUNC_AREAFKBERFunctional AreaCHAR16Mandatory
PRPSPOSIDPS_POSIDWBS element IDCHAR24Mandatory
PRPSPOST1PS_POST1PS: Short descriptionCHAR40Mandatory
PRPSPBUKRPS_PBUKRCompany code for WBS elementCHAR4Mandatory
PRPSPKOKRPS_PKOKRControlling areaCHAR4Mandatory
PRPSPRARTPS_PRARTProject TypeCHAR2Mandatory
PRPSPLAKZPS_PLAKZPlanning elementCHAR1Conditional
PRPSBELKZPS_BELKZAccount assignment elementCHAR1Conditional
PRPSFAKKZPS_FAKKZBilling elementCHAR1Conditional
PRPSPWPOSPS_PWPOSCurrencyCHAR5Mandatory
PRPSSCOPESCOPE_CVObject ClassCHAR2Mandatory
PRPSXSTATPS_XSTATStatistical WBS elementCHAR1Conditional
PRPSIMPRFPS_ZSCHMInvestment ProfileCHAR7Conditional
PRPSEEINHPS_EEINHUnit of measureCHAR3Mandatory
PRPSFUNC_AREAFKBERFunctional AreaCHAR16Mandatory
PRPSPSPHIPSPIDCurrent number for projectCHAR24Mandatory
PRPSSTUFEPS_STUFELevel in Project HierarchyIN13Mandatory
PRHILEFTPS_PHILEWBS_LEFTCHAR24Mandatory
PRHIUPPS_PHIUPWBS_UPCHAR24Mandatory
PRPSZX01
CAPEX/ OPEX CHAR10Mandatory


Data Cleansing

Data cleansing not applicable, as data object Project Template data (Project Definition and WBS) will be collected specifically for data migration. 

Collection will be done manually in the Data Collection Template.

IDCriticalityError Message/Report DescriptionRuleOutputSource System


Not Applicable



Conversion Process

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

Data Privacy and Sensitivity

Not Applicable.


Extraction

Extract data from a source into Syniti Migrate. There are 2 possibilities:

  1. The data exists. Syniti Migrate connects to the source and loads the data into Syniti Migrate. There are 3 methods:
    1. Perform full data extraction from relevant tables in the source system(s).
    2. Perform extraction through the application layer.
    3. Only if Syniti Migrate; cannot connect to the source, data is loaded to the repository from the provided source system extract/report.
  2. The data does not exist (or cannot be converted from its current state).  The data is manually collected by the business directly in Syniti Migrate. This is to be conducted using DCT (Data Collection Template) in Syniti Migrate

The agreed Relevancy criteria is applied to the extracted records to identify the records that are applicable for the Target loads

Extraction Run Sheet

Req #Requirement DescriptionTeam Responsible
1Ensure DCT is collected for Project Template (Project Definition / WBS elements)Data Team
2Perform preliminary completeness check, data quality check.Data Team
3

Raise issues as defects if Req # 1 to 2 are not met

Data Team
4

Repeat Req # 1 to 3 if required

Data Team

Selection Screen

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



Data Collection Template (DCT)

Target Ready Data Collection Template will be created for Template Project data with exception of some fields which require transformation as mentioned in the transformation rule.

Template Project DCT Rules

Field NameField DescriptionRule
Project Level
PROJ_PSPIDProject definitionUnique Identifier for the Project template, manually generated via coding mask starting with "T-000000".
PROJ_POST1PS: Short description

Template description entered manually.

Approach if the description is more than 40 characters: Abbreviate to required length (40 Chars) by eliminating vowels, use '&' for 'and'.

PROJ_VBUKRCompany code

Represents legal entity.

Refer configuration table field T001-BURKS for data validation.

The project template will have the default company code 1000.

PROJ-VBUKR = 1000

PROJ_PROFLProject Profile

The profiles contain default values and control parameters for processing objects and functions in the Project System. Project profile is maintained on the template project.

Rule applicable as below:

Rule 1: The Template Project mapped to PPM item type are assigned to project profile ZPS0001 and ZPS0002.

Template projects are mapped to item types through customizing settings for SAP Portfolio and Project Management (PPM).  Refer config table /RPM/V_PSITPT.

Refer Appendix below for applicable PPM item type mapped with template projects and its respective allowed project profile.

Rule 2:

Template project which are not assigned to PPM item type will be assigned the project profiles ZPS0003, ZPS0004, ZPS0005.

Refer Appendix below

Rule 3:

Project template "Detailed Engineering and construction" is not mapped to a PPM item but is assigned to project profile ZPS0001 .

Refer Appendix below

PROJ_XSTATStatistical WBS element

Indicator to specify whether a WBS element is only for statistical purposes or whether it may carry actual costs.

Mandatory for Statistical Projects template with Project profile = ZPS0003. Statistical field is derived from the profile ZPS0003.

PROJ_FUNC_AREAFunctional Area

The Functional Area allows classification of project-related costs by function.

 

Rule

Project templates linked to PPM Item Types

(config table /RPM/V_PSITPT)

Functional Area
1Z001 - Industrial Project with Qualification
Z002  -Industrial Project
Z003 -Industrial Project - Simple ?
IS
2Z004 -New Product Introduction
Z005 -Product & Process Improvement
Z006 -Customer and business support
Z007 -OPD Opportunity Development
R&I
3Z008 -IT Full Lifecycle Project
Z009 -IT Small Project
IT


WBS Level
POSIDWBS element ID

Unique Identifier for the WBS Element template as per project coding mask.

Starts with "T"

Project definition key = Project WBS ie. Project definition code to be matched with WBS code i,e always T for template WBS.

PRPS-POSID = PROJ-PSPID

POST1PS: Short description (1st text line)

Description of the WBS assigned to the template project.

Approach if the description is more than 40 characters: Abbreviate to required length (40 Chars) by eliminating vowels, use '&' for 'and'.

PBUKRCompany code for WBS elementRepresents legal entity and inherited from the Project Definition. Refer configuration table field T001-BURKS for data validation.
The project template will have the default company code 1000.
PRARTProject Type

It is an attribute that serve as classification field that help to define the nature, purpose, and governance of a WBS element. They are useful for reporting, controlling, and compliance alignment.
Refer configuration table field TCJ1-PRART for allowed values.

Project Type will be maintained as per rules defined in Appendix below:

BELKZAccount assignment element

This indicator enables financial posting on the WBS element. It will be checked in below conditions:

Item Type DP are mapped to PS WBS Element through customizing settings for SAP Portfolio and Project Management (PPM).  Refer config table /RPM/V_WBSDP_MAP - Item Type DP to PS WBS

Rule 1:

Item type = Z001to Z009 in /RPM/V_WBSDP_MAP, for decision point id, field DECISION_ID mapped to WBS, AA assignment element PRPS-BELKZ = blank, if PRPS-STUFE = 1 or 2

Rule 2:

Item type = Z010, Z012, Z013, Z014 in /RPM/V_WBSDP_MAP, for decision point id field DECISION_ID mapped to WBS, AA assignment element PRPS-BELKZ = active, if PRPS-STUFE = 2

Rule 3:

Template project with project profile PROJ-PROFL = ZPS0001, mapping does not exist in /RPM/V_PSITPT, and WBS PRPS-STUFE = 3 and beyond, AA assignment element PRPS-BELKZ = active

Rule 4:

Template project with project profile PROJ-PROFL = ZPS0003, ZPS0004, ZPS0005, mapping does not exist in /RPM/V_PSITPT, AA assignment element PRPS-BELKZ = active for all WBS.

IMPRFInvestment Profile

Investment Profile on WBS element is used to enable auto generation of AUC w.r.t. predefined asset class.

Template project with project profile PROJ-PROFL = ZPS0001 and mapping does not exist in config table /RPM/V_PSITPT, investment profile is mandatory on template WBS for level  PRSP-STUFE = 3 and Capex/Opex = Capex, PRPS-IMPRF = mandatory

Applicable to only those Templates that are not linked to Item type but Belonging to Project profiles = ZPS0001. 
Mandatory on Template WBS where Level = 3 and Capex/Opex = Capex. Refer to Appendix

FUNC_AREAFunctional Area

The value of this field will be inherited from the project definition template. It should not be changed at the WBS element level i.e PROJ-FUNC_AREA = PRPS-FUNC_AREA 


For template WBS  linked to Item Types Z001, Z002 & Z003 the Functional Area will be "IS".
 For template WBS linked to Item Types Z004, Z005, Z006 & Z007 the Functional Area will be "R&I".
 For template WBS linked to Item Types Z008 & Z009 the Functional Area will be "IT" For WBS elements governed by project profiles ZPS0004 & ZPS0005, this field will be maintained manually or derived from Responsible Cost Center.


PSPHICurrent number for projectProject ID assigned to the WBS elements in the project template
STUFELevel in Project HierarchyLevel of the WBS element within the template. 
LEFTWBS_LEFTThis field represents the left-adjacent WBS element in the same hierarchy level required for navigating sibling relationships within a WBS hierarchy.
UPWBS_UPThis field represents the immediate superior WBS element (parent node) required for establishing parent-child relationships in the WBS hierarchy.
ZX01CAPEX/ OPEXThis field identifies expense is CAPEX or OPEX.
 It is maintained on the project template's WBS elements.
- For project profile ZPS0001 this field will not be maintained on project template.
- For project profiles ZPS0002 & ZPS0003 this field will be set to OPEX on the project template.

Appendix:




Note: Upfront Automated Fields are not included in DCT as SAP validates these fields upon entry.

Extraction Dependencies

No Dependencies for Extract

Item #Step DescriptionTeam Responsible

NA


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 Syniti Migrate
  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

Obtain DCT Sign-off from Business

Data Team

2

Execute and Load and perform Transformation 

Data Team

3

Monitor the transformation progress and ensure performance and completion is within allowed timeframe

Data team

4

Review and Validate Error and Preload Reports

Data Team

5

Generate data load count.

Data team

6

Generate Load Files

Data Team

7

Log errors as defects, if any and address resolutions. Close defects.Data team
8Re-transform and re-validate the Pre-load reports if necessary.Data team
9Validate the transformed file as part of pre-load validation, raise data defects or provide the pre-load sign-off.Business
10Analyze and resolve any pre-load defects logged by business.Data team
11Repeat steps 7 to 10 if necessaryData team
12Proceed to pre-load validationsData team


Transformation Rules

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










1DCT
PSPIDProject definitionS/4 HanaPROJPSPIDProject definitionCopy from source to target system
2DCT
POST1PS: Short descriptionS/4 HanaPROJPOST1PS: Short descriptionCopy from source to target system
3DCT
VBUKRCompany codeS/4 HanaPROJVBUKRCompany codeCopy from source to target system
4DCT
PROFLProject ProfileS/4 HanaPROJPROFLProject ProfileCopy from source to target system
5DCT
XSTATStatistical WBS elementS/4 HanaPROJXSTATStatistical WBS elementCopy from source to target system
6DCT
FUNC_AREAFunctional AreaS/4 HanaPROJFUNC_AREAFunctional AreaCopy from source to target system

WBS






 
7DCT
POSIDWBS element IDS/4 HanaPRPSPOSIDWBS element IDCopy from source to target system
8DCT
POST1PS: Short description (1st text line)S/4 HanaPRPSPOST1PS: Short description (1st text line)Copy from source to target system
9DCT
PBUKRCompany code for WBS elementS/4 HanaPRPSPBUKRCompany code for WBS elementCopy from source to target system
10DCT
PRARTProject TypeS/4 HanaPRPSPRARTProject TypeCopy from source to target system
11DCT
BELKZAccount assignment elementS/4 HanaPRPSBELKZAccount assignment elementCopy from source to target system
12DCT
IMPRFInvestment ProfileS/4 HanaPRPSIMPRFInvestment ProfileCopy from source to target system

List of Custom Target Reports for this object is maintained here: Conversion Specification - Custom Reports Register.

The standard upload template to be used for Project template upload in S/4 Hana.


Transformation Mapping


Mapping Table NameMapping Table Description








Transformation Dependencies

List the steps that need to occur before transformation can commence
Item #Step DescriptionTeam Responsible













Pre-Load Validation

Project Team

Completeness

TaskAction

Verify Record Count

SyWay I2M 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.

Accuracy

TaskAction

Conversion Accuracy

SyWay I2M Data Team to verify that all fields below meet pass the checks:

  1. Mandatory Fields
  2. Field and Value Mapping Correctness
  3. Null Checks
  4. Text Length 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 (DCT) data.


Business

Completeness

TaskAction

Verify Record Count

Business Data Owner/s 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.

Accuracy

TaskAction

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


Load

The load process includes:

  1. Execute the automated data load into target system using load tool or product the load file if the load must be done manually
  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

Load using transaction CNMASSCREATE or Migration cockpit.

SyWay I2M Data Team

2

Load 3 records for < > to validate if data is loaded successfully without errors

SyWay I2M Data Team

3

Load 3 records for < > to validate if data is loaded successfully without errors

SyWay I2M Data Team

4

Proceed with full load if steps 2 and 3 are validated

SyWay I2M Data Team

5

Validate few records loaded by accessing Portfolio Bucket Structure App

SyWay I2M Data Team

6

Generate post load report if step 5 is validated

SyWay I2M Data Team


Load Phase and Dependencies

Configuration


Item #Configuration Item
1Number Range
2Company Code
3Controlling Area
4Project Type
5Factory Calendar
6Currency Code
7Plant
8Investment Profile

Conversion Objects

Object #Preceding Object Conversion Approach

list the exact title of the conversion object of only the immediate predecessor – this will then confirm the DDD (Data Dependency Diagram)

Error Handling

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 TypeError DescriptionAction Taken




Post-Load Validation

Project Team

Completeness

TaskAction

Verify Count

SyWay I2M Data Team to verify the record count created in target S/4 HANA by accessing post load reports 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.).

Accuracy

TaskAction

Conversion Accuracy

Verify that the Project Definition / WBS in target S/4 HANA were loaded correctly via Project Builder display and table PROJ / PRPS

Business

Completeness

TaskAction
Verify template Project data - Project Definition / WBSExtract data from PS report CN41N in S/4 Hana

Accuracy

TaskAction
titlespecific details of what and how the task needs to be performed e.g. which reports are being used etc.





Key Assumptions

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

Any additional key assumptions.


See also

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.

Change log