Cards: Single-Room Scheduling with Microsoft Office 365

Share on print
Share on facebook
Share on linkedin
Share on whatsapp
Share on email

This article provides the instructions to create and configure a Room Booking card with Microsoft Office 365 provider settings. The Room Booking card is ideal for single room scheduling.

Once the Room Booking card is configured and displayed on a tablet or device outside the respective meeting space, the following features will be available to you:

  • Room Information: The room name and status indicating if the room is available, offline, or occupied is displayed.
  • Meeting Information: Details of the current meeting and upcoming meetings for the day.
  • Booking Functions:
    • Book Now – Ability to book 30 minutes, 1 hour, or 1.5 hours from the current time, based on room availability.
    • Book In Advance – Book future time slots (on the same day only) or up to 7 days in advance, based on room availability.
    • Check In – Option to check in to a meeting from 10 minutes before until 10 minutes after the start of the meeting.
    • Extend Meeting – Extend the current meeting by 30 minutes, 1 hour, or 1.5 hours.
    • End Meeting – End the current meeting, and make the room available.
  • Support for Occupancy Sensor – Enables integration with 3rd party occupancy sensors connected to an Appspace App device to manage the room status.
    Important
    To utilize this feature, please contact Appspace Support, as this feature requires custom integrations that leverages on Appspace APIs, while some sensors may also require device tasks in order to function correctly. 
Note
If you are an end-user looking for information on booking a scheduled meeting via our App or your calendar, please refer to Booking Single Meeting Room.

The Room Booking card is an Appspace supported card, which is officially created and periodically updated by Appspace with new templates and features.

Important

In order to use the room booking and scheduling service with our Room Booking card, you must do the following:

Prerequisite

  • Ensure your device is compatible. Refer to the Supported Appspace Cards article.  
  • Account Owner, Publisher, or Author role in Appspace to create and configure the Room Booking card.
  • An Office 365 Administrator role to configure Office 365 booking accounts.
  • It is recommended that the device clock is set to automatically retrieve time from a Network Time Protocol (NTP) server with the correct time zone, in order for it to sync correctly with the calendar provider.
    Appspace Cloud servers retrieve time from an NTP server by default. If an Appspace on-prem server is used, configure the on-prem server to retrieve time from an NTP server with the correct time zone.
  • If using an Appspace on-prem deployment, configure the on-prem server and network to allow constant access to https://*.cloud.appspace.com and its subdomains, to ensure each device is able to attain new authorization tokens from the calendar provider on a regular basis via Appspace API services.

Create Booking Account and Configure Resources

Important
The instructions in this section must be completed first by an Office 365 Administrator prior to configuring a Room Booking card in the Appspace console.
Please select one of the following options and follow the instructions:

Create Room Booking Card

Important
You will need Account Owner, Publisher, or Editor (author) privileges to perform the steps below.
To create and configure the Room Booking card, please follow the instructions below:

  1. Log in to your Appspace console.
  2. To create this card, select one of the following options:
    • Click +Quick Action from the Appspace menu bar on the top right, and select Create Card.
    • Click Library from the ☰ Appspace menu. Select the library or folder you wish to create the content in, and click +CREATE.
    • To create and add the card directly to an existing channel, refer to Add Content to Playlist Channels.
  3. Select Workplace from the All Templates side panel, and click Room Booking.
    Important
    If you are unable to locate the card content, you may use either the Search bar, the Order by, Filter icon, or FILTER BY Content Category or Tags, to further narrow down the content that you are looking for.
  4. Enter the Title of the content. The Title is a mandatory field, and will also act as the filename for the content.
  5. In the Card preview section, you may authenticate the card by clicking the Connect button for Office 365. 
    If you would like to authenticate later, click the Preview card in demo mode link in the preview window, and proceed to step 8 to configure the booking options and styling of the Room Booking card.

    Note
    The demo mode on cards, allows users to experience the design and functionality of the card, prior to configuring the calendar provider. This includes displaying various booking statuses, and performing bookings on the card itself.
  6. Select the authentication type depending on your booking account.
  7. Enter your booking account credentials (created earlier) to authenticate the Room Booking card.
    Note
    Please contact your Microsoft O365 Administrator for credentials. Some large organizations may have one account for each room.
    If you encounter authentication issues while setting up the Office 365 integration with user privileges on Azure, please ensure the Azure Admin Consent Requests has been configured by following the steps in the Configure the admin consent workflow (preview) article: https://docs.microsoft.com/en-us/azure/active-directory/manage-apps/configure-admin-consent-workflow
  8. Once authentication is successful, you may assign a room to the card by selecting one of the two options provided:
    • Automatic room assignment from a player property – This option allows you to use the same card (with the defined configuration and branding themes) for multiple rooms.
      • You must then add a device property (card.room.roomid = <custom resource id>) to each device and ensure it points to the desired meeting room (One specific tablet for each meeting room.)
        Example:
        • Device property for Meeting Room 1 & Device 1: card.room.roomid = 47563454656
        • Device property for Meeting Room 2 & Device 2: card.room.roomid = 34547409516
      • Click here for instructions to Add a device property. You will need Location Admin or Account Owner privileges to add a property.
    • Manually selecting by room nameThis option allows you to assign one room directly to this card. If you have 10 rooms, you must create 10 cards for each room.
      • The default manual selection option text would be Manually selecting by room id with a Search by name link shown below, which upon clicking prompts you to enter a user email address (booking account email address OR userPrincipalName) to retrieve the resources list. If an email address has been entered previously, the manual selection option text would read Manually selecting by room name instead.
        Note
        If this manual option is selected, while the device is also configured with a player property for automatic room assignment, then the manual assignment of the room takes precedence.
        Due to a Microsoft Graph API limitation, only the first 100 rooms shall be retrieved and displayed. If you have more than 200 rooms within your organization, we recommend using the Automatic room assignment from a player property option to select your room, if the room is not displayed when running the search.
  9. Click Finish.
  10. Proceed to continue with the instructions based on the room assignment above:

