Digital Signage, Microsoft 365 (Exchange) Calendars
The recommended method to import Microsoft 365/Exchange calendar events into Korbyt Anywhere is using the built-in "Data Adapter" feature, which allows syncing up to seven days of events.
Account Configuration
To use , on a resource account and the DigitalSignage O365 Service Account (dss-o365servacct@ad.uillinois.edu) must be granted at least View All Details (also known as Reviewer) access to the calendar.
To use the interactive room scheduling element on the sign, the account must also be configured as a Room Mailbox with the service account granted Delegate access. Tech Services has an Answers KB article about Room Mailboxes here: https://answers.uillinois.edu/page.php?id=47594. This step is not required if the calendar data is imported for displaying events only.
Data Adapter Setup
After the permissions have been assigned, please submit a ticket to have the data adapter configured or email digitalsignage@illinois.edu.
The subscription data feed will include the following data fields:
Field | Description |
icaluid | Unique ID of event |
subject | Event subject text |
bodyHtml | Full HTML content of event message |
bodyPreview | Preview text of the event message |
location | Location field of event |
organizerName | Name of event organizer |
organizerEmail | Email address of event organizer |
isCancelled | Boolean (true/false) indicating event cancellation |
startDateTime | Timestamp of starting date/time in UTC time |
startTimezone | Timezone of startDateTime, "UTC" |
endDateTime | Timestamp of ending date/time in UTC time |
endTimezone | Timezone of endDateTime, "UTC" |
calendar | Email address of calendar account |
lastupdate | Date/time this row was last synced by adapter |
Accessing the Data Subscription on Layouts
Once enabled, the event data will be available within the Layout Editor as a subscription data feed. Each layout can only contain a single subscription, so if a sign requires multiple data feeds the subscription will need to be placed within a separate layout that can then be embedded inside the base layout for the sign.
Information on using and formatting subscription content is available on the Data Subscriptions Answers KB page, but there are some specific considerations when using Office 365 calendar data.
The adapter will contain events from multiple calendars, so filtering is required to retrieve only data from specific calendars. Filtering can be set from icon in the lower right of the subscription setup interface:
The filter rule should be set up with the Field: "calendar", Operator: "Is", Criteria: "Standard", and then the account email of the calendar.
The data subscription will include events with start times up to two days prior to the current date. To include only current and upcoming events, a filter can be set on the field "endDateTime" with the operator "Is after" "0 seconds". The toggle in the upper right should be set to "AND" to ensure both rules are applied.
Note: Mixing "AND" and "OR" filters may cause unexpected behavior. More complex filtering and dat aformatting Please contact the Digital Signage Services for questions about implementing this.
The subscription data can also be filtered in the Data Display element and some other Layout elements.. See the Data Subscriptions Answers KB page for guidance on displaying the data.
Note: Korbyt has a built-in "Calendar" element to display the events graphically in the Layout Editor. It includes a "Sign in with Microsoft" option. We advise you do not use this as it will connect to your currently logged-in Microsoft 365 account and use your own calendar as the data source for that element. This element can be used with subscriptions, however some adjustments to the data may be required.
Room Calendars/Scheduling
Korbyt supports interactive room reservations from the sign with the "Room Scheduling" element.
Information about this element is available on Korbyt's KB https://kb.korbyt.com/article/how-to-use-the-room-scheduling-element/