This document describes the actions that need to be performed in the Integration Platform to set up the reconciliation service. The reconciliation is a functionality which periodically checks if Workplace and Outlook are in sync and performs an action depending on the reconciliation services configuration.
| Info |
|---|
The reconciliation service is not yet supported for a calendar integration with Google Calendar. |
| Table of Contents | ||
|---|---|---|
|
1. Scope
Setting up the reconciliation service in the Integration Platform for Outlook.
2. Who is this document for?
Workplace Consultants
Workplace Integration Team
3. Prerequisites
Exchange/Outlook: The client needs to have Exchange and Azure set up correctly: /wiki/spaces/WM/pages/119668747
4. Integration Platform configuration
Log in to the Integration Platform via https://integration.spacewell.com/
Go to Reservation Sync -> Reconciliation:
...
Make sure a tenant is selected on the top right corner to see the reconciliation configuration of that tenant.
In the Reconciliation menu two collapsed overview are shown:
Click on the 'Configuration' overview to open the configuration:
...
Below an explanation about the different configuration settings:
Configuration ID: This is a automatically generated ID for the reconciliation configuration for the specific tenant.
Reconciliation Window (days): Reconciliation only works for a pre defined number of days in the future. Via this setting it can be determined for how many days in the future, the reconciliation works. The minimum value is 30 days and the maximum value is 90 days. For example, if the setting is set to 30 days, the reconciliation will check all reservations in the upcoming 30 days. A large number of days and a short interval between reconciliation jobs can severely affect the performance of the integration platform.
Schedule: Via this setting the reconciliation schedule can be determined. Via a Quartz Cron Expression it can be configured, when the reconciliation needs to be executed (e.g. every day at 06:00, every other day at 10:00 and 17:00, etc.). A Quartz Cron expression can be created via Free Online Cron expression generator.
With the 7 values of the Cron Expression it can be determined when the reconciliation needs to be executed.
Second
Minute
Hour
Day of month
Month
Day of week
Year
...
Leading: This setting indicates which application is the system of truth in case of a mismatch in the calendar events.
Example:
A meeting is created in Outlook, but not visible in Workplace for whatevery reason:
CalendarProvider = Leading: The meeting will be (re)synced to Workplace via the reonciliation service
IWMS = Leading: The meeting will be removed from the Outlook calendar
Conflict Resolution: This setting indicates on how the mismatch should be addressed. There are two options:
Rollback: Cancel one of the conflicting bookings in the leading application.
Report: Send an email notification and report in the UI for manual action by a reservation administrator.
Rollback Strategy: If the 'Conflict Resolution' is set to Rollback, this setting indicates which of the conflicts should be removed. By default the newer reservation will be removed.
The general configuration applies to all room mailboxes in scope. It is possible to make a room override where a different configuration applies.
...
Click + to add a Room Override.
#############################
Click on the 'Execution' overview to open the overview of reconciliation executions:Please bear with us while this article is being created.