Filtering Events using UserFilter
  • 27 Oct 2022
  • 1 Minute to read
  • Contributors
  • Dark
    Light
  • PDF

Filtering Events using UserFilter

  • Dark
    Light
  • PDF

Article Summary

Adding a user filter

The events filter is found at the bottom of a users configuration settings and looks like the screen shot below:

image.png

How it works

When no values are present, the user is whitelisted and able to see all call events. When you input a value into one of the text boxes this excludes all events except events with the inputted value. For example if you enter 2001 in the extension text box, they will be able to see all events involving 2001 but no other extension.

Entering information

You can enter a single value multiple values can be separated by commas e.g. 2001,2002,2005,2007,2009 alternatively you can enter the range separated by two hyphens e.g. 2001--2009. Or if you feel brave, you can even enter a regular expression (regex) ^200[0-9]$

Valid values

TypeValueNotes
String2001
Range2001--2009*Note the double hythen
Range2001--09
Regex^200[0-9]$

Query Type

Changes the underlying query to be AND / OR. For example, take the following values:

FieldValue
QueryTypeAND
Caller441234567890,441234567891
Called441234567892
Extension2001--2005

Results in the following (pseudo) query

    WHERE caller contains (441234567890 OR 441234567891) AND called contains (441234567892) AND extension contains (2001,2002,2003,2004,2005) 

If you want a less restrictive approach:

FieldValue
QueryTypeOR
Caller441234567890,441234567891
Called441234567892
Extension2001--2005

the following will match accross all 3 fields

    WHERE caller contains (441234567890 OR 441234567891) OR called contains (441234567892) OR extension contains (2001,2002,2003,2004,2005) 

Be aware when filtering based on caller or called as we do not control the format for outbound calls. For example 01234567890 could also be presented as 441234567890 or +441234567890 or even 00441234567890. It is recommended to either strip the 0, for example, search for 1234567890. However, if you want to be more accurate in your query, then use a regex syntax for example .*1234567890$ (ends with digits) or you can throw the kitchen sink at it and match the complete number with all variances ^(+44|0044|44|0)1234567890$