VSLogger Recording Filters Configuration

Version specific notes: VSLogger version 4.6.2.0 had this feature available, but hidden (not displayed as part of the CLI menu displayed on "config ?" command)

How to use CLI Tool - refer to CLI Tool Overview

Attention!!: most of the corresponding configuration functionality is also available within Versadial VSLogger Monitor graphical interface. Select setup View Setup View and the corresponding section (General, Storage, Channels, etc..).

Recording filters feature allows providing conditions and actions (record, not record, set field ) based on details. e.g. Dialed number or Caller Id etc

Multiple channels can be selected for filtering. Filters commonly used when recording trunk lines, with all trunk channels selected for filtering.

cli>(config)
->filters

cli>(config-filters)
->?
help|? - embedded help
add filter [1-n] - add filter
chset [1-256] [y|n] - set/unset channels
chlist - show channels
enable [y|n] - enable/disable filters
exit - exit current mode.
recordunfiltered [y|n] - record/not record unfiltered
remove filter [1-n] - remove filter
set filter [1-n] - set filter
swap filter [n] [n] - swap filters
show - show current configuration

cli>(config-filters)

General Filter Parameters and Command

Command Format	Description	Extra Notes
add filter [1-n]	add the filter at selected index	New individual filters can be added by this function. If index not provided, filter is appended to the list
chset [1-256] [y\|n]	set/unset filtered channel ( y- default)	Configured filters will apply to channels set by chset command chset 1-5 - select channels 1 through 5. chset 3-6 n - unselect channels 3 through 6.
chlist	Show list of channels set for filtering	cli>(config-filters) ->chlist ch# \|selected ---------------------------------------- 1 y 2 n.....
enable [y\|n]	enable/disable filters	If filters feature disabled. Rest of filters configuration is ignored, even if filters added with add command
recordunfiltered [y\|n]	record/not record unfiltered	Defines action for calls, for which none of the filter conditions were satisfied (record or not recorder) Setting parameter recordunfiltered = n means that none of the recordings should be saved unless it is matched by one of the specified filters. Setting parameter recordunfiltered = y means that all recordings should be saved unless matched and prevented to be saved by one of the specified filters.
remove filter [1-n]	remove filter at specific index	Remove individual filter
set filter [1-n]	set specific filter	Set specific filter value or select specific filter for edit
swap filter [n] [n]	swap filters at specified positions

Individual Filter Configuration

Add filter	cli>(config-filters) ->add filter *settings were modified, type 'save' command to save current settings. cli>(config-filter_1)
Select filter	cli>(config-filters) ->set filter 1 *settings were modified, type 'save' command to save current settings. cli>(config-filter_1)
Filter parameters menu	cli>(config-filter_1) ->? help\|? - embedded help enable [y\|n] - enable/disable filter chset [1-256] [y\|n] - set/unset channels add [or\|and] cond [1-n] [<fld>:<oper>:<pattern>] - add condition exit - exit current mode. remove cond [1-n] - remove condition set [or\|and] cond [1-n] [<fld>:<oper>:<pattern>] - set condition set act [record\|notrecord\|set] [<fld>:<value>] - set action show - show current configuration *settings were modified, type 'save' command to save current settings. cli>(config-filter_1)
Filter condition format - [<fld>:<oper>:<pattern>]	Where <fld> - condition field: note, callerid, dialed, sessionid, extension, direction <oper> - condition operator : eq, noteq, contain, notcontain, match, notmatch, empty, notempty, number, notnumber <pattern> - filter pattern/lookup For operations: eq, noteq, contain, notcontain , pattern is a String, charset For operations: match, notmatch , pattern is regular expression* For operations: empty, notempty, number, notnumber ,not needed and ignored * Some VSLogger CLI parameters support Regular expressions based on PCRE, the Perl Compatible Regular Expressions library by Philip Hazel (see http://www.pcre.org)
add conditions and action	cli>(config-filters-filter_1)add or cond extension:eq:201 cli>(config-filters-filter_1)add or cond extension:eq:102 cli>(config-filters-filter_1)add or cond extension:eq:255 cli>(config-filters-filter_1)set act notrecord

How Filters Applied

Main facts

Multiple channels can be selected for filtering.
Multiple filters could be configured, each filter can have one or more conditions connected with ( Logical OR | Logical AND ) and single action.
Filters processed when the call ends on selected for filtering channel
Filters processed in FIFO order, and first matched filter stops processing loop (remaining filters not processed)
If filter matched, the corresponding action is performed
If all filters passed and none is matched: if parameter recordunfiltered = y , recording is saved; if recordunfiltered = n recording deleted.

Filter actions:

record - save the recording, if filter conditions matched
notrecord - do not save recording if filter conditions matched
set - save recording and update listed fields

Sample configurations and Tests

Prior test assumptions:

line 101, connected to recorder channel 1

line 102, connected to recorder channel 3

line 103, Not connected to the recorder

line 104, Not connected to the recorder

Call from lines generate caller IDs 101,102, and 103 accordingly

No filters configured

Configuration and Test 1

Test Goal: Record only calls from or to 103

Configuration

cli>(config-filters) enable y

cli>(config-filters) chset 1-2

cli>(config-filters) recordunfiltered n

cli>(config-filters) add filter

cli>(config-filters-filter_1)add or cond dialed:eq:103

cli>(config-filters-filter_1)add or cond callerid:eq:103

cli>(config-filters-filter_1)set act record

...save and relod configuration

Test

Call from 103 to 101 , recorded and saved on channel 1
Call from 101 to 103 , recorded and saved on channel 1
Call from 103 to 102 , recorded and saved on channel 2
Call from 102 to 103 , recorded and saved on channel 2
Call from 101 to 102 , recorded (showed recording in monitor screen ) on both channel 1 2, but recording not saved on either channel
Call from 102 to 101 , recorded (showed recording in monitor screen ) on both channel 1 2, but recording not saved on either channel
Call from 104 to 101 , recorded (showed recording in monitor screen ) on 1 , but not saved

Configuration and Test 2

Test Goal: Record all calls except calls from or to 103