BR100 - Maintenance - v5.0 - Model - 2 - 29JAN2021

You might also like

Download as docx, pdf, or txt
Download as docx, pdf, or txt
You are on page 1of 64

Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

Dubai Petroleum Establishment


Configuration Document
Global Timesheet
Third Party Maintenance Contractors

Author Fujitsu Technology Solutions

Creation Date 15-Oct-2019

Last Updated 29-Jan-2021

Document Ref DPE GTS Maintenance Configuration Document

Version V5.0

Document Control

Document Change History

Date Version Change Reference Name

15-Oct- V1.0 No Previous Document Fujitsu Technology Solutions


2019

01-Jul- V2.0 Changes to Timekeeper Setup and Faisal M. Dokku


2020 Layout

28-Aug- V3.0 Updated with Timesheet Approval Faisal M. Dokku


2020 Setups

Page 1 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

Date Version Change Reference Name

04-Oct- V4.0 Updated the new possible error codes in


2020 PO program and a few feedback Faisal M. Dokku
received until the Training Session

09-Nov- V4.1 Added Points following the CR


Faisal M. Dokku
2020

29-Jan- V5.0 Incorporated changes made during UAT


Faisal M. Dokku
2021
62

Reviewers

No. Name Position

1 Ritasish Bhattacharjee Project Manager

Distribution

Copy No. Name Location

1 Library Master Project Library

2 PMO Library Fujitsu Library

Note to Holders:
If you receive an electronic copy of this document and print it out, please write your name on the equivalent of the cover page, for
document control purposes.
If you receive a hard copy of this document, please write your name on the front cover, for document control purposes.

Page 2 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

Table of Content
DOCUMENT CONTROL_______________________________________________________________________________1
DOCUMENT CHANGE HISTORY__________________________________________________________________________1
REVIEWERS_______________________________________________________________________________________2
DISTRIBUTION_____________________________________________________________________________________2
PURPOSE OF THIS DOCUMENT__________________________________________________________________________5
THIRD PARTY CONTRACTORS SETUP______________________________________________________________________6
1. CUSTOM RESPONSIBILITIES________________________________________________________________________7
Menus_______________________________________________________________________________________7
Functions_____________________________________________________________________________________7
Request Group_______________________________________________________________________________10
Responsibilities Definition_______________________________________________________________________12
2. FLEXFIELD VALUE SET___________________________________________________________________________14
Define Value Sets_____________________________________________________________________________14
3. DESCRIPTIVE FLEXFIELD__________________________________________________________________________18
Enterprise Asset Management DFF_______________________________________________________________18
HR Contractor Cost DFF________________________________________________________________________19
HR Contractors’ Master Data Update Notification Recipient List DFF_____________________________________20
Time and Labor Engine DFF_____________________________________________________________________21
4. LOOKUPS___________________________________________________________________________________23
Purchasing Lookups___________________________________________________________________________23
Employee Person Type_________________________________________________________________________23
Work Order Operation Status____________________________________________________________________25
Work Order Asset Area_________________________________________________________________________25
PO Process Mail______________________________________________________________________________26
PO Interface Errors____________________________________________________________________________27
Payables Notification Mail______________________________________________________________________28
Person Type__________________________________________________________________________________29
5. EAM______________________________________________________________________________________30
EAM Resource Setup___________________________________________________________________________30
EAM: Define WIP Accounting Classes______________________________________________________________31
6. SUPPLIER SETUP______________________________________________________________________________32
7. UNIT OF MEASURE_____________________________________________________________________________33
8. OTL______________________________________________________________________________________34
Define Messages______________________________________________________________________________34
Define Formula Function________________________________________________________________________35
Register Formula______________________________________________________________________________38
Define Formula_______________________________________________________________________________40
Define Mapping Components____________________________________________________________________50
Define Mapping______________________________________________________________________________51
Define Alternate Name Mapping_________________________________________________________________52
Define Alternate Name Definition________________________________________________________________53
Define Retrieval Rule Group_____________________________________________________________________54
Define Category for Time Entry Rules______________________________________________________________54
Define Time Entry Rule_________________________________________________________________________55
Define Time Entry Rule Group____________________________________________________________________58
Define Default Timekeeper Group________________________________________________________________59
Page 3 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

OTL Time Entry Approval_______________________________________________________________________59


Define Approval Periods________________________________________________________________________59
OTL Preferences______________________________________________________________________________60
Define Eligibility Criteria using below navigation_____________________________________________________64

Page 4 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

Purpose of this document


Dubai Petroleum’s requirement is to expand the use of the timesheet system to allow processing all 3rd Party
Maintenance contractor timesheets and payments using integration of Oracle Advance Procurement,
Purchasing, Oracle Enterprise Asset Management, Oracle Time & Labor, Payable and custom programs. This
document serves as a guide for DPE Administrative users to highlight the steps required to configure Global
Timesheet process flow for Third Party Maintenance Contractors.

Page 5 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

Third Party Contractors Setup


Following is the list of steps required to configure third party contractors in Global Timesheet:

1. Custom Responsibilities
2. Flexfield Value Set
3. Descriptive Flexfield
4. Lookups
5. EAM Setup
6. Suppliers Setup
7. Unit of Measure
8. OTL

The above has been divided into two categories:


1. Manual Setups that needs to be performed by DPE IT – Highlighted in Blue and
2. Automatic – Admin Upload files that will automate the setups – Highlighted in Green.
Details related to above mentioned steps are described in the following sections.

Page 6 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

1. Custom Responsibilities
Menus
Create Menus using below navigation:
Navigation: System Administrator Application Menu
First, define following Menu Headers:

Menu
Menu User Menu Name Action
Type

New -
DPE_CNTNGNT_TMKPR DPE Contingent Timekeeper Standard
Create
Update
(Will be
DPE_HR_CWK_MENU DPE Contigent Worker Menu Standard
used
below)
OTL EAM Mass Approval Self Service New -
Approval Menu
Standard
OTL_SELF_SERVICE_APPROVAL Create
New -
DPE_HXC_TK_ENTRY DPE EAM Contingent Super Timekeeper Standard Create

Now query for above created menus to add below functions

Functions
Function details are as follows:
Navigation: System Administrator  Application  Functions
User
Menu Se Actio
Menu Menu Prompt Submenu Function
Type q ns
Name
Continge
OTL
nt Standa Timekeep New -
DPE_CNTNGNT_TMKPR 10   Timekeep
Timekee rd er Entry Add
er Entry
per

Continge
Navigator:
nt Standa New -
DPE_CNTNGNT_TMKPR 20     Disable
Timekee rd Add
Multiform
per

DPE Upda
Departme
Contigen Standa Departme BOM_BOMFDORS_ te –
DPE_HR_CWK_MENU 60 nts:
t Worker rd nts MENU Add
Update
Menu to
Page 7 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

User
Menu Se Actio
Menu Menu Prompt Submenu Function
Type q ns
Name
existi
ng
list
Upda
te –
Add
DPE
to
Contigen Standa Resource BOM_BOMFDORS_
DPE_HR_CWK_MENU 70 Resources existi
t Worker rd s MENU
ng
Menu
list

Upda
te –
DPE Resources Add
Contigen Standa - to
DPE_HR_CWK_MENU 80    
t Worker rd Employee existi
Menu s ng
list

Upda
te –
DPE Resources Add
Contigen Standa - to
DPE_HR_CWK_MENU 90    
t Worker rd Equipmen existi
Menu ts ng
list

OTL
EAM
Mass
OTL_SELF_SERVICE_AP Approval Standa OTL Self-Service New -
10 Time
PROVAL Self rd Approval Function Add
Service
Approval
Menu
OTL
EAM
Mass Show
OTL_SELF_SERVICE_AP Approval Standa Invoice New -
20
PROVAL Self rd Line Add
Service Details
Approval
Menu
OTL_SELF_SERVICE_AP OTL Standa 30 Purchasing Buyer   New -
Page 8 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

