🗒️ Agenda

The Agenda layer displays the events scheduled on your locations, the spaces you manage under Agenda. One field, Agenda Mode, decides which of its three uses you get:

Needs a live connection

The device fetches this content while the layer is playing. With no network connection there is nothing to show, and no new data arrives until the connection is back.

Goal	Agenda Mode	What appears on screen
Event board	list	One entry per event, with title, times, room, and speaker.
Meeting room panel	meeting room	The meeting running right now in one room, with a free or busy message.
Directional signage	directions	One entry per location, with an arrow pointing towards it.

The content comes from the events people create in the Agenda calendar, so the screen follows them on its own as events are added, changed, or deleted. Once the layer is published you never touch the project again to keep it current.

Where the content comes from

Three separate things feed this layer, and each is configured in a different place:

• Locations, under Agenda, Locations. Only a location with This POI is bookable ticked appears in the layer, and it is listed as Name (Branch). The location carries the room name, description, capacity, equipment, and an attached image.
• Events, under Agenda, Calendar. Each event belongs to a location and carries a title, start and end, description, speaker, company, attendees, and an optional media file. Events can also arrive on their own, from an Exchange, Google, or ICS calendar connected to the location. See Microsoft Entra credentials for the Microsoft side of that.
• Direction arrows, on the device rather than on the layer, in the Device Position tab under Points of interest. The direction is set per screen and per location, so the same room points left on one screen and right on another. The Direction Symbols Set you pick in the layer only decides what the arrows look like.

Before you start

The layer only returns data when both of these are true:

• Your account has the Agenda module enabled, which is what puts the Agenda entry in the main menu.
• At least one location is marked as bookable. In directions mode you also need a direction configured for that location on the screen that will show it, otherwise the entry appears without an arrow.

Add the layer to a project

1. Open the Project section and create a project that fits the target screen.
2. Click Add new layer and search for the Agenda layer.

3. Select one or more locations in Points of Interests. The list holds every bookable location of your account.
4. Choose the Agenda Mode: list, meeting room, or directions.
5. Set Validity to the time window you want to cover, from today only up to the whole month.
6. Move to the Sublayers tab and add one sublayer per field you want to draw. The Sublayers section below lists the fields each mode provides.

Choose the mode before building sublayers

Agenda Mode changes both the list of fields the layer returns and how they are resolved. Set it first, then design the layer. If you switch mode later, check that every sublayer you already added still points to a field that exists.

Event board

Set Agenda Mode to list.

The layer returns the events themselves, one entry per event, sorted by start time, and pages through them at the interval set in Page Dur. Each entry carries the event data (title, description, start and end, speaker, company, organizer, attendees, and any attached media) plus the data of the location it was scheduled on (name, description, capacity, equipment, image, and a direction arrow).

An event is included as soon as it overlaps the window set in Validity, so a meeting that started an hour ago and is still running stays on the board in the day_ongoing window.

Use case

Use it for a lobby or corridor screen that answers "what is happening in this building today", or, with Validity set to a week, for a conference programme.

Meeting room panel

Set Agenda Mode to meeting room, and select a single location.

Instead of paging through a list, the layer draws one entry: the meeting running right now in that room. It recalculates every minute on the device itself, without waiting for Refresh time, and redraws only when the current meeting or the status changes.

The status is a plain two-state one, and both the message and its color are yours to set in the layer:

Status	When	Fields
Free	No meeting is running at this moment.	Room Free Msg and Room Free Color
Busy	A meeting is running right now.	Room Busy Msg and Room Busy Color

A meeting starting in ten minutes does not change the status: until it actually starts, the room reads as free. If you need a "starting soon" state, or a board covering several rooms at once, use the Booking layer instead.

Add the next meeting by hand

This mode also knows the first meeting still to come, but the field list does not offer it. Type the marker yourself into a Text sublayer, using next in place of the current meeting: ((next.title)), ((next.start.time_24)), ((next.end.time_24)), and so on for every event field in the table below. A Dynamic Date From Text sublayer takes ((next.start.rfc_2822)). When today holds no further meeting, these render empty, exactly like the current ones.

Every event field is blank while the room is free

The event fields resolve against the meeting in progress, and so do the room fields, because the layer looks the room up through that meeting. When nothing is running, all of them render as empty text, including PoiName. Put the room name in a plain Text sublayer with the name typed in, and keep the feed fields for the meeting details.

Use case

Use it for a small panel next to the door of a single meeting room.

Directional signage

Set Agenda Mode to directions.

The layer drops the events entirely and returns the locations, one entry per location, each with the arrow configured for that location on that screen. It pages through them like the event board, using Rows, Columns, and Page Dur.

Leaving Points of Interests empty is meaningful in this mode: the screen then shows every location that has a direction configured on it, so adding a direction on the device is enough to put a new room on the sign, with no edit to the project.

