Actions

Difference between revisions of "Dynamic group call"

From Zenitel Wiki

(→‎Event Handler configuration)
 
(60 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
{{A}}
+
{{AI}}
−
==Operation (CRM IV and CRM V)==
+
==Operation ==
−
*Press a dedicated "Group Config." [[DAK]] key. The red led in key starts flashing
+
For best performance it is recommended to use [[CRM_V_-_Control_Room_Master|CRM V station]] or [[ECPIR-3P|ECPIR-3P panel]], as these devices have buttons with LEDs showing status.
−
*Select subscribers to be included/excluded (toggle function) by pressing the assosiated [[DAK]] keys. A flashing green led in the keys indicates that the stations are included
 
−
*Press the "Group Config." button again, the [[Groups#Group_Call.2FAnnouncements|group call]] is now activated. The red led in the [[DAK]] key stops flashing. Now the group call is activated (the ding-dong chime is played) and pressing the `M`-key opens the microphone.
 
−
*The green leds continue to flash during the [[Groups#Group_Call.2FAnnouncements|group call]]
 
−
*Cancel the [[Groups#Group_Call.2FAnnouncements|group call]] by pressing the `C`-key. All members will be removed from the group, and the green leds stop flashing.
 
  
−
It is not neccessary to use [[Control Room Master IV|CRM-IV]] or [[IP Flush Master - 1008031000|CRM V]] stations, but with regular stations you will not get LED feedback on [[Groups#Group_Call.2FAnnouncements|group call]] inclusion/exclusion.
+
*Press a dedicated "Group Configuration" [[DAK]] key. The red led in key starts flashing, and the Dynamic Group is emptied.
 +
*Select stations or local groups to be included by pressing the associated [[DAK]] keys. A steady green led in the keys indicates that the stations/groups are included
 +
*Press the "Group Configuration" button again, and the group call is activated (the ding-dong chime is played). Pressing the `M`-key opens the microphone.
 +
*The green leds continue to be lit during the [[Groups#Group_Call.2FAnnouncements|group call]]
 +
*Cancel the [[Groups#Group_Call.2FAnnouncements|group call]] by pressing the `C`-key. The green LEDs are turned off.
  
−
{{note|You can only include subscribers, you cannot include groups! }}
+
{{note|One can only include, not remove, stations/groups into the dynamic group. If a wrong selection is made, press the C-key, and start the selection over again.}}
  
−
==Programming==
+
== Software requirements==
−
*Software requirement: AMC 8.26 or later
+
* ICX: Any version
 +
* AlphaCom: 13.0.3.0 or later
  
−
*In [[AlphaPro]], [[Directory_%26_Features_%28AlphaPro%29|Directory & Features]], create a directory number, feature 95/0. Directory number [[Event Trigger w/User Parameter|9535]] is included by default. Program the "Group Config." DAK button to 9535.
+
==Configuration==
 +
*Assign directory number 9535 to DAK 1 of the operator station. This is the '''Group Configuration''' button. Directory number [[Event Trigger w/User Parameter|9535]] is included in a default database.
  
−
*Each CRM station must be assigned its own [[Groups#Group_Call.2FAnnouncements|group call]] that nobody else uses. The directory number of the [[Groups#Group_Call.2FAnnouncements|group call]] must be changed so that the two last digits are identical to the group index number. Example:
+
[[File:DynGrp DAK.PNG|thumb|left|500px|"Group Configuration" button]]
−
**Group '''2''' = 85'''02'''
+
<br style="clear:both;" />
−
**Group '''3''' = 85'''03'''
 
−
**Group '''4''' = 85'''04'''
 
−
**Group '''10''' = 85'''10'''
 
−
So if you have 3 CRM stations, you need to program 3 [[Groups#Group_Call.2FAnnouncements|group calls]] (e.g. 8502, 8503 and 8504).
 
  
−
*Enter the [[Groups#Group_Call.2FAnnouncements|group call]] directory number in the User Defined Parameter (%1.EXP) field of each [[Control Room Master IV|CRM-IV]]. In AlphaPro, [[Users_%26_Stations_%28AlphaPro%29#UDP|Users & Stations -> UDP -> User Defined Parameter (%1.EXP)]]. For the above example, CRM station 1 will have (%1.EXP)=8502, CRM station 2 will have (%1.EXP)=8503 and CRM station 3 will have (%1.EXP)=8504.
+
*Each operator station is assigned its own Dynamic Group Call by entering the directory number of the Dynamic Group Call in the User Defined Parameter (%1.EXP) field of the operator.
−
*Put all CRM’s that should have [[Dynamic group call]] feature in [[UDP]] group 1. Name this [[UDP]] group : "The CRM stations".
+
*Include operator stations in [[UDP]] group 1. Name the [[UDP]] group e.g. "Operators".
  
−
===Event Handler configuration===
+
[[File:DynGrp UDP.PNG|thumb|left|500px|Include the operator station in UDP Group 1, and enter the directory number of the Dynamic Group used by this operator (Here: 899)]]
 +
<br style="clear:both;" />
  
−
In [[AlphaPro]], go to [[Exchange_%26_System_%28AlphaPro%29#Events|Exchange and System -> Events]], press Insert and create the following events:
 
−
------------
 
−
'''Event 1'''
 
  
−
-> This event will be triggered when the "Group Config." button is pressed for the first time.
+
===Event Handler configuration===
−
{|
 
−
|-
 
−
|width="120pt"|'''Event Owner''':
 
−
|width="400pt"|Stations w/ UDP Id: 1 (The CRM stations)
 
−
|-
 
−
|'''Event type''': || [[Event Trigger (Event Type)|15 – Event Trigger]]
 
−
|-
 
−
|'''Subevent''': || 0
 
−
|-
 
−
|'''When change to''': || ON or OFF
 
−
|-
 
−
|'''When related to''': || Directory Number, Id: 9535
 
−
|-
 
−
|'''Action''': || [[IND]] %1.phy [[%1.dak]](I%2.dir) 1 3  || Turn ON + flash the red LED of the Group Config. button
 
−
|-
 
−
|}
 
  
−
------------
+
In [[AlphaPro]], go to [[Exchange_%26_System_%28AlphaPro%29#Events|Exchange and System -> Events]], press '''Insert''' and create the following events (Simply '''copy/paste''' the action strings below into AlphaPro):
−
'''Event 2'''
 
  
−
-> This event will be triggered each time a match is found in the directory table (after the "Group Config." button has been pressed for the first time.)
+
'''Event 1: Start/stop Group Configuration'''
 +
*When the "Group Configuration" button is pressed, empty the Dynamic Group and turn on red LED in the button.
 +
*When leaving the Group Configuration mode, start a 1 sec timer. If the Dynamic Group is not activated within this time, the LEDs will be cleared.
  
−
-> E.g. pressing a DAK-key with a directorynumber stored in it, will call this event (%2 will contain the directory number of the DAK key).
+
[[File:DynGrp Event1.PNG|thumb|left|500px|Start/stop Group Configuration]]
 +
<br style="clear:both;" />
  
−
-> This event keeps being triggered until disconnected.
+
{{Code2|
−
{|  
+
IF %chg(1,0)
−
|-
+
  $GRM LV L%1.exp U3
−
|width="120pt"|'''Event Owner''':
+
IND %1.phy %1.dak(I%2.dir) 1 3 ON
−
|width="400pt"|Stations w/ UDP, Id: 1 (The CRM stations)
+
stop
−
|-
+
ENDIF
−
|'''Event type''': || [[Event Trigger with parameter (Event Type)|25 – Event trigger with parameter]]
+
  $ST L%1.dir W10 L%1.exp
−
|-
+
}}
−
|'''Subevent''': || 0
 
−
|-
 
−
|'''When change to''': || ON or OFF
 
−
|-
 
−
|'''When related to''': || All
 
−
|-
 
−
|'''Action''': || [[IF/ENDIF|IF]] [[%sgm]](%2.phy,%1.exp(2))|| If station is already member of this group, execute next lines.
 
−
|-
 
−
  || || || sgm = Station Group Member, %2.phy = station phys addr., %1.exp(2) = last 2 digits of UDP %1.exp value.
 
−
|-
 
−
| &nbsp; || [[IND]] %1.phy [[%1.dak]](I%2.dir) 2 3 OFF || Station was member and will be removed from group, so switch OFF green flashing LED.
 
−
|-
 
−
| &nbsp; || [[IF/ENDIF|ENDIF]]
 
−
|-
 
−
| &nbsp; || [[IF/ENDIF|IF]] [[%op]]([[%sgm]](%2.phy,%1.exp(2)),=,0)|| If station is not yet a member of this group, execute next lines.
 
−
|-
 
−
  || || || sgm = Station Group Member, %2.phy = station phys addr., %1.exp(2) = last 2 digits of UDP %1.exp value.
 
−
|-
 
−
| &nbsp; || [[IND]] %1.phy [[%1.dak]](I%2.dir) 2 3 ON || Station was not a member and will be added to the group, so switch ON green flashing LED.
 
  
−
|-
+
'''Event 2: Include members'''
−
| &nbsp; || [[IF/ENDIF|ENDIF]]
+
*When DAK keys are pressed during Group Configuration mode, turn on the green LED, and include the station or local group to the dynamic group
−
|-
+
*If the DAK key pressed is the "Group Configuration" button (9535), disconnect the station from configuration mode, turn off the red LED, and dispatch the dynamic group call
−
| &nbsp; || [[GROUP MEMBERSHIP|$GRM]] L%2.dir NG%1.exp(2) U2 || Group Membership Toggle (this will add/remove the station to the group)
 
−
|-
 
−
| &nbsp; || [[IF/ENDIF|IF]] [[%op]](%2.dir,=,9535)|| If the Group Config button is pressed, execute next lines (this is the 2nd time that the Group Config. button is pressed, so stop with the station selection phase and start the Group Call phase)
 
−
|-
 
−
| &nbsp; || [[DISCON ST|$DISCON_ST]] L%1.dir 0|| Disconnect this CRM station in order to stop this event being triggered.
 
−
|-
 
−
| &nbsp; || [[IND]] %1.phy [[%1.dak]](I%2.dir) 2 3 OFF || Switch OFF the flashing green LED in the Group Config. Button. This LED was switched ON by pressing the button while Event 2 was active.
 
−
|-
 
−
| &nbsp; || [[PAUSE]] || Allow the system to settle (each Pause is 100 msec delay)
 
−
|-
 
−
| &nbsp; || [[PAUSE]]
 
−
|-
 
−
| &nbsp; || [[PAUSE]]
 
−
|-
 
−
| &nbsp; || [[DIAL DIGITS|$DD]] L%1.dir L%1.exp || DD = Dial Digits. Now setup a call from this CRM station (%1.dir) to the groupnumber specified in the UDP settings (%1.exp)
 
−
|-
 
−
| &nbsp; || [[IF/ENDIF|ENDIF]]
 
−
|-
 
−
|}
 
  
−
------------
+
[[File:DynGrp Event2.PNG|thumb|left|500px|Include members]]
−
'''Event 3'''
+
<br style="clear:both;" />
  
−
-> This event is triggered at the end of each conversation (by pressing the 'C' key)
+
{{Code2|
 +
IND %1.phy %1.dak(I%2.dir) 2 1 ON
 +
$GRM L%2.dir L%1.exp U1
 +
IF %op(%2.dir,<nowiki>=</nowiki>,9535)
 +
$DISCON_ST L%1.dir 0
 +
IND %1.phy %1.dak(I%2.dir) 1 3 OFF
 +
PAUSE
 +
PAUSE
 +
PAUSE
 +
$DD L%1.dir L%1.exp
 +
}}
  
−
{|
+
'''Event 3: Reset LEDs when Dynamic Group Call ends'''
−
|-
+
*When the operator calls the dynamic group, stop the timer that resets all LEDs
−
|width="120pt"|'''Event Owner''':
+
*When the call to the dynamic group call ends, reset all LEDs
−
|width="400pt"|Stations w/ UDP, Id: 1 (The CRM stations)
 
−
|-
 
−
|'''Event type''': || [[Conversation Outgoing (Event Type)|08 – Conversation - Outgoing]]
 
−
|-
 
−
|'''Subevent''': || 0
 
−
|-
 
−
|'''When change to''': || OFF
 
−
|-
 
−
|'''When related to''': || All
 
−
|-
 
−
|'''Action''': || [[IF/ENDIF|IF]] [[%op]](%2.dir,=,%1.exp) || If the ended conversation was for this group (%1.exp), execute the next lines.
 
−
|-
 
−
| &nbsp; || [[IF/ENDIF|IF]] [[%gns]](%1.exp(2),0) || If station is member of group, execute next line.
 
−
|-
 
−
|| || || gns = Group Next Station. %1.exp(2) returns the last two digits of the groupnumber = Group Index Number.
 
−
|-
 
−
|| || || [[%gns]](%1.exp(2),0) returns the physical station number of first member in the group, if no members in group, it returns 0.
 
−
|-
 
−
| &nbsp; || [[EVENT_REPORT|$ER]] U15 U1 U1 U1 N[[%gns]](%1.exp(2),0) U3 %1.ref || Launch the next Event (Event 4).
 
−
|-
 
−
|| || || $ER = Event Report. [[%gns]](%1.exp(2),0) = Owner, %1.ref = Related To
 
−
|-
 
−
| &nbsp; || [[IF/ENDIF|ENDIF]]
 
−
|-
 
−
| &nbsp; || [[IF/ENDIF|ENDIF]]
 
−
|-
 
−
|}
 
  
−
------------
+
[[File:DynGrp Event3.PNG|thumb|left|500px|Reset LEDs]]
−
'''Event 4'''
+
<br style="clear:both;" />
  
−
-> This Event is triggered by the previous event (Event 3).
+
{{Code2|
 +
IF %op(%2.dir,<nowiki>=</nowiki>,%1.exp)
 +
IF %chg(1,0)
 +
$ST L%1.dir W0 L%1.exp
 +
stop
 +
ENDIF
 +
IND %1.phy 0 0 0 OFF
 +
ENDIF
 +
}}
  
−
-> This Event will remove all stations from the group and switch OFF the green flashing LED's on the DAK keys of this CRM station where the group member stations are stored.
 
  
−
{|
+
'''Event 4: Reset LEDs on timeout'''
−
|-
+
*If the operator exit the "Group Configuration" mode without starting the dynamic group call within set time, resets all LEDs
−
|width="120pt"|'''Event Owner''':
 
−
|width="400pt"|Stations w/ UDP, Id: 8 (All stations)
 
−
|-
 
−
|'''Event type''': || [[Event Trigger (Event Type)|15 – Event Trigger]]
 
−
|-
 
−
|'''Subevent''': || 1  ''(NOTE: Subtype 1, NOT 0)''
 
−
|-
 
−
|'''When change to''': || ON
 
−
|-
 
−
|'''When related to''': || All
 
−
|-
 
−
|'''Action''': || [[GROUP MEMBERSHIP|$GRM]] N[[%gns]](%2.exp(2),0) NG %2.exp(2) U0 || Remove station from group
 
−
|-
 
−
|| || || [[%gns]](%2.exp(2),0) returns the physical station number of the first member in the group, if no members are left in the group, it returns 0.
 
−
|-
 
−
|| || || %2.exp(2) returns the last two digits of the groupnumber = Group Index Number.
 
−
|-
 
−
| &nbsp; || [[IND]] %2.phy %2.dak(I%1.dir) 2 3 OFF || Switch OFF the green flashing LED of the DAK-key where this station is stored
 
−
|-
 
−
| &nbsp; || PAUSE || Allow the system to settle (each Pause is 100 msec delay)
 
−
|-
 
−
| &nbsp; || [[IF/ENDIF|IF]] [[%gns]](%2.exp(2),0) || Check if more stations are member of this group. If yes, execute next line.
 
−
|-
 
−
| &nbsp; || [[EVENT_REPORT|$ER]] U15 U1 U1 U1 N[[%gns]](%2.exp(2),0) U3 %2.ref || Re-launch this same event (loop).
 
−
|-
 
−
|| || || $ER = Event Report. [[%gns]](%2.exp(2),0) = Owner, %2.ref = Related To
 
−
|-
 
−
| &nbsp; || [[IF/ENDIF|ENDIF]]
 
−
|-
 
−
|}
 
  
−
------------
+
[[File:DynGrp Event4.PNG|thumb|left|500px|"Group Configuration" button]]
 +
<br style="clear:both;" />
  
 +
{{Code2|
 +
IF %op(%2.dir,<nowiki>=</nowiki>,%1.exp)
 +
IND %1.phy 0 0 0 OFF
 +
ENDIF
 +
}}
  
−
[[Category: Applications]]
+
[[Category:AlphaCom Applications]]
 +
[[Category:ICX-AlphaCom Applications]]
 
[[Category: Control Room Applications]]
 
[[Category: Control Room Applications]]
 +
[[Category:Applications using Event Handler]]

Latest revision as of 10:13, 8 July 2022

AI.png

Operation

For best performance it is recommended to use CRM V station or ECPIR-3P panel, as these devices have buttons with LEDs showing status.

  • Press a dedicated "Group Configuration" DAK key. The red led in key starts flashing, and the Dynamic Group is emptied.
  • Select stations or local groups to be included by pressing the associated DAK keys. A steady green led in the keys indicates that the stations/groups are included
  • Press the "Group Configuration" button again, and the group call is activated (the ding-dong chime is played). Pressing the `M`-key opens the microphone.
  • The green leds continue to be lit during the group call
  • Cancel the group call by pressing the `C`-key. The green LEDs are turned off.
Note icon One can only include, not remove, stations/groups into the dynamic group. If a wrong selection is made, press the C-key, and start the selection over again.


Software requirements

  • ICX: Any version
  • AlphaCom: 13.0.3.0 or later

Configuration

  • Assign directory number 9535 to DAK 1 of the operator station. This is the Group Configuration button. Directory number 9535 is included in a default database.
"Group Configuration" button


  • Each operator station is assigned its own Dynamic Group Call by entering the directory number of the Dynamic Group Call in the User Defined Parameter (%1.EXP) field of the operator.
  • Include operator stations in UDP group 1. Name the UDP group e.g. "Operators".
Include the operator station in UDP Group 1, and enter the directory number of the Dynamic Group used by this operator (Here: 899)



Event Handler configuration

In AlphaPro, go to Exchange and System -> Events, press Insert and create the following events (Simply copy/paste the action strings below into AlphaPro):

Event 1: Start/stop Group Configuration

  • When the "Group Configuration" button is pressed, empty the Dynamic Group and turn on red LED in the button.
  • When leaving the Group Configuration mode, start a 1 sec timer. If the Dynamic Group is not activated within this time, the LEDs will be cleared.
Start/stop Group Configuration


Action commands: 

IF %chg(1,0)
$GRM LV L%1.exp U3
IND %1.phy %1.dak(I%2.dir) 1 3 ON
stop
ENDIF
$ST L%1.dir W10 L%1.exp


Event 2: Include members

  • When DAK keys are pressed during Group Configuration mode, turn on the green LED, and include the station or local group to the dynamic group
  • If the DAK key pressed is the "Group Configuration" button (9535), disconnect the station from configuration mode, turn off the red LED, and dispatch the dynamic group call
Include members


Action commands: 

IND %1.phy %1.dak(I%2.dir) 2 1 ON 
$GRM L%2.dir L%1.exp U1
IF %op(%2.dir,=,9535)
$DISCON_ST L%1.dir 0
IND %1.phy %1.dak(I%2.dir) 1 3 OFF
PAUSE
PAUSE
PAUSE
$DD L%1.dir L%1.exp


Event 3: Reset LEDs when Dynamic Group Call ends

  • When the operator calls the dynamic group, stop the timer that resets all LEDs
  • When the call to the dynamic group call ends, reset all LEDs
Reset LEDs


Action commands: 

IF %op(%2.dir,=,%1.exp)
IF %chg(1,0)
$ST L%1.dir W0 L%1.exp
stop
ENDIF
IND %1.phy 0 0 0 OFF
ENDIF



Event 4: Reset LEDs on timeout

  • If the operator exit the "Group Configuration" mode without starting the dynamic group call within set time, resets all LEDs
"Group Configuration" button


Action commands: 

IF %op(%2.dir,=,%1.exp)
IND %1.phy 0 0 0 OFF
ENDIF


Retrieved from "https://wiki.zenitel.com/w/index.php?title=Dynamic_group_call&oldid=230406"