Cisco Cisco Computer Telephony Integration Option 8.5 Developer's Guide
4-31
CTI OS Developer’s Guide for Cisco Unified ICM/Contact Center Enterprise & Hosted
Release 8.0(1)
Chapter 4 Building Your Application
Logging In and Logging Out an Agent
When not successful, the Login() method generates the eControlFailureConf() event.
How to Handle Duplicate Log In Attempts
Overview
A duplicate log in attempt is when an agent who is already logged in tries to log in a second time using
the same ID. Desktop applications must account for such a possible situation and have a plan for dealing
with it.
the same ID. Desktop applications must account for such a possible situation and have a plan for dealing
with it.
You can handle duplicate log in attempts in three ways:
•
Allow the Duplicate Log In with No Warning
•
Allow the Duplicate Log In with a Warning
•
Do not allow a duplicate log in
You control how duplicate log in attempts are handled in two ways:
•
By configuring how duplicate log in attempts are to be handled on a global basis by creating custom
values in the CTI OS Server Registry. By using custom values in the CTI OS Server registry to
control how duplicate log in attempts are handled, and downloading these settings to your desktop
application as described on page 4-35, you can enable flexibility without having to modify your
desktop application code.
values in the CTI OS Server Registry. By using custom values in the CTI OS Server registry to
control how duplicate log in attempts are handled, and downloading these settings to your desktop
application as described on page 4-35, you can enable flexibility without having to modify your
desktop application code.
•
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).