Properties installed with Workplace Calendar Synchronization

  • Release version: Yokohama
  • Updated January 30, 2025
  • 2 minutes to read
    • 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 document outlines the key system properties installed with Workplace Calendar Synchronization in ServiceNow Yokohama release. These properties, stored in theSystem Properties [sysproperties]table, enable customers to customize synchronization behaviors between Workplace Reservation Management and external calendar providers like Microsoft Exchange Online and Google Calendar.

    Show full answer Show less

    Key Properties and Their Practical Use

    • snwsdrsvsync.syncintegrationmode: Defines the Exchange Online synchronization mode (Strict, Personal Authentication, or Normal). This controls how reservations sync with Microsoft Exchange Online.
    • snwsdrsvsync.useuserdefaulttz: Determines if synchronization respects the user’s time zone for reservations, falling back to system time zone or UTC if unspecified. It does not affect reservations synced from Exchange or Google Calendar.
    • snwsdrsvsync.createblockingrsv: Enables creation of blocking reservations on workplace locations synchronized with calendar providers to prevent double bookings.
    • snwsdrsvsync.maxeventretrycount: Sets how many times an event will be retried for processing before giving up, helping manage sync failures gracefully.
    • snwsdrsvsync.usedefaulttz: Controls usage of default time zones during reservation synchronization processes.
    • snwsdrsvsync.exchangecallbacktimelimit: Specifies the maximum wait time (in negative seconds) for Microsoft Exchange callback notifications. Since rejected or declined events are not notified, a scheduled cleanup job is recommended to clear these reservations.
    • snwsdrsvsync.outlookeventsyncinterval: Internally sets the interval in minutes for syncing events from Microsoft Exchange to Workplace Reservation Management. It must exceed the repeat interval of the related scheduled job.
    • snwsdrsvsync.googleeventsyncinterval: Used internally to set the sync interval (in minutes) for attendee updates from Google Calendar to Workplace Reservation. Must be longer than the related scheduled job’s repeat interval.
    • snwsdrsvsync.ewsPastSyncPeriodInMonths: Defines how many months in the past to synchronize reservations in a single sync cycle, with a recommended limit to avoid retrieving more than 1000 reservations at once.

    Key Outcomes for ServiceNow Customers

    • Customizing these properties allows precise control over calendar synchronization behavior, ensuring alignment with organizational policies and user preferences.
    • Proper configuration helps maintain accurate reservation data between Workplace Reservation Management and external calendar providers, reducing booking conflicts and improving user experience.
    • Time zone handling properties ensure reservation times are consistent and meaningful for users across different regions.
    • Retry and callback properties improve robustness of synchronization, handling temporary failures without data loss.
    • Scheduled cleanup jobs complement synchronization by removing rejected or declined reservations not automatically notified by calendar providers.

    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.
    Table 1. Properties for Workplace Calendar Synchronization
    Property Description
    sn_wsd_rsvsync.sync_integration_mode This property enables you to specify the Exchange Online sync integration mode to Strict, Personal Authentication, or Normal mode to synchronize reservation between Microsoft Exchange Online and Workplace Reservation Management.
    • Type: string
    • Default value: Normal
    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.

    • Type: true/false
    • Default value: false
    sn_wsd_rsvsync.create_blocking_rsv This property enables you to create blocker reservations on workplace locations that are synchronized with the calendar provider.
    • Type: true/false
    • Default type: true
    sn_wsd_rsvsync.max_event_retry_count This property enables you to specify after how many times an event must be reprocessed.
    • Type: Integer
    • Default value: 10
    sn_wsd_rsvsync.use_default_tz This property enables you to use the default time zones during the reservation synchronization.
    • Type: true/false
    • Default type: true
    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.
    • Type: Integer
    • Default value: -18000 (5 hours)
    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.
    • Type: Integer
    • Default value: 2
    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.
    • Type: string
    • Default value: 5
    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.
    • Type: Integer
    • Default value: 2