This chapter covers the following topics:
Oracle Telephony Adapter SDK provides APIs for the C and Java programming languages.
Oracle Telephony Adapter Java APIs provide an open interface for consultants and switch and CTI middleware vendors to implement an integration with Oracle Interaction Center (OIC) for any telephony platforms using the Java programming language.
Oracle Telephony Adapter C APIs enable programmers to integrate switches and CTI middlewares using the C programming language.
The Oracle Telephony Adapter C API consists of the following APIs and functions:
Header files for TeleDeviceFactory (TeleDeviceFactoryAPI.h), TelesetDevice (TelesetDeviceAPI.h) and RoutePointDevice (RoutePointDeviceAPI.h).
Event Listener API (TelesetEventListenerAPI.h and RouteEventListenerAPI.h)
Common utilities functions, typedefs and constants (occt_pub.h , occt_md.h)
OHashtable functions (Hashtable.h)
The C adapter implementer implements all methods that are defined in the Header files.
Use the following instructions to install the Oracle Telephony Adapter SDK.
Java Development Kit or Java Runtime Environment must be installed before you install Oracle Telephony Adapter SDK. Oracle recommends that you use JDK version 1.3.
The "Patch for Telephony Adapter Software Development Kit (SDK)" is available from My Oracle Support. Because guides such as this one cannot list patches, get the appropriate patch number from My Oracle Support.
Use the following steps to download the patch from My Oracle Support.
In the side navigation bar, select Patches.
The Select a Patch Search Area page appears.
Click New My Oracle Support Patch Search.
The Simple Search page appears.
Enter the patch number in the blank text field.
Click Go.
The Patch page appears for that patch number.
Click Download.
The download process begins.
Note: Before you extract the downloaded Zip file, in the WinZip Extract window make sure to check "Use folder names" (or a similar option) so that the files extract into the specified directory structure. See the following section "Unpacking."
Use a file extraction program to unzip ppatchnumber_11i_WINNT.zip to a directory path that does not contain white spaces. After you unzip ppatchnumber_11i_WINNT.zip, edit the file oracle/apps/cct/bin/sdkenv.cmd and modify the value of the SDK_JRE_HOME environment variable to the location where JDK is installed. The directory path where the JDK is installed should not contain blank spaces.
Oracle Telephony Adapter SDK package ppatchnumber_11i_WINNT.zip contains the following files.
Developers can use the Oracle Telephony Adapter SDK for Java to implement the adapter by using the Java programming language. The SDK for Java should be used when the Java API is available from the target switch and CTI middleware to be integrated, such as CT Connect and JTAPI.
The adapter implemented using SDK for Java is packaged as JAR files.
Developers can use the Oracle Telephony Adapter SDK for the C programming language to implement the adapter on only the Windows NT and Windows 2000 platforms. The SDK for C should be used when the C API is the only available option from the switch and middleware to be integrated, such as Cisco ICM and TAPI. SDK for Windows NT and Windows 2000 is a set of C functions implementing integrations to the switch and CTI middleware. These functions are collectively packaged as an adapter.
The adapter implemented using SDK for Windows NT and Windows 2000 is packaged as a Windows DLL (Dynamically Loaded Library) file.
Oracle Telephony SDK Integrated Test Utility is a user interface for running, configuring and testing telephony adapters. Developers can use this utility to test their adapter implementations in offline mode, which does not require an Oracle Application Database or Oracle Interaction Center servers. However, the Test Utility does require that the telephony adapter be connected to the telephony platform. The Test Utility is primarily used in the first phase of adapter development where developers can work on their own development workstations without connecting to an Oracle Application Database. The integrated test utility includes four components: Oracle Telephony Adapter Server, TelesetDevice Test Utility, Telephony Adapter Verification Tool, and the switch simulator.
The Test Utility contains the Oracle Telephony Adapter Server. Developers can use Oracle Telephony Adapter Server to run and test adapter implementations.
TeleDevice Test Utility: TeleDevice Test Utility provides a user interface for testing TelesetDevice and RoutePointDevice objects. Developers can use this utility to launch the softphone and to drive test cases.
Telephony Adapter Verification Tool: Telephony Adapter Verification Tool provides developers with a means to verify their adapter implementation against a predefined set of telephony test cases.
Switch Simulator: Developers can use the switch simulator to practice developing an adaptor without having to use a physical telephony switch.