User
Menu Se Actio
Menu Menu Prompt Submenu Function
Type q ns
Name
EAM
Mass
Approval
PROVAL Self rd Work Center Add
Service
Approval
Menu
OTL
EAM
Mass
OTL_SELF_SERVICE_AP Approval Standa View New -
40  
PROVAL Self rd Document Add
Service
Approval
Menu
DPE
EAM
OTL
Continge Stand Timekeep New -
DPE_HXC_TK_ENTRY 10 Timekeep
nt Super ard er Entry Add
er Entry
Timekee
per
DPE
EAM
Navigator:
Continge Stand New -
DPE_HXC_TK_ENTRY 20 Disable
nt Super ard Add
Multiform
Timekee
per
DPE
EAM OTL
Continge Stand Define New -
DPE_HXC_TK_ENTRY 30
nt Super ard Timekeep Add
Timekee er Group
per

Page 9 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

Request Group
Request Group details are as follows:
Navigation: System Administrator Security Responsibility Requests
C
o
Group Application Description Type Name Action
d
e
DPE Contingent All Contingent Progr DPE GTS Timekeeper Group New –
Purchasing  
User Group Workers Reports am Automation Create
DPE Contingent All Contingent Progr Retrieve Timecard Data from New –
Purchasing  
User Group Workers Reports am OTL to EAM Create
DPE Contingent All Contingent Progr DPE GTS Labor Reporting New –
Purchasing  
User Group Workers Reports am Transactions Without Cost Create

Delete
DPE Contingent All Contingent Progr
Purchasing   Pay On Receipt AutoInvoice from
User Group Workers Reports am List
Delete
DPE Contingent All Contingent Progr DPE HR Contractor Data
Purchasing   from
User Group Workers Reports am Updated Alert List
Delete
DPE Contingent All Contingent Progr DPE New invoice created
Purchasing   from
User Group Workers Reports am alert to supplier List

Progr Update
am – Add
Report set for DPE New invoice created
DPE AP Reports Payables to
DPE Payables alert to supplier
existing
list
Progr Update
am – Add
Report set for DPE OTL to Purchasing
DPE AP Reports Payables Interface Program
to
DPE Payables
existing
list
Progr Update
am – Add
Report set for DPE GTS Maintenance - GRN
DPE AP Reports Payables to
DPE Payables to OTL Return Program
existing
list
Progr Update
am – Add
Report set for DPE GTS Labor Reporting
DPE AP Reports Payables to
DPE Payables Transactions With Cost
existing
list
DPE AP Reports Payables Report set for Progr DPE GTS Labor Reporting Update

Page 10 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

am – Add
to
DPE Payables Transactions Without Cost
existing
list

Update
– Add
All Purchasing SRS Progr DPE OTL to Purchasing
All Reports Purchasing   Interface Program
to
Reports am
existing
list

Update
– Add
DPE Contractor Human Progr DPE HR Contractor Data
Updated Alert
to
Administrator Resources am
existing
list

Update
DPE EAM Enterprise
– Add
Labour Asset DPE EAM Labour Progr DPE GTS Labor Reporting
to
Reporting Manageme Reporting Admin am Transactions Without Cost
existing
Admin nt
list

Update
Enterprise
DPE GTS EAM Work Order – Add
DPE EAM Asset Progr Weekly Schedule Report
DPE EAM Reports to
Reports Manageme am
existing
nt
list
Update
Enterprise
DPE GTS EAM Work Order – Add
DPE EAM Asset Progr
DPE EAM Reports Weekly Schedule Report - to
Reports Manageme am RASHID existing
nt
list
Update
Enterprise
– Add
DPE EAM Asset Progr DPE GTS Weekly Schedule
DPE EAM Reports Report – WCM
to
Reports Manageme am
existing
nt
list

Page 11 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

Responsibilities Definition
Define Responsibilities with following details:
Navigation: System Administrator Security Responsibility Define

Dat Data Requ


a Grou est
Respon Appli Availa Ac
Descri Gro p Grou
sibility catio Responsibility Key ble Menu tio
ption up Appli p
Name n From n
Na catio Nam
me n e
DPE DPE
Time Time DPE Ne
EAM Conti Conti
and Oracle and Conti w–
Conting DPE_CNTNGNT_EA ngent Stan ngent
Labor Applic Labor ngent Cr
ent MTMKPR Timek dard User eat
Engin ation Engin Timek
Timeke eeper Grou e
e e eeper
eper p
OTL
EAM
DPE OTL Mass
Oracle DPE
EAM - Time EAM Time Appro Ne
Self Conti
Mass and Mass and val w–
XXDPE_OTL_SELF_S Servic Stan ngent
Time Labor Time Labor Self Cr
RV_APPROVER e Web dard User eat
Card Engin Card Engin Servic
Applic Grou e
Approv e Appro e e
ations p
al val Appro
val
Menu
DPE DPE DPE
DPE
EAM Time EAM Time EAM Ne
Conti
Conting and Conti Oracle and Conti w–
DPE_EAM_CWK_HX Stan ngent
ent Labor ngent Applic Labor ngent Cr
C_SUPER_ADMIN dard User eat
Super Engin Super ation Engin Super
Grou e
Timeke e Timek e Timek
p
eper eeper eeper

Update – Check and Correct the existing list

The above 3 responsibilities must be created through the TCP but the Request groups associated with it
might not be correct. Ensure it is: DPE Contingent User Group.

If empty or not the same, update it to: DPE Contingent User Group

Page 12 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

New – Update
Navigation: System Administrator > Profile > System
Profile Option Site Value Responsibility

HR:User Type DPE EAM - Mass HR with Payroll User


Time Card Approval

HR:User Type DPE EAM HR User


Contingent Super
Timekeeper

HR:User Type DPE EAM HR User


Contingent
Timekeeper

Add the below responsibilities to the Organization access list as follows:

Navigation: Inventory > Setup > Organizations > Organization Access

Org Application Name Action

DPE
New -
DPE Human Resources Contractor
Update
Administrator
DPE
New -
ONS Human Resources Contractor
Update
Administrator

Page 13 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

2. Flexfield Value Set


Define Value Sets
Define Value Set using below navigation:
Navigation: System Administrator Application Validation Set
New – Create
Ensure the below list of Value sets are Created:
 OTL_EAM_CHARGE_DEPT_DPE
 OTL_EAM_OPERATION_DPE
 OTL_EAM_ORGANIZATION_ID_DPE
 OTL_EAM_OWNING_DEPT_DPE
 OTL_EAM_RESOURCE_DPE
 OTL_EAM_SERIAL_NUMBER_DPE
 OTL_EAM_WORK_ORDER_DPE

New – Create

Value Set Name OTL_EAM_HOUR_TYPE_DPE


Description Hour Type
List Type Poplist
Security Type No Security
Format Type Char
Max Size 40
Validation Type Independent

Value Description From

Overtime Overtime 01-Jan-1950

Regular Regular 01-Jan-1950

Note: You will need the ID of these values for a setup later in OTL (Define Category for 1. Time Entry Rules
and also for 2. Personalization setup). Please record the values from there:

After Saving the form Navigate: Click on (M) Help > Diagnostics > Examine…

In the Dialog box enter:

Block: Value
Field: FLEX_VALUE_ID

Page 14 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

Value: (Record respective values in there for both Overtime and Regular Lines)
(Sample values from the current system setup (record yours) Overtime: 509082, Regular 509083)

New – Create

Value Set Name DPE_OTL_TO_PO_PROCESS_MODE


