7. Global Configuration

Owned by Michael Goss
Apr 07, 2024
1 min read

Administrators in an Ignition Gateway can access the module’s global configuration settings by navigating to Ignition Gateway Config → Outlook Calendar Sync → Settings. These settings apply to all Calendar Roster Mappings that are configured on the Gateway.

Enable Synchronization

When Enabled, this allows all active Calendar Roster Mappings to begin syncing and making changes to their respective On-Call Rosters automatically.

When Disabled, this stops all Calendar Roster Mappings from continuing to synchronize. Administrators should disable this when they wish to manage On-Call Rosters manually.

Sync Frequency

The number of milliseconds between each synchronization of Outlook calendars (utilizing the Microsoft Graph API). Gateway Administrators must ensure that this value complies with any current and future rate limits imposed by Microsoft: Microsoft Graph service-specific throttling limits - Microsoft Graph.

Always Override

WARNING: Careful attention should be paid to this setting, as it can result in a scenario where active alarms notifications are not being sent out.

If an event that is currently in-progress is deleted in Outlook, one of two actions take place depending on the module’s Always Overwrite (Ignition Gateway Config → Outlook Calendar Sync → Settings) value:

  1. If Always Overwrite is enabled, then deleting an in-progress event from the calendar will remove all users currently on the On-Call Roster, leaving an empty list and therefore no outgoing alarm notifications.

  2. If Always Overwrite is disabled, then deleting an in-progress event from the calendar will leave all users currently on the On-Call Roster intact, even though they do not exist in any in-progress calendar event.