Difficulty: novice
Content
Learning Objectives
After reading this article, you’ll be able to:
Understand how a Brain Rule works
Define which Brain Rules fit your use-case
What is the Brain?
The Workplace Brain enables you to define conditions (for example "IF temperature is higher than 25°C") and actions (for example: "Send an e-mail to John Doe") which you can link together. If a condition is met, an action is triggered.
The Brain does not have a user interface. This means you cannot login to a Workplace touch point and start creating conditions and actions. For now, only a fixed set of rules is available (you find that list below). Reach out to your Spacewell Account Manager to have a Brain Rule implemented.
If you are a creative person and want to create rules which are in the same trend as the rules below, but which are not exactly the same: we also have a solution for you. Please use the template below and send send in a product request via your Spacewell Account Manager.
To see which Brain Rules are active in your environment, see Brain Rules visualization
How does the Brain work?
Some people might say the Workplace Brain is a simple IFTTT engine (IF-This-Then-That). That's OK if it helps you understanding the brain basics, it's however not exactly what The Brain is all about. The strength of the Workplace brain is that it continuously scans all incoming (streaming) data from any data source that flows into the Workplace Platform. That means it scans all sensor data & BMS data, but it also scans the IWMS data available in Workplace. Thus, the brain is not a simple IFTTT engine: it's a complex event processing tool.
For die hard fans: in the Workplace architecture, The Brain is identified as "Backchat" and exists out of the Drools Engine, the AKKA concurrent application framework and the actual self-created Backchat architecture code. More detailed info can be found here: /wiki/spaces/SUM/pages/492052
Brain rules deep-links : confirmation by clicking button instead of just clicking the deep-link
In most cases, the Brain can send notifications (via e-mail or SMS) that include a deep-link. There are two possible actions that can be triggered by clicking a deep-link from a notification generated by the brain:
Request to keep a reservation
Request to cancel a reservation
Standard Brain rules
Decide which brain rules you want to implement, depending on your use case and situation (kind of devices installed).
Possible Brain rules for locations where occupancy or utilization sensors are installed:
Remember that Brain Rules are not compatible with Exchange that have a room-centric approach, as reservations can only be changed/canceled in the system they are created in (e.g. either in Outlook or in Workplace). So a reservation created via Outlook, cannot be changed in any way in a Spacewell Workplace touchpoint (hence also not by the Brain Rule).
For more information see High level features, prerequisites and current limitations
Possible Brain rule for locations where door counter sensors are installed:
Possible Brain rules for Status lights :
* Status light changes that are steered by a brain rule might take time to visualize on the devices. Latency up to 15min might be experienced.
Possible Brain rule when no devices are installed:
Custom brain rule
If you are a creative person and want to create rules which are in the same trend as the rules above, but which are not exactly the same; we also have a solution for you. Please use the template below and send send in a product request via your Spacewell Account Manager. Budget and implementation timing will vary based on your request.
Rule description
Describe your rule in words.
Make sure you think about all cases that occur.
Only describe rules & triggers for events that are currently already captured in Workplace (if we don't have the info in the system, we can't make a rule).
Rule exceptions
When will the rule not work?
Components
Define the rule variables and their contents
Requirements
What is needed from the system (configuration) to make this happen?
Verify which Brain Rules are set up for your tenant through Brain Rules visualization
Quality Assurance
After implementing 1 or more Brain Rules for your environment, make sure to test if everything is working as it should. Visit page Quality Assurance Occupancy and Utilization Sensor for tips & tricks on how to test this.
https://spacewell.atlassian.net/wiki/pages/resumedraft.action?draftId=492317 take action based on the sensor values from the sensor that is linked to the same location, so to do Quality Assurance on the sensor installation, please see above.
To do Quality Assurance on the different https://spacewell.atlassian.net/wiki/pages/resumedraft.action?draftId=492317 configured for the tenant, create some test scenarios:
Auto release Reservation when no occupancy is detected (and send a message) :
Select a location for which the above Brain Rule is configured
Make sure that
the motion sensor for that location cannot be triggered in the upcoming time (best practice is to close the door in case of a closed meeting room, and keep an eye on the door to make sure a colleague does not go in/triggers the sensor)
if there is a Meeting Room Display configured to this location, make sure the Auto-Release functionality has been disabled
Make a reservation at this time for the selected location on any of the Workplace touch points, with a user that is configured with as per the Brain Rule requirements (for example phone number and/or e-mail address of the reservation responsible needs to be configured)
If the Brain Rule is working, you should get a message + the location will be cancelled (reservation object receives flag "cancelled")
Auto-end Reservation when no occupancy is detected (and send a message) :
Select a location for which the above Brain Rule is configured
Make a reservation for the selected location on any of the Workplace touch points, with a user that is configured with as per the Brain Rule requirements (for example phone number and/or e-mail address of the reservation responsible needs to be configured)
Enter the location at the meeting start time and make sure the motion sensor is triggered. After some time, go away from the location. Make sure the sensor cannot be triggered (best practice is to close the door in case of a closed meeting room, and keep an eye on the door to make sure no-one goes in/triggers the sensor)
If the Brain Rule is working, you should get a message + the location should be freed up/end (reservation end time is changed)
Send a message when utilization exceeds maximum capacity :
Select a location for which the above Brain Rule is configured
Make sure that
utilization is measured correctly in this room/location (see Quality Assurance on motion & headcount sensors)
Setting the capacity and thresholds of spaces is configured in Workplace back-end Studio
Make a reservation for the selected room/location on any of the touch points
Enter the location with more people than are allowed as per the Setting the capacity and thresholds of spaces configuration
If the Brain Rule is working, dedicated (group of) user(s)) (as defined in the Brain Rule) should get a message
Send a message to confirm an upcoming meeting (and cancel if ignored) :
Select a location for which the above Brain Rule is configured
Make a reservation for the near future for the selected location on any of the touch points, with a user that is configured with as per the Brain Rule requirements (for example phone number and/or e-mail address of the reservation responsible needs to be configured)
If the Brain Rule is working, you should get a message
upon confirmation, the reservation continues to exist
upon cancellation, the location should be cancelled (reservation object receives flag "cancelled")
Search