Description DPE OTL to Purchasing Process Mode
List Type List of Values
Security Type No Security
Format Type Char
Max Size 20
Validation Type Independent

New – Create

Value Set Name XXDPE_OTL_PO_RCPT_REPROCESS


Description DPE OTL PO to Receipt ReProcess Mode
List Type List of Values
Security Type No Security
Format Type Char
Max Size 20
Validation Type Table
Table Application Purchasing
Table Name po_headers_all pha
Value Pha.segment1
Type Char
Size 20
ID Pha.po_header_id
Type Number
Page 15 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

Value Set Name XXDPE_OTL_PO_RCPT_REPROCESS


Size 20
where
type_lookup_code ='STANDARD' AND approved_flag = 'Y' AND EXISTS(select 1
Where/Order By FROM XXDPE_OTL_PO_RCPT_STG where po_header_id =pha.po_header_id AND
PO_IMPORT_FLAG = 'S' A ND RCV_IMPORT_FLAG IS NULL ) AND :
$FLEX$.P_ENABLE_PO_NUM is not null

New – Create

Value Set Name DPE_OTL_PO_FROM_DATE


Description DPE OTL PO From Date
List Type List of Values
Security Type No Security
Format Type Standard Date
Max Size 11
Validation Type Special
Event Validate
FND PLSQL "BEGIN

if ':$FLEX$.P_ENABLE_FROM_TO_DATE' IS NULL then

Function NULL;

end if;

END;"

Page 16 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

New – Create

Value Set Name DPE_OTL_PO_TO_DATE


Description DPE OTL PO TO Date
List Type List of Values
Security Type No Security
Format Type Standard Date
Max Size 11
Validation Type Special
Event Validate
FND PLSQL "BEGIN

if ':$FLEX$.P_ENABLE_FROM_TO_DATE' IS NULL then

Function NULL;

end if;

END;"

Page 17 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

3. Descriptive Flexfield

Enterprise Asset Management DFF


New – Update

Create a segment in the DFF using the below navigation


Navigation: EAM > Setup > Flexifields > Descriptive > Segments:
Query for:
Application: Bills of Material
Title: Resource Information
Unfreeze the Flexifiled definition > Click on the Segments Button
Define the following line:
 Number > 50
 Name > OT MM Number
 Window Prompt > OT MM Number
 Column > ATTRIBUTE7
 Required > Unchecked (Optional)
Freeze the Flexifield Definition again.
Save and Close

Page 18 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

HR Contractor Cost DFF


New – Update

Create a segment in the DFF using the below navigation


Navigation: Application Developer > Flexifields > Descriptive > Segments:
Query for:
Application: Human Resources
Title: Additional Personal Details
Unfreeze the Flexifiled definition > Choose the CWK Context > Click on the Segments Button

Define the following line:


 Number > 80
 Name > Total WO-PO Costing
 Window Prompt > Total WO-PO Costing
 Column > ATTRIBUTE12
 Required > Unchecked (Optional)
 Description: Total Work Order / Approved Purchase Order Costs
 Display Size: 25
Freeze the Flexifield Definition again.
Save and Close

Page 19 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

HR Contractors’ Master Data Update Notification Recipient List DFF


New – Update

Create a segment in the DFF using the below navigation


Navigation: Application Developer > Flexifields > Descriptive > Segments:
Query for:
Application: Application Object Library
Title: Common Lookups
Unfreeze the Flexifiled definition > Choose XXDPE_GTS_MAINT_CNGU_EMAILS Context
> Click on the Segments Button

Define the following lines:


Number Name Window Prompt Column Value Set Required
10 RECIPIENT_01 Recipient 1 ATTRIBUTE1 DPE_EAM_CUR_APPR No
20 RECIPIENT_02 Recipient 2 ATTRIBUTE2 DPE_EAM_CUR_APPR No
30 RECIPIENT_03 Recipient 3 ATTRIBUTE3 DPE_EAM_CUR_APPR No
40 RECIPIENT_04 Recipient 4 ATTRIBUTE4 DPE_EAM_CUR_APPR No
50 RECIPIENT_05 Recipient 5 ATTRIBUTE5 DPE_EAM_CUR_APPR No
60 RECIPIENT_06 Recipient 6 ATTRIBUTE6 DPE_EAM_CUR_APPR No
70 RECIPIENT_07 Recipient 7 ATTRIBUTE7 DPE_EAM_CUR_APPR No
80 RECIPIENT_08 Recipient 8 ATTRIBUTE8 DPE_EAM_CUR_APPR No
90 RECIPIENT_09 Recipient 9 ATTRIBUTE9 DPE_EAM_CUR_APPR No
100 RECIPIENT_10 Recipient 10 ATTRIBUTE10 DPE_EAM_CUR_APPR No
Freeze the Flexifield Definition again.
Save and Close

Page 20 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

Time and Labor Engine DFF


New – Update

Create a segment in the DFF using the below navigation


Navigation: System Administrator > Application > Flexifields > Descriptive > Segments:
Query for:
Application: Time and Labor Engine
Title: OTL Information Types
Unfreeze the Flexifiled definition > Click on the Segments Button
Under the Context Field Values, choose > EAM_CONTEXT.

Define the following line:


(Note: 10 to 80 should already exist. You may have to create from 90 and onwards)

Numb Value Display Enabl Requir


er Name Window Prompt Column Set ed ed ed
EAMWORKORDE EAMWORKORDE ATTRIBUT No
10 R R E1   * *
EAMASSETNUMB EAMASSETNUMB ATTRIBUT No
20 ER ER E2   * *
ATTRIBUT No
30 EAMOPERATION EAMOPERATION E3   * *
ATTRIBUT No
40 EAMRESOURCE EAMRESOURCE E4   * *
EAMCHARGEDEP EAMCHARGEDEP ATTRIBUT No
50 T T E5   * *
EAMASSETGROU EAMASSETGROU ATTRIBUT No
60 P P E6   * *
EAMDEPARTMEN EAMDEPARTMEN ATTRIBUT No
70 TID TID E7   * *
EAMORGANIZATI EAMORGANIZATI ATTRIBUT No
80 ONID ONID E8   * *
EAMHOURTYPED EAMHOURTYPED ATTRIBUT Yes
90 PE PE E9   * *
Freeze the Flexifield Definition again.
Save and Close

Page 21 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

Run the Mapping Program:


a) Switch responsibility to – Global HRMS Manager
b) View > Request >Single request
c) Request name : Generate Flexfield and Mapping Information
a. Parameter
i. Effective date : 01-jan-1951

d) Click OK.
e) Click Submit.

Page 22 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

4. Lookups

Purchasing Lookups
Create Purchasing Lookup Codes using below navigation
Navigation: Purchasing Super User Setup Purchasing Lookup Codes

NA

New – Update

Employee Person Type


Create Employee Person Type Lookup Codes using below navigation
Navigation: Application Developer Application Lookups Application Object Library
Search for Lookup Type ‘XXDPE_EMP_PER_TYPE_SEQ’ and update the below value:

Code Lookup Code Meaning Description Tag

199999 105000
SEQ-CON-
100001 (Check and update the last valid number for
MAIN
sequence generation)

Associate the generation sequence Lookup Codes using below navigation


Navigation: Application Developer Application Lookups Common
Search for Lookup Type ‘XXDPE_EMP_PER_TYPE’ and update the below value:

Lookup Code Description Tag Flex filed


Code
Meaning (Emp Type sequence)

CONTRACTOR Contractor SEQ-CON-MAIN


MAINTENANCE Maintenance

Page 23 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

New – Create
(Note: These values needs to be updated with the list of Approvers as applicable. Ensure the attached excel
list is available)
Create new Email list notification for Contractor master data changes using the below navigation
Navigation: Application Developer Application Lookups Common
Type: XXDPE_GTS_MAINT_CNGU_EMAILS
Meaning: GTS Maintenance - Contractors' Changes/Updates Email Recipients List
Application: DPE Custom Application
Description: GTS Maintenance - Contractors' Changes/Updates Email Recipients List

