Contents

Step 1 – Oracle HCM Cloud Application Setup .............................................................................................................................................................. 4

Register Time Clock Supplier...................................................................................................................................................................................... 4

Register Time Clock Events supported by the new Supplier ..................................................................................................................................... 5

Associate the supplier time clock event with Oracle HCM Cloud T&L events ........................................................................................................... 6

Create the Time Device Event Mapping Sets ............................................................................................................................................................. 7

Specify the setup data that will be exported for the time devices ............................................................................................................................ 8

Set up Manage Time Device Processing Profile to extract set up info for time devices ........................................................................................... 9

Step 2 Extract the time device configuration information .......................................................................................................................................... 10

Generating Export Data ........................................................................................................................................................................................... 10

Retrieve Export Data to build JSON Payload............................................................................................................................................................ 12

Step 3 – Push Time Event into Oracle HCM Cloud ....................................................................................................................................................... 19

Appendix ...................................................................................................................................................................................................................... 24

Setup Security for Rest service access ..................................................................................................................................................................... 24

Access APM .............................................................................................................................................................................................................. 25

Creating a New Application Role ............................................................................................................................................................................. 27

Adding Entitlement .................................................................................................................................................................................................. 29

Associating the new application role with HCM Integration Specialist Role ............................................................................................................... 35

Synchronizing OIM, APM & HCM Cloud....................................................................................................................................................................... 40

Step 1 – Oracle HCM Cloud Application Setup

Register Time Clock Supplier

Go to Setup & Maintenance

Search for task Manage Workforce Management Lookups

Create a new time clock supplier into ORA_HWD_TCD_SUPPLIERS

Register Time Clock Events supported by the new Supplier

Go to Setup & Maintenance

Search for task Manage Workforce Management Lookups

Create new time clock events supported by the new supplier into ORA_HWD_TCD_SUPPLIER_EVENTS
Associate the supplier time clock event with Oracle HCM Cloud T&L events

Go to Setup & Maintenance

Search for task Manage Time Device Event Mapping

Create the Time Device Event Mapping Sets

Go to Setup & Maintenance

Search for task Manage Time Device Event Mapping Sets

Specify the setup data that will be exported for the time devices

Go to Setup & Maintenance

Search for task Manage Time Device Export Data

Set up Manage Time Device Processing Profile to extract set up info for time devices

Go to Setup & Maintenance

Search for task Manage Time Device Processing Profile

Step 2 Extract the time device configuration information

Generating Export Data

Go to Setup & Maintenance

Search for task Export Time Device Data Configuration

Pick the Time Device Export Mode, we recommend that first time you pick Purge and full export

Pick the Device Processing Profile crated on step 6

Click Submit
Retrieve Export Data to build JSON Payload

Configure a Web Service client with any tool that support SOAP

The WSDL for the service is

https://adc-fap1925-hcm.oracledemos.com/hcmWfmTcdExportPublicService/TcdSetupDataService?WSDL

Use the web service client (in this case we are using as sample the SOAPUI tool) to invoke the beginExport operation with the following
parameters:

Export Configuration Name created on step 5

Source Id created on step 6

Sample Payload

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:typ="http://xmlns.oracle.com/apps/hcm/wfm/tcd/export/exportService/types/"

xmlns:exp="http://xmlns.oracle.com/apps/hcm/wfm/tcd/export/exportService/">

<soapenv:Header/>

<soapenv:Body>

<typ:beginExport>
 <typ:input>

<exp:Name>TcdSourceId</exp:Name>

<exp:Value>123</exp:Value>

<exp:DataType>string</exp:DataType>

</typ:input>

<typ:input>

<exp:Name>ExportConfigurationName</exp:Name>

<exp:Value>DHU_Time_Clock_Test_Export_Data</exp:Value>

<exp:DataType>string</exp:DataType>

</typ:input>

<typ:input>

<exp:Name>ExportType</exp:Name>

<exp:Value>FULL</exp:Value>

<exp:DataType>string</exp:DataType>

</typ:input>

</typ:beginExport>

</soapenv:Body>

</soapenv:Envelope>
Use the web service client (in this case we are using as sample the SOAPUI tool) to invoke the exportTimeCollectionDeviceSetupData
operation with the following parameters:

Export ID based on the response from beginExport call

Export Batch Count within 1 and the number found in the beginExport call, in our sample above will be a number between 1 and 21.

We will be using the Payroll Time Types values from the response to create the JSON payload, based on the sample above one of the values will
be Payroll Time Type = “Regular TL”

Sample Payload

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:typ="http://xmlns.oracle.com/apps/hcm/wfm/tcd/export/exportService/types/"
 xmlns:exp="http://xmlns.oracle.com/apps/hcm/wfm/tcd/export/exportService/">

<soapenv:Header/>

<soapenv:Body>

<typ:exportTimeCollectionDeviceSetupData>

<typ:input>

<exp:Name>ExportId</exp:Name>

<exp:Value>300000129752431</exp:Value>

<exp:DataType>long</exp:DataType>

