Cisco Cisco Computer Telephony Integration Option 8.5 Developer's Guide
8-29
CTI OS Developer’s Guide for Cisco Unified ICM/Contact Center Enterprise & Hosted
Release 8.0(1)
Chapter 8 Session Object
Notes On Message Filters
Parameters
args
Arguments array that contains the following parameters.
errorcode
An output parameter (return parameter in VB) that contains an error code from
in
Return Values
Default CTI OS return values. See
Chapter 3, “CIL Coding Conventions.”
Notes On Message Filters
A message filter is a condition that an event must meet in order to be sent to the client. It consists of a
keyword/value pair, as explained in the following sections.
keyword/value pair, as explained in the following sections.
Note
Two filter mode applicationss are allowed for each CTI OS Server.
Message Filter Syntax
The CTI OS Server’s event filter mechanism enables the rapid creation of powerful CTI integration
applications. The event filter allows the developer to create a custom event notification stream using a
simple filter expression. The filter expression is sent from the Client Interface Library (CIL) to the CTI
OS server to request an event stream. The CTI OS server’s event filter parses the filter expression, and
registers the CIL client for all events that match any of the filter’s conditions.
applications. The event filter allows the developer to create a custom event notification stream using a
simple filter expression. The filter expression is sent from the Client Interface Library (CIL) to the CTI
OS server to request an event stream. The CTI OS server’s event filter parses the filter expression, and
registers the CIL client for all events that match any of the filter’s conditions.
To set a filter expression, the Session object’s SetMessageFilter() method is used:
‘put filter expression in here
Dim sFilterExpression As String
‘call SetMessageFilter
m_session.SetMesageFilter sFilterExpression
The general form for a filter expression is key=value.
Table 8-5
SetSupervisorSilentMonitorMode Arguments Array Parameters
Keyword
Type
Description
CTIOS_SILENTMONITOR
FORCEMONITOREDMODE
FORCEMONITOREDMODE
INT
One of the following values:
1 -- supervisors can be monitored
0 (default) -- supervisors are put in monitoring mode and cannot
be monitored
be monitored