Cisco Cisco Customer Voice Portal 8.0(1) Developer's Guide

Page of 98
C
HAPTER 
4:
 
C
ALL 
S
TART 
A
CTION
 
 
V
OICE
XML
 
P
ROGRAMMING 
G
UIDE 
 
 
 
FOR 
C
ISCO 
U
NIFIED 
C
USTOMER 
V
OICE 
P
ORTAL 
R
ELEASE 
4.0(1) 
 
 
 
 
20
 
Using the Java API 
The call start action is built in Java by implementing the Unified CVP class 
StartCallInterface
 found in the 
com.audium.server.proxy
 package. It contains a single 
method named 
onStartCall 
that is the execution method for the call start class. This method 
receives a single argument, an instance of 
CallStartAPI
. This class belongs to the Session API 
and is used to access and modify session information such as session data (See Chapter 3: 
Session API for mo
re on this API). The method does not have a return value. It is expected that 
should an unrecoverable error occur, the call start action will throw an 
AudiumException
Using the XML API 
As described in Chapter 3: Session API, the standard “inputs” and “settings” XML documents 
are sent via POST to the call start URI. Figure 4-1 shows the DTD diagram of the XML 
document that must be sent in response. The DTD for the start of call action response is defined 
in the file 
CallStartResponse.dtd
 found in the VoiceXML Server 
dtds
 folder.  
 
Figure 4-1