Email/SMS Automation

Email/SMS Automation allows an operator to create a macro that will automatically send a message via email or SMS whenever a specific trigger occurs. The instructions below are based on a specific example of creating an Email/SMS message that is sent whenever a Door Forced Alarm is generated at a specific door.

 

Advanced View must be enabled for this option to appear on the Ribbon Bar.

 

There are five steps to Automating Email/SMS messages.

 

  1. Create the Macro
  2. Create the Trigger
  3. Configure the Linkage Service
  4. Verify the Macro is Operational
  5. Link the Hardware to the Macro

 

Click the Email/SMS ribbon icon to open the Global Linkage window.

 

 

Create the Macro

The Macro is the action to be performed when a trigger condition is met.

 

  1. Click the Macro Tab. Click the Add New button to create a Macro entry.

 

 

  1. Click on the New Macro entry to enable Macro Properties.
  2. Enter a descriptive name into the Description field. This name is copied into the corresponding menu-tree field as it is entered in the Properties field.

 

 

  1. Click the Add Macro Item button.
  2. Enter a description for the Action Type. This name is copied into the corresponding menu-tree field as it is entered in the Properties field.

 

 

  1. Select the Macro Item Type - This field defines the communication method the macro will use to send messages.

 

 

  1. Fill in the information fields according to the Item Type selected:

For Email

 

 

For SMS

 

 

  1. Save the Macro.

 

 

Create the Trigger

The Macro will execute when the Trigger condition is met.

 

  1. Click the Trigger Tab. Click the Add New button to create a Trigger entry.

 

 

  1. Click on the New Global Trigger entry to enable Trigger Properties.
  2. Enter a descriptive name into the Description field. This name is copied into the corresponding menu-tree field as it is entered in the Properties field.
  3. Click the Enabled check-box to enable the Trigger.
  4. Click the Condition Type pull-down menu and select a condition type. The Condition Type refers to the source where a change in the source's condition should be checked to see if it meets the trigger's criteria.

 

 

  1. Click the Add Condition button.

 

 

  1. Click on the New Condition entry to enable Condition Properties.
  2. Enter a descriptive name into the Description field. This name is copied into the corresponding menu-tree field as it is entered in the Properties field.
  3. Click the Enabled check-box to enable the Condition.
  4. Click the Enable Time Constraint pull-down menu and select a Time Schedule during which this Trigger should be active.
  5. Click the Macro pull-down menu and select the Macro this Trigger should activate.

 

 

  1. Select the Message Type to be applied to the Condition from the pull-down list of Available Message Types in the Properties pane.

 

 

  1. Save the Trigger.

 

 

Configure the Linkage Service

The Linkage Service makes the communication connection that sends out the contents of the Macro. Linkage Service configuration is done in the License Manager program (LicenseManager.exe). This program is found in the Keri\DoorsNet\ folder.

 

Linkage Service settings are already configured for major cell phone carriers, but must be configured for Email. These instructions assume you are familiar with the network configuration settings for your Email system, in particular the SMTP Host and Email Server Port values.

 

  1. Navigate to the Keri\DoorsNet folder, locate, and open the LicenseManager.exe program.
  2. Click the Global Linkage Service menu option.
  3. Click the Settings button.

 


Email Settings

  1. Click the Email Settings tab.
  2. Make edits according to the type of Email service you use. Keri recommends using the Simple Email option and not using the HTML option for maximum compatibility with multiple Email systems.
  3. Click the Save button.

 

 

  1. Click the Close button to exit the License Manager.


SMS Settings

  1. Click the SMS Settings tab. Default SMS settings are already entered for many major carriers.
  2. If your carrier is not listed you may consider co-opting one of the existing carriers and entering the SMS setting for your carrier. Remember to use this co-opted carrier in your SMS Macro definition.
  3. Click the Save button if you have made a change. Otherwise, click the X-box to close the window.

 

 

  1. Click the Close button to exit the License Manager.

 

Verify the Macro is Operational

  1. Right click on the Macro name and a pull-down menu appears.
  2. Select Execute and the Macro runs.
  3. Verify you have the expected result. Per the Macro described above, you should receive both Email and SMS messages.

 

 

Link the Hardware to the Macro

These instructions will vary slightly depending upon the type of trigger that was created.

 

  1. Click the Setup Tab at the top of the Doors.NET program.
  2. Click the Hardware Setup ribbon icon. The Hardware Setup window opens.
  3. Click the tab that corresponds to the Condition Type chosen for your trigger: Control Point, Controller, Monitor Point, Panel, Reader, Situation Manager.
  4. Click an entry to which the Macro should be applied.

 

 

  1. Enable the Parameter Pane Advanced View .
  2. Scroll down the Parameter List until the Monitoring section appears.
  3. Click the Global Trigger field and select the desired Trigger from the pull-down list.

 

 

  1. Save the selection.

 

 

  1. The Email/SMS Automation Task is now complete.