Cisco Cisco Computer Telephony Integration OS 8.5 Developer's Guide

Page of 500
   
4-32
CTI OS Developer’s Guide for Cisco Unified ICM/Contact Center Enterprise & Hosted
Release 7.5(1)
Chapter 4      Building Your Application
Logging In and Logging Out an Agent
To create keys to control duplicate log in attempts:
Step 1
Open the registry and navigate to: HKEY_LOCAL_MACHINE\Software\Cisco Systems, 
Inc.\CTIOS\[CTI Instance 
Name]\CTIOS1\EnterpriseDesktopSettings\AllDesktops\Login\ConnectionProfiles\Name\[Profile 
Name].
Step 2
Right click in the registry window and select New->DWord Value. The new value appears in the 
window.
Step 3
Change the value name to custom_WarnIfAgentLoggedIn.
Step 4
Double-click the value to open the Edit DWORD Value dialog box.
Step 5
Enter 1 in the Value data field to set the value to true, or 0 to set it to false.
Step 6
Repeat steps 2 through 5 for the value custom_RejectIfAgentLoggedIn.
How to Get Registry Configuration Values to Your Desktop Application
To get CTI OS registry configuration values to your desktop application, in order to handle duplicate log 
in attempts correctly, you must request global configuration settings, then extract the custom settings 
from the event. You would typically do this task before attempting to log in an agent, in the 
OnConnection() event.
Step 1
Create an instance of the Arguments class.
Step 2
In the Arguments instance, set the value for the CTIOS_DESKTOPTYPE key to either:
CtiOs_Enums.DesktopType.eAgentDesktop
CtiOs_Enums.DesktopType.eSupervisorDesktop
Goal
custom_WarnIfAgentLog
gedIn
custom_RejectIfAgentLo
ggedIn
To warn the agent of the 
duplicate log in attempt, 
but to allow the agent to 
proceed
1
0
To allow the agent to 
proceed with the 
duplicate log in attempt 
with no warning
0
0
To not allow the agent to 
proceed with a duplicate 
log in attempt
0 or 1
1