Configure Automatic Room Assignment

  1. In the Edit tab:
    • In the Booking Options section: click the arrow to expand.
      • Ensure the Enable device bookings checkbox is checked (default), and check the checkbox of the following features you wish to display or enable.
        • Allow naming of meetings. (default)
        • Allow users to end meetings. (default)
        • Allow users to extend meetings. (default)
        • Enable advanced booking. (default)
        • Enable time slot availability on front page.
        • Enable meeting check-in.
        • Allow 7 days advance booking.
          Important
          Unchecking the Enable Bookings checkbox hides the booking options. If the Room Booking card detects that the service provider has restricted viewing access to a meeting room/resource or the Enable Bookings option has been disabled, the card will automatically disable the interactivity and booking functions for that room on the app (Appspace App), and the “Interactivity has been disabled for read-only room” message is displayed. However, meeting information will still be displayed.
    • In the Design section: click the arrow to expand.
      • Upload a Logo.
      • Customize the Background color or media, Background Mask Color, Available Status Color, or Occupied Status Color.

        Note
        You may set an image or a video as the background media.
    • In the Configuration section: click the arrow to expand.
      • Configure the card Styling features to be displayed by checking its checkbox.

        • Show organizer’s name (default) – displays the organizer’s name (default)
        • Show meeting name (default) – displays the meeting name.
        • Show upcoming meetings (default) – display upcoming meetings of the day.
        • Show clock (default) – displays the date and time.
        • 24 hour clock – display the time in 24 hour format.
      • Select the Layout from the drop-down menu: 

        • Split Background and Status Color
        • Full Status Color
        • Full Background
    • In the Room Details section: click the arrow to expand.
      • Configure the room details to be displayed by checking its checkbox.
        • Show room number (default)
        • Show notes (default)
      • Click the Add Data button to enter or upload the room details in the Room Mapping section.
        • Manually enter the Room ID, Room Name, Room Number, Room Notes, and Room Label in the table.
        • Upload a .xlsx file containing the room  details. The table headers in the file must correspond to the headers in the card editor table shown, i.e.
        • Room ID, Room Name, Room Number, Room Notes, and Room Label.
           

      • Additionally, you may manually add the Room Facilities and Room Capacity via the following device properties (added individually for each registered device):
        Name Device Property Value
        Room Facilities card.room.facilities Ethernet Ethernet
        Phone Phone
        Projector Projector
        Video Conference VideoConference
        White Board WhiteBoard
        Wifi WiFi
        Screen Share ScreenShare
        Webex Webex
        MTR Dual Display mtrDualDisplay
        USB C Dock usbcDock
        Flexible Furniture flexibleFurniture
        Hearing Assisted hearingAssisted
        Room Capacity card.room.capacity Numeric characters
        • To display more than one room facility, add the values separated by a comma.
          Example: card.room.facilities: Ethernet, Phone, Projector
        • The Room Booking card will display the room capacity from 1 to 100, anything more than 100 would be displayed as >100.
          Example: card.room.capacity: 20
        • Click here for instructions to Add a device property. You will need Location Admin or Account Owner privileges to add a property.
    • In the Occupancy Sensor Settings section: click the arrow to expand.
      • Click the Enable occupancy sensor checkbox to proceed with the following features you wish to display or enable.

        Important
        To utilize this feature, please contact Appspace Support, as this feature requires custom integrations that leverages on Appspace APIs, while some sensors may also require device tasks in order to function correctly.
        • Automatically check-in based on occupancy – Enter the duration after the room is occupied. Defaulted at 3 mins.
        • Automatically create a new meeting based on occupancy – Enter the duration after the room is occupied. Defaulted at 3 mins.
        • Automatically end meetings based on occupancy – Enter the duration after the room is vacant. Defaulted at 3 mins.
        • Automatically extend meetings based on occupancy – Enter the duration before the current meeting ends. Defaulted at 3 mins.
  2. The Card preview section on the right displays how the Room Booking card looks like when displayed. You may click the Gear icon to preview the Occupied or Offline status of the card, Change Room, or Log Out from the authenticated card.
     
     
    Note
    The booking status of the meeting room is only a preview, and is not indicative of the real status in this preview. If the card is in demo mode, clicking the Gear icon will display the Authenticate Account option, which will allow you to authenticate the card with your desired calendar provider.
  3. In the Article tab: This section may be skipped.
    • Include an Article or Caption to accompany the content item when being displayed on mobile apps, tablets, and other social collaboration apps.
    • Enter a Referral Link to link more information to the content.
  4. In the Schedule tab: This section may be skipped.
  5. In the Settings tab: This section may be skipped.
    • The Name field will be auto-populated to match the Title of the content which will also act as the filename for the content. This is a mandatory field.
    • Enter any relevant Tags for the content. (Optional)
    • Select a folder for the content in the Library Location drop-down menu to change the default folder location.
    • Upload an image to be used as the Thumbnail for the content.
      Important
      Please do not set an expiry date for the Room Booking card.
  6. Once done, click SAVE.