Ensure the list values (as tested by HR Team in UAT)

Page 24 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

Work Order Operation Status


Create Work Order Operation Status Lookup Codes using below navigation
Navigation: Application Developer Application Lookups MFG Lookups
Search for Lookup Type ‘XXDPE_WO_OP_STATUS’ and create below lookup codes.
New – Create

Code Lookup Code Meaning Description Tag

CAN CAN CAN

COMP COMP COMP

INPRG INPRG INPRG

SCHED SCHED SCHED

TECO TECO TECO

WSCHED WSCHED WSCHED

Work Order Asset Area


Create Work Order Asset Area Lookup Codes using below navigation
Navigation: Application Developer Application Lookups MFG Lookups
Search for Lookup Type ‘XXDPE_ASSET_AREA_TSP_OTL_APPR’ and create below lookup codes.
New – Create
(Note: These values needs to be updated with the list of EAM Area and TSP Approval Fields as applicable)

Code Lookup Code Meaning Description Tag

FATEH FATEH Prefix A belongs to Fateh A

Prefix B also belongs to Rashid with B


RASHID RASHID
detailed logic in code

SWF SWF Prefix B belongs to SWF B

ONS ONS Onsite C

Page 25 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

PO Process Mail
Create PO Process Mail Lookup Codes using below navigation
Navigation: DPE Purchasing Setup PurchasingLookups
Search for Lookup Type ‘XXDPE_OTL_TO_PO_CONC_PROG_MAIL’ and create below lookup
codes.
New – Create
(Note: These values needs to be updated with the list of Oracle users interested in receiving the GTS
Maintenance PO Program Error Notifications – Replace and add the sample names from the list BELOW)

Code Lookup Code Meaning Description Tag

10 10 DOKKUF

20 20 MASCARJ

30 30 MENDOJ

40 40 RAJAGR

Page 26 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

PO Interface Errors
Create PO Interface Errors Lookup Codes using below navigation
Navigation: DPE Purchasing Setup PurchasingLookups
Search for Lookup Type ‘XXDPE_OTL_TO_PO_INTF_ERRCODE’ and create below lookup codes.
New – Create

Code Lookup Code Meaning Lookup Code Description Tag

10 GL_ERR1 GL Period closed Finance

20 PO_ERR1 PO Period closed Finance

30 INV_ERR1 MM Number Not Linked to Craft Code Maintenance

40 PO_ERR2 BPA line Expired Supply Chain

50 PO_ERR3 Valid BPA Not Found Supply Chain

60 HR_ERR1 HR Supplier Info missing HR

70 IT_ERR1 Unknown Errors - Contact the IT Applications Support IT

80 PO_ERR4 ‘Maintenance’ Site not found for this Vendor Supply Chain

90 PO_ERR5 Multiple active BPAs found for this Item Code and Vendor Supply Chain

100 GL_ERR2 Inactive Charge Account Finance

110 GL_ERR3 Funds Check Failed Finance

Page 27 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

Payables Notification Mail


Create Payables Notification Mail Lookup Codes using below navigation
Navigation: DPE Payables Manager > Setup > Lookups > Payables
Search for Lookup Type ‘XXDPE_iSUP_TO_FIN_TAX_INV_MAIL’ and create below lookup codes.
New – Create
(Note: These values needs to be updated with the list of Recipients for Tax Invoice updates by suppliers as
applicable)

Code Lookup Code Meaning Description Tag

10 DOKKUF Dokku Mohammed Faisal

20 RAJAGR Rajashree

30 MASCARJ Janet

40 MENDOJ Jason

Search for Lookup Type ‘SOURCE’ and add below lookup codes.
New – Update

Code Lookup Code Meaning Description Tag

GTS Maintenance GTS Maintenance Labour Entries - OTL


GTSMLEOTL
Labour Entries – OTL

Page 28 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

Assignment Category
Create Human Resource Assignment Category Code using below navigation
Navigation: Global HRMS Manager Other Definitions Application Utilities Lookup
Search for Lookup Type ‘CWK_ASG_CATEGORY’ and create below lookup codes.
New – Update

Code Lookup Code Meaning Description

DPE_MNTC Maintenance Maintenance

Person Type
Create Human Resource Person Type using below navigation:
Navigation: Global HRMS Manager Other Definitions Person Types
New – Update

User Name System Name

Contractor Maintenance Contingent Worker

Ex-Contractor – Contractor Maintenance Ex-contingent Worker

Page 29 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

5. EAM

EAM Resource Setup


eAM Resources will be created with Outside Processing Option as checked. Contingent Workers will be
assigned as employees on eAM Resource.
Existing – Update (when required/Ensure DFF is enabled in the form in this step)
Navigation: Bills of Material Routing Resources

Overtime Item Code will be associated through the DFF Field > OT MM Number. Enter the
corresponding Overtime MM Number in it.
(The DFF OT MM Number is left as free text to update the new MM Numbers. Validations could be added as
a valueset if required)

Page 30 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

EAM: Define WIP Accounting Classes


Existing – Update (If required)
Define or Update WIP Accounting Class using following navigation
Navigation: EAMSetupWIPWIP Accounting Class

Description: Use this form to define or update the Accounting combination for the Contractor expenses in
the Outside Processing Fields – both Valuation and Variance

Page 31 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

6. Supplier Setup
Existing – Update
(Note; This site setup ‘Maintenance’ is a very critical setup for the GTS Maintenance PO program. Hence it is
added in the BR100. In normal cases it should be with the users responsible for creating the Supplier site)
Create/Update Suppliers: A new site ‘Maintenance’ is required for the GTS Maintenance Program with the
following setup at supplier level (Ensure the Spelling is correct without any extra spaces/characters):
Navigation: Purchasing Super User Supply Base Suppliers
 Tab > Address Book:
o Create new Site > Click on Create (Or Select Site and click on Update if the site name
‘Maintenance’ already exists)
o Make sure Address Purpose Purchasing and Payment is checked

 Tab > Purchasing > Self-Billing:


o For the same site updated in Address Details ensure:
 Pay On = Receipt
 Invoice Summary Level = Pay Site
 Tab > Invoice Management:
o Ensure at Supplier Site Level Invoice Match Option = Receipt
 Save

Page 32 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

7. Unit of Measure
New – Update
Define UOM:
Navigation: Inventory Setup Unit of Measure Unit of Measure
 Define D08 as 8 Hours Day, D10 as 10 Hours Day, D12 as 12 Hours Day, etc. within Class Time
 In the UOM Conversion, Provide the respective UOM with the corresponding number of hours.

Page 33 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

8. OTL

Define Messages
Define Messages using below navigation:
Navigation: Application Developer Application Messages
New – Ensure the setup as below with the updated message.
Name DPE_OTL_STD_WORKING_HRS
Languag
US
e
Applicati
Time and Labor Engine
on
Hours Exceeded!
Current
Message You have entered number of hours exceeding your contractual hours per day. If you have
Text worked more than your contractual hours, and if you are eligible for overtime, then please
enter them as over time in a separate line.
Name DPE_OTL_EAM_TSP_NO_APPR
Languag
US
e
Applicati
Time and Labor Engine
on
Current
Message No approver defined in TSP system. Please contact support team.
Text

Page 34 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

Define Formula Function


Define Formula Function using below navigation:
Navigation: Global HRMS Manager Other Definitions Formula Functions
New – Add
Name DPE_OTL_EAM_CWK_PERIOD_MAX
Data Type Number
Class External Function
Alias Name CWK_PERIOD_MAX
Description Function to enforce EAM TK timecard rule
Definition XXGTSM_OTL_EAM_TK_UTIL_PKG.CHECK_TC_RULE
Context Usages
Number Context Name Data Type

