You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 70 Next »

Purpose

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

Permit to Work in Work Clearance Management (WCM) provides a systematic approach in controlling and executing the operational and maintenance activities safely and efficiently in a worksite. The Permit to Work solution helps to manage the risks inherent to hazardous tasks and ensure that the necessary precautions are put in place to improve the safety of personnel, plant, and the environment.

To provide authorization for jobs that require high-risk activities, Permit to Work provides Work Permit, a formal printed document with the description of the work, the requirements to be fulfilled, and the safety measures to be followed. A work permit authorizes the receiver to carry out the specified work at the specified time and acts as an agreement between the issuer and the receiver about the conditions, risks, and precautions involved.

A Work Permit Template provides a predesigned structure that can be used to create work permits in a consistent format. Creating work permits using a template allows you to simplify and streamline the work permit generation process.


Conversion Scope

The scope of this document covers the approach for creating Work Permit Template into S/4HANA following the Permit to Work Template Master Data Design Standard. 

All Data for Permit to Work Template fully construted in the DCT.

The data from legacy system includes:

  1. Not applicable

The data from legacy system excludes:

  1. Not applicable

Note: There are no tables to extract from the source systems


List of source systems and approximate number of records

SourceScope

Source Approx No. of Records

Target SystemTarget Approx

No. of Records

DCT

All Permit to Work data will be fully constructed, as it does not currently exist in the source systems and represents a new design in the to-be Syensqo landscape.

300

S/4 HANA

300

Additional Information

Multi-language Requirement

Permit to Work Template does not have multi language support. Permit to Work Template text will be migrated using EN logon.

Document Management

Not Applicable

Legal Requirement

Not Applicable

Special Requirements

Not Applicable


Target Design

1. Permit to Work Template

TableFieldData ElementField DescriptionData TypeLengthRequirement
IWRKPMTTEMPLATEWORKPERMITWCEWAPINRApplicationCHAR12Mandatory
IWRKPMTTEMPLATEWORKPERMITTYPEWCEUSAGEUsage of WCM ObjectCHAR3Mandatory
IWRKPMTTEMPLATEWRKPERMITDESCWCESTXTDescriptive Short TextCHAR40Mandatory
IWRKPMTTEMPLATEMAINTENANCEPLANNINGPLANTIWERKMaintenance Planning PlantCHAR4 Mandatory
IWRKPMTTEMPLATEWRKPERMITVALIDFRMDATEWCEDATEFRValid-From Date for WCM ObjectDATS8Mandatory
IWRKPMTTEMPLATEWRKPERMITVALIDFRMTIMEWCETIMEFRValid-From Time for WCM ObjectTIMS6Mandatory
IWRKPMTTEMPLATEWRKPERMITVALIDTODATEWCEDATETOValid-To Date for WCM ObjectDATS8Mandatory
IWRKPMTTEMPLATEWRKPERMITVALIDTOTIMEWCETIMETOValid-To Time for WCM ObjectTIMS6Mandatory
IWRKPMTTEMPLATEWORKCENTERPPH_ARBPLWork CenterCHAR8Mandatory
IWRKPMTTEMPLATEWORKCENTERPLANTWERKS_DPlantCHAR4Mandatory

2. Approvals

TableFieldData ElementField DescriptionData TypeLengthRequirement
IWPMAPPROVALWORKPERMITWCEWAPINRApplicationCHAR12Mandatory
IWPMAPPROVALWORKPERMITAPPROVALPMSOGPermit Key (Approval Type)CHAR10Mandatory
IWPMAPPROVALWORKPERMITAPPROVALSTATUSPTWEWORKPERMITAPPROVALSTATUSWork Permit Approval StatusCHAR1Mandatory

Permit to Work Template Data strictly adheres to the Master Data Standard. The complete information of the key fields that hold the Permit to Work Template information follows the Master Data Standard document that is located here.


Data Cleansing

The Permit to Work Template does not exist in the legacy system. Therefore, data cleansing is not applicable.

Data for the Work Permit Template will be captured directly in the Data Collection Template (DCT) and any required refinement will be carried out during the data construction activity.

IDCriticalityError Message/Report DescriptionRuleOutputSource System


