Cisco Cisco Computer Telephony Integration Option 9.0 Developer's Guide

Page of 500
   
4-82
CTI OS Developer’s Guide for Cisco Unified ICM/Contact Center Enterprise & Hosted
Release 7.5(1)
Chapter 4      Building Your Application
Sample Code in the CTI OS Toolkit
<configuration>
<configSections>
    <section name="JoeUser" type="System.Configuration.SingleTagSectionHandler" />
<appSettings>
    <add key="LogFilePath" value=".\CtiOsClientLog" />
    <add key="CtiOsA" value="CtiOsServerA" />
    <add key="CtiOsB" value="CtiOsServerB" />
    <add key="PortA" value="42028" />
    <add key="PortB" value="42028" />
  </appSettings>
</configSections>
  <JoeUser TraceMask="0xf" AgentID="1003" AgentInstrument="3009" PeripheralID="5000" 
DialedNumbers="3011,3010" />
</configuration>
The configuration file is composed of the following elements.  These elements are as follows.
configuration – This elements contains the configuration for the desktop.
appSettings – This section defines configuration settings that are shared by every Windows user that 
logs into the system.  A system administrator needs to configure these values for the appropriate CTIOS 
Server(s) and port(s).  Each of this element’s sub-elements defines key value pairs used to configure the 
desktop.
LogFilePath – The value for this key is the path to the log file as well as the prefix of the name of 
the log file.  The name of the Windows user, the log file’s creation time, and the extension “.log” 
will be appended to form the complete name of the log file.  For example, if the desktop was run at 
11:58 AM on May 23, 2005, the log file would have the name 
CtiOsClientLog.JoeUser.050523.11.58.04.5032.log.
CtiOsA – The name or IP address of one of the CTI OS Server peers.
CtiOsB – The name or IP address of the other CTI OS Server peer.
PortA – The port used to connect to the CTI OS Server specified by the CtiOsA key.
PortB – The port used to connect to the CTI OS Server specified by the CtiOsB key.
configSections – This section is used to define Windows user specific sections of the configuration 
file.  These sections are defined using the section element.  You will notice in the sample configuration 
file that there is a section element under configSections corresponding to the element tagged with the 
Window’s user name “JoeUser” under the configuration element.  This section should not need to be 
manually modified.  As different Windows users use the desktop, this section will be modified to include 
section elements for each of the users.
The rest of the configuration file is composed of elements that define configuration specific to different 
Windows users.  For each section element in the configSections element, there is a corresponding 
element under the configuration element.  These elements are used to store information specific to given 
users such as trace mask, agent login ID, dialed numbers, etc.  Most of the attributes in this element 
should not need to be modified.  The one attribute that may need modification is the TraceMask 
attribute.  This attribute is used to control the amount of information logged to the log file.
CtiOs Data Grid.NET
This sample is a set of helper classes that are used in other .NET CIL samples.