Manage Schedule Deletion

Clear a Schedule

An employee Anthony Clifford works Monday through Friday on the Normal Work Hours shift from 8.30 AM to 5:00 PM. Anthony is in training this week and is unavailable to work in a store. His schedule must be cleared of his Normal Work Hours shifts for this week. Third-party scheduling sends the updates to Anthony's schedule for the week he is in training. Oracle Fusion Time and Labor imports the schedule for Anthony Clifford using the POST operation on the scheduleRequests resource and the 'FULL' importMode on the scheduleEvents 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.
  • Planned and published schedules for managers and schedulers.
  • Time calendar for workers.
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 obejct is controlled by the Owner:

  • If you use REST just to load data, use ORA_HWM_WFM as RequestSource.
  • If you use REST as an interface with a third-party scheduling application, register your application in this lookup and use the lookup code value in the RequestSource.

The following table describes the application processing actions that occur for the imported schedule.

ScheduleRequest Application Processing
Third-party scheduling sends the revised schedule showing Anthony unavailable to work in the store.
  1. Imports the schedule request using the REST Web service.
  2. Runs the Process Imported Shifts process to add the imported shifts to the planned and published schedules.

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":"Anthony-Clifford-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":"N"
			}
		]
}