Cisco Cisco Computer Telephony Integration Option 8.5 Developer's Guide

Page of 640
 
3-13
CTI OS Developer’s Guide for Cisco ICM/IPCC Enterprise & Hosted Editions Release 7.0(0)
 
Chapter 3      CIL Coding Conventions
UniqueObjectID
Setting Object Properties and Request Parameters with SetValue
The CIL also provides an extensible mechanism to set properties on CTI OS 
Client Interface Objects. The SetValue mechanism, available on the CIL Interface 
Objects (as well as the CTI OS Arguments class), enables setting properties of any 
known type to the object as a key-value pair. 
SetValue, similar to GetValue and AddItem, supports string keywords and 
enumerated names:
// C++
Agent a;
a.SetValue(“AgentID”, “22866”);
a.SetValue(CTIOS_AGENTID, “22866”); // alternative
a.SetValue(ekwAgentID, “22866”); // alternative
‘Visual Basic
Dim a As Agent
a.SetValue “AgentID”, “22866”
//Java. Note use of the CTIOS_AGENTID version of keywords.
String  sAgentID = “22866”;
Args.SetValue(“AgentID”, sAgentID);
Args.SetValue(CtiOs_IkeywordIDs.CTIOS_AGENTID, sAgentID);  // 
alternative
Args.SetValue(ekwAgentID, sAgentID); 
The complete syntax and usage of the GetValue, AddItem, and SetValue methods 
is detailed in 
 The Arguments structure is detailed in 
UniqueObjectID
The CTI OS Server creates and manages the CTI OS objects, representing all 
interactions for the contact center. The CTI OS Server and CIL use the 
UniqueObjectID field  to match up a CTI OS object on the CIL with the 
corresponding object on the Server.
The UniqueObjectID is a variable-length string which can uniquely identify the 
object within the current context of the CTI OS Server and the ICM Enterprise. 
The UniqueObjectID is composed of an object type (e.g. call, agent, skillgroup, 
etc.), and two or more additional identifying fields. 
 explains the 
composition of the UniqueObjectID.