Not Applicable


Note: List of Cleansing is maintained here: Conversion Specs Register (DCT & Cleansing Report)


Conversion Process

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

image-2025-6-11_16-37-32.png

Collection will be done manually in the Data Collection Template for the following scenarios:

  • For all A2D In-scope Planning Plants.

Data Privacy and Sensitivity

Not Applicable


Extraction

Data extraction is not applicable, as no corresponding data exists in the legacy system.

Extraction Run Sheet

Req #Requirement DescriptionTeam Responsible

Not Applicable

Selection Screen

Selection Ref ScreenParameter NameSelection TypeRequirementValue to be entered/set

Not Applicable


Data Collection Template (DCT)

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

Note: All rules specified below should be documented as a tooltip in the DC Page.

Format:

  • Line 1: Mandatory / Conditional
  • Line 2: Remaining text


1. Permit to Work Template

Field NameField DescriptionRule
WORKPERMITApplication

Mandatory.

Staging identifier used to uniquely define a Permit to Work Template.

WORKPERMITTYPEUsage of WCM Object

Mandatory.

Must be a valid Work Permit Template Type (VPTWTEMPLATETYPE).

WRKPERMITDESCDescriptive Short Text

Mandatory.

Template for Maintenance - prefix with MAIN and suffixed with NNN.

Template for Non-Maintenance Work - prefix with NMW and suffixed with NNN. 

Note: NNN should be running 3 digit number

Examples:

  • MAIN_WORK_PERMIT_001
  • MAIN_WORK_PERMIT_002
  • NMW_WORK_PERMIT_001

There should be no duplicate descriptions within the same plant.

All Letters must be in uppercase.

The description must correspond to the permit template type. For example, a maintenance work permit can only use the prefix MAIN if the Permit Template Type is also set to Maintenance.

MAINTENANCEPLANNINGPLANTMaintenance Planning Plant

Mandatory.

Allowed values: List from Value Mapping - Plant where Maintenance Plant = Yes

WRKPERMITVALIDFRMDATEValid-From Date for WCM Object

Mandatory.

  • Start date of validity of template
  • Ensure this is set to  current date or in the future. No date in the past.
  • Must be in DDMMYYYY format

Note: "Current Date" refers to the start validity of the Permit to Work template at a specific reference point in time. 

During mocks and at go-live, "Current Date" should be treated as the "go-live" date.
If a past date is provided, this will be set to the "go-live" date.

WRKPERMITVALIDFRMTIMEValid-From Time for WCM Object

Mandatory.

  • Start time of validity of template
  • Must be in HHMMSS format 
WRKPERMITVALIDTODATEValid-To Date for WCM Object

Mandatory.

  • End date of validity of template
  • Ensure date is in the future. Should be later than the Valid-From Date
  • Must be in DDMMYYYY format

Note: Referring to the note in “Valid-From Date for WCM Object”, if a past date is provided, this will be set to the "go-live" date plus the difference between the originally provided Valid-To Date and Valid-From Date for the WCM Object.

WRKPERMITVALIDTOTIMEValid-To Time for WCM Object

Mandatory

  • End time of validity of template
  • Must be in HHMMSS format
WORKCENTERWork Center

Mandatory.

  • Responsible work center for template
  • Should exist in Work Centre DCT.
WORKPERMITAPPROVALPermit Key (Approval Type)

Mandatory.

Must be a valid Permit Template Type  (T357G).

Note: List of DCTs is maintained here: Conversion Specs Register (DCT & Cleansing Report)

Extraction Dependencies

Item #Step DescriptionTeam Responsible

Not Applicable


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 ADMM 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 Advanced Data Migration and Management (ADMM)
  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.

SyWay Data Team

2

In dspMigrate, select the wave –R3 S4/HANA – Plant Maintenance

Syniti

3

Go to Process Area Launch and Process the Object – Permit to Work Template

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

SyWay Data Team


Transformation Rules

1. Permit to Work Template

