Supports Standards
This manufacturer's devices support standards for receiving alarms.
Standards: Requirements
Version
Validated against Irisity IRIS+ version 2024.2
License
N/A - No additional manufacturer license required
Network Requirements
N/A - Cloud to Cloud standards based integration. No additional network requirements required
Permission Requirements
N/A - No Irisity user details are used in SureView
Standards: Supported Features
- Alarms (via email)
- Attached Alarm Snapshot
- Temporary Alarm Video URL (valid for 25 minutes only) - requires Irisity Support to add to URL email alarm body on initial setup.
Standards: Alarm Configuration
In SureView - First Time Configuration
Create the Irisity Decoder
Please contact SureView Support for assistance in creating the decoder for the first time.
- Login to SureView and navigate to the "Alarms" setup screen
- Click on the "Alarm Decoder" Tab
- If the "Irisity" decoder does not already exist:
Click "Add Alarm Decoder" and complete the following values
Title: Irisity
"sensorId":\s*"(?<rc>\d+)"
Event Regex "behaviorType":\s*"(?<ec>[^"]+)"
Extra Text Regex "objectType":\s*"(?<et>[^"]+)"
URL Regex "EventClipUri": "(?<url>[^\s"]+)\s?"
Default Area: Select your top level area
(Your SureView Organisation Account Name)
This is where alarms will be sent if they don't match to an individual Irisity alarm pointDefault Action Plan: Select your preferred Action Plan or leave blank Default Grouping: Select your preferred Default Grouping
Recommended "By Area"Default Priority Enter your preferred default priority
Recommended: 100
Add the Irisity Event Types
The "Event Types" are based on the Iristy "Behaviours" that can be matched during an analytic alarm.
- Login to SureView and navigate to the "Alarms" setup screen
- Click on the "Alarm Decoder" Tab
- Edit the "SureView Standard Decoder"
- If the following Event Types don't already exist - Add them
Note: The Event Type Name, Default Priority and Default Grouping can be customised to your requirements but the "Event Code" must match exactly (including case) for compatibility with Irisity
Event Type Name Event Code Default Priority Default Grouping Anomaly Anomaly 100 Inherit Asset protection Asset protection 100 Inherit Counterflow traffic Counterflow traffic 100 Inherit Crossing a line Crossing a line 100 Inherit Crowd density Crowd density 100 Inherit Grouping Grouping 100 Inherit Moving an area Moving an area 100 Inherit Slip and fall Slip and fall 500 Inherit Smoke and fire detection Smoke and fire detection 1000 Inherit Stopped vehicle Stopped vehicle 100 Inherit Unattended object Unattended object 100 Inherit
System Identifier
Note down the "System Identifier" for your Irisity decode (shown in the "Alarm Decoder" tab of Alarm Setup). You will use this in Irisity for configuring the email alarms.
Example
System Identifier: 0rcs2ceaic
The email address to use in Irisity would then be be either
0rcs2ceaic@eu.sureviewops.com
or
0rcs2ceaic@us.sureviewops.com
depending on your SureView Response region.
Important: Make sure to use the @eu.sureviewops.com or @us.sureviewops.com domain that matches your SureView Response region / web address
In Irisity - First Time Configuration - Add Integration Target
- Navigate to portal.irisity.io and login
- Navigate to the settings tab on the upper level of the UI
- Select integration targets and add new
- Change type to email and give the integration a name
In Irisity - First Time Configuration - Set Targets to Folders
- Navigate to portal.irisity.io and login
- Navigate to the administrator tab
- Select the folder(s) which you want to enable the integration on.
- Navigate to the integrations tab and add new
- Select detection event, target (email) and your object type, behaviour type and severity. (Leaving the object, behaviour type and severity as it is will send events for any rules you have setup in IRIS+)
- Input the subject as "Irisity IRIS+" (or any other text you want to be displayed to the Operator on alarm)
- Set the recipient as the sureview email address you generated in the previous steps (based on the Sureview "System Identifier". It should be an address similar to
0rcs2ceaic@eu.sureviewops.com
or
0rcs2ceaic@us.sureviewops.com
depending on your SureView Response region. - By default the Irisity IRIS+ email alarms do not include the "Temporary Alarm Video URL". Reach out to Irisity for assistance in configuring the SureView Alarming content to include the URL in the body of the email. Once done once this content can be copied for any additional folders that need to be configured.
In Irisity IRIS+ - Finding the Sensor IDs to map to SureView Alarms
SureView matches the incoming alarms based on the "Sensor ID" follow these steps to find the Camera's Sensor IDs
- Navigate to portal.irisity.io and login
- Select your camera and navigate to it’s settings tab
- The sensor ID can be found here next to the camera status box.
- Copy the ID for use in SureView
In SureView - Individual Alarm Setup
See Email Alarm Setup support page for more details
Follow these steps for each individual alarm point / Irisity IRIS+ camera that you want to add to SureView.
Note: If an incoming Irisity IRIS+ alarm does not match any known alarm points it will automatically trigger in the Default Area that was selected during the Alarm Decoder setup (this is normally your top level area)
- Go to the Alarm Setup screen and make sure the Smtp Alarms tab is selected
- Click the Add Alarm button
- Configure your alarm point with the following details (other fields can be left blank)
- Alarm Name e.g. "Stairwell", "Front Door", "Main Entrance" etc
- Area - The Area/Site the alarm point should be associated with
- Action Plan - If you have an Action Plan for your operators to follow such select it, otherwise leave this blank
- Alarm Decoder - Select your Irisity alarm decoder
- Response Code - Enter the "Sensor ID" that matches the camera/alarm you're adding - found in the Irisity IRIS+ Settings screen.
- Priority - How important the alarm is (higher the number, the more important the alarm). Normal alarms are normally set to priory 100. If left blank the alarm will use the default priority based on the type of alarm
- Grouping - Select "By Area"
- Auto Handle - Select "No"
- Press Add
Example Alarm
Irisity IRIS+ alarms come into SureView with an attached snapshot (including bounding box) which will be shown in Media Matrix plus a temporary URL that can be clicked to load the alarm video.
The temporary video URL will expire a 25 minutes after the alarm was triggered. If the link has expired the below error message will be displayed if the user clicks the link
Code: 10011, token expired
Raw Email Text Example
Below is an example of email text that is sent to SureView for decoding. This is documented for technical reference for advanced users want or may want to adjust the Iris Regular Expression decoders to adapt the incoming alarm.
{ "id": "24ff7560-8f5b-45d0-b263-3ec35f7444d6", "accountId": "211941842", "sensorId": "1561491135872", "externalSensorId": "Concourse E S", "ruleId": "8562143456780124422", "externalRuleId": "", "eventTime": "1719400841461", "description": "", "objectType": "People", "behaviorType": "Grouping", "status": "1", "severity": "4", "EventClipUri": "https://api.innovi.io/v1/eventClip?imageToken=awwB5BqEvndf63f63v8SyxABnjrM1T9lLudfFtrulRiuvcyfdOB17jwUkt5nx8EnpLCk%2Bv4K4h12yUkVrMLqY%2FqbO%2BGeUZAmkAUaBiwZSGqsAdIZfFDa0fCEI%" }
Comments
0 commentsPlease sign in to leave a comment.