Manage Schedule Creation
Organizations can use a third-party scheduling application to manage their worker schedule. Oracle Fusion Time and Labor application imports these schedules by performing a POST operation on the scheduleRequests resource.
The following figure shows data transfers between Time and Labor and the third-party scheduling application.
- Configures shift properties, scheduler profiles, and layout shifts.
- Exports worker data to the third-party scheduling application.
- Imports schedule data using REST web service.
The Time and Labor managers and schedulers can verify imported schedules using the planned and published pages of the Time Management work area. Workers can verify their imported and published schedules using the calendar and team schedules pages of the Time work area.
Create a Weekly Schedule
In this scenario, an employee Smith Wilson works Monday through Friday on the day shift (DAY) from 9:00 AM to 5:00 PM.
- importMode is "FULL" for the scheduleEvents resource.
- shiftAction is "CREATE" for the scheduleShiftEvents resource.
The following table shows the Time and Labor configuration that applies to this scenario
Configuration | Purpose |
Manage Shift Properties | Define a shift code for all shifts to be imported. |
Manage Layout Sets | Define a shift layout to display imported time attributes on the following pages:
|
Manage Scheduler Profiles | Define at least one scheduler profile for each worker for whom shifts must be imported. |
Manage Common Lookups | Review the lookup type ORA_HWM_SHIFT_ENTRY_OWNER values. For shifts imported from a third-party scheduling application, the RequestSource field in the ScheduleRequest object is controlled by the Owner:
|
The following table describes the application processing actions that occur for the imported schedule.
Schedule Request | Application Processing |
Third-party scheduling sends the five shifts corresponding to Smith Wilson's schedule for the current week. |
|
Example URL
The following is the format of the resource URL.
POST
/hcmRestApi/resources/11.13.18.05/scheduleRequests/
Example Request
The following is an example of the request body in JSON format.
{
"scheduleRequestNumber":"Import001",
"requestTime":"2017-01-09T13:25:20.010+01:00",
"requestSource":"KRONOS",
"scheduleEvents":
[
{
"resourceReferenceType":"PERSON_NUMBER",
"resourceReference":"955160008182054",
"importMode":"FULL",
"periodStartDate":"2017-01-09",
"periodEndDate":"2017-01-15",
"allowEdits":"N",
"publish":"Y",
"workerNotification":"Y",
"scheduleShiftEvents":
[
{
"shiftNumber":"TM1001",
"shiftAction":"CREATE",
"referenceDay":"2017-01-09",
"shiftStartTime":"2017-01-09T09:00:00+01:00",
"shiftEndTime":"2017-01-09T17:00:00+01:00",
"shiftDuration":"",
"shiftTimeNotWorked":"60",
"shiftCode":"DAY",
"shiftCategory":"WORK",
"shiftType":"TIME",
"allowEdits":"N",
"scheduleShiftAttributes": [
{
"attributeName":"PayrollTimeType",
"attributeValue":"WFM_PAY_REGULAR_US"
},
{
"attributeName":"GD_Department WFMTL_CHAR",
"attributeValue":"WFM_Department"
}
]
},
{
"shiftNumber":"TM1002",
"shiftAction":"CREATE",
"referenceDay":"2017-01-10",
"shiftStartTime":"2017-01-10T09:00:00+01:00",
"shiftEndTime":"2017-01-10T17:00:00+01:00",
"shiftDuration":"",
"shiftTimeNotWorked":"60",
"shiftCode":"DAY",
"shiftCategory":"WORK",
"shiftType":"TIME",
"allowEdits":"N",
"scheduleShiftAttributes": [
{
"attributeName":"PayrollTimeType",
"attributeValue":"WFM_PAY_REGULAR_US"
},
{
"attributeName":"GD_Department WFMTL_CHAR",
"attributeValue":"WFM_Department"
}
]
},
{
"shiftNumber":"TM1003",
"shiftAction":"CREATE",
"referenceDay":"2017-01-11",
"shiftStartTime":"2017-01-11T09:00:00+01:00",
"shiftEndTime":"2017-01-11T17:00:00+01:00",
"shiftDuration":"",
"shiftTimeNotWorked":"60",
"shiftCode":"DAY",
"shiftCategory":"WORK",
"shiftType":"TIME",
"allowEdits":"N",
"scheduleShiftAttributes": [
{
"attributeName":"PayrollTimeType",
"attributeValue":"WFM_PAY_REGULAR_US"
},
{
"attributeName":"GD_Department WFMTL_CHAR",
"attributeValue":"WFM_Department"
}
]
},
{
"shiftNumber":"TM1004",
"shiftAction":"CREATE",
"referenceDay":"2017-01-12",
"shiftStartTime":"2017-01-12T09:00:00+01:00",
"shiftEndTime":"2017-01-12T17:00:00+01:00",
"shiftDuration":"",
"shiftTimeNotWorked":"60",
"shiftCode":"DAY",
"shiftCategory":"WORK",
"shiftType":"TIME",
"allowEdits":"N",
"scheduleShiftAttributes": [
{
"attributeName":"PayrollTimeType",
"attributeValue":"WFM_PAY_REGULAR_US"
},
{
"attributeName":"GD_Department WFMTL_CHAR",
"attributeValue":"WFM_Department"
}
]
},
{
"shiftNumber":"TM1005",
"shiftAction":"CREATE",
"referenceDay":"2017-01-13",
"shiftStartTime":"2017-01-13T09:00:00+01:00",
"shiftEndTime":"2017-01-13T17:00:00+01:00",
"shiftDuration":"",
"shiftTimeNotWorked":"60",
"shiftCode":"DAY",
"shiftCategory":"WORK",
"shiftType":"TIME",
"allowEdits":"N",
"scheduleShiftAttributes": [
{
"attributeName":"PayrollTimeType",
"attributeValue":"WFM_PAY_REGULAR_US"
},
{
"attributeName":"GD_Department WFMTL_CHAR",
"attributeValue":"WFM_Department"
}
]
}
]
}
]
}