Triggers: Difference between revisions
Telcredstaff (talk | contribs) No edit summary |
Telcredstaff (talk | contribs) |
||
| (17 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) |
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 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: |
|||
# 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. |
||
=== |
=== Mobile action === |
||
A trigger of type '' |
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 === |
||
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. |
|||
[[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: | ||
== |
== 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 [[ |
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)]]. |
||
| ⚫ | 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:recipients.png|border|Recipients]] |
|||
[[file:invoking.png|Invoke notifications and 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). |
||
==== Setting up an access granted trigger ==== |
|||
For an access granted trigger it is not necessary to specify any activation. The trigger will activate on all user initiated access granted events (but not on access granted events initiated from the Telcred API). |
|||
[[file:access-granted-activation.png|Access granted trigger activation]] |
|||
It is possible to define restrictions on the trigger: |
|||
* When it can be activated (schedule) |
|||
* From which doors it can be activated (doors and/or door groups) |
|||
==== Setting up a door forced open trigger ==== |
|||
For a door forced open trigger it is not necessary to specify any activation. The trigger will activate when a door forced open event occurs. |
|||
It is possible to define restrictions on the trigger: |
|||
* When it can be activated (schedule) |
|||
* From which doors it can be activated (doors and/or door groups) |
|||
==== Setting up a remote trigger ==== |
|||
Remote triggers are activated from the [[Telcred Entry]] app. There are two types of remote triggers: |
|||
* Remote by overview |
|||
* Remote by door |
|||
Remote by overview triggers do not include information about any specific door when they are activated by the user. Therefore, they can only be used with commands defined by the administrator (as opposed to "native" door commands, e.g. ''override to unlock''). In other words, remote by overview should be used for commands that do not target a specific door. |
|||
[[file:remote-by-overview.png|Remote by overview]] |
|||
Remote by door commands are available from the door page in the [[Telcred Entry]] app, and include information about the door when they are activated by the user. Therefore, they are suitable for triggering commands that target individual doors, e.g. override to unlock, override to locked, etc. |
|||
[[file:remote-by-door.png|Remote by door]] |
|||
It is possible to define a ''remote by door'' trigger that invokes a command that does not target any specific door. However, that has the potential to confuse the end user, so it is not recommended to do so. The reason administrator defined commands are available also for ''remote by door'' triggers is that a trigger can invoke several commands of which one could be door specific and others not (e.g. unlock the door and turn on the light). |
|||
==== Setting up an IO port trigger ==== |
|||
For an IO port trigger it is necessary to specify the input port and transition that should activate the trigger. |
|||
[[file:controller-trigger-activation.png|Controller trigger activation]] |
|||
Just as for commands targeting the output port(s) not all controllers have the same number of IO ports, so it is necessary to know which type of controller that will be used when specifying the input port for the trigger. It is also necessary to [[A1001_settings#IO_port_settings|configure the IO ports of the controller]]. |
|||
As for other trigger types, it is possible to define restrictions on the trigger: |
|||
[[file:commands.png|border|Commands]] |
|||
* When it can be entered (schedule) |
|||
* From which doors it can be entered (doors and/or door groups) |
|||
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.
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 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:
- 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, 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
- Enter the activation code (e.g. *111).
- 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
- Enter the activation code (e.g. *111).
- 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.
- 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.
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.
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.
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:
On the other hand, a Controller offline event can only be restricted with regards to time and controller:
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.
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).
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).
