Cisco Cisco Computer Telephony Integration Option 8.5 Developer's Guide

Page of 490
   
8-30
CTI OS Developer’s Guide for Cisco Unified Contact Center Enterprise
Release 8.5(3)
Chapter 8      Session Object
Notes On Message Filters
For example, a filter expression with multiple keys, each with multiple values might look like the 
following:
sFilterExpression = 
“AgentID=22866, 22867, 22868; SkillGroupNumber=20, 21”
The interpretation of this filter is to match on any event with AgentID of 22866, 22867, or 22868 and 
with SkillGroupNumber of 20 or 21. 
Filtering for Specific Events
One of the most powerful types of event filters for custom applications are filters that work on specific 
events. 
An example of such an application is an “all agents” real time display, listing the agent states of all 
known agents at the call center, using the eAgentStateEvent to receive agent updates. To request 
specific events, use the MessageID keyword, and the numeric value for the event ID that you wish to 
receive:
‘ register for all eAgentStateEvents
sFilterExpression = “MessageID = 30”
It is also possible to obtain multiple specific events. For example, consider an all calls real-time display 
application, using eCallBeginEvent and eCallEndEvent to add or remove calls from a view:
‘ register for all eCallBeginEvents, eCallEndEvents
sFilterExpression = “MessageID = 23, 24”
Events Not Allowed In Filter Expressions
You cannot use the following events in filter expressions:
ePreLogoutEvent
ePostLogoutEvent
eOnConnection
eOnConnectionClosed
eOnConnectionFailure
eOnHeartbeat
eOnMissingHeartbeat
eOnCurrentCallChanged
eOnCurrentAgentReset
Events that are part of the IMonitoredAgentEvents interface or the IMonitoredCallsInterface. This 
includes the following events:
eOnMonitoredAgentStateChange
OnMonitoredAgentInfoEvent
OnMonitoredCallDeliveredEvent 
OnMonitoredCallEstablishedEvent 
OnMonitoredCallHeldEvent