Cisco Cisco Computer Telephony Integration OS 8.5 Developer's Guide

Page of 508
   
4-3
CTI OS Developer’s Guide for Cisco Unified ICM/Contact Center Enterprise & Hosted
Release 8.0(1)
Chapter 4      Building Your Application
Setting Up Your Environment for .NET
Adding CTI OS Toolkit 8.0(1) Components to the “Add Reference” Dialog Box
In Visual Studio.NET 2005, you have the ability to select class libraries and assemblies from the .NET 
tab of the “Add Reference Dialog”. This facilitates the development process and always allows you to 
use the correct version of the components.
In order to enable the .NET CIL class libraries to appear on the Add References dialog, follow the steps 
described in: 
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/vbcon/html/vbtskaddingremovingrefe
rences.asp
Set a registry key that specifies the location of assemblies to display.
To do this, add one of the following registry keys, where <AssemblyLocation> is the directory of the 
assemblies that you want to appear in the Add Reference dialog box:
[HKEY_CURRENT_USER\SOFTWARE\Microsoft\.NETFramework\<version>\AssemblyFoldersEx\MyAsse
mblies]@="<AssemblyLocation>"
[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\<version>\AssemblyFoldersEx\MyAss
emblies]@="<AssemblyLocation>"
Creating the registry key under the HKEY_LOCAL_MACHINE node allows all users to see the 
assemblies in the specified location in the Add Reference dialog box. Creating the registry key under the 
HKEY_CURRENT_USER node affects only the setting for the current user.
For example, if you want to add:
Cisco .NET CIL to the Add Reference dialog>"
[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\<version>\AssemblyFoldersEx\MyAss
emblies]@="<AssemblyLocation>"
Cisco CTI OS RCWs to the Add Reference dialog
[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\v2.0.50727\AssemblyFoldersEx\Cisc
oCtiOsRCWs]@="C:\Program Files\Cisco Systems\CTIOS Client\CTIOS Toolkit\Win32 
CIL\.NETInterops"
Adding Cisco CTI OS ActiveX 8.0(1) Controls to the Toolbox
The Visual Studio .NET 2005 IDE allows visual editing of Windows Forms based applications toolbox 
of visual components available. Since Windows Forms applications are native, the visual components 
are also native. However, it still is possible to use ActiveX controls and they can also be included in the 
toolbox.
Adding CTI OS ActiveX 8.0(1) controls to the toolbox provides pre-packaged CTI functionality such as 
Agent Login, Make Call, Transfer Call, Barge In, etc. The ActiveX controls use COM CIL as the API to 
provide call center and telephony services. These components are use in rapid software development. 
You can “Drag & Drop” selected components into your project, and immediately gain the selected CTI 
functionality. These components are used in development environments such as: Microsoft Visual Basic 
6.0, Microsoft Visual C++ 6.0, 7.0 & 8.0, Power Builder and others.
In order to use the Cisco CTI OS ActiveX 8.0(1) Controls in Visual Studio .NET 2005, it is necessary to 
configure the Cisco CTI OS RCWs as described in the previous section add to the Form Editor Toolbox:
1.
From Visual Studio’s  View menu, make sure to select the “Add/Remove Toolbox Items…” 
command.
2.
From the “Customize Toolbox” dialog box, select the “.NET Framework Components” tab.