Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Scheduling components in Workforce Optimization for ITSM

Workforce Optimization for ITSM has roles to administer agent shifts and schedules and properties to configure default behavior.

Roles

Role title \[name\]DescriptionContains roles
Shift Planning User \[sn\_shift\_planning.user\]Grants read access for scheduling including the ability to view schedules and shifts. 
Shift Planning Agent \[sn\_shift\_planning.agent\]Grants agents access to their calendar. Agents can request shift swap or time off.sn\_shift\_planning.user
Shift Planning Admin \[sn\_shift\_planning.admin\]Grants administrative access to create, read, update, and delete \(CRUD\) schedules and work shifts.- sn\_shift\_planning.approver - sn\_shift\_planning.user - sn\_shift\_planning.agent

Properties

PropertyDescription
sn\_itsm\_ mobile\_agent.events\_query\_days\_pastThe maximum number of days past events for your shifts can be displayed on your mobile application. You can enter values that range from -1 to -31. - Type: Integer - Default value: -31
sn\_itsm\_ mobile\_agent.events\_query\_days\_futureThe maximum number of days future events for your shifts can be displayed on your mobile application. You can enter values that range from 1 to 90.- Type: Integer - Default value: 90
sn\_uib\_agent\_sp.allow\_agent\_edit\_breakEnables agents to edit the start and end time of their break time in a shift span.- Type: true\|false - Default value: false
sn\_uib\_agent\_sp.allow\_agent\_add\_remove\_breakEnables agents to add or remove their break time in a shift span.- Type: true\|false - Default value: false
sn\_shift\_planning.number\_of\_days\_to\_cacheNumber of days to cache agent schedules.- Type: Integer - Default value: 5
sn\_shift\_planning.max\_shifts\_to\_autoassignNumber of preferred shifts from a schedule plan that will be auto-assigned. - Type: Integer - Default value: 1
sn\_shift\_planning.max\_shifts\_allowed\_for\_signupThe maximum number of shifts that agents can sign up for within a schedule plan. - Type: Integer - Default value:1
sn\_shift\_planning.enable\_agent\_signupEnable agents to sign up for their own shifts. - Type: true\|false - Default value:true
sn\_shift\_planning.enable\_schedule\_signup\_linkEnables or disables the link in the Upcoming section in the Service Operations Workspace landing page where agents can view shifts that they've signed up for that are due on the current day and the day after the current day. - Type:true\|false - Default value: true
sn\_shift\_planning.days\_to\_signup\_due\_dateThe number of days before the shift sign-up due date when agents and managers are notified. - Type: Integer - Default value: 2
sn\_shift\_planning.display\_shift\_name

Set this property to true to display the shift name. If the value is set to false, the event type will be displayed.- Type: Boolean - Default value: True

Note: It will take 24 hours for any changes you make to the property value to take effect. To view the changes immediately, run the Shift Planning - Delete All Agent Schedules Cache scheduled job.

assignShiftAgentsTypeaheadDisableAutoClose

Turns off the closing of the Assign agents to this shift typeahead list every time an agent is selected.

In the application navigator, enter sys_ux_page_property.LISTand press Enter. - Type:true\|false - Default value: false

sn\_wfo\_outlook.enable\_outlook\_sync

Set this property to true to turn on the synchronization between the agent's calendar and the Microsoft Outlook calendar.

  • Type: Boolean
  • Default value: False

Scheduled jobs

NameDescription
Shift Planning - Delete All Agent Schedules CacheDeletes cache from the sn\_shift\_planning\_agent\_availability table.- Runs automatically everyday at 2:30 am - Run this job on-demand when you import data.

User preferences

Navigate to All > User Administration > User Preferences and add the preferences listed in the table below.

Note: To set a system-wide user preference, select the System check box.

For information on setting user preferences, see User preferences.

User PreferenceDescription
workspace.onCallShiftsPageSizeSet the maximum number of on-call shifts to view per page in the On-call shifts tab in the Shifts side panel.- Name: workspace.onCallShiftsPageSize - Type: Integer - Value: Enter the preferred number of on-call shifts you want to view per page.
workspace.workShiftsPageSizeSet the maximum number of work shifts to view per page in the Work shifts tab in the Shifts side panel.- Name: workspace.workShiftsPageSize - Type: Integer - Value: Enter the preferred number of work shifts you want to view per page.
workspace.schedulePlanPageSizeSet the maximum number of scheduling plans to view per page in the Schedules side panel.- Name: workspace.schedulePlanPageSize - Type: Integer - Value: Enter the preferred number of schedules you want to view per page.