Rule #Source systemSource TableSource FieldSource DescriptionTarget SystemTarget TableTarget FieldTarget DescriptionTransformation Logic
1DCTIWRKPMTTEMPLATEWORKPERMITApplicationS/4 HanaIWRKPMTTEMPLATEWORKPERMITApplicationDirect Mapping
2DCTIWRKPMTTEMPLATEWORKPERMITTYPEUsage of WCM ObjectS/4 HanaIWRKPMTTEMPLATEWORKPERMITTYPEUsage of WCM ObjectDirect Mapping
3DCTIWRKPMTTEMPLATEWRKPERMITDESCDescriptive Short TextS/4 HanaIWRKPMTTEMPLATEWRKPERMITDESCDescriptive Short TextDirect Mapping
4DCTIWRKPMTTEMPLATEMAINTENANCEPLANNINGPLANTMaintenance Planning PlantS/4 HanaIWRKPMTTEMPLATEMAINTENANCEPLANNINGPLANTMaintenance Planning PlantDirect Mapping
5

DCT


IWRKPMTTEMPLATE



WRKPERMITVALIDFRMDATE

Valid-From Date for WCM ObjectS/4 Hana

IWRKPMTTEMPLATEWRKPERMITVALIDFRMDATEValid-From Date for WCM Object

Direct Mapping.

If the DCT date is earlier than the value specified in Value Mapping: OTH_Migration_Date Relevant Values A2D (using Object ID "1004" and Field Name "IWRKPMTTEMPLATE-WRKPERMITVALIDFRMDATE"), replace it with the Value from OTH_Migration_Date Relevant Values A2D.

Value Mapping

OTH_Migration_Date Relevant Values A2D

Value

Value
6DCTIWRKPMTTEMPLATEWRKPERMITVALIDFRMTIMEValid-From Time for WCM ObjectS/4 Hana

IWRKPMTTEMPLATEWRKPERMITVALIDFRMTIMEValid-From Time for WCM Object

Direct Mapping.

If DCT "Valid-From Date for WCM Object" date is earlier than the value specified in Value Mapping: OTH_Migration_Date Relevant Values A2D (using Object ID "1004" and Field Name "IWRKPMTTEMPLATE-WRKPERMITVALIDFRMDATE"), replace it with the

Value from OTH_Migration_Date Relevant Values A2D +

(DCT Valid-To Time for WCM Object - DCT Valid-From Time for WCM Object).

Value Mapping

OTH_Migration_Date Relevant Values A2D

Value

Value
7DCTIWRKPMTTEMPLATEWRKPERMITVALIDTODATEValid-To Date for WCM ObjectS/4 HanaIWRKPMTTEMPLATEWRKPERMITVALIDTODATEValid-To Date for WCM ObjectDirect Mapping
8DCTIWRKPMTTEMPLATEWRKPERMITVALIDTOTIMEValid-To Time for WCM ObjectS/4 HanaIWRKPMTTEMPLATEWRKPERMITVALIDTOTIMEValid-To Time for WCM ObjectDirect Mapping
9DCTIWRKPMTTEMPLATEWORKCENTERWork CenterS/4 HanaIWRKPMTTEMPLATEWORKCENTERWork CenterDirect Mapping
10DCTIWRKPMTTEMPLATEMAINTENANCEPLANNINGPLANTMaintenance Planning PlantS/4 HanaIWRKPMTTEMPLATEWORKCENTERPLANTPlantDirect Mapping

2. Approvals

Rule #Source systemSource TableSource FieldSource DescriptionTarget SystemTarget TableTarget FieldTarget DescriptionTransformation Logic
1DCTIWRKPMTTEMPLATEWORKPERMITApplicationS/4 HanaIWPMAPPROVALWORKPERMITApplicationDirect Mapping
2DCTIWRKPMTTEMPLATEWORKPERMITAPPROVALPermit Key (Approval Type)S/4 HanaIWPMAPPROVALWORKPERMITAPPROVALPermit Key (Approval Type)Direct Mapping
3----S/4 HanaIWPMAPPROVALWORKPERMITAPPROVALSTATUSWork Permit Approval StatusDefault to "A"

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

Transformation Mapping

Mapping Table NameMapping Table Description
OTH_Migration_Date Relevant Values A2DDates to be defaulted for A2D objects for each Migration Cycle
PlantOld to New Plant

