Manage calendar synchronizations

  • Release version: Washingtondc
  • Updated February 1, 2024
  • 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 allows admins to monitor and manage events and calendar items associated with reservations. It facilitates the approval of reservations, handles event notifications, and tracks synchronization details to ensure seamless integration with calendar services.

    Show full answer Show less

    Key Features

    • Approvals: Admins can approve reservations created from calendar providers through the Workplace Core approval configuration.
    • Events: Actions like creating, updating, or canceling reservations trigger events that communicate with calendar services. Events are standardized to ensure consistency across systems.
    • Calendar Items: Each action by the calendar service results in a corresponding calendar item, enabling the creation, update, or cancellation of reservations in the Workplace Reservation Management application.
    • Synchronization Deltas: A delta key is generated for each synchronization, allowing only changes since the last sync to be retrieved, minimizing data transfer and improving efficiency. This is applicable only for Microsoft Exchange On-Premises and Google Calendar.

    Key Outcomes

    By effectively managing calendar synchronizations, admins can ensure accurate tracking of reservations, streamline workflow through automated notifications, and enhance the overall efficiency of workplace management. Checking synchronization details provides insights into the number of events and calendar items created, helping maintain clarity in operations.

    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.