N4 Alarms to Monday.com Service


N4 Alarms to Monday.com Service

Overview


N4 Alarms to Monday.com instantly notifies of new station alarms. Monday.com is a Work Operating System (Work OS) that powers teams to run projects and workflows via boards. A board is a place to organize everything you need to do - a project, a to-do list, CRM, schedule... Boards create transparency within the company, all users in the account can see and use these boards.

Setup:

1. Copy the wLicensingModule-rt.jar and alarmsToMonday-rt.jar module to your modules directory. Restart station AND Workbench. Open Workbench and drag the service to your stations services section.

monday.com

2. Sign up for Monday.com (they offer a free trial).

3. Board Setup.
Here is how we setup our board for alarm data to come through.

Monday.com board

Columns Explained:

Item Title - Using example above of 'AHU Normal'. This is what you set in the high/low limit text field. E.g. High Limit %alarmData.alarmValue%.
Status - status of the alarm. Normal, Offnormal, Fault, and Alert. On Monday.com this column type is a status.
Site Name - This comes from the alarm source. On Monday.com this column type is a text.
Date - timestamp of alarm. On Monday.com this column type is Date.
Location - this is not yet support by Monday.com API V2. However it will be supported in the near future. This is useful as it can map the items on a map like google maps.


4. API Key
With your board all setup we now need to copy Monday.com's api key to the module services section. On Monday.com click on Admin -> API.

n4 alarms

Copy the key into the service property sheet.
Monady.com service

If you're on a restricted network make sure the station can get out to https://www.monday.com. You may need to add an outbound firewall rule.

5. Board Id
Grab the board ID from the monday.com webpage address bar and place this in the service property sheet.

N4 alarm board

6. Get Groups and Columns Action
From the service, invoke the Get Groups and Columns action. This will get all group and column information from Monday.com. We will need the information to setup the alarm data column mappings.

n4 alarm columns

7. Set Column Id's
Because Monday.com doesn't allow us to use the column names specified on their service, we have to set the unique id's from the data we brought in from step 6. On the service property sheet, set the appropriate column id's.

alarm columns

8. Setup Alarm subscriptions and filters.
Each group in your board can filter certain alarms. Here is an example:

Alarm subscription
->If you make changes here, invoke the 'resubscribe' action on the Group.

Alarm Class Subscriptions:

This is a comma separated field of absolute ords pointing to the alarm Classes you want to get notification for.
By default the defaultAlarmClass is subscribed. This can be removed.
Add additional alarm classes as required. E.g.
station:|slot:/Services/AlarmService/defaultAlarmClass,station:|slot:/Services/AlarmService/AnotherAlarmClass

Alarm Class Filters:

Use the alarm class filters property, on the service to only send specific alarms classes to messenger. Leave empty for all alarm classes to be sent.

blank - all alarm classes sent

Comma separated list examples:
defaultAlarmClass - only alarms with defaultAlarmClass will be sent
defaultAlarmClass,S2AlarmClass - both alarm classes will be sent

You're all setup now. Trigger some alarms to see it in action. Any errors are in the application directory and on the service message field.

Demo

(also on youtube) N4 Alarms to Monday.com Service

You May Also Like

Advanced Alarm Table

N4 View Builder

tridium bms system

N4 Alarms to Slack

alarm messenger

back to more widgets...