List of Transformation Mappings with additional details is maintained here: Transformation Mappings

Transformation Dependencies

List the steps that need to occur before transformation can commence
Item #Step DescriptionTeam Responsible
1Ensure DCT tables completenessSyniti
2Ensure all Transformation mappings are up to date.Syniti


Pre-Load Validation

Project Team

Completeness

TaskAction
Verify Record CountData team to verify that the total number of relevant records from the source systems is equal to the total number of records in the Preload and Load Sheets.

Accuracy

TaskAction
Conversion Accuracy

SyWay A2D 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 ReportsReview 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.

Business

Completeness

TaskAction
Verify Record CountBusiness team to verify that the total number of relevant records from the source systems is equal to the total number of records in the Preload and Load Sheets.

Accuracy

TaskAction
Conversion AccuracyBusiness  to verify that all the data in the load table/file is accurate as per endorsed transformation/mapping rules (and signed-off data) 


Load

Custom Load tool will be used to upload the Work Permit Template. The load tool should replicate data creation method under class CL_WCM_PTW_HELPER_ROOT to accommodate upload of all the necessary data sets. 

Load Run Sheet

Item #Step DescriptionTeam 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

Configuration

Item #Configuration Item
1T001W-Plants/Branches
2T357G-Permits
3

WCCY-WCM: Use of Application

Conversion Objects

Object #Preceding Object Conversion Approach
1006Work Centre

Error Handling

Error TypeError DescriptionAction Taken
Configuration

Invalid Plant

Engage Functional team to expedite and fix the error in the system

Configuration

Invalid Permit

Engage Functional team to expedite and fix the error in the system

Configuration

Invalid WCM: Use of Application

Engage Functional team to expedite and fix the error in the system

Invalid 

Invalid or Inactive Work Centre assigned

Expedite whether the master data is changed in the system


Post-Load Validation

Project Team

Completeness

TaskAction

Verify Count

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


Accuracy

TaskAction

Conversion Accuracy

Data team to verify that the Work Permit Template data in target S/4 HANA were loaded correctly via dspMigrate post load reports or standard reports from S/4 HANA. 


Business

Completeness

TaskAction

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.


Accuracy

TaskAction

Conversion Accuracy

Verify that the Work Permit Template data in target S/4 HANA were loaded correctly via dspMigrate post load reports or standard reports from S/4 HANA.


Key Assumptions

  • Master Data Standard is up to date as on the date of documenting this conversion approach and data load.
  • Permit to Work Template is in scope based on data design and any exception requested by business.
  • Only one approval type is required for the Permit to Work Template.
  • There must be at least one Maintenance Permit Template Type and at least one Non-Maintenance Permit Templaye Type for all Planning Plants, unless local regulatory requirements specify otherwise.
  • Planning Plants in A2D scope are the same as Maintenance Plants in A2D scope. As per the SyWay to-be design, the Planning Plant will always correspond to the Maintenance Plant.


See also

Work Permit Template is managed using Fiori Application and the data sits within CDS views.

Since this is a new functionality, references have been included below to support the conversion process.

1. General Information


2. Approvals


Change log

Version Published Changed By Comment
CURRENT (v. 70) Feb 09, 2026 11:20 ERGUIZA-ext, Pinky Love
v. 75 Jan 29, 2026 07:44 ERGUIZA-ext, Pinky Love
v. 74 Jan 28, 2026 06:30 ERGUIZA-ext, Pinky Love
v. 73 Dec 15, 2025 15:21 ERGUIZA-ext, Pinky Love
v. 72 Dec 15, 2025 14:53 ERGUIZA-ext, Pinky Love
v. 71 Dec 15, 2025 14:31 ERGUIZA-ext, Pinky Love
v. 70 Dec 15, 2025 14:23 ERGUIZA-ext, Pinky Love
v. 69 Dec 11, 2025 13:11 ERGUIZA-ext, Pinky Love
v. 68 Dec 11, 2025 12:53 ERGUIZA-ext, Pinky Love
v. 67 Dec 11, 2025 12:50 ERGUIZA-ext, Pinky Love

Go to Page History

  • No labels