Actions

Logging (VS-Operator)

From Zenitel Wiki

AI.png

This article shows how to configure basic logging in the VS-Operator. Information can be logged to the on-screen journal (Show) and/or to disk (Log).

In the VSOP Client, select Filter sets, and Add a filter set for Station, and in the Caption field assign a descriptive name to the filter set, e.g. "Journal".

Configuring Filter Set "Journal" for logging. Here "Call Received from <number> <name>" is logged when a call request is received



The text to send to the log is defined in the field Message text.

Here are some examples that can be used:

Event Text in "Message text" field Information Level Comment
On CallRequest Add Call received from %DIRA %ACAPTION Info Triggered when a Ringing Group call (or Call Request) is received
On CallRequest Remove Call from %DIRA %ACAPTION removed from queue Info Triggered when a call is removed from the call queue
OnConnect Conversation with %DIRB %BCAPTION Info Triggered when a conversation is established
OnDisconnect Conversation with %DIRB %BCAPTION ended Info Triggered when a conversation is terminated
OnError Device error at %DIRA %ACAPTION Alarm Triggered when a station or device is reported faulty
On Custom params Door Opening triggered at %DIRA %ACAPTION Warning Triggers on "custom parameter" send from ICX-AlphaCom when Door Opening is activated
On Custom word string <depends on the event> <depends on the event> Triggers on "custom parameter" including text parameters


Different icons will be used in the journal depending on the "Information level":

Alarm, Warning and Info icons



If there is a need to log Door Opening, some additional configuration is required in the ICX-AlphaCom. One have to add a "custom parameter" command in the Door Opening event. For each door opening event one need to add the following code:

Action commands:
IF %chg(1,0)
@*D1 M7F01 L(1)%1.dir U0 W0 W0 W0 W1 W1
ENDIF



Example of a Door Opening event:

Door Opening event in AlphaPro event handler



Finally all stations that should be logged (typically all stations except the operator station) needs to be assigned to the new Filter Set. This can be done in one operation. Select Selected object, and from the Device List select all stations using Shift + Click, then deselect the Operator station by Ctrl + Click. Now right-click and assign the new filter set to the stations:

Assigning the filter set "Journal" to stations



Now change the mode of operation to Operational, and verify that the on-screen Journal displays the correct information:

Output to the log when using the "Message text" and "Information Level" from examples in the table above



Accessing the Log file:
Depending on the rights of the operator, a History button VSOP Journal History.png may be available on the status bar. Click this button to bring up a dialog to view the System log, the Activity log or available Snapshots. Use the filters to search the entries in the log for the required information. In the Activity log, it is possible to select Show paired. When this is selected, call requests and calls will be shown on one line with begin time, end time and duration.

Click Export to export logs to a comma delimited text file. This file can be imported into Excel for further investigation. Snapshots can be exported to a specified directory. Not every operator may be able to view or export all information; this will depend on the access rights that have been assigned to the particular operator.

History


Note that in the Activity log it is possible that a Disconnected call is shown without a matching Connected entry. Under certain circumstances a call may, as far as the ICX-AlphaCom is concerned, get disconnected before it was ever connected. This can for instance be the case for a call to an intercom that is set to Private mode and which times out or is cancelled before the call has been accepted.


Related articles