PDK io - People - EVENT Tab

PDK io People Settings Overview

Event rules are actions to be taken at doors and elevators when the selected Triggers and Action events occur at the designated locations. 

If necessary, refer to the PDK io - People article. 

Event Tab - Read In / Read Out Rules

To add event rules, select the EVENT tab in the Add Rule screen.

Click inside the Name field to assign a unique descriptive name for the Event rule.

Schedule

1. Specify a Start Time and Stop Time in 24-hour format for the rule to be active. Click on the down arrow in these fields and use the up and down arrows to set hours and minutes. Click SAVE.

2. Recurring - If selected, check the day(s) of the week for a recurring event.

3. Single Date - If selected, a rule can be defined for a specific date, such as a holiday closure. Use the Date menu to select the month and day. Click inside the Date field to enter a date using the MM/DD/YYYY format (Month, Day, Year) or click on the down arrow to use a calendar. 

4. Use the < and > to change to a previous or future month.

5. Click on the month to select a month's name from the drop-down list.

6. Click on the year to change the year. 

NOTE: Single dates are useful for temporary access, holidays, etc. Once the date and time have passed, the rule will be inactive. These rules can be used again by simply changing the date.

Action

Select a Trigger event and a subsequent Action to take place when the Trigger occurs. 

Trigger

A Trigger event is a selectable option that, when it occurs, triggers or "sets off" a specifically selected Action. Click inside the Trigger field or on the down arrow to select an event that will trigger an Action.  

• When Allowed - Any time there is an ALLOW rule set in the system and a card is scanned for that person or group
• When Denied (Explicit) - Any time there is a DENY rule set in the system and a card is scanned for that person or group
• When Denied (No Rules) - Any time a card is scanned and denied because there are no access rights set for that person or group
• Always (Valid Credentials) - Any credential scanned that is listed in the system for that person or group
• On Multiswipe Allow (2 Swipe) - Any time a card is presented two times in three seconds for the person or group
• On Multiswipe Allow (3 Swipe) - Any time a card is presented three times in three seconds for the person or group
• On Multiswipe Allow (4 Swipe) - Any time a card is presented four times in three seconds for the person or group
• On Duress - When a duress PIN is entered

Duress PIN

A Duress PIN is automatically system generated when a PIN number is entered in the PIN field. A leading 9 is added to the personal identification number (PIN) that has been created. For example, if the user-created PIN is 1234, a Duress PIN of 91234 is automatically created for that user.

NOTE: The system generated duress PIN does not appear in the Duress PIN field until after the SAVE button in the Person screen is clicked. 

As is the case with most of these screens in this application, the SAVE button does not appear unless and until additions/changes have been made to the information on that screen. 

The Duress PIN is used to trigger system event rules that use the Trigger option "On Any Duress", group rules using the trigger "On Duress", reports events using “Duress PIN Entered” and “Any Duress PIN Entered”, and Live Events using “Duress PIN Entered”. 

As an example, in a threat situation in which a user is being forced to use their PIN to enter a building or office against their will by an unauthorized person, the Duress PIN can be used to activate an emergency lockdown or some other action to help resolve and alert others to the situation. A Duress PIN rule, for example, can be created that sends out an email or text message to alert others to the situation. 

Action 

An Action event is a specific response that occurs when the action is triggered or "set off" by a Trigger event.  Click inside the Action field or on the down arrow to select a specific action or response from the list that will occur when set off by the Trigger event. 

Send Email - With a valid Trigger, an email (or an SMS text message) is sent to the specified email address(es) or phone number(s) using the pre-configured email template. When Send Email is selected, the Email Template heading and its associated fields are displayed. 

Email Template

When Send Email is selected in the Action field, the Email Template screen is displayed.

Click the + icon next to Recipients to assign who will receive the email or text message notification. The Add Recipients screen is displayed. 

EMAIL Tab - Add Recipients

The email list is generated from the list of users associated with the customer. An email is sent to the recipient(s) that are checked when the specified Trigger option is met.

Check the email address(es) listed under Permissions to be notified. Click ADD.

Another Email - To add an email that is not listed, click in the Another Email field and enter the email address.

Click ADD. Repeat this for any additional email addresses that need to be added.

PHONE NUMBER Tab - Add Recipients

Use the PHONE NUMBER tab to send an SMS (text) message Action event. A text message is sent to the recipient(s) when the specified Trigger option is met.  

Mobile Provider - Click in the Mobile Provider field to select the provider name that corresponds to the phone number. 

Phone Number - In the Phone Number field, enter the recipient's phone number in the form: 1234567890 (numbers only, no special characters such as a dash, period, comma, or parentheses).

Click ADD. Repeat for any additional phone numbers that need to be added. 

NOTE: For Verizon customers receiving the SMS text message, there is a 75-character limit for email-to-text messages. To eliminate this issue, the portion of the message that begins, “This event has been logged…” needs to be deleted, otherwise, the full content of the text message may be truncated. 

Action