Configure Manual Room Assignment

  1. In the Edit tab:
    • In the Booking Options section: click the arrow to expand.
      • Ensure the Enable device bookings checkbox is checked (default), and check the checkbox of the following features you wish to display or enable.
        • Allow naming of meetings. (default)
        • Allow users to end meetings. (default)
        • Allow users to extend meetings. (default)
        • Enable advanced booking. (default)
        • Enable time slot availability on front page.
        • Enable meeting check-in.
        • Allow 7 days advance booking.
          Important
          Unchecking the Enable Bookings checkbox hides the booking options. If the Room Booking card detects that the service provider has restricted viewing access to a meeting room/resource or the Enable Bookings option has been disabled, the card will automatically disable the interactivity and booking functions for that room on the app (Appspace App), and the “Interactivity has been disabled for read-only room” message is displayed. However, meeting information will still be displayed.
    • In the Design section: click the arrow to expand.
      • Upload a Logo.
      • Customize the Background color or media, Background Mask Color, Available Status Color, or Occupied Status Color.

        Note
        You may set an image or a video as the background media.
    • In the Configuration section: click the arrow to expand.
      • Configure the card Styling features to be displayed by checking its checkbox.

        • Show organizer’s name (default) – displays the organizer’s name (default)
        • Show meeting name (default) – displays the meeting name.
        • Show upcoming meetings (default) – display upcoming meetings of the day.
        • Show clock (default) – displays the date and time.
        • 24 hour clock – display the time in 24 hour format.
      • Select the Layout from the drop-down menu: 

        • Split Background and Status Color
        • Full Status Color
        • Full Background
    • In the Room Details section: click the arrow to expand.
      • Configure the room details to be displayed by checking its checkbox.
        • Show room number (default)
        • Show notes (default)
      • Enter the following room details to add or overwrite existing room information:
        • Room Name
        • Room Label
        • Room Number
        • Room Notes
      • Additionally, you may manually add the Room Name, Room Lable, Room Number, Room Notes, Room Facilities and Room Capacity via the following device properties (added individually for each registered device):
        Name Device Property Value
        Room Name card.room.roomname Alphanumeric and special characters
        Room Label card.room.label.room Alphanumeric and special characters
        Room Number card.room.roomnumber Alphanumeric and special characters
        Room Notes card.room.roomnotes Alphanumeric and special characters
        Room Facilities card.room.facilities Ethernet
        Phone
        Projector
        VideoConference
        WhiteBoard
        WiFi
        ScreenShare
        Room Capacity card.room.capacity Numeric characters
        • To display more than one room facility, add the values separated by a comma.
          Example: card.room.facilities: Ethernet, Phone, Projector
        • The Room Booking card will display the room capacity from 1 to 100, anything more than 100 would be displayed as >100.
          Example: card.room.capacity: 20
        • Click here for instructions to Add a device property. You will need Location Admin or Account Owner privileges to add a property.
    • In the Occupancy Sensor Settings section: click the arrow to expand.
      • Click the Enable occupancy sensor checkbox to proceed with the following features you wish to display or enable.

        Important
        To utilize this feature, please contact Appspace Support, as this feature requires custom integrations that leverages on Appspace APIs, while some sensors may also require device tasks in order to function correctly.
        • Automatically check-in based on occupancy – Enter the duration after the room is occupied. Defaulted at 3 mins.
        • Automatically create a new meeting based on occupancy – Enter the duration after the room is occupied. Defaulted at 3 mins.
        • Automatically end meetings based on occupancy – Enter the duration after the room is vacant. Defaulted at 3 mins.
        • Automatically extend meetings based on occupancy – Enter the duration before the current meeting ends. Defaulted at 3 mins.
  2. The Card preview section on the right displays how the Room Booking card looks like when displayed. You may click the Gear icon to preview the Occupied or Offline status of the card, Change Room, or Log Out from the authenticated card.
     
     
    Note
    The booking status of the meeting room is only a preview, and is not indicative of the real status in this preview. If the card is in demo mode, clicking the Gear icon will display the Authenticate Account option, which will allow you to authenticate the card with your desired calendar provider.
  3. In the Article tab: This section may be skipped.
    • Include an Article or Caption to accompany the content item when being displayed on mobile apps, tablets, and other social collaboration apps.
    • Enter a Referral Link to link more information to the content.
  4. In the Schedule tab: This section may be skipped.
  5. In the Settings tab: This section may be skipped.
    • The Name field will be auto-populated to match the Title of the content which will also act as the filename for the content. This is a mandatory field.
    • Enter any relevant Tags for the content. (Optional)
    • Select a folder for the content in the Library Location drop-down menu to change the default folder location.
    • Upload an image to be used as the Thumbnail for the content.
      Important
      Please do not set an expiry date for the Room Booking card.
  6. Once done, click SAVE.