Parameters
Number Parameter Name Type Class Optional Continuing
1 P_RESOURCE_ID Number Input Only No No
2 P_SUBMISSION_DATE Text Input Only No No
3 P_PERIOD_MAXIMUM Number Input Only No No
4 P_PERIOD Number Input Only No No
5 P_REFERENCE_PERIOD Number Input Only No No
6 P_PRE_PERIOD_START Text Input Only No No
7 P_PRE_PERIOD_END Text Input Only No No
8 P_POST_PERIOD_START Text Input Only No No
9 P_POST_PERIOD_END Text Input Only No No
10 P_REF_PERIOD_START Text Input Only No No
11 P_REF_PERIOD_END Text Input Only No No
12 P_DURATION_IN_DAYS Number Input Only No No
13 P_TIMECARD_HRS Number Input Only No No

Page 35 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

New – Add
Name DPE_OTL_EAM_TSP_APPR_CNT
Data Type Number
Class External Function
Alias Name
Description Function to validate the existence of approver
Definition XXDPE_OTL_TO_PO_APPRV_PKG.GET_TSP_APPR_CNT
Context Usages
Number Context Name Data Type

Parameters
Number Parameter Name Type Class Optional Continuing
1 P_RESOURCE_ID Number Input Only No No

New – Add
Name XXDPE_EAM_TSP_REVIEWER
Data Type Number
Class External Function
Alias Name
Description Function to derive reviewer from TSP data
Definition XXDPE_OTL_TO_PO_APPRV_PKG.GET_APPROVER1
Context Usages
Number Context Name Data Type

Parameters
Number Parameter Name Type Class Optional Continuing
1 P_TIMECARD_BB_ID Number Input Only No No
2 P_TIMECARD_BB_OVN Number Input Only No No
3 P_RESOURCE_ID Number Input Only No No

Page 36 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

New – Add
Name XXDPE_EAM_TSP_APPROVER
Data Type Number
Class External Function
Alias Name
Description Function to derive approver from TSP data
Definition XXDPE_OTL_TO_PO_APPRV_PKG.GET_APPROVER2
Context Usages
Number Context Name Data Type

Parameters
Number Parameter Name Type Class Optional Continuing
1 P_TIMECARD_BB_ID Number Input Only No No
2 P_TIMECARD_BB_OVN Number Input Only No No
3 P_RESOURCE_ID Number Input Only No No

Page 37 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

Register Formula
New – Add
Register above formula using below steps:
1. Go to Navigation: System Administrator Application Flexfield Descriptive
Segments
2. Search for Title OTL Formulas
3. Unfreeze Flexfield definition
4. Under Context Field Values area add following Context

New – Add

Code Name Description

XXDPE_OTL_EAM_ASG_ Formula to restrict time hours


Formula to restrict time hours per assignment
HRS per assignment

N Window Display Enabl Requir


Name Column Value Set
o Prompt ed ed ed

ATTRIBUT
10 PERIOD Period HXC_TCARD_PERIOD Yes Yes Yes
E1

Time
ATTRIBUT
15 TIME_CATEGORY Categor HXC_TIME_CATEGORIES Yes Yes No
E4
y

Maximu ATTRIBUT HR_US_NUMBER_LENGT


20 PERIOD_MAXIMUM Yes Yes No
m Hours E2 H_10

Referen
ATTRIBUT HR_US_NUMBER_LENGT
30 REFERENCE_PERIOD ce Yes Yes No
E3 H_10
Period

Conside
CONSIDER_ZERO_HO ATTRIBUT
40 r Zero HR_US_YES_NO Yes Yes No
URS E5
Hours

Page 38 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

New – Add

Code Name Description

XXDPE_OTL_EAM_OT_H Formula to restrict Overtime


RS
Formula to restrict Overtime hours for EAM
hours for EAM

N Window Display Enabl Requir


Name Column Value Set
o Prompt ed ed ed

ATTRIBUT
10 PERIOD Period HXC_TCARD_PERIOD Yes Yes Yes
E1

Time
ATTRIBUT
15 TIME_CATEGORY Categor HXC_TIME_CATEGORIES Yes Yes No
E4
y

Maximu ATTRIBUT HR_US_NUMBER_LENGT


20 PERIOD_MAXIMUM Yes Yes Yes
m Hours E2 H_10

Referen
ATTRIBUT HR_US_NUMBER_LENGT
30 REFERENCE_PERIOD ce Yes Yes No
E3 H_10
Period

Conside
CONSIDER_ZERO_HO ATTRIBUT
40 r Zero HR_US_YES_NO Yes Yes No
URS E5
Hours

5. Freeze Flexfield and Save

Page 39 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

Define Formula
Define Formula using below navigation:
Navigation: Global HRMS Manager Total Compensation Basic Write Formulas
New – Add

Name XXDPE_OTL_EAM_ASG_HRS
Type OTL Time Entry Rules
Description Formula to restrict time hours per assignment
Effective Date From 01-JAN-2019
Formula
/* ******************************************************************
Formula Name : XXDPE_OTL_EAM_ASG_HRS
Author : Fardin Sheikh
Description : Implement standard rule for period maximum based on
requirements from WTD
Contexts : None
Explanation : The formula is passed a resource_id, data and
period maximum values to check if the resource has
exceeded working x number of hours in a given period
****************************************************************** */
/* Change History:

Date Author Comments


------------ -------------- ------------------------------------
29-JUN-2020 Fardin Sheikh Initial creation
*/

/*****************************************************************
Initialise Variables which can be null
******************************************************************/

default for db_pre_period_start is ' '


default for db_pre_period_end is ' '
default for db_post_period_start is ' '
default for db_post_period_end is ' '
default for db_ref_period_start is ' '
default for db_ref_period_end is ' '
default for ASG_HOURS is 0
default for period_maximum is 0
default for Regular_Hours_AED IS 0

/* ******************************************************************
READ IN INPUT VARIABLES

Page 40 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

****************************************************************** */

INPUTS ARE resource_id (number)


, submission_date (text)
, period (number)
, period_maximum (number)
, reference_period (number)
, db_pre_period_start (text)
, db_pre_period_end (text)
, db_post_period_start (text)
, db_post_period_end (text)
, db_ref_period_start (text)
, db_ref_period_end (text)
, duration_in_days (number)
, timecard_hrs (number)

/* ****************************************************************
Processing
**************************************************************** */
hours_worked = ASG_HOURS

IF (CWK_PERIOD_MAX (resource_id, submission_date,


hours_worked, period, reference_period,
db_pre_period_start, db_pre_period_end,
db_post_period_start, db_post_period_end,
db_ref_period_start, db_ref_period_end,
duration_in_days, timecard_hrs ) = 1 )
THEN
rule_status = 'S'
ELSE
( rule_status = 'E'
message1 = 'DPE_OTL_STD_WORKING_HRS')

RETURN rule_status, message1


Verify formula clicking verify button.

Page 41 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

New – Add

Name XXDPE_OTL_EAM_OT_HRS
Type OTL Time Entry Rules
Description Formula to restrict Overtime hours for EAM
Effective Date From 01-JAN-2019
Formula
/* ******************************************************************
Formula Name : XXDPE_OTL_EAM_OT_HRS
Author : Fardin Sheikh
Description : Implement standard rule for period maximum based on
requirements from WTD
Contexts : None
Explanation : The formula is passed a resource_id, data and
period maximum values to check if the resource has
exceeded working x number of hours in a given period
****************************************************************** */
/* Change History:

Date Author Comments


------------ -------------- ------------------------------------
29-JUN-2020 Fardin Sheikh Initial creation
*/