</typ:input>

<typ:input>

<exp:Name>ExportBatchId</exp:Name>

<exp:Value>2</exp:Value>

<exp:DataType>long</exp:DataType>

</typ:input>

</typ:exportTimeCollectionDeviceSetupData>

</soapenv:Body>

</soapenv:Envelope>
Use the web service client (in this case we are using as sample the SOAPUI tool) to invoke the endExport operation with the following
parameters:

Export ID based on the response from beginExport call

Sample Payload

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:typ="http://xmlns.oracle.com/apps/hcm/wfm/tcd/export/exportService/types/"

xmlns:exp="http://xmlns.oracle.com/apps/hcm/wfm/tcd/export/exportService/">

<soapenv:Header/>

<soapenv:Body>

<typ:endExport>
 <typ:input>

<exp:Name>ExportId</exp:Name>

<exp:Value>300000129752431</exp:Value>

<exp:DataType>long</exp:DataType>

</typ:input>

<typ:input>

<exp:Name>Status</exp:Name>

<exp:Value>SUCCESS</exp:Value>

<exp:DataType>string</exp:DataType>

</typ:input>

</typ:endExport>

</soapenv:Body>

</soapenv:Envelope>
Step 3 – Push Time Event into Oracle HCM Cloud

Configure a Web Service client with any tool that support REST

The URI for the service is

https://adc-fap1925-hcm.oracledemos.com/hcmWorkforceMgmtApi/resources/latest/timeEventRequests

Use the web service client (in this case we are using as sample the SOAPUI tool) to invoke the rest service with the following content

 Request Number – Unique Number provided by the customer

 Source ID – supplier code created on step 1 from Oracle HCM Cloud Application Setup

 Request Time Stamp – Date time with format ISO 8601

 Device ID –

 Supplier Device Event - supplier time event code created on step 2 from Oracle HCM Cloud Application Setup

 Event Date Time – Event Time with format

o Start / Stop Time example: 2017-01-11T08:00:00.000-08:00

o Time Duration example: 2017-01-11T08:00:00.000-08:00/PT8H00M

 Report ID – Person Number or Badge Number

 Reporter ID Type – Person or Badge

 Time Event Attributes – Name PayrollTimeType values coming from the XML result of the SOAP service invoked on step 2 from Retrieve
Export Data to build JSON Payload
Sample Pay Load for Time Entry

"requestNumber":"0000001",

"sourceId":"DHU_TEST_CLOCK",

"requestTimestamp":"2017-03-14T15:00:00.000-07:00",

"timeEvents":[

"deviceId":"MAP0",

"eventDateTime":"2017-03-14T15:00:00.000-07:00",

"supplierDeviceEvent":"DHU_TEST_CLOCK_IN",

"reporterId":"541",

"reporterIdType":"PERSON",

"timeEventAttributes":[

"name":"PayrollTimeType",

"value": "Regular TL"

},

{
 "deviceId":"MAP0",

"eventDateTime":"2017-03-14T15:00:00.000-07:00",

"supplierDeviceEvent":"DHU_TEST_CLOCK_OUT",

"reporterId":"541",

"reporterIdType":"PERSON",

"timeEventAttributes":[

"name":"PayrollTimeType",

"value": "Regular TL"

},

"deviceId":"MAP1",

"eventDateTime":"2017-03-14T15:00:00.000-07:00/PT8H00M",

"supplierDeviceEvent":"DHU_TEST_CLOCK_IN",

"reporterId":"541",

"reporterIdType":"PERSON",

"timeEventAttributes":[

{
 "name":"PayrollTimeType",

"value": "Regular TL"

}
Appendix

Setup Security for Rest service access

Log in into the system.

Access APM

Click on Navigator

Click on Setup and Maintenance

Search for task Manage Duties
Creating a New Application Role

Select Application Name HCM

Click on New Application Role

Give a Display Name for example TCD_Time_Entry_Rest_Service

Give a Role Name for example TCD_Time_Entry_Rest_Service

Select Role Category HCM_DUTY

Click Save
Adding Entitlement

Click on Find Policies / Default Policy Domain

In the Functional Policies click on +

Give a Name for the policy such as TCD_Time_Entry_Rest_Service_Policy

Click on + in the Target

Search for Use REST Service – Time Events

Select the row and click on Add Selected

Click on Add Targets
Click on Apply
Associating the new application role with HCM Integration Specialist Role

Select HCM on Application Name

Click on Search External roles

Search for Human Capital Management Integration Specialist

Select the Human Capital Management Integration Specialist role from the list

Click Open Role

Select the Application Role Mapping Tab

Click on Map button

Search for the Duty Role created previously

Click on Map Roles

Check if the new duty role is associated with the Human Resource Specialist Integration role.
Synchronizing OIM, APM & HCM Cloud
Click on Navigator

Click on Scheduled Processes

Search for Retrieve Latest LDAP Changes

Click Ok
Click on Submit

Click on Close
Check the status of the process once is completed and succeeded we are ready