Manage calendar synchronizations

  • 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 Manage calendar synchronizations

    The Workplace Calendar Synchronization application enables administrators to monitor and manage calendar reservations synchronized between Workplace Reservation Management and external calendar providers. This includes tracking events, approvals, calendar items, and synchronization deltas to ensure accurate and efficient reservation updates.

    Show full answer Show less

    Key Features

    • Approvals: Manage and approve reservation requests created from calendar provider applications using Workplace Core approval configurations. This helps control access and reservation workflows.
    • Events: Each synchronization action (create, update, cancel) triggers an event that standardizes communication between calendar services and Workplace Reservation Management. Events contain requests and responses, can be converted to JSON, and reprocessed if errors occur.
    • Calendar Items: Actions from calendar services are converted into calendar items representing new or updated reservations. Admins can create, update, or cancel reservations directly within Workplace Reservation Management using these items, which are also convertible to JSON format.
    • Synchronization Deltas: A delta key is generated and updated with each synchronization, allowing retrieval of only changes since the last sync instead of the full calendar history. This optimizes synchronization by focusing on new, updated, or canceled reservations. Note that delta synchronization is supported only for Microsoft Exchange On-Premises and Google Calendar.

    Practical Considerations

    When setting up synchronization, admins should review synchronization prerequisites and implementation guidelines to ensure correct configuration. Monitoring synchronization events and deltas helps maintain data accuracy and resolve any errors through event reprocessing.

    As an admin, monitor the number of events and calendar items in the Workplace Calendar Synchronization application whenever a reservation is synchronized.

    As an admin, the application enables you to view and manage the following:
    • Approvals
    • Events
    • Calendar items
    • Synchronization deltas

    When you configure synchronization, you must keep in mind a few important conditions. Refer to Synchronization - Prerequisites and implementation.

    Approvals

    If there are any reservations created from the calendar provider application that requires approval, you can approve them using the Workplace Core approval configuration. For more information on how to approve a reservation or create a performer criteria, refer to Create a workplace performer criteria.

    Events

    Every action during a reservation synchronization triggers an event. These actions include creating, updating, or canceling a reservation. The Workplace Calendar Synchronization handles these events and sends notifications to the calendar services. For more information about an event and the type of events created in the application, refer to Events in Workplace Calendar Synchronization.
    • An event can create one or more calendar items.
    • An event contains a request and a response to the request.
    • To ensure that multiple calendar services can communicate with Workplace Reservation Management, events translate the reservations and messages from the calendar provider into standardized actions in Workplace Reservation Management.

    When a workplace item is synchronized with the calendar service, an event is created to get the latest details. The response from the calendar service also creates an event. Similarly, events are created whenever a reservation is created or updated within Workplace Reservation Management for workplace items that are configured to synchronize. You can convert an event into JSON format. You can also reprocess an event if there was an error or for any reason.

    Calendar items

    Every action performed by the calendar service is converted to a calendar item that is handled in the Workplace Reservation Management application. A calendar item is either a new reservation or a reservation update. Using calendar items, you can also create, update, or cancel a reservation in the Workplace Reservation Management application. You can convert a calendar item into JSON format.

    Synchronization deltas

    When a workplace item is synchronized, a delta key is generated. A delta key is used and updated every time a workplace item synchronizes with the calendar service. Each sync delta contains a token that indicates how much information was synced last time so that a delta with the new changes can be returned in the next request instead of the complete calendar history. You can know the details of the workplace item such as the number of reservations created, or any changes made on the reservation. The delta key ensures that only the changes that occurred between the previous and the current synchronization is retrieved. The delta key retrieves details of any new, updated, and canceled reservations on the workplace item.
    Note:
    Synchronization deltas are used only for Microsoft Exchange On-Premises and Google Calendar.