/*****************************************************************
Initialise Variables which can be null
******************************************************************/

default for db_pre_period_start is ' '


default for db_pre_period_end is ' '
default for db_post_period_start is ' '
default for db_post_period_end is ' '
default for db_ref_period_start is ' '
default for db_ref_period_end is ' '
default for ASG_HOURS is 0
default for period_maximum is 0
default for Regular_Hours_AED IS 0

/* ******************************************************************
READ IN INPUT VARIABLES
****************************************************************** */

INPUTS ARE resource_id (number)


, submission_date (text)

Page 42 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

, period (number)
, period_maximum (number)
, reference_period (number)
, db_pre_period_start (text)
, db_pre_period_end (text)
, db_post_period_start (text)
, db_post_period_end (text)
, db_ref_period_start (text)
, db_ref_period_end (text)
, duration_in_days (number)
, timecard_hrs (number)

/* ****************************************************************
Processing
**************************************************************** */

IF (CWK_PERIOD_MAX (resource_id, submission_date,


period_maximum, period, reference_period,
db_pre_period_start, db_pre_period_end,
db_post_period_start, db_post_period_end,
db_ref_period_start, db_ref_period_end,
duration_in_days, timecard_hrs ) = 1 )
THEN
rule_status = 'S'
ELSE
( rule_status = 'E'
message1 = 'DPE_OTL_STD_WORKING_HRS')

RETURN rule_status, message1


Verify formula clicking verify button.

Page 43 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

New – Add

Name DPE_OTL_EAM_TSP_NO_APPR
Type OTL Time Entry Rules
Description DPE OTL Get TSP Approver Count
Effective Date From 01-JAN-2019
Formula /* ******************************************************************
Formula Name : XXDPE_OTL_EAM_TSP_NO_APPR
Author       : SQL Infotech - Vignesh
Description  : Formula to validate TSP System approver
Contexts     : None
Explanation  : The formula is passed a resource_id,
****************************************************************** */
/* Change History:
 
Date            Author                       Comments
------------    --------------               ------------------------------------
08-AUG-2020     SQL Infotech - Vignesh       Initial creation
*/
 
/*****************************************************************
Initialise Variables which can be null
******************************************************************/
 
default for db_pre_period_start is ' '
default for db_pre_period_end is ' '
default for db_post_period_start is ' '
default for db_post_period_end is ' '
default for db_ref_period_start is ' '
default for db_ref_period_end is ' '
default for ASG_HOURS is 0
default for period_maximum is 0
default for Regular_Hours_AED  IS 0
default for hour_type is ' '
 
 
/* ******************************************************************
READ IN INPUT VARIABLES
****************************************************************** */
 
INPUTS ARE resource_id      (number)
,          submission_date  (text)
,          period           (number)
,          period_maximum   (number)
,          reference_period (number)
,          db_pre_period_start  (text)
,          db_pre_period_end    (text)
,          db_post_period_start (text)
,          db_post_period_end   (text)
,          db_ref_period_start  (text)
,          db_ref_period_end    (text)
,          duration_in_days     (number)

Page 44 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

,          timecard_hrs         (number)


,          hour_type (text)
/* ****************************************************************
Processing
**************************************************************** */
 
 

IF ( DPE_OTL_EAM_TSP_APPR_CNT (resource_id ) = 0 )
THEN
(
rule_status = 'E'
message1 = 'DPE_OTL_EAM_TSP_NO_APPR'
)
ELSE
( rule_status = 'S'
)

RETURN rule_status, message1

Verify formula clicking verify button.

Page 45 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

New – Add

Name HXC_OVERRIDE_APPR_OTL_EAM_LEVEL1
Type OTL Approvals
Description HXC EAM Level1 Approver
Effective Date
01-JAN-2019
From
Formula /*++
+*************************************************************************************************
***+++*
**  Company: Dubai Petroleum Establishment
**  Formula Name:  HXC_OVERRIDE_APPR_OTL_EAM_LEVEL1
**  Author: SQL Infotech Vignesh
**  Date: 06-Aug-2020
**  Description:
    -------------------------------------------------------------------------------------------------------
      Author                         Date    
                                                       Version                Change
      ------                         ----             -------                ------
    Vignesh                       06-Aug-2020          V1                Intial Version
**++
+*************************************************************************************************
+++*/
 
 
/*****************************************************************
Initialise Variables which can be null
******************************************************************/
 
default for formula_status is 'S'
default for formula_message is 'NO MESSAGE'
 
/* ******************************************************************
READ IN INPUT VARIABLES
****************************************************************** */
 
INPUTS ARE timecard_bb_id            (number)
,          timecard_bb_ovn           (number)
,          application_period_bb_id  (number)
,          application_period_bb_ovn (number)
,          time_recipient_id         (number)
,          resource_id               (number)
,          resource_type             (text)
 
 
/* ****************************************************************
Processing
**************************************************************** */
 
 
 
l_reviwer_id =

Page 46 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

XXDPE_EAM_TSP_REVIEWER(timecard_bb_id,timecard_bb_ovn,resource_id)
 
 
approval_mechanism_id =  l_reviwer_id
 
IF ISNULL(l_reviwer_id) = 'N' THEN
approval_mechanism    = 'PERSON'
ELSE 
 approval_mechanism    = 'AUTO_APPROVE'
 
 
/* ****************************************************************
RETURN VARIABLE
**************************************************************** */
 
RETURN approval_mechanism
,      approval_mechanism_id
,      formula_status
,      formula_message

Verify formula clicking verify button.

Page 47 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

New – Add

Name HXC_OVERRIDE_APPR_OTL_EAM_LEVEL2
Type OTL Approvals
Description HXC EAM Level2 Approver
Effective Date
01-JAN-2019
From
Formula
/*++
+*************************************************************************************************
***+++*
**  Company: Dubai Petroleum Establishment
**  Formula Name: HXC_OVERRIDE_APPR_OTL_EAM_LEVEL2
**  Author: SQL Infotech
**  Date: 06-Aug-2020
**  Description:
    -------------------------------------------------------------------------------------------------------
      Author                         Date    
                                                       Version                Change
      ------                         ----             -------                ------
    Vignesh                       06-Aug-2020          V1                Intial Version
**++
+*************************************************************************************************
+++*/
 
 
/*****************************************************************
Initialise Variables which can be null
******************************************************************/
 
default for formula_status is 'S'
default for formula_message is 'NO MESSAGE'
 
/* ******************************************************************
READ IN INPUT VARIABLES
****************************************************************** */
 
INPUTS ARE timecard_bb_id            (number)
,          timecard_bb_ovn           (number)
,          application_period_bb_id  (number)
,          application_period_bb_ovn (number)
,          time_recipient_id         (number)
,          resource_id               (number)
,          resource_type             (text)
 
 
/* ****************************************************************
Processing
**************************************************************** */
 
 
 
Page 48 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

l_reviwer_id =
XXDPE_EAM_TSP_APPROVER(timecard_bb_id,timecard_bb_ovn,resource_id)
 
 
approval_mechanism_id =  l_reviwer_id
 
IF ISNULL(l_reviwer_id) ='N' THEN
approval_mechanism    = 'PERSON'
ELSE
approval_mechanism    = 'AUTO_APPROVE'
 
 
 
/* ****************************************************************
RETURN VARIABLE
**************************************************************** */
 
RETURN approval_mechanism
,      approval_mechanism_id
,      formula_status
,      formula_message

Verify formula clicking verify button.

Page 49 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

Define Mapping Components


