Cisco Cisco Unified Customer Voice Portal 11.0(1) User Guide

Page of 83
C
HAPTER 
2:
 
C
ISCO 
CVP
 
V
OICE
XML
 
C
OMPONENTS IN 
D
ETAIL
 
 
C
ISCO 
CVP
 
V
OICE
XML 
 
 
User Guide 
 
another CVP VoiceXML application, or other rarer ways for the call to end such as a blind 
transfer or session timeout. 
The purpose of the start of call action is typically to set up dynamic information that is used 
throughout the call, for example, the current price of a stock or information about the caller 
identified by their ANI in some situations. The end of call action is typically used to export 
information about the call to external systems, perform call flow history traces, or execute other 
tasks that require information on what occurred within the call. 
 
The start of call action is given the special ability to change both the voice browser and the 
logging level of the call. These changes apply to the current call only, and allows for a truly 
dynamic application. By allowing the voice browser to change, the application can be deployed 
on multiple voice browsers at once and use a simple DNIS check to output VoiceXML 
compatible with the appropriate browser. Dynamically changing the logging level will allow a 
call to be “singled out” for full logging for audit purposes. These tasks can only be done in the 
start of call action because the call technically has not started when this action occurs. 
The end of call action is given the special ability to produce a final VoiceXML page to send to 
the browser. Even though the caller is no longer connected to the browser by the time the end of 
call action is run, some voice browsers will allow for the interpretation of a VoiceXML page sent 
back in response to a request triggered by a disconnect or hang-up event. Typically this page will 
perform final logging tasks on the browser. 
On Error Notification 
When errors occur on the CVP VoiceXML Server, the application-specific error voice element 
will handle how to handle the caller. If specified, the on error notification Java class can be 
configured to be activated when an error occurs. The class is given information about the 
application and some basic call information to allow the developer to specify the action 
accordingly. The developer can write this class to perform whatever they wish. 
The most common purpose for the on error notification class is to perform some custom 
notification, something to indicate at runtime that an error occurred. This could involve paging 
an administrator or integrating with a third-party trouble ticket and notification process. Since the 
notification usually involves an administrator whose responsibility is the entire CVP VoiceXML 
Server, the Java class, once specified, will apply to any error that prematurely ends a call on any 
CVP VoiceXML application. 
Note that this class is used for notification purposes; it does not allow the call to recover from the 
error. Note also that there is no XML API equivalent for the on error notification; if done at all, it 
must be written in Java. 
 
 
©2000 - 2005 Audium Corporation.  All Rights Reserved.  1/14/05
 
28