Cisco Cisco Computer Telephony Integration Option 9.0 Developer's Guide
8-31
CTI OS Developer’s Guide for Cisco ICM/IPCC Enterprise & Hosted Editions
Cisco CTI OS Release 7.2(1)
Chapter 8 Session Object
Notes On Message Filters
Combining Filters
Multiple filters expressions (as described above) can be combined to create more complex expressions.
The general form allows for any number of filters to be concatenated using the semicolon (;), which
produces a logical AND effect.
The general form allows for any number of filters to be concatenated using the semicolon (;), which
produces a logical AND effect.
For example, a filter expression with multiple keys, each with multiple values might look like the
following:
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.
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.
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:
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:
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:
includes the following events:
–
eOnMonitoredAgentStateChange