Nortel CTI ToolKit, User Manual

Page: 44 / 108

PeriProducer CTI Toolkit User’s Guide for M1
Page 44 Nortel Networks Confidential # P0606089 Ver: 1.1
The following is important information pertaining to the use of the Telephony
Request block:
• To use the Telephony Request block several other blocks have to be executed
first. The CTI Initialize block (see page 32 ) should be used to obtain the CTI
resource. Also, the Set Event Handling block (see page 37 ) should be used to
wait for the
Established
state (in most cases) to guarantee that CSVAPI is
ready to process the request.
• It is generally best if the first use of the Set Event Handling is ignores all
events, thus clearing the wait conditions of anything left over from a previous
circumstance. The application should use
Set Event Handling a second time
before trying to make a telephony request. This is usually best done right after
the call is answered to synchronize the CTI services and their data stores with
the actual phone device state.
• The CTI.status data card is the only value in the CTI folder that is affected by
this CTI toolkit block. The CTI.status parameter is set to 0 if the request is
successful. It is set to 1 if the request fails.
• When using a Telephony Request block to transfer a call, the
cticond
should be handled. After the block is executed, the value of CTI.status can be
checked to verfiy whether or not the transfer was successful. If the transfer
fails due to a problem with the CTI resource, a regular transfer might still be
successful. If the failure is related to the switch, all transfers will be
unsuccessful.
• For examples of applications that use this block, see Appendix Example
Applications — Telephony Request on page 65 .
• For example log files showing the internal functions of this block, see
Appendix
Example Log Files — Telephony Request CSVAPI Log File on
page 78 .
Use of the
Answer Call
function of the Telephony Request block requires that the
application use the Set Event Handling block to wait for
Ringing
.