Cisco Cisco Computer Telephony Integration Option 9.0 Developer's Guide

Page of 668
 
Chapter 8      Session Object
Notes On Message Filters
8-44
CTI OS Developer’s Guide for Cisco ICM/IPCC Enterprise & Hosted Editions Release 7.1(1) 
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 would be 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
The following events cannot be used 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