Triggers: Difference between revisions

From Telcred documentation
Jump to navigation Jump to search
 
(14 intermediate revisions by the same user not shown)
Line 8: Line 8:




[[File:create-trigger-event.png|Create trigger for events]]
[[File:create-trigger-event.png|border|Create trigger for events]]


=== Reader input ===
=== Reader input ===


A trigger of type ''Reader input'' is activated when a user enters a pre-defined code on an access control reader. Codes are always prefixed with a * (e.g. *112). It is possible to require authentication through either a personal PIN or card in order to activate the trigger. In this case, it is also necessary which [[Roles|roles]] should be allowed to activate the reader.
A trigger of type ''Reader input'' is activated when a user enters a pre-defined code on an access control reader. Codes are always prefixed with a * (e.g. *112).


[[File:activate-trigger-reader.png|border|Activate trigger for readers]]


It is possible to require authentication to activate the trigger. If authentication is required, it is necessary to specify:
[[File:activate-trigger-reader.png|Activate trigger for readers]]
* The authentication method (card or personal PIN)

* Whether to block the card reader before presenting the authentication credential. This is to prevent the door from unlocking or even opening (especially if the door opens automatically). If 'Block access' is set to ''Yes'', the card reader will flash to indicate that the reader has been blocked and is ready to accept the credential. The correct procedure for the end user then becomes:
# Enter activation code
# Wait for the reader to flash (to indicate that the reader has been blocked)
# Present the credential (swipe card or enter PIN)
* Allowed [[Roles|roles]], i.e. which roles should be allowed to activate the trigger.


==== User feedback ====
==== User feedback ====
Line 33: Line 39:
# Wait for a blinking "success indicator" (will blink for approx two seconds). The success indicator indicates that the command completed successfully. If the success indicator is not displayed, the command failed to complete all of its actions.
# Wait for a blinking "success indicator" (will blink for approx two seconds). The success indicator indicates that the command completed successfully. If the success indicator is not displayed, the command failed to complete all of its actions.


=== Remote action ===
=== Mobile action ===


A trigger of type ''Remote action'' is activated from the mobile app [[Telcred Personal]]. It is necessary to specify whether the origin is by ''Overview'' or by ''Door''. This determines if the trigger will be displayed in the top menu of the app or on the respective page of the individual doors. It can also have consequences for what the trigger does, in case the trigger invokes a command (see further the section on independent commands vs. origin dependent commands in the [[Commands|commands]] documentation). Just as for ''Reader input'' with authentication, it is necessary to specify which [[Roles|roles]] are allowed to activate the trigger.
A trigger of type ''Mobile action'' is activated from the mobile app [[Telcred Personal]]. It is necessary to specify whether the origin is by ''Site'' or by ''Door''. This determines if the trigger will be displayed on the Site detail page or on the respective page of the individual doors. It can also have consequences for what the trigger does, in case the trigger invokes a command (see further the section on independent commands vs. origin dependent commands in the [[Commands|commands]] documentation). Just as for ''Reader input'' with authentication, it is necessary to specify which [[Roles|roles]] are allowed to activate the trigger.




[[File:activate-trigger-remote.png|Activate remote trigger]]
[[File:activate-trigger-remote.png|border|Activate remote trigger]]


=== IO port activity ===
=== IO port activity ===
Line 46: Line 52:


[[File:activate-trigger-ioport.png|Activate IO port trigger]]
[[File:activate-trigger-ioport.png|Activate IO port trigger]]

=== External request ===

A trigger of type ''External request'' is activated when the Telcred Access Manager service receives an https GET or POST request on a specified "secret" URL, which is automatically generated by the Telcred service.


[[File:activate-trigger-external-request.png|Activate External request trigger]]


== Optional restrictions ==
== Optional restrictions ==
Line 71: Line 84:




== Invoking notifications and commands ==
== Notifications and commands ==

The final step of creating a trigger is to specify what should happen when the trigger is activated. The same trigger can invoke both notifications and [[Commands|commands]]. For notifications, it is necessary to specify the [[Recipients|recipient(s)]].


[[file:recipients.png|border|Recipients]]


The final step of creating a trigger is to specify what should happen when the trigger is activated. The same trigger can invoke both [[Notifications|notifications]] and [[Commands|commands]].


