Cisco Cisco Computer Telephony Integration Option 8.5 Developer's Guide

Page of 668
C H A P T E R
 
8-1
CTI OS Developer’s Guide for Cisco ICM/IPCC Enterprise & Hosted Editions Release 7.1(1)
 
8
Session Object
The Client Interface Library’s Session object is used to establish a connection to 
an active CTI OS server. The main functions of the Session object are:
  •
Managing the connection to the CTI OS Server
  •
Distributing events to the appropriate objects and event subscribers
  •
Creating and managing the collections of Agent, Call, and SkillGroup objects 
  •
Automatically recovering from failures 
Typically, an application has a single instance of the Session object, which is used 
by all other CIL objects to send and receive events. However, there are no 
restrictions on the number or types of Session objects one application can employ. 
It is possible, and sometimes desirable, to establish and manage multiple 
independent Sessions, for example to use multiple current event streams. If there 
is more than one Session object monitoring the same Agent or Call, each Session 
object will receive its own events. The order in which events are received is not 
guaranteed when there are multiple Session objects.
For a step-by-step explanation of using the Session object to connect with CTI OS 
Server, see the section 
The Session object creates new Call, Agent, and SkillGroup objects upon receipt 
of an event for that object if the targeted object does not already exist. The Session 
object maintains collections of all Agents, Calls, SkillGroups, and WaitObjects. 
Object lifetime is managed by the Session object, and thus it is important that the 
client application not delete the objects, which would render the object reference