Create Playlist Channel and Add Room Booking Card

Important
You will need Account Owner, or Publisher privileges to perform the steps below.
  1. Click the Quick Actions menu, and select Create Channel to create a playlist channel. Enter in the Playlist channel name.
  2. Click ADD CONTENT, and select the Room Booking card from the Library. Click Add once done.
  3. We recommend setting the Content Duration of the card to 30-minute intervals, (current default is 8 seconds) so that the card does not refresh while you are updating the booking details.
  4. Click the Apply button to save the settings.

Assign Playlist Channel to a Registered Device

Important
You will need Account Owner or Location Admin privileges to perform the steps below.
  1. Register your device as per the Register a device article.
  2. Go to the Appspace menu, and select Devices.
  3. Select the name link of the device that will be used for the meeting room.
  4. In the Device Information page, click the Settings tab, and select Admin assigns a single channel option from the Channel selection mode drop-down menu.
  5. Navigate back to the Overview tab, and click the Select channel button, and select the playlist channel with the Room Booking card, created earlier.
  6. Click Save. The meeting room booking service can now be viewed on the device. 

Book Meeting Room via a Calendar or the Appspace App

For booking instructions, please see Booking Single Meeting Rooms.

Edit Room Booking Card

The instructions below show you how to edit a Room Booking card.

  1. Log in to the Appspace console.
  2. Click Library from the ☰ Appspace menu, and select a library or folder containing the content you wish to edit.
  3. Select and click the Room Booking card to edit, and select the desired tab to edit or view.
    • In the Edit, Article, and Settings tabs:
      • You may edit the content the same way as it was configured. For detailed instructions on how to do this, please refer to the Create Room Booking Card section above.
    • In the Preview tab:
      • Preview how the content is displayed on your device.
    • In the Channels tab:
    • In the Analytics tab:
      • View the individual content analytics in this tab. For more information, please refer to the Individual Content Analytics section of the Analytics article.
  4. Once done, click SAVE.