View source for Unlock station by PIN code (Node-RED)

{{cons}} {{C}}
== Functional description  ==
This article explains how to configure a predefined group of intercom stations so that they remain locked while idle and can be temporarily unlocked by entering a PIN code.

When a user dials the PIN code (which is implemented as an Event Trigger number), the system unlocks the station for a specified duration. After this period expires, the station automatically returns to its locked state.

'''Example:''' The user dials '''8951 + 106''' to unlock his station and place a call to number 106.

== Configuration ==
This application is based on a premade Node-RED flow.

=== Preparations ===
* [[Node-Red_-_Installation|Node-RED must be installed]] and the [[Node-Red_-_Getting_Started|communication between Node-RED and Zenitel Connect Pro]] must be established. 
* Download the flow from the [[Downloads|Downloads section]]
* [[Node-Red_-_Getting_Started#Importing_flows|Import the flow]] in to your Node-RED application 
* For the Zenitel Nodes to communicate with ZCP, create a "[[Node-Red_-_Getting_Started#Setting_up_Node-RED_for_the_first_time|wamp-client]]"

=== Node configuration ===
'''Call Handling flow:''' <br>
<table style="max-width:80%; border-style: double; border-color: #c7c7c7;">
<tr style="rowspan:2;">
<td style="display: block; vertical-align: bottom;">[[File:Node red UnlockFlow1.jpg|1000px]]</td>
</tr>
<tr>
<td style='background-color:#efefef;'>Call Handling flow</td>
</tr>
</table>
With reference to the above imported flow:
* Node 1 (Zenitel Call State Event): This node receives information about all calls in the system. The only configuration required is to assign the '''ZCP Link'''.
* Node 2 (Exclude '''from''' dirno range): 
* Node 3 (Exclude '''to''' dirno range): 
* Node 4 (Exclude PIN code): 
* Node 5 (Check for locked station): 
* Node 6 (Zenitel Call End): If the call is not authorized this node will send a command to ZCP to cancel the call immediately after it is established. The only configuration required is to assign the '''ZCP Link'''.

'''Event Trigger flow:''' <br>
<table style="max-width:80%; border-style: double; border-color: #c7c7c7;">
<tr style="rowspan:2;">
<td style="display: block; vertical-align: bottom;">[[File:Node red UnlockFlow2.jpg|700px]]</td>
</tr>
<tr>
<td style='background-color:#efefef;'>Set "Unlock" state by dialing an Event Trigger</td>
</tr>
</table>

With reference to the above imported flow:
* Node 1 (Zenitel Event Trigger Event): In the '''Eventno''' field enter the Event trigger number to be used as PIN code (e.g. 8951). Assign the '''ZCP Link'''.
* Node 2 (Unlock station): 
* Node 3 (Delay 30s): 
* Node 4 (Lock station): 


== Test and confirm operation ==


----

'''When the PIN code (e.g., 8951) is entered:'''
*The variable xxxxxx is set to yyyyyy (station becomes unlocked)
*After the configured timeout (e.g., 30 seconds), the variable xxxxxx is reset to zzzzz (station locks again)

'''While the station is unlocked, and the user dials another number, the flow will verify:'''
# Whether the calling station is excluded from PIN requirements
# Whether the called number is excluded from PIN requirements
# Whether the called number is the actual PIN code itself (if so, this is always permitted)
# If 







[[Category: Node-RED]]