Define Mapping Components using below navigation:
Navigation: Global OTL Application Developer> Deposit/Retrieval Process>Define Mapping
Components:
New – Add
Name Field Name Type Category Segment
EAM_CONTE EAM_CONTE
EAMWORKORDER EAMWORKORDER XT XT EAMWORKORDER
EAM_CONTE EAM_CONTE
EAMCHARGEDEPT EAMCHARGEDEPT XT XT EAMCHARGEDEPT
EAM_CONTE EAM_CONTE
EAMASSETNUMBER EAMASSETNUMBER XT XT EAMASSETNUMBER
EAM_CONTE EAM_CONTE
EAMOPERATION EAMOPERATION XT XT EAMOPERATION
EAM_CONTE EAM_CONTE
EAMRESOURCE EAMRESOURCE XT XT EAMRESOURCE
EAM_CONTE EAM_CONTE
EAMASSETGROUP EAMASSETGROUP XT XT EAMASSETGROUP
EAMDEPARTMENTI EAMDEPARTMENTI EAM_CONTE EAM_CONTE EAMDEPARTMENTI
D D XT XT D
EAMORGANIZATION EAMORGANIZATION EAM_CONTE EAM_CONTE EAMORGANIZATION
ID ID XT XT ID
EAM_CONTE EAM_CONTE
EAMHOURTYPE EAMHOURTYPE XT XT EAMHOURTYPEDPE

Page 50 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

Define Mapping
Define Mapping Components using below navigation:
Navigation: Global OTL Application Developer> Deposit/Retrieval Process>Define Mapping:
Query for Name: Maintenance Retrieval Mapping and add the values as below (some of the values will be
available)
New – Add

Components: Name Field Name Type Category Segment


EAMASSETGROUP EAMASSETGROUP EAM_CONTEXT EAM_CONTEXT EAMASSETGROUP
EAMASSETNUMBER EAMASSETNUMBER EAM_CONTEXT EAM_CONTEXT EAMASSETNUMBER
EAMCHARGEDEPT EAMCHARGEDEPT EAM_CONTEXT EAM_CONTEXT EAMCHARGEDEPT
EAMDEPARTMENTID EAMDEPARTMENTID EAM_CONTEXT EAM_CONTEXT EAMDEPARTMENTID
EAMHOURTYPE EAMHOURTYPE EAM_CONTEXT EAM_CONTEXT EAMHOURTYPEDPE
EAMOPERATION EAMOPERATION EAM_CONTEXT EAM_CONTEXT EAMOPERATION
EAMORGANIZATIONID EAMORGANIZATIONID EAM_CONTEXT EAM_CONTEXT EAMORGANIZATIONID
EAMRESOURCE EAMRESOURCE EAM_CONTEXT EAM_CONTEXT EAMRESOURCE
EAMWORKORDER EAMWORKORDER EAM_CONTEXT EAM_CONTEXT EAMWORKORDER

Page 51 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

Define Alternate Name Mapping


Create Alternate Name Mapping using below navigation:
Navigation: Global OTL Application Developer Alternate Names Alternate Name Mapping
New – Add
(Enter the Value Set/Context and Type Name Values as shown below and then click in the
Attribute/Column Name record under the Mapping Association. Then enter the values besides it.)
Attribute/Column Mapping Component
Value Set/Context Type Name
Name Name
Value Set - Table OTL_EAM_CHARGE_DEPT_D
PE BD.DEPARTMENT_ID EAMCHARGEDEPT
Value Set - Table WOR.OPERATION_SEQ_
OTL_EAM_OPERATION_DPE NUM EAMOPERATION
Value Set - Table OTL_EAM_ORGANIZATION_I
D_DPE ORGANIZATION_ID EAMORGANIZATIONID
Value Set - Table OTL_EAM_OWNING_DEPT_D
PE BD.DEPARTMENT_ID EAMDEPARTMENTID
Value Set - Table OTL_EAM_RESOURCE_DPE BR.RESOURCE_ID EAMRESOURCE
Value Set - Table OTL_EAM_SERIAL_NUMBER_
DPE MSN.SERIAL_NUMBER EAMASSETNUMBER
Value Set - Table OTL_EAM_WORK_ORDER_DP
E WE.WIP_ENTITY_ID EAMWORKORDER
Value Set –
Independent OTL_EAM_HOUR_TYPE_DPE Value EAMHOURTYPE

Page 52 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

Define Alternate Name Definition


Create Alternate Name Definition using below navigation:
Navigation: Global OTL Application Developer Alternate Names Alternate Name Definition
New – Add
Alternate Name Alternate Name
Description Type Name Prompt
Definition Type
EAMCHARGEDEPTD Charge OTL_EAM_CHARGE_DEPT_ Charge
Value Set Table
PE Department DPE Department
OTL_EAM_OPERATION_DP
EAMOPERATIONDPE Operation Value Set Table Operation
E
EAMORGANIZATION OTL_EAM_ORGANIZATION
Organization Value Set Table Organization
IDDPE _ID_DPE
EAMDEPARTMENTI Owning OTL_EAM_OWNING_DEPT Owning
Value Set Table
DDPE Department _DPE Department
EAMRESOURCE Resource Value Set Table OTL_EAM_RESOURCE_DPE Resource
EAMASSETNUMBER Asset Serial OTL_EAM_SERIAL_NUMBE Asset Serial
Value Set Table
DPE Number R_DPE Number
EAMWORKORDERD OTL_EAM_WORK_ORDER_
Work Order Value Set Table Work Order
PE DPE
Value Set OTL_EAM_HOUR_TYPE_D
EAMHOURTYPEDPE Hour Type Hour Type
Independent PE

Page 53 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

Define Retrieval Rule Group


Create Retrieval Rule Group using below navigation:
Navigation: Global OTL Application Developer Deposit / Retrieval Processes Define Retrieval Rule
Groups
Query – Ensure the below values

Name EAM Retrieval Rule Group


Application Description
Enterprise Asset Management Maintenance Retrieval Processes

Define Category for Time Entry Rules


Define Category for Time Entry Rules using below navigation:
Navigation: Global OTL Application Developer Time Categories Create Time Category:
New – Add
Name DPE EAM Overtime Hours
Operator And
Description Overtime Working Hours for EAM TK
Mapping
EAMHOURTYPE
Component Name
Mapping 509082 (Get this value from the OTL_EAM_HOUR_TYPE_DPE Valueset prepared
Component Value earlier , for value Overtime)
New – Add
Name DPE EAM Regular Hours
Operator And
Description Regular Working Hours for EAM TK
Mapping Component
EAMHOURTYPE
Name
Mapping Component 509083 (Get this value from the OTL_EAM_HOUR_TYPE_DPE Valueset prepared
Value earlier , for value Regular)

Page 54 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

Define Time Entry Rule


Create Time Entry Rule using below navigation:
Navigation: Global OTL Application Developer Time Entry Rules Define Time Entry Rules
(Enter the Effective dates as per the cut over plan)
New – Add

Name EAM_ASG_HRS_SUBMIT

Description Formula to restrict time hours per assignment-Submit

Usage Submission / Resubmission

Formula Formula to restrict time hours per assignment

Period (Formula Inputs) DPE - One Day


Time Category DPE EAM Regular Hours
Maximum Hours
Reference Period 1
Consider Zero Hours No
New – Add

Name EAM_ASG_HRS_SAVE

Description Formula to restrict time hours per assignment-Save

Usage Save

Formula Formula to restrict time hours per assignment

Period DPE - One Day


Time Category DPE EAM Regular Hours
Maximum Hours
Reference Period 1
Consider Zero Hours No

Page 55 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

New – Add

Name EAM_OT_HRS_SUBMIT

Description Formula to restrict time hours per assignment-Submit

Usage Submission / Resubmission

Formula Formula to restrict Overtime hours for EAM

Period (Formula Inputs) DPE - One Day


Time Category DPE EAM Overtime Hours
Maximum Hours 6
Reference Period 1
Consider Zero Hours No

New – Add

