Versions Compared

Key

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

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 - Work Permit Template will be build 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

system

systems and represents a new design in the to-be Syensqo landscape.

200

300

S/4 HANA

200

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 Object
CHAR3Mandatory
IWRKPMTTEMPLATEWRKPERMITDESCWCESTXTDescriptive Short TextCHAR40Mandatory
IWRKPMTTEMPLATEMAINTENANCEPLANNINGPLANTIWERKMaintenance Planning PlantCHAR4 Mandatory
IWRKPMTTEMPLATEOPERATIONWORKCENTERINTERNALIDCR_OBJIDObject ID of the resourceNUMC8Mandatory
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.  ApprovalsApprovals

TableFieldData ElementField DescriptionData TypeLengthRequirement
IWPMAPPROVALWORKPERMITWCEWAPINRApplicationCHAR12Mandatory
IWPMAPPROVALWORKPERMITAPPROVALPMSOGPermit Key
(Approval Type)CHAR10Mandatory
IWPMAPPROVALWORKPERMITAPPROVALSTATUSPTWEWORKPERMITAPPROVALSTATUSWork Permit Approval StatusCHAR1
MandatoryIWPMAPPROVALWORKPERMITAPPROVALDESCRIPTIONGNTXTPermit TextCHAR
30
Mandatory
IWPMAPPROVALWRKPMTMGMTOBJSUBTYPEWCETYPType of WCM ObjectCHAR1 Mandatory

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 Permit 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 for the following scenarios:

  • For all A2D In-
scope Maintenance
  • 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. 

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: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
Field
NameField DescriptionRule
WORKPERMITApplication

Mandatory.

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

WORKPERMITTYPE
Usage of WCM Object
Work Permit Template Type

Mandatory.

Must be a valid

Characteristic Group (WCCY

Work Permit Template Type (VPTWTEMPLATETYPE).

WRKPERMITDESCDescriptive Short Text

Mandatory.

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

Template for

Operator Asset Care

Non-Maintenance Work - prefix with NMW and suffixed with

OAC.

NNN. 

Note: NNN should be running 3 digit number

Examples:

  • MAIN_WORK_PERMIT_001
OAC
  • MAIN_WORK_PERMIT_002
  • NMW_WORK_PERMIT_001

There should be no duplicate descriptions within the same plant.

All Letters must

be Capital.

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

MAINTENANCEPLANNINGPLANTMaintenance Planning Plant

Mandatory.

Allowed values: List from Value

Mapping - Plant where Maintenance Plant = Yes

OPERATIONWORKCENTERINTERNALIDObject ID of the resource

Mandatory.

Start time of validity of template

WRKPERMITVALIDFRMDATEValid-From Date for WCM Object

Mandatory.

  • Start date of validity of template
  • Ensure
date today or
  • this is set to  current date or in the future. No date in the past.
  • Must be in DDMMYYYY format
WRKPERMITVALIDFRMTIMEValid-From Time for WCM Object

Mandatory.

End time of validity of template

WRKPERMITVALIDTODATE

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
Valid-To Date
for WCM Object

Mandatory.

End date
  • Start time of validity of template
Ensure date is in the future.
  • 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
WRKPERMITVALIDTOTIME

Note: Referring to the note in “Valid-

To Time for WCM ObjectMandatoryWORKCENTERWork Center

Mandatory.

  • Responsible work center for template
  • Should

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

    Mandatory.

    Default: Same as maintenance planning plant

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

    Extraction Dependencies

    Item #Step DescriptionTeam Responsible
    NA

    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

    Permit

    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

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

    Transformation Mapping

    Mapping Table NameMapping Table Description

    Transformation Dependencies

    List the steps that need to occur before transformation can commenceItem #Step DescriptionTeam Responsible1Ensure DCT tables completenessSyniti2Ensure all Transformation mappings are up to date.Syniti
    1DCTIWRKPMTTEMPLATEWORKPERMITApplicationS/4 HanaIWRKPMTTEMPLATEWORKPERMITApplicationDirect Mapping
    2DCTIWRKPMTTEMPLATEWORKPERMITTYPEWork Permit Template TypeS/4 HanaIWRKPMTTEMPLATEWORKPERMITTYPEUsageDirect 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.

    6DCTIWRKPMTTEMPLATEWRKPERMITVALIDTODATEValid-To Date for WCM ObjectS/4 Hana

    IWRKPMTTEMPLATEWRKPERMITVALIDTODATEValid-To Date 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 +

    (Valid-To Date for WCM Object - Valid-From Date for WCM Object).

    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
    2----S/4 HanaIWPMAPPROVALWORKPERMITAPPROVALPermit Key (Approval Type)Derive the value as per Value Mapping: OTH_Migration_Date Relevant Values A2D (using Object ID "1004" and Field Name = "IWPMAPPROVAL-WORKPERMITAPPROVAL".
    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

    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

    Note: A custom load program is required and is to be developed by the SyWay Development Team.

    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

    Pre-Load Validation

    Project Team

    Completeness

    TaskActionVerify 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

    TaskActionConversion Accuracy

    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

    TaskActionVerify 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

    TaskActionConversion 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 Item1Authorisation Groups2Nature of Work3

    Personal Protective Equipment

    4

    Safety Precautions

    5

    Approval Categories

    Approval Types

    7

    Work Permit Type

    8

    Work Permit Template Types

    Conversion Objects

    Object #Preceding Object Conversion Approach1002Equipment1003Functional Location1006Work Center3001Business Partner - Employee (BUP003)

    Error Handling

    Error TypeError DescriptionAction Taken

    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 loaded in the target 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
    the same count as of the endorsed load file.
    • 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, aligned with the configuration values. Exceptions apply only to plants with local regulatory requirements, where no templates may be expected.
    • 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

    Image Added

    2. Approvals

    Image Added

    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.

    See also

    Work Permit Template is managed using Fiori Application and the data sits within CDS views. The technical design of the target for this conversion approach.

    • General Information (View - IWRKPMTTEMPLATE)

    Image Removed

    • Nature of Work (View- IWRKPERMITNOW)

    Image Removed

    • Object List (View - ITECHOBJLIST)

    Image Removed

    • Safety Requirements
      • Safety Precautions (View - IWRKPERMITSPR)
      • Personal Protective Equipment (View - IWRKPERMITPPE)

    Image Removed

    • Partners - (View - IPERMITPARTNER)

    Image Removed

    • Approvals (View - IWPMAPPROVAL)
    Image Removed


    Change log

    Change History
    limit10