• Do Not Disturb - Toggles the “Do Not Disturb” status of the door/relay. On DND status, the door is locked and unresponsive to regular access attempts until the DND status is removed. For example, a DND can be set while on a conference call or in a meeting to prevent entry to an office by others during the call/meeting.
• Force Toggle - Toggles the current state of the door/relay to open/closed. If the door is closed (locked), toggles to open (unlocked). If the door is open (unlocked), toggles to closed (locked). 
• Force Open - Holds the door/relay (that the event is created on) in the Open (unlocked) position and will not close (lock) unless Force Closed
• Force Close - Clears the Force Open status and locks the door
• Open - Opens (unlocks) the door/relay
• Close - Closes (locks) the door/relay
• Lockdown On - Lockdown (doors locked) of selected devices is set to On. All doors are locked.
• Lockdown Off - Lockdown (doors locked) of selected devices is set to Off. All doors are unlocked. 
• Delay Open - A time delay for opening (unlocking) the door/relay
• Delay Close - A time delay for closing (locking) the door/relay
• Open/Close - Opens (unlocks) the door/relay and sends a close (lock) after a delayed time period

Subject - Recipients 

You can determine what appears in the Subject line of the email/text message. Click inside the Subject field to edit its contents. 

By default <%loginfo%> <%time%> appears in this Subject field. These can be changed to any of a number of parameter options or you may enter text of your own choosing.

All text within this Subject field can be edited to display whatever content is desired for the Subject of the email. Clicking anywhere in the Subject field displays a floating + icon. Click on the floating + icon to display a list of the Subject field parameter options. 

• <%time%>  Displays the date and time
• <%logdoor%>  Displays the accessed door
• <%logevent%>  Displays the logged event
• <%logresult%>  Displays the logged result
• <%loginfo%>  Displays the logged information
• <%logcardno%>  Displays the card number
• <%logname%>  Displays the name of the person
• <%logiolink%>  Displays the logged link

Mail - Recipients 

You can determine what appears in the contents of the email/text message. Click inside the Mail field, where ALERT INFORMATION appears, to edit its contents. By clicking anywhere in the Mail field, a floating + icon appears. All text within this field can be edited to display whatever content is desired for the recipient; text of your own choosing can be entered.

By default, the following field text is displayed. 

• TIME/DATE:  <%time%>
• LOG INFO:  <%loginfo%>
• CARD NUMBER:  <%logcardno%>
• NAME:  <%logname%>

Click on the floating + icon to display a list of the Mail field parameter options or change the existing text to whatever is desired. 

• <%time%>  Displays the date and time 
• <%logdoor%>  Displays the accessed door 
• <%logevent%>  Displays the logged event 
• <%logresult%>  Displays the logged result 
• <%loginfo%>  Displays the logged information 
• <%logcardno%>  Displays the card number 
• <%logname%>  Displays the name of the person 
• <%logiolink%>  Displays the logged link 

Source Doors 

A Source Door is the location where a trigger event, such as a card scan, occurs. Typically, the Source door (when triggered) and the Target door (where the action occurs) are the same, such as performing a card scan at a door (the Source door), after which that same door (the Target door) is unlocked. 

Source Doors is where the Trigger event is set to occur. With Trigger and Action option(s) defined, select from the list of Source Doors to be affected by the Trigger. When the Trigger event occurs, the defined Action occurs at the selected Source door(s). It is not affected by the Action unless the selected Source door(s) are included with the Target doors.

Click the + icon next to Source Doors to view and check the door(s) to be associated with Trigger and Action. When doors are selected from Source Doors, the Target Doors option is also made available (unless Send Email is selected as an Action). Click SELECT. 

Target Doors 

Target door(s) is a specified location where a defined Action occurs after a specific Trigger event occurs. Typically, the Source door (when triggered) and the Target door (where the action occurs) are the same, such as performing a card scan at an office’s front door (the Source door), after which that same door (the Target door) is unlocked. In addition, an Action can also be defined to occur on multiple Target doors when a Source door is triggered. For example, when the front door is scanned, it not only unlocks that door, it can also unlock that person’s office door. (See Same as Source Doors below.) Selected Target Doors perform the Action specified in the rule. 

NOTE: If the Send Email option is selected in the Action field, the Target Doors option is not available. 

To select specific Target door(s), click the + icon next to Target Doors and check the door(s) to be associated with the Source Doors. Click SELECT. 

Same as Source Doors - Target Doors

If a Target door (where the action occurs) is to be the same as Source door (when triggered), select Same as Source Doors. Typically, a Source door (when triggered) and a Target door (where the action occurs) are the same, such as performing a card scan at an office door (the Source door), after which that same office door (the Target door) is unlocked. 

Another Doors - Target Doors

To use a Target door(s) that is different from the Source door(s), select the Another Doors option and click the + icon next to Target Doors. As an example, with Another Doors selected, a scan at the Source door (when triggered), would result in an action at the Target door (where the action occurs) that is not the same as the Source door.

Check the desired Target doors, or search for a specific door(s) by name from a long list using the Filter field. Click SELECT. 

Click SAVE at the upper right to accept your changes. 

NOTE: As is the case with most of these screens in this application, the SAVE button does not appear unless and until additions/changes have been made to the information on that screen.