Name EAM_OT_HRS_SAVE

Description Formula to restrict time hours per assignment-Save

Usage Save

Formula Formula to restrict Overtime hours for EAM

Period DPE - One Day


Time Category DPE EAM Overtime Hours
Maximum Hours 6
Reference Period 1
Consider Zero Hours No

Page 56 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

New – Add
Name EAM_OTL_TSP_NO_APPR

Description Formula to validate the existence of approver during save

Usage Save
Formula DPE OTL Get TSP Approver Count

New – Add
Name EAM_OTL_TSP_NO_APPR_SUBMIT

Description Formula to validate the existence of approver during submit

Usage Submission / Resubmission


Formula DPE OTL Get TSP Approver Count

Page 57 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

Define Time Entry Rule Group


Create Time Entry Rule Group using below navigation:
Navigation: Global OTL Application Developer> Time Entry Rules> Define Time Entry Rule Groups
New – Add
Name Rule Name Outcome

EAM_ASG_HRS_SAVE Error

EAM_ASG_HRS_SUBMIT Error

EAM_OT_HRS_SAVE Error

OTL Manpower Maintenance Rule Group

EAM_OT_HRS_SUBMIT Error

EAM_OTL_TSP_NO_APPR Error

EAM_OTL_TSP_NO_APPR_SUBMIT Error

Page 58 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

Define Default Timekeeper Group


Create a Default Timekeeper Group ‘GTS Maintenance’ for default assignment to the new contractors.
Navigation: OTL Timekeeper > Timekeeper Group
 Enter Name: GTS Maintenance
 Save and close
Note: Profile OTL: Allow Change Group Timekeeper needs to be updated with either a responsibility or
user value to yes for allowing the user to have option of changing the Timekeeper group. (New requirement
as per HR discussion to avoid selecting a timekeeper group)

OTL Time Entry Approval


Approval Styles
New – Add
Define Approval Style and Assign Time category to it
Navigation: Global OTL Application Developer Approval  Define Approval Styles
Name Application Type Seq
DPE EAM Approval Style Enterprise Asset Management Entry Level Approval 10

Click Entry Level Approval components for Sequence 10

Default Approval Style Time Category Type Identifier Seq


Auto Approve DPE EAM Regular Hours Formula HXC EAM Level1 Approver 10
Auto Approve DPE EAM Regular Hours Formula HXC EAM Level2 Approver 20
Auto Approve DPE EAM Overtime Hours Formula HXC EAM Level1 Approver 10
Auto Approve DPE EAM Overtime Hours Formula HXC EAM Level2 Approver 20

Define Approval Periods


Create Approval Periods using below navigation:
Navigation: Global OTL Application Developer Approval Define Approval Periods

Name DPE eAM Daily Approval Period


Application Recurring Period
Enterprise Asset Management DPE - One Day

Page 59 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

OTL Preferences
Define Preferences for ‘Maintenance Contractors’
Define Preferences for Maintenance Contractors using below navigation:
New – Add
Navigation: Global OTL Application Developer > Preferences
Create Node:

1. While on the top node ‘Preference Tree’ is selected, enter the Name in Tree as ‘EAM Timekeeper’
2. Save
3. Close the Preferences Tree and Reopen to view the new branch
4. Look for Node ‘EAM Timekeeper’. Right-Click on it and click on New
5. Enter the below values one by one and Save after each record.
(For creating a new record, click on the node created and then enter the subsequent values)

Notifica
Name Preferen Preference Preference Preference Preference Value
tion
in Tree ce Value 1 Value 2 Value 3 4-10
Layout
Self
Service
Timecard
Alternat Alternate
e Name        
Names Set
Defined
for a
User
Time
Enterprise
Applica Store
Asset      
tion Set Applicati Management
on Set
Time
Approv
Store DPE eAM Daily
al      
Approval Approval Period
Period
Periods
Time
Approv Store DPE EAM DPE EAM
   
al Style Approval Approval Style Approval Style
Style
Timecar
Timecard
d
Delete No  
Delete
Allowed
Allowed
SS Self EAM Timecard EAM Review EAM DPE
 
Layout Service Layout Layout Confirmation EAM
Page 60 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

Notifica
Name Preferen Preference Preference Preference Preference Value
tion
in Tree ce Value 1 Value 2 Value 3 4-10
Layout
Timecard
, Review
and
Attribut Review
Confirma Layout
es-EAM Layout
tion
Layout
Pages

EAMDEPARTMENTI
DDPE

EAMRESOURCE
Timekee
Layout per EAMASSETNUMBE
EAMWORKORD EAMOPERATIO EAMHOURTY
Attribut Layout RDPE
ERDPE NDPE PEDPE
es Attribute
s EAMORGANIZATIO
NIDDPE

EAMCHARGEDEPT
DPE

Timekee (Default Recurring


per Misc Period on
Misc No Yes Yes
Setup Timekeeper Find)
Items DPE - One Day
Time
Retriev Store
EAM Retrieval
al Rule Retrieval      
Rule Group
Group Rule
Groups
Self
Service
Preferen
Rules
ce to
Evaluati No      
Allow
on
Rules
Evaluatio
n
Time Self New, Working Active 365 365
Edit Service or Rejected Assignment
Timecard
Status

Page 61 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

Notifica
Name Preferen Preference Preference Preference Preference Value
tion
in Tree ce Value 1 Value 2 Value 3 4-10
Layout
that
Allows
User
Edits
Self
Service
Timecar
Timecard
d DPE - One Day      
Period
Period
for
Worker
Time
Time
Store OTL Manpower
Store
Time Maintenance      
Entry
Entry Rule Group
Rules
Rules

Page 62 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

Define new Preferences as ‘EAM Super Timekeeper:


Name in Tree Preference Preference Values
Retro
Self Service Preference Value 1
Edit
Timecard Status Preference Value 2 Active Assignment
Timesheet
that Allows User
Preference Value 3 365
Edits
Preference Value 4 365
Timekeeper Layout item 1 EAMWORKORDERDPE

Timekeeper Layout item 2 EAMOPERATIONDPE

EAMHOURTYPEDPE
Timekeeper Layout item 3

Timekeeper Layout item 4 EAMDEPARTMENTIDDPE


Layout Timekeeper Layout
Attributes Attributes EAMRESOURCE
Timekeeper Layout item 5

Timekeeper Layout item 6 EAMASSETNUMBERDPE

Timekeeper Layout item 7 EAMORGANIZATIONIDDPE

Timekeeper Layout item 8 EAMCHARGEDEPTDPE


Timekeeper Misc.
Misc. Preference Value 1 No
Setup Items
    Preference Value 2 Yes
    Preference Value 3 Yes
    Preference Value 4  
    Preference Value 5  
DPE - One
    Preference Value 6
Day

Page 63 of 64
Oracle E-Enhancement Project

DPE Configuration Document – Global Time Sheet - Maintenance

Define Eligibility Criteria using below navigation


Define Eligibility Criteria using below navigation:
Navigation: Global OTL Application Developer Preferences Eligibility Criteria (Tab)
New – Add

Name of Rule Name of Branch Link by Linked to Precedence From To


DPE EAM
Contingent DPE EAM 01-
Session
Timekeeper- EAM Timekeeper Contingent 9997 Oct-
Responsibility 2020
Session Timekeeper
Responsibility
01-
Contractor
One Day EAM Timekeeper Person Type 9996 Oct-
Maintenance 2020
DPE EAM
Contingent 01-
Assignment
Timekeeper- EAM Timekeeper Maintenance 9995 Oct-
Category 2020
Assignment
Category
DPE EAM
01-
EAM Super Session Contingent
DPE EAM 99999 Oct-
Timekeeper Responsibility Super
2020
Timekeeper

Page 64 of 64

You might also like