PDK & DW Spectrum Integration Documentation
The reaction to an Event is an Action. Each Action has its own parameters. The common parameters Interval of action / Instant and Fixed duration are described in Interval of action in the next paragraph.
Interval of action – Check this box to limit the frequency with which an action will occur in response to an event. Enter an integer value (1 - 999) in the No more than once per field, and select a corresponding time increment (sec, min, hrs, days). This feature is useful, for example, with an action like show notification where the triggering event may be continuous but it is only necessary to be notified periodically.
Creates a Bookmark in the archive of one or more cameras when an event occurs.
NOTE: Recording must be enabled on the selected cameras for Bookmarks to be saved. A Bookmark is automatically named with this syntax: <Event> on <Device>
at – Camera(s) for which Bookmarks will be recorded. To specify cameras see Selection Lists in Event Rules. At least one device must be selected.
Fixed duration – The duration of the Bookmark. Applies to continuous events only (those with Starts and Stops attributes). It can be unchecked for continuous events such as motion on camera, an input signal on device, etc. If not checked, the Bookmark will continue until the event ends.
Pre-Recording – If checked, used to specify an amount of time to include in the Bookmark before the event occurs.
Post-Recording – If checked, used to specify an amount of time to include in the Bookmark after the event occurs.
Tags – Optional descriptors that can be added to help identify and search for Bookmarks.
May be caused by
Why Action may work incorrectly
Generates output on a device when an event occurs, starts, or stops.
IMPORTANT: Output must be supported on the selected devices.
at – Device(s) on which output will be triggered. To specify devices see Selection Lists in Event Rules. At least one device must be selected.
NOTE: A warning notification will open if one or more of the selected devices does not have an output relay. These devices will be highlighted in red.
Output ID – The I/O Module port ID to route signal to.
May be caused by
Why Action may work incorrectly
Starts recording on selected cameras when the event occurs.
at – Devices to record. To specify cameras see Selection Lists in Event Rules. At least one device must be selected.
IMPORTANT: At least one camera must be selected, and recording must be enabled on the selected cameras for this rule to be functional.
Interval of action – Check this option to aggregate the number of times the action will be triggered. For No more than once per a given amount of time, or instance, enter an integer value (1 - 999) and select a time interval from the menu (seconds, minutes, hours, or days). If unchecked, the action is instant and will occur whenever the event is triggered.
Quality – Select the desired recording parameter for these options: Lowest, Low, Medium, High, Best.
FPS – Enter a value for frames per second (up to 30). The camera's maximum FPS will be used if the FPS value entered exceeds the camera's capability.
Select one of the following:
Post-recording – For continuous events (those with Starts and Stops attributes), you can enter the number of seconds that recording will continue after the triggering event.
or
Fixed duration – Records for a specified amount of time in seconds when the event occurs.
May be caused by:
Why Action may work incorrectly
A Do HTTP Request is an Action that would be done when creating a rule event in DW Spectrum in order to send a command to PDK io. The Do HTTP Request sends an HTTP request to a targeted external device or system (a floodlight switch, access control trigger, or an alarm system, for example) which can then be used in those devices or systems to trigger additional actions. The request must follow the proper format in order to be read by the receiving device.
This action generates an HTTP GET, POST, PUT, or DELETE request in response to any event triggered in DW Spectrum. Together with the Generic Event, which can receive an HTTP request as an event, a bi-directional API communication can be created between DW Spectrum and PDK io.
For example, a manufacturer has a restricted area with an ACS card reader at the entry point and cameras that monitor the area surrounding the entry point. DW Spectrum has a standard rule to send a notification when abnormal duration motion is detected in the entry area. If someone tampers with the card reader in an unauthorized attempt to enter the restricted area, DW Spectrum triggers one action to notify the surveillance center that motion is detected in the area, and a second HTTP request action to the manufacturer's call center server, which in turn runs a security procedure to activate an alarm and generate a phone call to the factory floor security personnel.
Example
http://123.12.8.1:7001/api.clickandcall.com/http/sendmsg?user=dwspectrumadmin&password=123456&api_id=3612726$MO=1&from15554567890&to=15551234567$text=Visitor+is+outside+front+door.
This example sends an API request to the clickandcall system to send an SMS message to the specified phone number. It could be coupled, for example, with a Generic Event that can trigger a third-party device to unlock the front door. Refer to the example above for use of each of the following parameters.
sendmsg – Sends data to a server at IP Address 123.12.8.1 port 7001
user and password – Credentials required by the receiver to allow the request access to their system
api_id – Required account number with receiving entity
from – Phone number from which the message will be sent
to – Phone number to which the message is sent
text – The message text, in this case, "Visitor is outside front door"
Basic Parameters
Interval of action – Check this option to aggregate the number of times the action will be triggered. For No more than once per a given amount of time, or instance, enter an integer value (1 - 999) and select a time interval from the menu (seconds, minutes, hours, or days). If unchecked, the action is instant and will occur whenever the event is triggered.
HTTP URL – The HTTP link to the external system that will receive the request. It can also contain the request itself.
HTTP content – The body of the HTTP request, if needed
Login and Password – If required by the external system, enter credentials for authentication
Content type – Enter the body of the request. Select from Auto, text/plain, text/html, application/html, application/json, or application/xml format according to the requirements of the receiving system. Auto selects the best format based on your entry.
Authentication type – Level of authentication required (Auto or Basic)
Request type – Type of request (Auto, GET, POST, PUT or DELETE)
Why the Action may work incorrectly
Activates a PTZ (Pan, Tilt, Zoom) Preset on a specific camera (see Saving and Restoring PTZ Positions). PTZ Tours cannot be activated by an event.
IMPORTANT: At least one PTZ position must be defined on the selected camera for this action to be valid.
at – Select one camera on which to activate preset.
Interval of action – Check this option to aggregate the number of times the action will be triggered. For No more than once per a given amount of time, or instance, enter an integer value (1 - 999) and select a time interval from the menu (seconds, minutes, hours, or days). If unchecked, the action is instant and will occur whenever the event is triggered.
PTZ Preset – Choose from the PTZ presets defined for the selected camera. If no presets are configured, the menu will be empty.
May be caused by
Why Action may work incorrectly
Triggers Panic Recording mode when the event occurs. Panic Recording switches recording settings for all cameras to maximum FPS and highest possible quality.
NOTE: If the recording is not enabled for a camera, Panic Recording cannot be activated.
Interval of action – Check this option to aggregate the number of times the action will be triggered. For No more than once per a given amount of time, or instance, enter an integer value (1 - 999) and select a time interval from the menu (seconds, minutes, hours, or days). If unchecked, the action is instant and will occur whenever the event is triggered.
Why Action may work incorrectly
It plays a sound when the event occurs.
at – Device to play the sound on. (The device should support 2-way audio.)
Interval of action – Check this option to aggregate the number of times the action will be triggered. For No more than once per a given amount of time, or instance, enter an integer value (1 - 999) and select a time interval from the menu (seconds, minutes, hours, or days). If unchecked, the action is instant and will occur whenever the event is triggered.
Play to users – If checked, the sound will be played in the client application of the selected users. From the drop-down menu, select a sound from the available options.
IMPORTANT: Either Play to user or a camera for 2-way audio (at) must be enabled for this rule to be valid.
Volume
Test
Manage – Click to open the Notification Sounds dialog where the library of available sounds can be customized by adding, renaming, or deleting sounds.
To add a sound:
May be caused by
Why Action may work incorrectly
It plays a sound repeatedly when an event occurs.
at – Device on which to play the sound. (The device should support 2-way audio.)
Interval of action – Check this option to aggregate the number of times the action will be triggered. For No more than once per a given amount of time, or instance, enter an integer value (1 - 999) and select a time interval from the menu (seconds, minutes, hours, or days). If unchecked, the action is instant and will occur whenever the event is triggered.
Play to users – If checked, the sound will be played in the client application of the selected users. Those users are sent a special notification in the Notification Panel. Note that if the user closes the notification, the sound will stop playing even if the event continues.
From the Sounds drop-down menu, select a sound from the available options.
IMPORTANT: Either Play to user or a camera for two-way audio ("at") must be enabled for this rule to be valid.
Volume
Test
Manage – Click to open the Notification Sounds dialog where you can customize the library of available sounds by adding, renaming, or deleting sounds.
To add a sound:
May be caused by
Why Action may work incorrectly
Sends email to one or more users, or to additional email addresses, when an event occurs. An email server must be configured for DW Spectrum to send emails (see Configuring Mail Server for Email Notifications) and the users must have a valid email address in the DW Spectrum System.
Users the email should be sent to:
Use the Search field to filter names.
Additional Recipients – Additional email addresses to send notifications. Use a semicolon ( ; ) to separate multiple addresses (no spaces).
Interval of action – Check this option to aggregate the number of times the action will be triggered. For No more than once per a given amount of time, or instance, enter an integer value (1 - 999) and select a time interval from the menu (seconds, minutes, hours, or days). If unchecked, the action is instant and will occur whenever the event is triggered.
Global Email Settings... – Click to configure email server parameters.
Why Action may work incorrectly
An email server must be configured for the System to be able to send emails. DW Spectrum can automatically provide server settings for certain email carriers, in which case you can enter just basic information using the simple entry form. If your email carrier is not recognized (warning message: "No preset found. Use 'Advanced' option"), you will need to enter the required settings manually using the Advanced entry form.
Email – Email address to use for outgoing mail
Password – Password for the outgoing email account
System Signature – User-defined System description that will identify the System in outbound emails
Support Signature – Support website for the DW Spectrum installation
Email – Email address to use for outgoing mail
SMTP Server – Email server address
User – Email of person entering the information
Password – Password for user email account
System Signature – User-defined System description that will identify the System in outbound emails
Support Signature – Support website for the DW Spectrum installation
Port – SMTP port. Select Auto, 25, 465, or 587
Connection type – Select Secure connection using TLS, Secure connection using SSL, or Unsecure connection
NOTE: Even when Advanced settings are properly configured and emails are working as desired, the simple entry form may display an error.
Sends a notification to the selected user(s).
Users – Select users who will see the notification.
Interval of action – Check this option to aggregate the number of times the action will be triggered. For No more than once per a given amount of time, or instance, enter an integer value (1 - 999) and select a time interval from the menu (seconds, minutes, hours, or days). If unchecked, the action is instant and will occur whenever the event is triggered.
Force Acknowledgment – Prompts the recipient to acknowledge the notification. When checked, a notification will remain in the Notification Panel until the recipient responds by clicking the Acknowledge button. Hovering over the Acknowledge button opens a thumbnail that shows the device name and timestamp of the event. Clicking the Acknowledge button opens a Bookmark form.
The Name field is pre-populated with an event description but may be edited. A Description is required, Tags are optional.
Click OK.
Why Action may work incorrectly
DW Spectrum provides the ability to dynamically create Alarm Layouts. An Alarm Layout opens certain cameras when a specific event occurs, with a special Alarm title and icon.
For example, a rule can be configured as follows:
If motion occurs on cameras 1 or 2, open cameras 2, 3, and 4 in an Alarm Layout.
Camera(s) to show on Alarm Layout. To specify:
To select all cameras on a specific server, check the corresponding box. To filter search, use the Filter field. Filter criteria are the same as the search criteria. It is possible to drag-and-drop the selected cameras from Resource Tree onto the action's advanced settings form.
Interval of action – Check this option to aggregate the number of times the action will be triggered. For No more than once per a given amount of time, or instance, enter an integer value (1 - 999) and select a time interval from the menu (seconds, minutes, hours, or days). If unchecked, the action is instant and will occur whenever the event is triggered.
Users to show alarm to – It is possible to show the Alarm Layout only to certain users. If several events are configured to show different cameras on Alarm Layout for the same user, the corresponding cameras will be added upon the Event occurrence. If several Events are configured to show different cameras on Alarm Layout for different users, each user will see the separate Alarm Layout.
Force Alarm Layout opening – If checked, when Event occurs, Alarm Layout will show up immediately. If not, the Alarm Layout will be created, but the user will still be watching the current layout and will be able to switch to Alarm Layout.
Also show source camera – Available only if Event is bound to cameras. If checked, when Event occurs Alarm Layout will contain the camera that created the Event.
For example, if a rule is set up to show cameras 2 and 3 and motion occurs on Camera 1, Alarm Layout will contain cameras 1, 2 and 3. If unchecked, it will contain only cameras 2 and 3.
Why Action may work incorrectly
Displays text overlay on specific cameras when an event occurs.
Camera(s) to display text overlay on. To specify:
To select all cameras on a specific server, check the corresponding box. To filter search, use the Filter field. Filter criteria is the same as search criteria. It is possible to drag-and-drop the selected cameras from Resource Tree onto the Action’s advanced settings form.
Also show on source camera – Available only if the event is bound to cameras. If checked, when event occurs, text will be displayed on the source camera too.
For example, if a rule is set up to show cameras 2 and 3 and an event occurs on camera 1, text will display on all 3 cameras. If unchecked, it will display only on cameras 2 and 3.
Display text for ... Seconds – If checked, the text will be visible for the specified amount of time. Can be unchecked for the following continuous events: Motion on Camera, Input Signal on Device, or Generic Event. If unchecked, text will be displayed until the event stops.
For example, text will be displayed on a specific camera while the motion is going on.
Use custom text – If not specified, the event description will be used.
Why Action may work incorrectly
Pronounces specific text when an event occurs.
Speak the following – Enter the text to pronounce.
at – Camera to pronounce the text on. Camera should support 2-Way Audio.
Speak to users – If checked, the text will be pronounced to the selected users in the Client application.
IMPORTANT: Either Speak to users should be checked, or at least one camera should be selected for two-way audio, otherwise the rule will be invalid.
Interval of action - Check this option to aggregate the number of times the action will be triggered. For No more than once per a given amount of time, or instance, enter an integer value (1 - 999) and select a time interval from the menu (seconds, minutes, hours, or days). If unchecked, the action is instant and will occur whenever the event is triggered.
May be caused by
Why Action may work incorrectly
Writes a record to the event log when an event occurs. By default, all events mentioned in rules are written to the log; however, if all notifications are turned off, you can use the Write to Log action for a specific event.
Interval of action - Check this option to aggregate the number of times the action will be triggered. For No more than once per a given amount of time, or instance, enter an integer value (1 - 999) and select a time interval from the menu (seconds, minutes, hours, or days). If unchecked, the action is instant and will occur whenever the event is triggered.
May be caused by
Why Action may work incorrectly