System properties for On-Call Scheduling

The property settings configure On-Call Scheduling operations.

Setting properties from the UI

You can set most property values from the On-Call Properties page at On-Call Scheduling > Administration > On-Call Properties.

Property	Description
com.snc.on\_call\_rotation.calendar\_macro	The name of the macro that provides a calendar functionality for On-Call shift. The default uses DHTMLX scheduler. Fullcalendar is set by ocf\_calendar.xml.
com.snc.on\_call\_rotation.support\_legacy\_spans	Used to search for override or time-off records that may have been generated as cmn\_schedule\_span records and not the standard roster\_schedule\_span table.
com.snc.on\_call\_rotation.pto.approval.required	Configuration to determine if PTO requests need approval.
com.snc.on\_call\_rotation.factor\_daily\_rotation\_interval\_all\_day	If true, mandates daily rotation to occur at midnight. If false, then use the time that is specified for the roster start time for the next day. Location: System Property \[sys\_properties\] table
com.snc.on\_call\_rotation.log.level	Enable logs for debugging.Location: System Property \[sys\_properties\] table
com.snc.on\_call\_rotation.log\_escalations	Enable logging of escalations. See View details in an escalation log.Location: System Property \[sys\_properties\] table
com.snc.on\_call\_rotation.calendar\_macro	The name of the macro that provides a calendar for On-Call shift. The default uses DHTMLX scheduler. Fullcalendar is set by ocf_calendar.xml.Location: System Property [sys_properties] table
com.snc.on\_call\_rotation.support\_legacy\_spans	Used to search for override or time-off records that may have been generated as records in the cmn\_schedule\_span table and not in the standard roster\_schedule\_span table.Location: System Property \[sys\_properties\] table
com.snc.on\_call\_rotation.pto.approval.required	Configuration to determine whether PTO requests require approval.Location: System Property \[sys\_properties\] table
com.snc.on\_call\_rotation.contrast	Sets text color to either white or black depending on which has the highest contrast with the background color on the calendar. The following algorithms determine text color: - ContrastYIQ - ContrastPercent - ContrastLuminance Note: ContrastYIQ is used if the property is not enabled. Location: System Property [sys_properties] table
com.snc.on\_call\_rotation.access.debug	If true, enable general On-Call logs for debugging.Location: System Property \[sys\_properties\] table
com.snc.on\_call\_rotation.reminders.showtz	Include a user's time zone in On-Call Shift Reminder notification emails.Location: System Property \[sys\_properties\] table
com.snc.on\_call\_rotation.show\_legacy\_calendar	Show the legacy On-Call calendar.Location: System Property \[sys\_properties\] table
com.snc.on\_call\_rotation.calendar\_read\_roles	Comma-separated list of roles that can read the calendar.Location: System Property \[sys\_properties\] table
com.snc.on\_call\_rotation.cover.color	Sets the color of the span for On-Call coverage for another roster member.Location: System Property \[sys\_properties\] table
com.snc.on\_call\_rotation.timeoff.color	Sets the color of the span when the type is time-off.Location: System Property \[sys\_properties\] table
com.snc.on\_call\_rotation.landing\_page.group\_limit	The number of On-Call schedules loaded per batch on the client side. Default: 20.
com.snc.on\_call\_rotation.landing\_page.max\_groups	The maximum number of On-Call schedules that can be loaded on the client side. Default: 300.Note: The default value is chosen as the limit of acceptable client performance.
com.snc.on\_call\_rotation.landing\_page.pinned\_notification	Displays a message when any schedule is pinned successfully.
com.snc.on\_call\_rotation.landing\_page.notification\_timeout	Specifies the time \(in milliseconds\) until the message for successful pinned scheduled is displayed.
com.snc.on\_call\_rotation.landing\_page.show\_wizard\_btn	Displays the New button to open the On-Call schedule wizard.
com.snc.iam.conference\_call\_follow\_on\_call\_escalation	If selected, On-Call the escalation path is followed when a user group is added to a conference call.This property is added when the Incident Communications Management \(com.snc.iam\) plugin is activated.
com.snc.iam.conference\_call\_escalation\_workflow	If selected, custom escalation hierarchy is applicable in On-Call Scheduling workflows.This property is added when the Incident Communications Management \(com.snc.iam\) plugin is activated.
com.snc.on\_call\_rotation.landing\_page.show\_pending\_actions	If true, displays the pending actions on the On-Call Schedules landing page.
com.snc.on\_call\_rotation.allow\_rota\_overlap	If true, overlapping shifts are allowed for a user group.
com.snc.on\_call\_rotation.escalation\_rule\_rota\_overlap	Escalation rule that applies for shift overlap. Options:- Escalate to outgoing Shift - Escalate to incoming Shift - Escalate to all Shifts
com.snc.on\_call\_rotation.pto.configuration	Specifies how a roster member can create vacation time \(PTO\). Options:- With approval - Without approval - Not allowed
com.snc.notify.default.conference\_call\_follow\_on\_call\_escalation	If true, the On-Call escalation path is followed when a user group is added to a conference call. However, the time between reminders is set to 60 secs. Users can create properties for required task types such as incident. Example: For Incident, the property key would be com.snc.notify.incident.conference_call_follow_on_call_escalation.Note: The property is enabled only when the Notify plugin (com.snc.notify) is active.
com.snc.notify.default.on\_call\_escalation\_level	Fetches the number of users from the group escalation plan. A value of -1 fetches all users from the plan. A value of 1 fetches only the first level of users, and so on. Note: This is the default property that is used until the specific property for the task type is configured. To use different workflows for different task types (such as incident or problem), create a new property by replacing the word `default` in the key with the task type. This property is used only when the com.snc.notify.default.conference_call_follow_on_call_escalation sys property is false. The property is enabled only when the Notify plugin (com.snc.notify) is active.
com.snc.notify.default.conference\_call\_escalation\_workflow	The sys_id of the default workflow that must be attached when escalating a conference call.Note: This is the default property that is used until the specific property for the task type is configured. To use different workflows for different task types (such as incident or problem), create a new property by replacing the word `default` in the key with the task type. Example: For Incident, the property key would be com.snc.notify.incident.conference_call_escalation_workflow. The property is enabled only when the Notify plugin (com.snc.notify) is active.
com.snc.on\_call\_rotation.use\_slack\_for\_dm	If false, disables direct messaging via Slack on all On-Call Scheduling pages.
com.snc.on\_call\_rotation.use\_msteams\_for\_dm	If false, disables direct messaging via Microsoft Teams on all On-Call Scheduling pages.
com.snc.on\_call.announcement\_message	If false, removes the banner of SOW announcement from on\_call\_calendar page.
com.snc.on\_call\_rotation.new\_trigger\_engine	If true, a new on-call trigger engine is activated which enables on-call subflows get triggered via flow runner queue. As the on-call subflows are marked as high priority they get processed faster via flow runner queue compared to the traditional event queue especially when multiple events are triggered at the same time and are in the process queue.

Parent Topic:Reference for on-call scheduling