/ Introduction

Whit Breece Cloud Addon functionality we want to make makes it possible for users to access data from different sources and use the data on the displays. Because all sources are different, the addons are customized to work with specific sources.

/ General Functionality

Cloud web

You can manage addons in the addon section on an installation. 

Here you can create the addon you what to use. Upload custom layouts and assign displays.

Implementation

Breece scheduler service handles all addon connections. 

The service will check if any addons need to be updated every minute and will update the displays that need to be updated.

/ Setup O365 in cloud

Log in to the cloud, choose addon -> addon list

In the bottom left corner -> clic create Addon – Choose Office365 -> click save

are Insert values from Azure (Values are obtained from customers' IT department, if they don’t know how to get values then “Breece Cloud - Office365 integration.pdf”. can be obtained by sending mail to [email protected] 

Used culture – Choose the Language displayed for calendar view.

(use this list if to find Language Code: http://www.lingoes.net/en/translator/langcode.htm )

Time Offset:

We recommend setting “Time offset” to 80 sec. so the sign has changed slightly before an actual meeting starts.

Numbers are measured in seconds.

Update Interval: 

How often do we retrieve data from Azure. Recommended is every 5 min.

From To:

To save power on batteries, set “From” and “To”, to active opening hours.

Email Notification:

If there is a problem, this person will be notified.

Finish Setup:

When you filled out the steps above (see picture)

Click Save

Design Packages

Right now you need preconfigured Designs to get started. 

In a later release, you can create new design right away. Designs is attached to this solution. are

the Click in lower left corner on “Upload Design Package -> upload Design and Layout -> Clic save -> Clic Publish

Do this for all your designs (in this example Calendar and CalendarBusy)

/ Layouts

Addon layouts use the same layout as products.

The way the layout differs is how we handle variables. 

Variables are prefixed with an Addon type. In this example, we get the Office 365 users department from Office 365.

 You can now use the variable by prefixing the addon type like this OFFICE365.Department.

Here is an example of how it looks in the bdm file 

<text><![CDATA[/ [OFFICE365.Department]]]></text>

/ Installation Layouts

In the Addon section, you can upload your custom layouts that can make use of the Addon variables.

These layouts will only be available on the installation level.

/ Standard Layouts

Standard layouts are system-wide layouts that are available for all installations. 

These layouts should remain generic because all installations have access to them.

Standard layouts are manually uploaded to the database. 

Upload the layout to StandardAddonTemplates. You also need to add the layout type and ID to AddonsActiveDesignPakages.
 

/ Error Handling

When things do not go as expected, we will handle the error. 

Either on Addon level, as on general error, in the addon that will affect all displays attached to the addon.

 Or it can be an error-specific error on the display.

/ Addon

When The addon fails, the addon will change status to failed and will. 

When in this state, it will not update any displays. 

The default way to fix this error is to correct and save the configuration again.

 Fx. If the user used the wrong tenant id or the user lost its permissions. 

No display image will be updated when the addon fails, but an email will be sent to the configured notification email.

/ Display

When an error occurs on a Display, the display will be marked as failed.

 When this happens, the display image will be updated, with an error layout. 

The error layout is marked as “IsErrorLayout” in StandardAddonTemplates. 

The error layout will not be shown in Gui. You can use variables on the layout. There can only be one Error layout on the system. 

When creating an Error Layout do not prefix the addon name

• Installation (int)
• SerialNumber (string)
• AssignValue (string)
• Message (string)
•  

/ Office 365 Modes

User – Will have a user calendar

Display example

With user, you can use these variables

• RoomName (string)
• UserTitle (string)
• Department (string)
• Date (string)
• UserAllDayEvents (string)
• UserAppointments (string)
• UserAppointmentsOneLinePerEvent (string)

Room – Will have a room calender and show if the room is occupied. calendar

Calender example

Calendar busy example

• RoomName (string)
• Date (string)
• MeetingStartsWithin5Minutes (True/False)

With room you also have access to 20 appointments

– eks AppointmentSubject1

– eks AppointmentStart1

– eks AppointmentEnd1

– eks AppointmentDuration1

– eks AppointmentOrganizer1

/Assign Calendar to Display.

To assign a calendar to a display go to: Addon -> Assigned display

Click Assign Display in the lower left corner.

Addon:

Select Office 365

Alias: 

Give it a telling name

Display Seria Number:

Find display you want to use for room signage, enter display serial (on the back of the display is the Serial number)

Office 365 type:

Calendar: is for meeting rooms.

User: shows the information on personal calendar.

Choose a layout:

Here you can choose among uploaded designs.

Choose a busy layout:

Show another design when a meeting is in progress.

Assign value:

the Enter email address of the meeting room or personal email for a single user.

Finish configuration

When finished, click save. The cloud will now send calendar info to the display.

Assign used Display to another Calendar:

click rightclickRight clic (see picture), and choose to unassign. After unassign follow the “Assign Calendar” steps again.