Properties installed with Workplace Calendar Synchronization
Summarize
Summarized using AI
This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.
Summary of Properties installed with Workplace Calendar Synchronization
This content outlines the configurable properties available in the System Properties [sysproperties] table for Workplace Calendar Synchronization in ServiceNow. These properties govern how calendar events and reservations synchronize between external calendar providers (like Microsoft Exchange and Google Calendar) and the Workplace Service Delivery platform. Understanding and customizing these properties helps optimize synchronization behavior according to organizational needs.
Show less
Key Properties and Their Practical Use
- snwsdrsvsync.useuserdefaulttz: Enables synchronization of reservations using the user's time zone if specified, otherwise defaults to system or UTC time zone. Defaults to false, meaning system time zone is used by default. Useful for ensuring reservations reflect the correct time zone per user.
- snwsdrsvsync.createblockingrsv: Controls whether blocking reservations are created on synchronized workplace locations. Defaults to true, allowing blockers to prevent conflicts during synchronization.
- snwsdrsvsync.maxeventretrycount: Defines how many times an event is retried for processing if initial attempts fail. Default is 10, helping manage event processing reliability.
- snwsdrsvsync.usedefaulttz: Determines if default time zones are applied during synchronization. Default is true, aligning with standard time zone usage unless otherwise specified.
- snwsdrsvsync.exchangecallbacktimelimit: Sets the maximum wait time (in negative seconds, default -18000 or 5 hours) for Microsoft Exchange callbacks during synchronization. Important for managing callback expectations and handling rejected or declined events via scheduled cleanup jobs.
- snwsdrsvsync.outlookeventsyncinterval: Defines the synchronization interval in minutes for events received from Microsoft Exchange. Default is 2 minutes and should be greater than the related scheduled job intervals to ensure proper event updates.
- snwsdrsvsync.googleeventsyncinterval: Controls the interval (in minutes, default 5) for updating Google Calendar attendee details on reservations. Must be set longer than the corresponding scheduled job interval.
- snwsdrsvsync.ewsPastSyncPeriodInMonths: Specifies the number of past months to synchronize reservations. Defaults to 2 months. Syncs should be limited to return fewer than 1000 reservations per run to maintain performance.
Practical Implications for ServiceNow Customers
By configuring these properties, ServiceNow customers can tailor calendar synchronization behavior to match organizational policies, time zone requirements, and integration performance expectations. Proper setup ensures accurate reservation times, reduces synchronization conflicts, and maintains system efficiency by managing retry counts and sync intervals.
Additionally, awareness of the Microsoft Exchange callback limits and the use of scheduled cleanup jobs helps handle rejected or declined events effectively, preserving data integrity within Workplace Service Delivery.
Customize the properties available with Workplace Calendar Synchronization.
These properties are available for Workplace Calendar Synchronization.
Note:
All of
these properties are located in the System Properties [sys_properties] table. To access
the table, enter sys_properties.list in the navigation
filter.
| Property | Description |
|---|---|
| sn_wsd_rsvsync.use_user_default_tz | This property enables you to synchronize reservations created by users according to their time zone. Either the system's time zone or the user's time zone is used to update and synchronize reservation. First,
the property checks if the user has a time zone specified or not. If the user has not specified any time zone, the system's time zone is used. Again, if the system has no time zone specified, then the property
uses the UTC time zone. Reservations synchronized from Microsoft Exchange and Google Calendar to Workplace Service Delivery are not affected.
|
| sn_wsd_rsvsync.create_blocking_rsv | This property enables you to create blocker reservations on workplace locations that are synchronized with the calendar provider.
|
| sn_wsd_rsvsync.max_event_retry_count | This property enables you to specify after how many times an event must be reprocessed.
|
| sn_wsd_rsvsync.use_default_tz | This property enables you to use the default time zones during the reservation synchronization.
|
| sn_wsd_rsvsync.exchange_callback_time_limit | This property enables you to specify the maximum time limit to wait for Microsoft exchange to notify with a callback. Specify the time limit in negative seconds as specified in the default value. Note: You
won’t be notified when an event is rejected or declined by Microsoft Outlook. For the same reason, a scheduled job - Clean-up Awaiting/Rejected Reservations, is available that you can run
on any suitable frequency to clear the reservations rejected or declined by the Microsoft Outlook calendar.
|
| sn_wsd_rsvsync.outlook_event_sync_interval | This property is used internally by the application, it enables you to set the time(in minutes) to synchronize events received by Microsoft Exchange with Workplace Reservation Management application. Ensure
that the time that you set in this property is more that the time specified in the Create and Update Reservations from Events scheduled job's repeat interval.
|
| sn_wsd_rsvsync.google_event_sync_interval | This property is used internally by the application while updating the attendee details on the reservations. Ensure that the time that you set in this property is more than the time specified in the
Update attendees of Workplace Reservation (Google) scheduled job's repeat interval.
|
| sn_wsd_rsvsync.ewsPastSyncPeriodInMonths | This property enables you specify the number of months that you want a sync to run in order to sync past reservation. A single sync will run for specified number of months for past reservation. Ensure that a
single sync does not return more 1000 reservations. Specify the number of months based on the same.
|