Commands are divided into ''Origin independent'' and ''Origin dependent''. The two categories are explained in more detail in the documentation for [[Commands|commands]], but in short an origin dependent command will always have the same effect, regardless from where it is triggered, while an origin dependent command takes the origin as an input (e.g. perform ''Override to unlocked'' on the door where the trigger is entered on the reader or activate an output port on the controller of the door where the trigger is entered).
Commands are divided into ''Origin independent'' and ''Origin dependent''. The two categories are explained in more detail in the documentation for [[Commands|commands]], but in short an origin dependent command will always have the same effect, regardless from where it is triggered, while an origin dependent command takes the origin as an input (e.g. perform ''Override to unlocked'' on the door where the trigger is entered on the reader or activate an output port on the controller of the door where the trigger is entered).




[[file:invoking.png|Invoke notifications and commands]]
[[file:commands.png|border|Commands]]

Latest revision as of 15:36, 29 February 2024

Using triggers, it is possible to specify conditions that, when met, should send a notification, start a command, or both.

Trigger types and activation

Event

A trigger of type Event is activated when a matching event is received in the event log.


Create trigger for events

Reader input

A trigger of type Reader input is activated when a user enters a pre-defined code on an access control reader. Codes are always prefixed with a * (e.g. *112).

Activate trigger for readers

It is possible to require authentication to activate the trigger. If authentication is required, it is necessary to specify:

  • The authentication method (card or personal PIN)
  • Whether to block the card reader before presenting the authentication credential. This is to prevent the door from unlocking or even opening (especially if the door opens automatically). If 'Block access' is set to Yes, the card reader will flash to indicate that the reader has been blocked and is ready to accept the credential. The correct procedure for the end user then becomes:
  1. Enter activation code
  2. Wait for the reader to flash (to indicate that the reader has been blocked)
  3. Present the credential (swipe card or enter PIN)
  • Allowed roles, i.e. which roles should be allowed to activate the trigger.

User feedback

All readers behave a little differently, but in general this is what should be expected.

No authentication credential required
  1. Enter the activation code (e.g. *111).
  2. Wait for a blinking "success indicator" (will blink for approx. two seconds). The success indicator indicates that the command completed successfully. If the success indicator is not displayed, the command failed to complete all of its actions.
Authentication credential required
  1. Enter the activation code (e.g. *111).
  2. Wait for the reader to start blinking (can take a few seconds). This means that the reader has been temporarily blocked and is ready to receive the authentication credential (i.e. user PIN or card) without granting access.
  3. Wait for a blinking "success indicator" (will blink for approx two seconds). The success indicator indicates that the command completed successfully. If the success indicator is not displayed, the command failed to complete all of its actions.

Mobile action

A trigger of type Mobile action is activated from the mobile app Telcred Personal. It is necessary to specify whether the origin is by Site or by Door. This determines if the trigger will be displayed on the Site detail page or on the respective page of the individual doors. It can also have consequences for what the trigger does, in case the trigger invokes a command (see further the section on independent commands vs. origin dependent commands in the commands documentation). Just as for Reader input with authentication, it is necessary to specify which roles are allowed to activate the trigger.


Activate remote trigger

IO port activity

A trigger of type IO port activity is activated when an input port on a controller changes state. It is necessary to specify which input port and transition should activate the trigger.


Activate IO port trigger

External request

A trigger of type External request is activated when the Telcred Access Manager service receives an https GET or POST request on a specified "secret" URL, which is automatically generated by the Telcred service.


Activate External request trigger

Optional restrictions

It is possible to restrict a trigger with regards to:

  • When the trigger can be activated
  • Which events or actions can activate the trigger

The options for restricting the trigger depend on the trigger type and possibly also on choices made regarding the trigger activation. For example, for a trigger of type Event, the available restrictions will depend on which event(s) activate the trigger. An Access granted event can be restricted with regards to time door, user, and method:


Restrictions for Access granted event


On the other hand, a Controller offline event can only be restricted with regards to time and controller:


Restrictions for Controller offline event


Restrictions that do not apply to all of the activation conditions will not be displayed. For example, if both Access granted and Controller offline are selected as activation conditions for a trigger of type Event, it will only be possible to restrict the trigger with regards to time since no event contains attributes for both door and controller. In this case, it may be necessary to create two separate triggers - each with its own restrictions.


Restrictions for mixed door and controller events


Notifications and commands

The final step of creating a trigger is to specify what should happen when the trigger is activated. The same trigger can invoke both notifications and commands. For notifications, it is necessary to specify the recipient(s).


Recipients


Commands are divided into Origin independent and Origin dependent. The two categories are explained in more detail in the documentation for commands, but in short an origin dependent command will always have the same effect, regardless from where it is triggered, while an origin dependent command takes the origin as an input (e.g. perform Override to unlocked on the door where the trigger is entered on the reader or activate an output port on the controller of the door where the trigger is entered).


Commands