Use case

Use it for a wayfinding screen at a corridor junction or at the top of a staircase.

Content fields

• Points of Interests: the locations the layer reads. Only bookable ones are listed. In meeting room mode select exactly one.

• Refresh time (in minutes): how often the device fetches fresh event data (default 60). Events change through the day, so a lower value keeps a busy board honest; 5 to 15 minutes is a reasonable range.

• Direction Symbols Set: the arrow images used by the direction field. Any custom set loaded for your account also appears in this list.

• Languages: the languages used for the translated location name and description. It defaults to the language you are logged in with.

• Validity: the time window the layer asks for. The ongoing values start from the current time, the others from the start of the period:

  Value	Window
  day	Today, from midnight to midnight. This is the default.
  day_ongoing	From now until midnight. Events that already ended drop off on their own.
  week	The current week, Monday to Sunday.
  week_ongoing	From now to the same time seven days later.
  month	The current calendar month.
  month_ongoing	From now to the end of the month.

• Agenda Mode: list (default), meeting room, or directions. See the three sections above.

• Page Dur: how many seconds a page of results stays on screen before the next one (default 5). It matters as soon as there are more results than the table can hold.

• Room Free Color, Room Free Msg, Room Busy Color, Room Busy Msg: the color and the text of the two room states, for meeting room only. They default to green with FREE and red with BUSY.

Layout fields

In list and directions mode the Agenda layer arranges its results in a table, so you can show several entries at once instead of one at a time. In meeting room mode there is only ever one entry, so these fields have no effect.

• Rows and Columns: the grid of results drawn on one page. An event board is usually a single column with as many rows as the screen can fit; a wayfinding sign with three rooms side by side fits a 1 row by 3 columns grid.
• Row Padding, Col Padding and Cell Padding: the spacing around and inside the cells of that grid.

Sublayers

The Agenda layer draws nothing by itself. Add a sublayer for each piece of information you want on screen. Sublayers can be edited and moved like regular layers, but they remain tied to their parent Agenda layer.

Each field comes with the sublayer type it needs: plain values become Text sublayers, a full date needs a Dynamic Date From Text sublayer, and an image or an arrow needs an External Image sublayer.

Location fields

Available in all three modes.

Field	Content
PoiName	Name of the location, in the first of the selected Languages.
PoiDescription	Its description, in the same language.
PoiSpaces	The number of available spaces in the room.
PoiInstruments	The equipment available in the room.
PoiMedia	The image attached to the location.
PoiDirection	The direction arrow towards the location, drawn from the selected Direction Symbols Set.

The list also offers PoiBranchId, PoiAccount, and PoiRoomConfig. These are internal values, not meant for the screen.

Event fields

Available in list and meeting room mode. In meeting room mode they describe the meeting in progress, and are empty while the room is free.

Field	Content
Title	The title of the event.
Description	Its description.
Start / End	Start and end of the event, in the timezone of its branch. Each is available as a full date, or as separate day, month, year, time_12, and time_24 values.
Speaker	The speaker entered on the event.
Company	The company entered on the event.
Organizer	Name and surname of the user who created the event.
Attendees	The list of attendee addresses.
Attendees_name	The same attendees by name, one per line.
Media	The image or video attached to the event.

Room status

Only in meeting room mode.

Field	Content
Room Status Text	Room Free Msg or Room Busy Msg, whichever applies right now.

🙋🏼 Common Issues

The Points of Interests list is empty

It only holds locations flagged as bookable. Open Agenda, Locations, edit the location, and tick This POI is bookable. Locations that belong to a branch your user cannot see are also left out.

The editor preview shows a Dummy Event

That is intentional. When the selected locations have no events in the chosen window, the project editor injects one sample event so you can lay the sublayers out against something visible. It never reaches a screen; the published layer shows nothing until a real event exists.

The screen still shows a meeting that has been cancelled

The device keeps the event data it downloaded until Refresh time has elapsed, so a change made a minute ago is not on screen yet. Lower Refresh time, or publish the project again to force the device to reload. In meeting room mode the free or busy status is recalculated every minute from the data already downloaded, but the events themselves still arrive on the refresh cycle.

The room panel is blank apart from the status message

That is the free state. Every event field, and every location field with it, is empty while no meeting is running. Type the room name into a plain Text sublayer so the panel still identifies itself.

The room and the time appear but there is no arrow

Direction arrows are configured on the device, not on the layer. Open the device, go to the Device Position tab, and set a direction for that location under Points of interest. If directions are set and arrows are still missing, check the filenames in the direction icon set.

Only part of my events appear

Check Validity first, since day covers only today and is the default. Then check the layout, because Rows by Columns sets how many entries fit on one page, and Page Dur has to be short enough for the screen to cycle through every page while someone is watching.