Applies to Version 2 (20231018.1) of the IBSS Microsoft 365 Sync Service
Applies to IBSS API version 1.21.1.24410 of the IBSS Microsoft 365 Connector
ICONICS insists that you are not using both the IBSS Microsoft 365 Sync Service and IBSS Microsoft 365 Connector simultaneously in the same environment. This could lead to a meeting being constantly moved as each system will try to synchronise bookings for a different purpose.
What is the IBSS Microsoft 365 Sync Service
The IBSS Platform provides the IBSS Microsoft 365 Sync Service that allows users to create appointments for workspaces directly and solely in Microsoft Outlook or Teams and have these appointments synchronised as bookings with the IBSS Platform.
Use this if you want meetings within the organisation to solely be created in Outlook or Teams and synchronised with IBSS. When appointments are moved in Outlook or Teams or attendees are being added, they will get updated in IBSS.
Note: The meetings should not be changed in IBSS as this will not be reflected back in the Microsoft 365 appointment.
There are several consideration points about IBSS Microsoft 365 Sync Service:
-
Synchronisation period
The IBSS Microsoft 365 Sync Service will work within a configurable parameter called the Forward_Sync_Period which will determine how far in advance the service will look for appointments in Outlook to update IBSS correspondingly.
The default for the Forward_Sync_Period is 7 days. We recommend not amending this, especially for big environments.
Note: Users won't see their future bookings in IBSS that are further in the future than the Forward_Sync_Period that is set up for your organisation.
Note: The Outlook meeting description is not synchronised to IBSS and correspondingly won't update in IBSS if changed in Outlook.
-
Per building configuration
The IBSS Microsoft 365 Sync Service is configured for each building separately, and buildings can have different forward sync periods.
Note: Users might not know the forward sync periods for their building.
-
IBSS Microsoft 365 Sync Service and booking policies
IBSS Microsoft 365 Sync Service disregards any booking policy defined in IBSS.
-
Adding additional services
Additional services such as catering, equipment, or hearing or presentation aids cannot be used directly when creating a booking in Outlook or Teams.
Supported scenarios for IBSS Microsoft 365 Sync Service
Scenario |
Action |
|---|---|
Create appointment in Outlook or Teams and invite a room |
Booking gets created in IBSS for that space and linked to the Microsoft 365 appointment |
Update appointment in Outlook or Teams |
Booking gets updated in IBSS |
Move appointment in Outlook or Teams to another day in the future |
Booking updated in IBSS |
Delete appointment in Outlook or Teams |
Booking gets cancelled in IBSS |
| IBSS auto cancels the booking if not checked in | Booking is removed in the resource calendar for other people to use it. User's calendar is not modified. |
| Check out of the meeting earlier than its end time | Appointment in the resource calendar is shrunk to the checkout time. User's calendar is not modified. |
NOT supported scenarios for IBSS Microsoft 365 Sync Service
| Scenario | Action |
|---|---|
Update booking in IBSS linked to the Outlook or Teams appointment |
Does not happen |
Move booking in IBSS linked to an appointment to another day within forward sync period |
Does not happen, is not allowed |
Delete booking in IBSS |
Is not allowed Outlook returns the event back even if you have more rights and managed to delete a booking in IBSS |
| Add catering or other services to an existing booking in IBSS | Is not allowed |
What is the IBSS Microsoft 365 Connector
The IBSS Platform supports integration with Microsoft 365 Calendar via the Graph API. The IBSS Platform supports both appointments for workspaces (for example, desks) and meetings for support spaces (for example, meeting rooms).
Use this method if you want your organisation to manage and control their meetings solely in IBSS and have them appear in their Microsoft 365 Calendar.
Note: The meetings should not be changed in Microsoft 365 as this will not be reflected back in the IBSS calendar.
Supported scenarios for IBSS Microsoft 365 Connector
| Scenario | Action |
|---|---|
Create a booking in IBSS (Flex or Roamer) |
Booking is created in IBSS and synchronised with Microsoft 365 |
Update appointment in IBSS |
Booking gets updated in Microsoft 365 |
Move appointment in IBSS to another day in the future |
Booking updated in Microsoft 365 |
Delete appointment in IBSS |
Booking gets cancelled in Microsoft 365 |
NOT supported scenarios for IBSS Microsoft 365 Connector
| Scenario | Action |
|---|---|
Booking moved in Outlook or Teams |
No corresponding changes will be made in IBSS |
Configuration settings for IBSS Microsoft 365 Connector
The Booking external system (Bkng_Ext_System) building-level parameter identifies where the booking has been created.
Meta external booking system (Meta_Ext_Booking_System) is the space-level parameter.
If Bkng_Ext_System (building level) is set to 1 and Meta_Ext_Booking_System (space level) is set to 1 then the IBSS Microsoft 365 Connector (Integration Library in IBSS API) will make a call to the Graph API to make a booking and reserve a space.
If Bkng_Ext_System (building level) is set to 0 and Meta_Ext_Booking_System (space level) is set to 1 then the IBSS Microsoft 365 Connector (Integration Library in IBSS API) will not make a call to the Graph API to make a booking and reserve a space.
If Bkng_Ext_System (building level) is set to 0 Bkng_Sync_Enabled (building level) is set to 1 and your personal preference is to have sync enabled and you are not booking an Microsoft 365 resource, then appointments are created in your own calendar but no one is invited to them and the room won't be booked either.