Oracle Telephony Adapter SDK Components

This chapter covers the following topics:

Installing Oracle Telephony Adapter SDK

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:

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.

Prerequisite

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.

Downloading Oracle Telephony Adapter SDK

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.

  1. In the side navigation bar, select Patches.

    The Select a Patch Search Area page appears.

  2. Click New My Oracle Support Patch Search.

    The Simple Search page appears.

  3. Enter the patch number in the blank text field.

  4. Click Go.

  5. The Patch page appears for that patch number.

  6. 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."

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.

Package Contents

Oracle Telephony Adapter SDK package ppatchnumber_11i_WINNT.zip contains the following files.

Contents of Zip File
Directory Description
bin Scripts for starting Adapter Server and Test Tools
lib Java and C runtime libraries supplied by Oracle
docs Documentation
c SDK for C
c/include SDK for C: C include files
c/lib SDK for C: C libraries supplied by Oracle for C adapter development
c/impl SDK for C: Directory for storing C adapter implementation
c/sample SDK for C: Sample C code
java SDK for Java
java/javadoc SDK for Java: Javadoc
java/classes SDK for Java: Directory for storing Java adapter implementation class files
java/sample SDK for Java: Sample code
3rdParty Storage for Java and C libraries provided by switch and CTI middleware vendor
c/ao/include AO SDK Extension: C include files
c/ao/lib AO SDK Extension: C libraries supplied by Oracle for AO SDK Extension
c/ao/sample AO SDK Extension: Sample AO All C Implementation
java/sample/advanced SDK for Java: Sample Code for Advanced Integration
java/sample/ao AO SDK Extension: Sample AO All Java Implementation
java/sample/basic SDK for Java: Sample Code for Basic Integration
java/sample/ standard SDK for Java: Sample Code for Standard Integration

SDK for Java

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.

SDK for C

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

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.

Oracle Telephony Adapter Server

The Test Utility contains the Oracle Telephony Adapter Server. Developers can use Oracle Telephony Adapter Server to run and test adapter implementations.