Cisco Cisco Computer Telephony Integration Option 9.0 Developer's Guide
4-31
CTI OS Developer’s Guide for Cisco ICM/IPCC Enterprise & Hosted Editions
Cisco CTI OS Release 7.2(1)
Chapter 4 Building Your Application
Logging In and Logging Out an Agent
•
By implementing code in your desktop application to detect then to handle the duplicate log in
attempt error according to the custom values in the CTI OS Server Registry. You can write code to
handle duplicate log in attempts in each of the three ways listed above. Then when you must change
how such attempts are handled, you would simply change the registry settings; you would then not
need to change the desktop application code.
attempt error according to the custom values in the CTI OS Server Registry. You can write code to
handle duplicate log in attempts in each of the three ways listed above. Then when you must change
how such attempts are handled, you would simply change the registry settings; you would then not
need to change the desktop application code.
How to Create Values in the CTI OS Server Registry to Control Duplicate Log In Attempts
You can create keys in the CTI OS Server Registry that will instruct desktop applications to handle
duplicate log in attempts in a specific way.
duplicate log in attempts in a specific way.
Warning
Two keys exist by default in the registry that are used by the CTI OS CIL: WarnIfAlreadyLoggedIn
and RejectIfAlreadyLoggedIn. You must not use these keys in your desktop application. You must
instead create other keys as described in this section.
and RejectIfAlreadyLoggedIn. You must not use these keys in your desktop application. You must
instead create other keys as described in this section.
You should create two custom values:
•
custom_WarnIfAgentLoggedIn
•
custom_RejectIfAgentLoggedIn
The custom keys you create can be set to 0 (False) or 1 (True).
The following table lists the settings to use to control how duplicate log in attempts are to be handled:
Goal
custom_WarnIfAgentLog
gedIn
gedIn
custom_RejectIfAgentLo
ggedIn
ggedIn
To warn the agent of the
duplicate log in attempt,
but to allow the agent to
proceed
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
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
proceed with a duplicate
log in attempt
0 or 1
1
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].
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.
window.
Step 3
Change the value name to custom_WarnIfAgentLoggedIn.
Step 4
Double-click the value to open the Edit DWORD Value dialog box.